@peripheries/renderer 0.23.0 → 0.23.1

package/README.md

@@ -1,18 +1,18 @@
 # @peripheries/renderer
 
-The one renderer for pages built from federated component bundles
-([design/renderer.md](../../docs/plan/design/renderer.md)). The host, the
-component repos' harness and the agency's preview all render through it, so a
-page looks the same in each.
+The one renderer for pages built from federated component bundles. Hosts,
+component repos' harnesses and previews all render through it, so a page looks
+the same in each.
 
 | Entry | Holds |
 |---|---|
 | `@peripheries/renderer/core` | Framework-free: cells and thin-ref hydration, references and conditions, the data context, walks and state names, cell props, layout, document structure, bundle refs and resolution, the shared store, `loadPageData(page, source)`, validation, `DIAGNOSTICS` and `PAGE_RULES` |
-| `@peripheries/renderer/catalog` | `checkCatalog`: what a component repo runs on the knowledge it emits (design/catalog.md §5). The only entry with a JSON Schema validator (ajv) |
-| `@peripheries/renderer/react` | `PageRenderer`, `CellView`, `StructureView`, the cell states, `useContainerSize` |
+| `@peripheries/renderer/catalog` | `checkCatalog`: what a component repo runs on the knowledge it emits. The only entry with a JSON Schema validator (ajv) |
+| `@peripheries/renderer/react` | `PageRenderer`, `CellView`, `StructureView`, the cell states, `useContainerSize`, `useFormsRuntime` and its `FormSlotProps` and `FormAnswer` |
 | `@peripheries/renderer/runtime` | What a page boots with: the import map and boot script, the shims, `installRuntime`, the store bundles import |
-| `@peripheries/renderer/theme` | The org theme pipeline (design/core-and-tokens.md §6.2): `parseTheme` (version 1 or 2 in, version 2 out, with diagnostics), `themeTokens` (semantic overrides derived in OKLCH), `themeCss` (the `theme` layer), `checkTheme` (WCAG contrast) |
+| `@peripheries/renderer/theme` | The org theme pipeline: `parseTheme` (version 1 or 2 in, version 2 out, with diagnostics), `themeTokens` (semantic overrides derived in OKLCH), `themeCss` (the `theme` layer), `checkTheme` (WCAG contrast) |
 | `@peripheries/renderer/print` | The print pipeline, framework-free: `collectBlocks` (the page map), `paginate`, `buildPrintLayout` (the packer's decision as CSS), `buildPageStylesheet` (`@page` geometry and margin boxes), running headers, `@printPolicy` parsing, print lint, `resolveDocumentProfile`, region bindings, map staleness, and the `layout.structure[].print` writer |
+| `@peripheries/renderer/forms` | The forms runtime, framework-free: the steps overlay and its model, conditions, modes, navigation, progress, deep links, and the persistence port (`FormsPort`); the React hook is `useFormsRuntime` in `/react` |
 | `@peripheries/renderer/testing` | The golden pages, synthetic fixtures, and sources that serve them |
 | `@peripheries/renderer/styles.css` | Page and cell containers, the responsive buckets, placeholders and notices, in the `renderer` layer |
 
@@ -32,9 +32,18 @@ const runtime = await loadPageData(page, source, { params, baseProps, viewer, co
 
 `RendererEnvironment` takes, besides `core`, `navigate` and `store`:
 
-- `actionsFor(cell)`: the actions a cell gets. The host has none until R2's
-  write rule; `projectCellActions(cell.actions, pageActions)` applies the PWA's
-  lookup rule (binding key, then registry key, then the cell's own name).
+- `actionsFor(cell)`: the actions a cell gets;
+  `projectCellActions(cell.actions, pageActions)` applies the lookup rule
+  (binding key, then registry key, then the cell's own name).
+- `runAction`: runs a cell's declared action (the host's write path, or a
+  harness's mock); without it a declared action reports `FAILED`.
+- `loadPage`: loads a paged label's next page.
+- `onPropSources(cell, sources)`: each rendered cell's props, leaf by leaf,
+  with where each value came from (for an edit layer, with `editTarget`).
+- `retry()`: reads the page again, for a failed cell's "Try again".
+- `cellProps(cell)`: props from the page's runtime, merged last; on a form
+  page, `useFormsRuntime`'s `cellProps` gives each cell `form`, `answers` and
+  `answer`.
 - `onCellError(cellId, error)`: a component threw. The cell shows an error
   notice either way.
 - `onUnresolvedReference(cellId, ref)`: a prop's `@ref` resolved to nothing
@@ -52,8 +61,7 @@ sharing the channel reads it.
 ## The names a bundle may rely on
 
 What the renderer writes, for a bundle's CSS and checks. These are the only
-names: 0.8.0 dropped the old client-prefixed twins and container names
-(design/core-and-tokens.md §14).
+names: 0.8.0 dropped the old client-prefixed twins and container names.
 
 | Where | Name |
 |---|---|
@@ -69,9 +77,13 @@ bundle's `ThemeProvider` export.
 
 ## Versions
 
-- **0.23.0** (graph-model G2 · DF M1, 2026-10-15): every
-  renderer and runtime contract change for G2–G4, in one minor.
-  - **Main only** (versions.md §4.6, G1 · DF M0): `prepareDocument` reads
+- **0.23.1** (2026-10-15): the published files carry no comments and no
+  source maps (declarations included); this README is the documentation.
+  No API change.
+
+- **0.23.0** (2026-10-15): the
+  versions and forms release, in one minor.
+  - **Main only:** `prepareDocument` reads
     main systems and placements only, adding `version: { is: NULL }` to
     `systemCollection`, `graph_nodeCollection` and `graph_edgeCollection`
     at any depth. New diagnostics: `SYSTEM_NOT_MAIN` (a warning: a page
@@ -96,14 +108,15 @@ bundle's `ThemeProvider` export.
     which (`recorded` | `context`), and `PageRuntime.readVersionIds` the
     versions the states were read from, for print's and an embed's "Release
     N". A state row may carry `versionId`, `unversioned` and `outOfScope`.
-  - **Render-time functions:** `RENDER_FUNCTIONS` adds G2's version reads
+  - **Render-time functions:** `RENDER_FUNCTIONS` adds the version reads
     (`node_states_as_of`, `node_state_view`, `version_context_for`,
     `version_scope_members`, `versions_for`, `version_diff`,
     `auto_release_status`), each with the tables it reads for
     invalidation.
-  - **Declared ahead:** `form_answers(p_structure_nodes: [UUID!]!)` (SCH
-    M3b) is a render function now, listed in `RENDER_FUNCTIONS_AHEAD`, so
-    G3's workbook snapshots need no renderer release. Its JSON is a leaf:
+  - **Declared ahead:** `form_answers(p_structure_nodes: [UUID!]!)` is a
+    render function now, listed in `RENDER_FUNCTIONS_AHEAD` until the
+    database has it, so descriptors can read a workbook's answers without a
+    renderer release. Its JSON is a leaf:
     `result.path` reads into it and nothing in it is flattened. An alias on
     a render function's JSON root is refused (`DESCRIPTOR_ALIAS_JSON_ROOT`),
     since its JSON is decoded by field name.
@@ -117,7 +130,7 @@ bundle's `ThemeProvider` export.
   - **Releases:** `validateManifest(pages)` returns `ReleaseProblem[]`,
     advisory before a release; `manifestPageFrom(graphNodeId, data)` reads a
     page artifact's state data as a manifest page. The runtime adds `PageView` and
-    `SubmissionData` for G3.
+    `SubmissionData`.
   - **The forms runtime** (`@peripheries/renderer/forms`): the steps
     overlay, modes, navigation, saving, progress and deep links behind
     `FormsPort { save, submit, visit, reopen }` (and, optional, `upload` and
@@ -156,10 +169,10 @@ bundle's `ThemeProvider` export.
       null, never an email or a user id;
     - a component reads `form`, `answers` and `answer` from its props on a
       form page, and puts `answer.inputId` on its control.
-    - from G3, page ids (an embed's `page_id`, `PageScope`'s page) are
-      anchor ids; the renderer treats them as opaque, so nothing changes.
+    - page ids (an embed's `page_id`, `PageScope`'s page) become anchor
+      ids; the renderer treats them as opaque, so nothing changes.
 
-- **0.10.0** (data-render M2): actions run, documents edit, pages embed.
+- **0.10.0:** actions run, documents edit, pages embed.
   - Declared actions run through the environment's `runAction`; the runtime's
     `ACTION_FIELDS` takes `subjects` and `audience` on `create`, `edit` and
     `append`, and `create` needs `edge_type` only under a parent.
@@ -175,9 +188,8 @@ bundle's `ThemeProvider` export.
   - A nullable query variable whose whole reference reads `@params`,
     `@context` or `@viewer` and resolves to nothing is sent as `null`.
   - PAGE_RULES is shorter (3780 characters) and describes embed cells.
-- **0.9.0** (data-render M1; prerelease `0.9.0-data-render.0`): queries
-  (design/data.md §2–§6), realtime's inputs, the host contract retired, and
-  the renderer half of actions (§9.2).
+- **0.9.0:** queries, realtime's inputs, the host contract retired, and
+  the renderer half of actions.
   - A label can be `{ descriptor: QueryDescriptor }`, or a node binding to a
     live `query_data` node, whose descriptor runs instead of returning its
     state. `GraphSource` gains `query(descriptor, variables)`, which returns
@@ -208,7 +220,7 @@ bundle's `ThemeProvider` export.
 
 - **0.8.1:** `BaseProps` carries the org's `locale` and `currency` (from its
   org template's metadata), which `@stack/charts` formats with.
-- **0.8.0:** the old names go (design/core-and-tokens.md §14). The renderer
+- **0.8.0:** the old names go. The renderer
   writes only the attributes and container names above, the runtime installs
   only `__STACK_RUNTIME__` and maps only `@stack/store`, and the store has no
   second hook name. A bundle's `ThemeProvider` is no longer lifted or wrapped
@@ -216,15 +228,15 @@ bundle's `ThemeProvider` export.
   gone). `@peripheries/runtime` 0.8.0 drops `LEGACY_RUNTIME_GLOBAL` and
   `SPECIFIER_ALIASES`.
 
-- **0.7.3:** the page container also carries `data-page-grid`, the name
-  design/bundles.md §6 gives the old page-grid attribute, so every attribute
+- **0.7.3:** the page container also carries `data-page-grid`, the
+  canonical name of the old page-grid attribute, so every attribute
   the renderer writes has its canonical name (above) before the old ones go.
 
 - **0.7.2:** the package ships its LICENSE: proprietary to Peripheries Studio
   Inc., all rights reserved.
 - **0.7.1:** `bundleScope` puts the advisor org's `main` after the shared
   lineages, so an advisor org's older copy of a core component never shadows
-  core on a client org's page (design/core-and-tokens.md §3).
+  core on a client org's page.
 - **0.7.0:** shared lineages and the theme. `bundleScope` appends the
   platform's shared lineages, and the loader imports them by specifier;
   `@core/` resolves from `stack/core` (`host:` is retired); `importMapFor` and
@@ -264,7 +276,7 @@ bundle's `ThemeProvider` export.
 - **0.3.0:** `@peripheries/runtime/rank`, sibling order on `graph_node.rank`
   (`compareRank`, `sortByRank`, `rankBetween` and the rest), so no one
   vendors it; the `WALK_NODE_TYPES_EMPTY` warning, because `nodeTypes: []`
-  filters nothing here where the PWA read it as "enter nothing".
+  filters nothing (it doesn't mean "enter nothing").
 - **0.2.0:** the hooks above, `pageRuntimeFromValues`, action projection,
   `data-missing-component` on a missing component's notice, the theme passed
   to `ThemeProvider`, store defaults seeded.
@@ -285,7 +297,7 @@ to fix it; `Diagnostic.code` is typed from that table. Tools show the fix with
 the diagnostic, so a writer learns a rule when they break it.
 
 **`PAGE_RULES`** (from `/core`) is the host's rules for composing a page, the
-short text a writer reads first (design/catalog.md §3.3). It is built from the
+short text a writer reads first. It is built from the
 constants the renderer and validator use, so it changes when they do.
 
 `core` imports no React at runtime and never reaches the network, and the
@@ -296,4 +308,4 @@ code; the golden pages run over fixture sources in `react/golden-pages.test.tsx`
 publishes every package whose version isn't on npm yet, built output only;
 `.github/workflows/publish-packages.yml` stages each new version from
 `develop`, and a maintainer approves it on npmjs.com. Bump the version here to
-release (design/renderer.md §11).
+release.

package/dist/catalog.js

@@ -1,8 +1,7 @@
-import { x as isEach } from "./chunks/query-LnTbQghF.js";
-import { i as eachFormProblems, s as validatePage } from "./chunks/validate-B_g7719l.js";
+import { x as isEach } from "./chunks/query-D6xQbTFK.js";
+import { i as eachFormProblems, s as validatePage } from "./chunks/validate-BcB_PA1k.js";
 import { KNOWLEDGE_BUDGETS, KNOWLEDGE_KEY } from "@peripheries/runtime";
 import Ajv2020 from "ajv/dist/2020.js";
-//#region packages/renderer/src/catalog/check.ts
 var ref = (kind, key) => `${kind}:${key}`;
 var size = (v) => JSON.stringify(v ?? null).length;
 var isReference = (v) => typeof v === "string" && (v.startsWith("@") || v.includes("${"));
@@ -272,7 +271,4 @@ function validateLiteral(schema, value, path, push, ajv) {
 		if (!ajv.validate(schema, value)) push("error", "PROP_INVALID", path, ajv.errorsText(ajv.errors, { dataVar: "" }).replace(/^\s+/, ""));
 	} catch {}
 }
-//#endregion
 export { checkCatalog, validatePageProps };
-
-//# sourceMappingURL=catalog.js.map

package/dist/chunks/{forms-CCAE7sCu.js → forms-DxA9WzCt.js}

@@ -1,4 +1,3 @@
-//#region packages/renderer/src/forms/conditions.ts
 var CONDITION_OPS = [
 	"eq",
 	"ne",
@@ -188,8 +187,6 @@ function normalizeCondition(legacy) {
 		problems
 	};
 }
-//#endregion
-//#region packages/renderer/src/forms/model.ts
 var answered = (v) => v !== void 0 && v !== null && !(typeof v === "string" && v.trim() === "") && !(Array.isArray(v) && v.length === 0);
 function visibleSteps(model, values) {
 	const shows = (when) => evaluateCondition(when ?? null, values);
@@ -336,7 +333,4 @@ function linkTo(steps, mode, at) {
 		...at.question ? { question: at.question } : {}
 	};
 }
-//#endregion
 export { CONDITION_OPS as _, goToQuestion as a, normalizeCondition as b, missing as c, positionsOf as d, progress as f, visibleSteps as g, stepKind as h, goTo as i, move as l, settle as m, enterAdvances as n, isReadOnlyStatus as o, questionsOf as p, fromPageSteps as r, linkTo as s, defaultMode as t, positionFromLink as u, evaluateCondition as v, normalizeOperator as x, isConditionOp as y };
-
-//# sourceMappingURL=forms-CCAE7sCu.js.map

package/dist/chunks/{load-CjPvISzH.js → load-b38vUiZM.js}

@@ -1,5 +1,4 @@
 import { READY_GLOBAL } from "@peripheries/runtime";
-//#region packages/renderer/src/core/bundles/load.ts
 function isComponentExport(value) {
 	if (typeof value === "function") return true;
 	if (!value || typeof value !== "object") return false;
@@ -66,7 +65,4 @@ async function loadBundles(rows, files) {
 function _clearBundleCache() {
 	cache.clear();
 }
-//#endregion
 export { loadBundlesSettled as a, loadBundles as i, isComponentExport as n, projectModule as o, loadBundle as r, runtimeReady as s, _clearBundleCache as t };
-
-//# sourceMappingURL=load-CjPvISzH.js.map

package/dist/chunks/{page-bundles-DLRIBP8g.js → page-bundles-CPj_vx-J.js}

@@ -1,5 +1,4 @@
-import { a as normalizeRef, o as refKey } from "./refs-BLUokra5.js";
-//#region packages/renderer/src/core/bundles/page-bundles.ts
+import { a as normalizeRef, o as refKey } from "./refs-Csgh6rXq.js";
 function pageBundleRefs(scope, cells, pageOrgId) {
 	const out = [...scope];
 	const seen = new Set(out.map(refKey));
@@ -28,7 +27,4 @@ function pageBundles(scope, rows, loaded, pageOrgId, failed = false) {
 		}
 	};
 }
-//#endregion
 export { pageBundles as n, pageBundleRefs as t };
-
-//# sourceMappingURL=page-bundles-DLRIBP8g.js.map

package/dist/chunks/{persistence-DCMakM9H.js → persistence-hurkUUQ0.js}

@@ -1,5 +1,4 @@
 import { Store } from "@tanstack/store";
-//#region packages/renderer/src/core/store/create-store.ts
 function createStackStore(initial) {
 	const store = new Store({
 		selections: {},
@@ -89,8 +88,6 @@ function createStackStore(initial) {
 		subscribe: (listener) => store.subscribe(() => listener(getState()))
 	};
 }
-//#endregion
-//#region packages/renderer/src/core/store/persistence.ts
 var KEY_PREFIX = "stack.store.";
 function storageFor(mode) {
 	if (typeof window === "undefined" || mode === "none") return null;
@@ -134,7 +131,4 @@ function clearAllScopes() {
 		} catch {}
 	}
 }
-//#endregion
 export { createStackStore as a, saveScope as i, clearScope as n, loadScope as r, clearAllScopes as t };
-
-//# sourceMappingURL=persistence-DCMakM9H.js.map

package/dist/chunks/{projection-yvYKzMOS.js → projection-zhu32_KJ.js}

@@ -1,5 +1,4 @@
-import { t as CORE_SPECIFIER } from "./refs-BLUokra5.js";
-//#region packages/renderer/src/core/cells.ts
+import { t as CORE_SPECIFIER } from "./refs-Csgh6rXq.js";
 var HYDRATED_CELL_FIELDS = [
 	"component",
 	"props",
@@ -86,8 +85,6 @@ function rootCells(cells) {
 	const roots = cells.filter((c) => !nested.has(c.id));
 	return roots.length ? roots : cells;
 }
-//#endregion
-//#region packages/renderer/src/core/cell-props.ts
 function projectCellData(cell, ctx) {
 	if (!cell.data) return null;
 	const data = { ...cell.data.static };
@@ -149,8 +146,6 @@ function assembleCellProps(i) {
 	if (i.renderComponent) props.renderComponent = i.renderComponent;
 	return props;
 }
-//#endregion
-//#region packages/renderer/src/core/layout.ts
 function pageContainerStyle(layout) {
 	const type = layout?.type ?? "stack";
 	const gap = typeof layout?.gap === "number" ? `${layout.gap}px` : typeof layout?.gap === "string" ? layout.gap : "16px";
@@ -209,8 +204,6 @@ function documentProfile(layout) {
 	const profile = layout.profile;
 	return typeof profile === "string" && /^[a-z][a-z0-9-]*$/.test(profile) ? profile : void 0;
 }
-//#endregion
-//#region packages/renderer/src/core/bundles/resolve.ts
 function resolveComponent(name, { cellBundle, scope, core }) {
 	if (name.startsWith("@core/")) {
 		const bare = name.slice(6);
@@ -239,8 +232,6 @@ function resolveComponent(name, { cellBundle, scope, core }) {
 		source: "core"
 	} : null;
 }
-//#endregion
-//#region packages/renderer/src/core/store/scope-keys.ts
 var pageScopeKey = (pageId) => `page:${pageId}`;
 var projectScopeKey = (projectId) => `project:${projectId}`;
 function resolveScopeId(kind, ctx) {
@@ -248,8 +239,6 @@ function resolveScopeId(kind, ctx) {
 	if (kind === "project") return ctx.projectId ? projectScopeKey(ctx.projectId) : null;
 	return null;
 }
-//#endregion
-//#region packages/renderer/src/core/store/projection.ts
 var setterName = (name) => "set" + name.charAt(0).toUpperCase() + name.slice(1);
 function projectSelections(decls, state, ctx) {
 	if (!decls) return void 0;
@@ -315,7 +304,4 @@ function collectScopeIds(ctx, selections, viewState) {
 	}
 	return [...ids];
 }
-//#endregion
 export { normalizeCell as C, hasRef as S, rootCells as T, failedLabels as _, projectSelections as a, HYDRATED_CELL_FIELDS as b, pageScopeKey as c, resolveComponent as d, cellAttributes as f, assembleCellProps as g, pageContainerStyle as h, projectLive as i, projectScopeKey as l, documentProfile as m, attachViewStateSetters as n, projectViewState as o, cellPlacementStyle as p, collectScopeIds as r, shallowEqualBundle as s, attachSelectionSetters as t, resolveScopeId as u, projectCellData as v, resolveCell as w, STORE_FIELDS as x, CONTENT_FIELDS as y };
-
-//# sourceMappingURL=projection-yvYKzMOS.js.map

package/dist/chunks/{query-LnTbQghF.js → query-D6xQbTFK.js}

@@ -1,6 +1,5 @@
 import { DESCRIPTOR_VERSION, GRAPHQL_MAX_ROWS } from "@peripheries/runtime";
 import { Kind, parse, print, visit } from "graphql";
-//#region packages/renderer/src/core/references.ts
 var STRICT_REF$1 = /^@[A-Za-z0-9_$-]+(\.[A-Za-z0-9_$[\]-]+)*$/;
 var INTERPOLATION = /\$\{(?:context\.)?([^}]+)\}/g;
 var UnresolvedReference = class extends Error {
@@ -215,8 +214,6 @@ function passesConditions(conditions, ctx) {
 	if (hideIf !== void 0 && hideIf !== "" && resolveReferences(hideIf, ctx)) return false;
 	return true;
 }
-//#endregion
-//#region packages/renderer/src/core/query.ts
 var RENDER_FUNCTIONS = {
 	walk_graph: [
 		"edge",
@@ -948,7 +945,4 @@ var queryKey = (descriptor, variables) => JSON.stringify([
 	descriptor.result?.path ?? null,
 	descriptor.result?.flatten_connections !== false
 ]);
-//#endregion
 export { passesConditions as C, pageContext as S, settled as T, EACH as _, VARIABLE_NAMESPACES as a, cellResolutionContext as b, pageVariables as c, resolveDescriptorVariables as d, selectionShape as f, variableReferences as g, variableLabels as h, UnsafeDocumentError as i, prepareDocument as l, validateDescriptor as m, RENDER_FUNCTIONS as n, descriptorShape as o, shapeAt as p, RENDER_FUNCTIONS_AHEAD as r, orderByVariable as s, PAGING_VARIABLES as t, queryKey as u, EACH_DEFAULT_AS as v, resolveReferences as w, isEach as x, cellContext as y };
-
-//# sourceMappingURL=query-LnTbQghF.js.map

package/dist/chunks/{refs-BLUokra5.js → refs-Csgh6rXq.js}

@@ -1,4 +1,3 @@
-//#region packages/renderer/src/core/bundles/refs.ts
 var CORE_SPECIFIER = "@stack/core";
 var MAIN = "main";
 var PUBLIC = "public";
@@ -65,7 +64,4 @@ function bundleScope(input) {
 	});
 	return out;
 }
-//#endregion
 export { normalizeRef as a, bundleScope as i, MAIN as n, refKey as o, PUBLIC as r, CORE_SPECIFIER as t };
-
-//# sourceMappingURL=refs-BLUokra5.js.map

package/dist/chunks/{structure-BrKSgzRJ.js → structure-CKBtQHJq.js}

@@ -1,6 +1,5 @@
-import { T as settled, w as resolveReferences, x as isEach } from "./query-LnTbQghF.js";
+import { T as settled, w as resolveReferences, x as isEach } from "./query-D6xQbTFK.js";
 import { ACTION_FIELDS, ACTION_KINDS, SECTION_KINDS as SECTION_KINDS$1, isGraphAction } from "@peripheries/runtime";
-//#region packages/renderer/src/core/actions.ts
 var actionBindingKey = (registry, entityKey) => entityKey ? `${registry}#${entityKey}` : registry;
 function normalizeActionDeclaration(decl) {
 	if (typeof decl === "string") return decl.trim() ? {
@@ -148,8 +147,6 @@ function declaredActions(cell, ctx, runAction) {
 	}
 	return Object.keys(out).length ? out : void 0;
 }
-//#endregion
-//#region packages/renderer/src/core/structure.ts
 var PAGE_DOCUMENT = "__page__";
 function normalizeStructure(nodes) {
 	if (!Array.isArray(nodes)) return [];
@@ -383,7 +380,4 @@ function tableOfContents(structure, cells = []) {
 	});
 	return walk(normalizeStructure(structure), 1, PAGE_DOCUMENT);
 }
-//#endregion
 export { resolveAction as C, projectCellActions as S, actionBindingKey as _, deriveSectionReferences as a, declaredActions as b, nodePrintStyle as c, referencesFor as d, sectionAnchor as f, usesStructureLayout as g, tableOfContents as h, deriveSectionNumbering as i, normalizeStructure as l, structureIssues as m, SECTION_KINDS$1 as n, isSectionNode as o, sortByOrder as p, deriveElementReferences as r, mergeSectionReferences as s, PAGE_DOCUMENT as t, numberingFor as u, actionProblems as v, normalizeActionDeclaration as x, actionReferences as y };
-
-//# sourceMappingURL=structure-BrKSgzRJ.js.map

package/dist/chunks/{validate-B_g7719l.js → validate-BcB_PA1k.js}

@@ -1,7 +1,6 @@
-import { _ as EACH, h as variableLabels, m as validateDescriptor, o as descriptorShape, p as shapeAt, v as EACH_DEFAULT_AS, x as isEach } from "./query-LnTbQghF.js";
-import { g as usesStructureLayout, m as structureIssues, v as actionProblems } from "./structure-BrKSgzRJ.js";
+import { _ as EACH, h as variableLabels, m as validateDescriptor, o as descriptorShape, p as shapeAt, v as EACH_DEFAULT_AS, x as isEach } from "./query-D6xQbTFK.js";
+import { g as usesStructureLayout, m as structureIssues, v as actionProblems } from "./structure-CKBtQHJq.js";
 import { DEFAULT_STATE, STATE_NAMES, WALK_DEFAULTS, isDescriptorBinding, isGraphAction, isStateName } from "@peripheries/runtime";
-//#region packages/renderer/src/core/graph.ts
 var TIER_OF_GRAPH_TYPE = {
 	"meta-process": "meta",
 	"process-eng": "eng",
@@ -223,8 +222,6 @@ function readWalk(raw, request) {
 		diagnostics
 	};
 }
-//#endregion
-//#region packages/renderer/src/core/selected.ts
 var STRICT_REF$1 = /^@([A-Za-z0-9_$-]+)((?:\.[A-Za-z0-9_$[\]-]+)*)$/;
 var shapes = new Map();
 function shapeOf(d) {
@@ -273,8 +270,6 @@ function selectionIssues(cell, queries, at) {
 	visit(cell.conditions, `${at}.conditions`, top);
 	return out;
 }
-//#endregion
-//#region packages/renderer/src/core/validate.ts
 var words = (name) => name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().split(/[\s_-]+/).filter(Boolean);
 function editDistance(a, b) {
 	let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
@@ -831,7 +826,4 @@ function slotIssues(cells, catalog) {
 	});
 	return out;
 }
-//#endregion
 export { stateValue as _, nearestNames as a, walkKey as b, selectionIssues as c, needsWalk as d, readField as f, stateNames as g, resolveWalkStart as h, eachFormProblems as i, RESERVED_LABELS as l, referencedLabels as m, STORE_SCOPES as n, validateCell as o, readWalk as p, WALK_DIRECTIONS as r, validatePage as s, RESPONSIVE_BUCKETS as t, mergeStates as u, systemsFromGraphs as v, walkRequest as x, systemsFromProcess as y };
-
-//# sourceMappingURL=validate-B_g7719l.js.map

package/dist/core.js

@@ -1,13 +1,12 @@
-import { C as normalizeCell, S as hasRef, T as rootCells, a as projectSelections, b as HYDRATED_CELL_FIELDS, c as pageScopeKey, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, l as projectScopeKey, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, r as collectScopeIds, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as projectCellData, w as resolveCell, x as STORE_FIELDS, y as CONTENT_FIELDS } from "./chunks/projection-yvYKzMOS.js";
-import { C as passesConditions, S as pageContext, T as settled, _ as EACH, a as VARIABLE_NAMESPACES, b as cellResolutionContext, c as pageVariables, d as resolveDescriptorVariables, f as selectionShape, g as variableReferences, h as variableLabels, i as UnsafeDocumentError, l as prepareDocument, m as validateDescriptor, n as RENDER_FUNCTIONS, o as descriptorShape, p as shapeAt, r as RENDER_FUNCTIONS_AHEAD, s as orderByVariable, t as PAGING_VARIABLES, u as queryKey, v as EACH_DEFAULT_AS, w as resolveReferences, x as isEach, y as cellContext } from "./chunks/query-LnTbQghF.js";
-import { _ as stateValue, a as nearestNames, b as walkKey, c as selectionIssues, d as needsWalk, f as readField, g as stateNames, h as resolveWalkStart, i as eachFormProblems, l as RESERVED_LABELS, m as referencedLabels, n as STORE_SCOPES, o as validateCell, p as readWalk, r as WALK_DIRECTIONS, s as validatePage, t as RESPONSIVE_BUCKETS, u as mergeStates, v as systemsFromGraphs, x as walkRequest, y as systemsFromProcess } from "./chunks/validate-B_g7719l.js";
-import { C as resolveAction, S as projectCellActions, _ as actionBindingKey, a as deriveSectionReferences, b as declaredActions, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, h as tableOfContents, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, n as SECTION_KINDS, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor, v as actionProblems, x as normalizeActionDeclaration, y as actionReferences } from "./chunks/structure-BrKSgzRJ.js";
-import { a as loadBundlesSettled, i as loadBundles, n as isComponentExport, o as projectModule, r as loadBundle, s as runtimeReady, t as _clearBundleCache } from "./chunks/load-CjPvISzH.js";
-import { a as normalizeRef, i as bundleScope, n as MAIN, o as refKey, r as PUBLIC, t as CORE_SPECIFIER } from "./chunks/refs-BLUokra5.js";
-import { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-DLRIBP8g.js";
-import { a as createStackStore, i as saveScope, n as clearScope, r as loadScope } from "./chunks/persistence-DCMakM9H.js";
+import { C as normalizeCell, S as hasRef, T as rootCells, a as projectSelections, b as HYDRATED_CELL_FIELDS, c as pageScopeKey, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, l as projectScopeKey, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, r as collectScopeIds, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as projectCellData, w as resolveCell, x as STORE_FIELDS, y as CONTENT_FIELDS } from "./chunks/projection-zhu32_KJ.js";
+import { C as passesConditions, S as pageContext, T as settled, _ as EACH, a as VARIABLE_NAMESPACES, b as cellResolutionContext, c as pageVariables, d as resolveDescriptorVariables, f as selectionShape, g as variableReferences, h as variableLabels, i as UnsafeDocumentError, l as prepareDocument, m as validateDescriptor, n as RENDER_FUNCTIONS, o as descriptorShape, p as shapeAt, r as RENDER_FUNCTIONS_AHEAD, s as orderByVariable, t as PAGING_VARIABLES, u as queryKey, v as EACH_DEFAULT_AS, w as resolveReferences, x as isEach, y as cellContext } from "./chunks/query-D6xQbTFK.js";
+import { _ as stateValue, a as nearestNames, b as walkKey, c as selectionIssues, d as needsWalk, f as readField, g as stateNames, h as resolveWalkStart, i as eachFormProblems, l as RESERVED_LABELS, m as referencedLabels, n as STORE_SCOPES, o as validateCell, p as readWalk, r as WALK_DIRECTIONS, s as validatePage, t as RESPONSIVE_BUCKETS, u as mergeStates, v as systemsFromGraphs, x as walkRequest, y as systemsFromProcess } from "./chunks/validate-BcB_PA1k.js";
+import { C as resolveAction, S as projectCellActions, _ as actionBindingKey, a as deriveSectionReferences, b as declaredActions, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, h as tableOfContents, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, n as SECTION_KINDS, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor, v as actionProblems, x as normalizeActionDeclaration, y as actionReferences } from "./chunks/structure-CKBtQHJq.js";
+import { a as loadBundlesSettled, i as loadBundles, n as isComponentExport, o as projectModule, r as loadBundle, s as runtimeReady, t as _clearBundleCache } from "./chunks/load-b38vUiZM.js";
+import { a as normalizeRef, i as bundleScope, n as MAIN, o as refKey, r as PUBLIC, t as CORE_SPECIFIER } from "./chunks/refs-Csgh6rXq.js";
+import { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-CPj_vx-J.js";
+import { a as createStackStore, i as saveScope, n as clearScope, r as loadScope } from "./chunks/persistence-hurkUUQ0.js";
 import { ACTION_KINDS, QUERY_DESCRIPTOR_KEY, SECTION_KINDS as SECTION_KINDS$1, STATE_ROLES, STATE_TIERS, WALK_DEFAULTS, isDescriptorBinding, isLiveQueryState, isReadOnlyVersion } from "@peripheries/runtime";
-//#region packages/renderer/src/core/data-context.ts
 function resolveDeclarations(queries, systems, diagnostics = [], cellId) {
 	const out = {};
 	for (const [label, raw] of Object.entries(queries ?? {})) {
@@ -91,8 +90,6 @@ function buildDataContext(input) {
 	}
 	return ctx;
 }
-//#endregion
-//#region packages/renderer/src/core/load-page.ts
 async function resolveSystems(source, page) {
 	const systems = !page.process_id ? {} : source.graphSystems ? systemsFromGraphs(await source.graphSystems(page.process_id)) : systemsFromProcess(await source.processSystems?.(page.process_id));
 	if (!systems.eng_data) {
@@ -620,8 +617,6 @@ function recordsByName(found, declarations) {
 	}
 	return out;
 }
-//#endregion
-//#region packages/renderer/src/core/sources.ts
 var TOOL_OWNED_KEYS = ["content_index", "ref_index"];
 var STRUCTURE_FIELDS = [
 	"title",
@@ -741,8 +736,6 @@ function cellPropSources(runtime, cell, env = {}) {
 		}))
 	};
 }
-//#endregion
-//#region packages/renderer/src/core/diagnostics.ts
 var DIAGNOSTICS = {
 	PAGE_INVALID: {
 		meaning: "`content.cells` is not a list.",
@@ -850,7 +843,7 @@ var DIAGNOSTICS = {
 	},
 	UNSUPPORTED_REGISTRY_BINDING: {
 		meaning: "A binding names a registry query (`{ registry: \"x.y\" }`) from the retired host contract.",
-		fix: "Copy the matching recipe’s descriptor into `{ descriptor }` (the component’s pattern pack has it), or bind the graph node that produces the data. docs/plan/host-contract-verdicts.md maps every id."
+		fix: "Copy the matching recipe’s descriptor into `{ descriptor }` (the component’s pattern pack has it), or bind the graph node that produces the data."
 	},
 	STATE_UNKNOWN_NAME: {
 		meaning: "A state name is not `<tier>_<role>`.",
@@ -1021,8 +1014,6 @@ var DIAGNOSTICS = {
 		fix: "Fix the snippet; it is copied far more faithfully than any rule."
 	}
 };
-//#endregion
-//#region packages/renderer/src/core/rules.ts
 var LAYOUT_TYPES = [
 	"stack",
 	"grid",
@@ -1069,8 +1060,6 @@ The host's rules for every page. Components, kits and patterns are in the catalo
 ## When a check fails
 Every page write is validated; each diagnostic names its code, place and fix.
 `;
-//#endregion
-//#region packages/renderer/src/core/values.ts
 var isTraversal = (v) => !!v && typeof v === "object" && Array.isArray(v.nodes);
 function pageRuntimeFromValues(page, { values = {}, traversal } = {}) {
 	const cells = (page.content?.cells ?? []).map((c) => resolveCell(normalizeCell(c).cell, null));
@@ -1108,8 +1097,6 @@ function pageRuntimeFromValues(page, { values = {}, traversal } = {}) {
 		diagnostics: validatePage(page)
 	};
 }
-//#endregion
-//#region packages/renderer/src/core/release.ts
 function validateManifest(pages, catalog) {
 	return pages.flatMap(({ graphNodeId, page }) => validatePage(page, catalog).filter((d) => d.severity === "error").map((d) => ({
 		graph_node_id: graphNodeId,
@@ -1129,7 +1116,4 @@ function manifestPageFrom(graphNodeId, data) {
 		}
 	};
 }
-//#endregion
 export { CONTENT_FIELDS, CORE_SPECIFIER, DIAGNOSTICS, EACH, EACH_DEFAULT_AS, HYDRATED_CELL_FIELDS, LAYOUT_TYPES, MAIN, PAGE_DOCUMENT, PAGE_RULES, PAGING_VARIABLES, PUBLIC, RENDER_FUNCTIONS, RENDER_FUNCTIONS_AHEAD, RESERVED_LABELS, RESPONSIVE_BUCKETS, SECTION_KINDS, STORE_FIELDS, STORE_SCOPES, STRUCTURE_FIELDS, TOOL_OWNED_KEYS, UnsafeDocumentError, VARIABLE_NAMESPACES, WALK_DIRECTIONS, _clearBundleCache, actionBindingKey, actionProblems, actionReferences, assembleCellProps, attachSelectionSetters, attachViewStateSetters, buildDataContext, bundleScope, cellAttributes, cellContext, cellPlacementStyle, cellPropSources, cellResolutionContext, clearScope, collectDeclarations, collectDescriptors, collectScopeIds, collectStatic, createStackStore, declaredActions, deriveElementReferences, deriveSectionNumbering, deriveSectionReferences, descriptorShape, eachFormProblems, editTarget, hasRef, isComponentExport, isEach, loadBundle, loadBundles, loadBundlesSettled, loadPageData, loadScope, manifestPageFrom, mergeSectionReferences, mergeStates, nearestNames, needsWalk, nodePrintStyle, normalizeActionDeclaration, normalizeCell, normalizeRef, normalizeStructure, numberingFor, orderByVariable, pageBundleRefs, pageBundles, pageContainerStyle, pageContext, pageRuntimeFromValues, pageScopeKey, pageVariables, passesConditions, patchAt, prepareDocument, projectCellActions, projectCellData, projectLive, projectModule, projectScopeKey, projectSelections, projectViewState, queryKey, readField, readWalk, refKey, referencedLabels, referencesFor, resolveAction, resolveCell, resolveComponent, resolveDataSystem, resolveDeclarations, resolveDescriptorVariables, resolveReferences, resolveScopeId, resolveSystems, resolveWalkStart, rootCells, runtimeReady, saveScope, sectionAnchor, selectionIssues, selectionShape, settled, shallowEqualBundle, shapeAt, stateNames, stateValue, structureIssues, systemsFromGraphs, systemsFromProcess, tableOfContents, usesStructureLayout, validateCell, validateDescriptor, validateManifest, validatePage, variableLabels, variableReferences, walkKey, walkRequest };
-
-//# sourceMappingURL=core.js.map

package/dist/forms.js

@@ -1,2 +1,2 @@
-import { _ as CONDITION_OPS, a as goToQuestion, b as normalizeCondition, c as missing, d as positionsOf, f as progress, g as visibleSteps, h as stepKind, i as goTo, l as move, m as settle, n as enterAdvances, o as isReadOnlyStatus, p as questionsOf, r as fromPageSteps, s as linkTo, t as defaultMode, u as positionFromLink, v as evaluateCondition, x as normalizeOperator, y as isConditionOp } from "./chunks/forms-CCAE7sCu.js";
+import { _ as CONDITION_OPS, a as goToQuestion, b as normalizeCondition, c as missing, d as positionsOf, f as progress, g as visibleSteps, h as stepKind, i as goTo, l as move, m as settle, n as enterAdvances, o as isReadOnlyStatus, p as questionsOf, r as fromPageSteps, s as linkTo, t as defaultMode, u as positionFromLink, v as evaluateCondition, x as normalizeOperator, y as isConditionOp } from "./chunks/forms-DxA9WzCt.js";
 export { CONDITION_OPS, defaultMode, enterAdvances, evaluateCondition, fromPageSteps, goTo, goToQuestion, isConditionOp, isReadOnlyStatus, linkTo, missing, move, normalizeCondition, normalizeOperator, positionFromLink, positionsOf, progress, questionsOf, settle, stepKind, visibleSteps };

package/dist/print.js

@@ -1,4 +1,3 @@
-//#region packages/renderer/src/print/document-profile.ts
 var bundleName = (bundle) => bundle.label ?? bundle.key ?? "(unkeyed)";
 var DEFAULTS = {
 	profile: null,
@@ -73,8 +72,6 @@ function readMaxDepth(profile, bundleKey) {
 	}
 	return max;
 }
-//#endregion
-//#region packages/renderer/src/print/document-bindings.ts
 function asRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
@@ -101,8 +98,6 @@ function resolveProfileId(page) {
 	if (fromMetadata !== void 0 && fromMetadata !== fromLayout) console.warn(`[document-bindings] page declares layout.profile=${JSON.stringify(fromLayout)} and metadata.profile=${JSON.stringify(fromMetadata)}. **layout wins.** These are two copies of one fact and only one is read — delete metadata.profile rather than keeping them in step by hand.`);
 	return fromLayout;
 }
-//#endregion
-//#region packages/renderer/src/print/print-policy.ts
 var BREAK_INSIDE = new Set(["avoid", "auto"]);
 function toCount(value) {
 	if (!/^[1-9][0-9]*$/.test(value)) return void 0;
@@ -221,8 +216,6 @@ function deserializeConstraints(value) {
 	const { constraints } = parsePrintPolicy(raw);
 	return Object.keys(constraints).length > 0 ? constraints : void 0;
 }
-//#endregion
-//#region packages/renderer/src/print/page-map.ts
 function collectBlocks(root, printWidthPx, { measureRect, readConstraints, boxFor = defaultBoxFor, selector = "[data-cell-id]", sectionStart, blankBefore }) {
 	if (!root) return {
 		blocks: [],
@@ -444,8 +437,6 @@ function paperGeometryPx(sheet, margins, columns) {
 		columnsReconcile: railPx === 0 || printWidthPx + gutterPx + railPx === pageBoxWidthPx
 	};
 }
-//#endregion
-//#region packages/renderer/src/print/paginate.ts
 function mayNotSplit(c) {
 	if (!c) return true;
 	if (c.atomic) return true;
@@ -663,8 +654,6 @@ function paginate(blocks, { textBlockPx, keepWithNextScaleFloor = .6, sectionFil
 		idealPages: textBlockPx > 0 ? Number((total / textBlockPx).toFixed(2)) : 0
 	};
 }
-//#endregion
-//#region packages/renderer/src/print/running-header.ts
 function resolveRunningValues(map, bands, markers) {
 	const markerByCell = new Map(markers.map((m) => [m.cellId, m]));
 	const cellsOfBand = new Map(bands.map((b) => [b.id, b.members]));
@@ -711,8 +700,6 @@ function runningSlotValues(values, { continuedSuffix = " (continued)" } = {}) {
 		"section-title-continued": values.continued ? `${values.sectionTitle}${continuedSuffix}` : values.sectionTitle
 	};
 }
-//#endregion
-//#region packages/renderer/src/print/print-stylesheet.ts
 var warned = new Set();
 function warnOnce(key, message) {
 	if (warned.has(key)) return;
@@ -862,8 +849,6 @@ function buildPageVariables(profile) {
 	}
 	return decls.length > 0 ? `:root {\n${decls.join("\n")}\n}` : "";
 }
-//#endregion
-//#region packages/renderer/src/print/print-layout.ts
 var SEPARATOR_MARGIN_PX = 48;
 var SEPARATOR_PADDING_PX = 16;
 var SEPARATOR_BORDER_PX = 2;
@@ -1048,8 +1033,6 @@ function round2(n) {
 function round4(n) {
 	return Math.round(n * 1e4) / 1e4;
 }
-//#endregion
-//#region packages/renderer/src/print/map-staleness.ts
 function expectedHeightAfterTypesetting(measuredContainerPx, layout) {
 	return measuredContainerPx - layout.scaled.reduce((sum, r) => sum + (r.heightPx - r.scaledHeightPx), 0) + layout.screenExtraPx;
 }
@@ -1065,8 +1048,6 @@ function mapStaleness(liveHeightPx, expectedPx, textBlockPx) {
 		tolerancePx
 	};
 }
-//#endregion
-//#region packages/renderer/src/print/print-lint.ts
 var VIEWPORT_UNIT = /(?<![\w-])(\d*\.?\d+)(v[hw]|vmin|vmax|[sld]v[hwbi]|vb|vi)(?![\w-])/gi;
 var IGNORED_PROPERTIES = new Set(["container-type"]);
 function viewportUnitsIn(cssText, where) {
@@ -1121,8 +1102,6 @@ function describe(el) {
 	if (cls) return `${el.tagName.toLowerCase()}.${cls.trim().split(/\s+/).slice(0, 2).join(".")}`;
 	return el.tagName.toLowerCase();
 }
-//#endregion
-//#region packages/renderer/src/print/structure-print.ts
 function setRowPageIntent(structure, cellId, intent) {
 	if (!structure || !cellId) return {
 		structure: structure ?? [],
@@ -1385,7 +1364,4 @@ function splitMarginalia(page, marginaliaCellId, hasReservedTrack) {
 		reason: null
 	};
 }
-//#endregion
 export { BLANK_PAGE_SEPARATOR_PX, DEFAULT_MARGINS, DEFAULT_SHEET, MissingRequiredBindingError, PRINT_POLICY_ATTR, RUNNING_SLOTS, SEPARATOR_TOTAL_PX, __clearDocumentProfileWarnings, __clearPrintStylesheetWarnings, applyRowPrint, auditPrintLint, buildPageStylesheet, buildPageVariables, buildPrintLayout, checkPaginatorBindings, collectBlocks, composeConstraints, constraintsFromBox, constraintsFromComputedStyle, constraintsResolver, cssLengthToPx, cssString, cssValue, deserializeConstraints, diffRowPrint, expectedHeightAfterTypesetting, findSlottedCellIds, forcedBreaksWithin, intentOfPrintBlock, isRunningSlot, mapStaleness, mediaReachesPrint, nodePrintConstraints, paginate, paperGeometryPx, parsePrintPolicy, printBlockForIntent, printByCellId, printPolicyToStyle, resolveDocumentProfile, resolvePlacement, resolveProfileId, resolveRegionBindings, resolveRunningValues, rowHasBlankPage, rowPageIntent, runningSlotValues, serializeConstraints, setRowBlankPage, setRowPageIntent, splitMarginalia, stalenessTolerancePx, viewportUnitsIn, withForcedBreaks };
-
-//# sourceMappingURL=print.js.map