gesso-core 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# gesso-core
+
+## 0.1.0
+
+First public release.
+
+The engine: the retained UI graph, typed properties and dirty flags; a layout
+engine covering flexbox in full, CSS Grid with typed tracks, absolute, relative
+and sticky positioning and overflow; one paragraph algorithm shared by the
+engine and both renderers; `Canvas2DRenderer` and `WebGPURenderer` behind one
+`UiRenderer` interface; pointer, wheel, keyboard, focus, gesture and
+hit-testing input; and `UiEnvironment` for typed, scoped, reactive theming.
+
+Layout is checked against headless Chrome: 239 generated cases agree within
+0.1 px, with the divergences that remain pinned by name. Text breaking is
+checked the same way across 124 paragraphs in seven faces, including CJK,
+Arabic, Hebrew, Devanagari, Thai and emoji.
+
+`engine.explain(node)` answers why a box is the size it is, in sentences, in
+the order the rules applied.
+
+Also in this release: the half of the accessibility mirror that lives below a
+component. `UiEditingController.replaceText` is new, so a value set by an
+assistive technology arrives as ordinary editing.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Baker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# gesso-core
+
+The engine under a Gesso application: the retained UI graph, the layout engine, the two renderers, input, text and theming. Everything below a component.
+
+You do not usually install this directly. [`gesso-framework`](https://github.com/kevinpbaker/gesso/tree/main/packages/framework) depends on it and re-exports what an application author needs. Reach for `gesso-core` when you are writing a modifier, a custom layout, or anything else that works against elements rather than components.
+
+```bash
+npm install gesso-core rxjs
+```
+
+## What is in it
+
+| Area          | What it owns                                                                                                          |
+| ------------- | --------------------------------------------------------------------------------------------------------------------- |
+| **Graph**     | The retained node tree, typed properties, and the dirty flags a change raises                                         |
+| **Layout**    | Flexbox in full, CSS Grid with typed tracks, absolute, relative and sticky positioning, overflow                      |
+| **Text**      | One paragraph algorithm shared by the engine and both renderers: wrapping, `maxLines`, ellipsis, real baselines, bidi |
+| **Rendering** | `Canvas2DRenderer` and `WebGPURenderer` behind one `UiRenderer` interface                                             |
+| **Input**     | Pointer, wheel, keyboard, focus, gestures and hit-testing against the painted boxes                                   |
+| **Theming**   | `UiEnvironment`: typed, scoped, reactive values that dirty exactly the nodes reading them                             |
+
+Layout borrows CSS's vocabulary, so it borrows CSS's answers. Every layout conformance case is rendered by headless Chrome and the engine is asserted against it within 0.1 px.
+
+## Asking why
+
+A box is never a mystery:
+
+```ts
+engine.explain(node);
+// constraints received, sizes measured, and a per-axis `decidedBy`
+// in sentences, in the order the rules applied
+```
+
+## Entry points
+
+- `gesso-core` -- the engine
+- `gesso-core/testing` -- the canvas doubles its own suite uses
+
+## Documentation
+
+[Layout](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/layout/flex.md) | [Text](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/guide/text.md) | [Canvas2D and WebGPU](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/rendering/canvas2d-and-webgpu.md) | [Asking the engine why](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/layout/explain.md)
+
+MIT (c) Kevin Baker