eclexia/docs/stdlib-index.html at main · hyperpolymath/eclexia · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<!DOCTYPE html>
<html>
<head>
<title>Eclexia Standard Library Documentation</title>
<style>
/* SPDX-License-Identifier: PMPL-1.0-or-later */

body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
    line-height: 1.6;
    max-width: 900px;
    margin: 0 auto;
    padding: 20px;
    background: #f5f5f5;
    color: #333;
}

h1 {
    color: #2c3e50;
    border-bottom: 3px solid #3498db;
    padding-bottom: 10px;
}

h2 {
    color: #34495e;
    margin-top: 30px;
}

.module {
    background: white;
    border: 1px solid #ddd;
    border-radius: 5px;
    padding: 20px;
    margin: 20px 0;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}

.module h3 {
    color: #2980b9;
    margin-top: 0;
}

.module a {
    color: #3498db;
    text-decoration: none;
    font-weight: bold;
}

.module a:hover {
    text-decoration: underline;
}

.module-desc {
    margin: 10px 0;
    color: #555;
}

.tag {
    display: inline-block;
    background: #ecf0f1;
    padding: 3px 8px;
    border-radius: 3px;
    font-size: 12px;
    margin-right: 5px;
    color: #7f8c8d;
}

footer {
    margin-top: 50px;
    text-align: center;
    color: #7f8c8d;
    font-size: 14px;
}
</style>
</head>
<body>
<h1>Eclexia Standard Library Documentation</h1>

<p>
The Eclexia standard library provides essential data structures, algorithms, and utilities for resource-aware programming. All modules are designed with first-class support for dimensional analysis, shadow pricing, and adaptive execution.
</p>

<h2>Core Modules</h2>

<div class="module">
<h3><a href="core.html">core</a></h3>
<div class="module-desc">
Core types and functions including Option, Result, assertion utilities, and string operations. This module provides the fundamental building blocks for all Eclexia programs.
</div>
<span class="tag">fundamentals</span>
<span class="tag">types</span>
<span class="tag">errors</span>
</div>

<div class="module">
<h3><a href="collections.html">collections</a></h3>
<div class="module-desc">
Comprehensive collection types including Vec, HashMap, HashSet, SortedMap, Queue, PriorityQueue, and set operations. All collections support resource tracking and dimensional types.
</div>
<span class="tag">data-structures</span>
<span class="tag">algorithms</span>
<span class="tag">15KB</span>
</div>

<div class="module">
<h3><a href="math.html">math</a></h3>
<div class="module-desc">
Mathematical functions including trigonometry, exponentials, logarithms, rounding, and number theory. Supports dimensional arithmetic with units.
</div>
<span class="tag">mathematics</span>
<span class="tag">numerics</span>
</div>

<h2>I/O and Text Processing</h2>

<div class="module">
<h3><a href="io.html">io</a></h3>
<div class="module-desc">
File I/O operations including reading, writing, and existence checks. JSON helpers for reading and writing structured data.
</div>
<span class="tag">files</span>
<span class="tag">input-output</span>
</div>

<div class="module">
<h3><a href="text.html">text</a></h3>
<div class="module-desc">
String manipulation utilities including trim, split, join, case conversion, and pattern matching. Built on efficient string operations.
</div>
<span class="tag">strings</span>
<span class="tag">text-processing</span>
</div>

<h2>Time and Scheduling</h2>

<div class="module">
<h3><a href="time.html">time</a></h3>
<div class="module-desc">
Time and duration types with support for instants, datetime operations, sleep, and execution measurement. Essential for scheduling and timing applications.
</div>
<span class="tag">timing</span>
<span class="tag">scheduling</span>
<span class="tag">measurement</span>
</div>

<h2>About Eclexia</h2>

<p>
Eclexia is a resource-aware programming language that combines static typing with runtime resource tracking. Every computation has a cost, and Eclexia makes those costs first-class citizens in the type system through:
</p>

<ul>
<li><strong>Dimensional Types:</strong> Physical units (energy, time, mass) are tracked at compile-time</li>
<li><strong>Shadow Prices:</strong> Resources have dynamic prices that reflect scarcity</li>
<li><strong>Adaptive Execution:</strong> Programs automatically choose optimal implementations based on resource availability</li>
</ul>

<footer>
<p>Generated by eclexia-doc | <a href="https://eclexia.org">eclexia.org</a></p>
</footer>

</body>
</html>