@peripheries/renderer 0.23.0 → 0.24.0

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

package/dist/react.js

@@ -1,11 +1,10 @@
-import { T as rootCells, _ as failedLabels, a as projectSelections, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, m as documentProfile, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as projectCellData } from "./chunks/projection-yvYKzMOS.js";
-import { C as passesConditions, S as pageContext, T as settled, b as cellResolutionContext, c as pageVariables, v as EACH_DEFAULT_AS, w as resolveReferences, y as cellContext } from "./chunks/query-LnTbQghF.js";
-import { a as deriveSectionReferences, b as declaredActions, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, o as isSectionNode, p as sortByOrder, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor } from "./chunks/structure-BrKSgzRJ.js";
-import { a as goToQuestion, c as missing, 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, s as linkTo, t as defaultMode, u as positionFromLink } from "./chunks/forms-CCAE7sCu.js";
+import { T as rootCells, _ as failedLabels, a as projectSelections, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, m as documentProfile, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as projectCellData } from "./chunks/projection-zhu32_KJ.js";
+import { C as passesConditions, S as pageContext, T as settled, b as cellResolutionContext, c as pageVariables, v as EACH_DEFAULT_AS, w as resolveReferences, y as cellContext } from "./chunks/query-D6xQbTFK.js";
+import { a as deriveSectionReferences, b as declaredActions, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, o as isSectionNode, p as sortByOrder, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor } from "./chunks/structure-CKBtQHJq.js";
+import { a as goToQuestion, c as missing, 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, s as linkTo, t as defaultMode, u as positionFromLink } from "./chunks/forms-DxA9WzCt.js";
 import { Component, Fragment, Suspense, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useSelector } from "@tanstack/react-store";
-//#region packages/renderer/src/react/cell-states.tsx
 function CellPlaceholder({ state }) {
 	return jsx("div", {
 		className: "cell-placeholder",
@@ -43,8 +42,6 @@ var CellErrorBoundary = class extends Component {
 		}) : this.props.children;
 	}
 };
-//#endregion
-//#region packages/renderer/src/react/use-cell-store.ts
 function useCellStore(cell, scope, api) {
 	const selections = useSelector(api.store, (s) => projectSelections(cell.selections, s, scope), { compare: shallowEqualBundle });
 	const viewState = useSelector(api.store, (s) => projectViewState(cell.viewState, s, scope), { compare: shallowEqualBundle });
@@ -81,8 +78,6 @@ function useCellStore(cell, scope, api) {
 		scope.projectId
 	]);
 }
-//#endregion
-//#region packages/renderer/src/react/use-container-size.ts
 function useContainerSize(ref, enabled) {
 	const [size, setSize] = useState();
 	useEffect(() => {
@@ -107,8 +102,6 @@ function useContainerSize(ref, enabled) {
 	}, [ref, enabled]);
 	return size;
 }
-//#endregion
-//#region packages/renderer/src/react/use-paging.ts
 var LABEL_REF = /@([A-Za-z0-9_$-]+)/g;
 function cellLabels(cell) {
 	const out = new Set(Object.keys(cell.data?.queries ?? {}));
@@ -208,8 +201,6 @@ function usePaging(cell, entries, loadPage) {
 		loadPage
 	]);
 }
-//#endregion
-//#region packages/renderer/src/react/cell-view.tsx
 var REPEAT_SLOT = "item";
 function useSoftNavigation(navigate) {
 	return useCallback((e) => {
@@ -439,8 +430,6 @@ function CellView({ cell, env, nested = false, injectedProps }) {
 		children: body
 	});
 }
-//#endregion
-//#region packages/renderer/src/react/structure-view.tsx
 function useStructureFacts(structure, cells, env, documents) {
 	return useMemo(() => {
 		const numbering = deriveSectionNumbering(structure);
@@ -535,8 +524,6 @@ function StructureView({ nodes, env, facts, level = 0, documentId = PAGE_DOCUMEN
 		}, `${node.sectionId ?? ""}\u0000${node.cellId ?? index}`);
 	}) });
 }
-//#endregion
-//#region packages/renderer/src/react/page-renderer.tsx
 var warn = (d) => console.warn(`[render] ${d.code}${d.cellId ? ` (cell ${d.cellId})` : ""}: ${d.message}`);
 function PageRenderer({ runtime, bundles, params, baseProps, context, viewer, environment }) {
 	const { page, cells } = runtime;
@@ -651,8 +638,6 @@ function PageRenderer({ runtime, bundles, params, baseProps, context, viewer, en
 		}, cell.id))
 	});
 }
-//#endregion
-//#region packages/renderer/src/react/use-forms-runtime.ts
 var FORM_SAVE_DEBOUNCE_MS = 3e3;
 var answerInputId = (key) => `form-answer-${key.replace(/[^\w-]/g, "_")}`;
 var reviewOf = (notes) => {
@@ -677,7 +662,7 @@ function useFormsRuntime(o) {
 	const steps = useMemo(() => visibleSteps(o.model, values), [o.model, values]);
 	const [at, setAt] = useState(() => positionFromLink(visibleSteps(o.model, answeredOf(o.initial)), mode, o.link ?? {}));
 	const here = settle(steps, mode, at);
-	const readOnly = isReadOnlyStatus(status);
+	const readOnly = o.readOnly === true || isReadOnlyStatus(status);
 	const opts = useRef(o);
 	opts.current = o;
 	const expected = useRef(new Map(Object.entries(o.initial).map(([k, a]) => [k, a.stateId ?? null])));
@@ -728,7 +713,7 @@ function useFormsRuntime(o) {
 		return chain.current;
 	}, []);
 	const change = useCallback((key, value) => {
-		if (isReadOnlyStatus(status)) return;
+		if (readOnly) return;
 		setValues((v) => ({
 			...v,
 			[key]: value
@@ -736,7 +721,7 @@ function useFormsRuntime(o) {
 		pending.current.set(key, value);
 		if (timer.current) clearTimeout(timer.current);
 		timer.current = setTimeout(() => void flush(), FORM_SAVE_DEBOUNCE_MS);
-	}, [flush, status]);
+	}, [flush, readOnly]);
 	useEffect(() => {
 		const onLeave = () => void flush();
 		window.addEventListener("pagehide", onLeave);
@@ -856,7 +841,7 @@ function useFormsRuntime(o) {
 			refusal: refusals[q.key] ?? null,
 			inputId: answerInputId(q.key),
 			...port.upload ? { upload: async (file) => {
-				if (isReadOnlyStatus(status)) return {
+				if (readOnly) return {
 					ok: false,
 					refusal: words("FORM_NOT_OPEN")
 				};
@@ -934,7 +919,7 @@ function useFormsRuntime(o) {
 			run: () => void runSubmit(),
 			blocked: o.model.submitRequired === "block" && allMissing.length > 0
 		} : null,
-		reopen: status === "submitted" && o.model.submittable !== false ? {
+		reopen: status === "submitted" && !o.readOnly && o.model.submittable !== false ? {
 			label: "Edit answers",
 			run: () => void runReopen()
 		} : null,
@@ -995,7 +980,4 @@ function bindActions(v, path, latest) {
 	if (v && typeof v === "object") return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, bindActions(x, [...path, k], latest)]));
 	return v;
 }
-//#endregion
 export { CellErrorBoundary, CellNotice, CellPlaceholder, CellView, FORM_SAVE_DEBOUNCE_MS, PageRenderer, StructureView, answerInputId, cellLabels, useCellStore, useContainerSize, useFormsRuntime, usePaging, useStructureFacts };
-
-//# sourceMappingURL=react.js.map

package/dist/runtime.js

@@ -1,5 +1,5 @@
-import { s as runtimeReady } from "./chunks/load-CjPvISzH.js";
-import { a as createStackStore, t as clearAllScopes } from "./chunks/persistence-DCMakM9H.js";
+import { s as runtimeReady } from "./chunks/load-b38vUiZM.js";
+import { a as createStackStore, t as clearAllScopes } from "./chunks/persistence-hurkUUQ0.js";
 import { PINNED_RUNTIMES, READY_GLOBAL, RESOLVE_GLOBAL, RUNTIME_GLOBAL, buildImportMap } from "@peripheries/runtime";
 import * as React from "react";
 import * as JsxRuntime from "react/jsx-runtime";
@@ -8,7 +8,6 @@ import * as ReactDOM from "react-dom";
 import * as ReactDOMClient from "react-dom/client";
 import * as JsxDevRuntime from "react/jsx-dev-runtime";
 import * as zustand from "zustand";
-//#region packages/renderer/src/runtime/boot.ts
 var RUNTIME_BOOT_SCRIPT = `(function(g){if(g.${READY_GLOBAL})return;g.${READY_GLOBAL}=new Promise(function(r){g.${RESOLVE_GLOBAL}=r;});})(globalThis);`;
 function importMapFor(shared = []) {
 	return { imports: buildImportMap(shared).imports };
@@ -17,8 +16,6 @@ function importMapJson(shared = []) {
 	return JSON.stringify(importMapFor(shared)).replace(/</g, "\\u003c");
 }
 var IMPORT_MAP_JSON = importMapJson();
-//#endregion
-//#region packages/renderer/src/runtime/store-export.ts
 var singleton = null;
 function getStackStore() {
 	return singleton ??= createStackStore();
@@ -43,8 +40,6 @@ function buildStoreRuntime() {
 		selectors
 	};
 }
-//#endregion
-//#region packages/renderer/src/runtime/install.ts
 function buildRuntime(extra = {}) {
 	return {
 		react: React,
@@ -68,8 +63,6 @@ function installRuntime(g = globalThis, extra = {}) {
 	g[RESOLVE_GLOBAL]?.();
 	return runtime;
 }
-//#endregion
-//#region packages/renderer/src/runtime/shims.ts
 function shimFileName(specifier) {
 	const base = PINNED_RUNTIMES[specifier].url.split("/").pop();
 	if (!base?.endsWith(".js")) throw new Error(`[runtime] ${specifier}: url is not a .js file`);
@@ -92,7 +85,4 @@ function renderShim(specifier, names, hasDefault) {
 	}
 	return lines.join("\n") + "\n";
 }
-//#endregion
 export { IMPORT_MAP_JSON, RUNTIME_BOOT_SCRIPT, buildRuntime, getStackStore, importMapFor, importMapJson, installRuntime, renderShim, resetStackStore, runtimeReady, selectors, shimFileName, useStackStore };
-
-//# sourceMappingURL=runtime.js.map

package/dist/styles.css

@@ -1,23 +1,17 @@
-/* @peripheries/renderer/styles.css: what the renderer's markup needs (design/renderer.md §2).
-   Import it once per app. Everything is in the `renderer` layer (design/core-and-tokens.md §7.2):
-   above the reset and the tokens, below every bundle and the org's theme. */
+
 
 @layer renderer {
-  /* ── Page cells (design/core.md §3–4) ─────────────────────────────────────
-     The page and every cell are size containers, so layout responds to the
-     space a component actually has, not the viewport. */
+  
   :root {
     --cell-placeholder-bg: var(--color-surface-sunken, #f1f1f1);
     --cell-notice-bg: var(--color-warning-surface, #fff4d6);
     --cell-notice-fg: var(--color-warning, #6b4e00);
   }
-  /* A page reads the theme's body font and ink, so a cell that sets neither still matches it. */
+  
   [data-page-container] { font-family: var(--font-body, system-ui, sans-serif); color: var(--color-text, inherit); }
   [data-page-container] { container: page / inline-size; }
   .cell { container: cell / inline-size; min-width: 0; }
-  /* A child cell sizes to what it holds: inside its parent's flex or grid parts (a Card's header, an
-     Inline) an inline-size container would have no width of its own and collapse to nothing. Its
-     `@container cell` queries read the parent cell's width instead. */
+  
   .cell[data-nested] { container: none; }
   .cell-placeholder { min-height: 6rem; border-radius: 0.5rem; background: var(--cell-placeholder-bg); }
   .cell-placeholder[aria-busy='true'] { animation: cell-pulse 1.5s ease-in-out infinite; }
@@ -25,24 +19,24 @@
   @media (prefers-reduced-motion: reduce) { .cell-placeholder[aria-busy='true'] { animation: none; } }
   .cell-notice { padding: 0.75rem 1rem; border-radius: 0.5rem; background: var(--cell-notice-bg); color: var(--cell-notice-fg); }
 
-  /* Responsive buckets: each fires at or below its width (narrow 480, compact 720, wide 1024). */
+  
   [data-show-when] { display: none; }
   @container page (max-width: 1024px) {
     [data-hide-when='wide'] { display: none; }
     [data-show-when='wide'] { display: revert; }
-    [data-stack-when='wide'] { grid-column: 1 / -1 !important; } /* over the inline span */
+    [data-stack-when='wide'] { grid-column: 1 / -1 !important; } 
     [data-truncate-when='wide'] { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   }
   @container page (max-width: 720px) {
     [data-hide-when='compact'] { display: none; }
     [data-show-when='compact'] { display: revert; }
-    [data-stack-when='compact'] { grid-column: 1 / -1 !important; } /* over the inline span */
+    [data-stack-when='compact'] { grid-column: 1 / -1 !important; } 
     [data-truncate-when='compact'] { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   }
   @container page (max-width: 480px) {
     [data-hide-when='narrow'] { display: none; }
     [data-show-when='narrow'] { display: revert; }
-    [data-stack-when='narrow'] { grid-column: 1 / -1 !important; } /* over the inline span */
+    [data-stack-when='narrow'] { grid-column: 1 / -1 !important; } 
     [data-truncate-when='narrow'] { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   }
 
@@ -54,6 +48,6 @@
     }
   }
 
-  /* Document structure: sections span a grid page; inside, content stacks. */
+  
   .structure-section { grid-column: 1 / -1; display: flex; flex-direction: column; gap: inherit; }
 }

package/dist/testing.js

@@ -1,10 +1,9 @@
-import { l as prepareDocument } from "./chunks/query-LnTbQghF.js";
-import { o as projectModule } from "./chunks/load-CjPvISzH.js";
-import { i as bundleScope } from "./chunks/refs-BLUokra5.js";
-import { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-DLRIBP8g.js";
-import { r as fromPageSteps } from "./chunks/forms-CCAE7sCu.js";
+import { l as prepareDocument } from "./chunks/query-D6xQbTFK.js";
+import { o as projectModule } from "./chunks/load-b38vUiZM.js";
+import { i as bundleScope } from "./chunks/refs-Csgh6rXq.js";
+import { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-CPj_vx-J.js";
+import { r as fromPageSteps } from "./chunks/forms-DxA9WzCt.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -15,8 +14,6 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
-//#endregion
-//#region packages/renderer/src/testing/ids.ts
 var fixtureId = (n) => `00000000-0000-4000-8000-${String(n).padStart(12, "0")}`;
 var FIXTURE_ID = /^00000000-0000-4000-8000-\d{12}$/;
 var FIXTURE_ORG_SLUGS = ["example-client", "example-advisor"];
@@ -29,8 +26,6 @@ var ADVISOR_ORG = {
 	id: fixtureId(2),
 	slug: "example-advisor"
 };
-//#endregion
-//#region packages/renderer/src/testing/base-props.ts
 var FIXTURE_BASE_PROPS = {
 	user: {
 		id: fixtureId(3),
@@ -47,8 +42,6 @@ var FIXTURE_BASE_PROPS = {
 		secondaryColor: "#c8a13a"
 	}
 };
-//#endregion
-//#region packages/renderer/src/testing/components.tsx
 var components_exports = __exportAll({
 	Badge: () => Badge,
 	Boom: () => Boom,
@@ -183,8 +176,6 @@ var advisorKit = {
 	}),
 	Badge
 };
-//#endregion
-//#region packages/renderer/src/testing/golden.ts
 var bundle = (n, org, module, contracts) => ({
 	row: {
 		id: fixtureId(n),
@@ -830,8 +821,6 @@ var GOLDEN_PAGES = [
 	mixedPage,
 	walkPage
 ];
-//#endregion
-//#region packages/renderer/src/testing/sources.ts
 function goldenGraphSource(g) {
 	const calls = [];
 	const pick = (rows, systemId, ids) => (rows ?? []).filter((r) => r.system_id === systemId && ids.includes(r.graph_node_id));
@@ -1117,8 +1106,6 @@ var form_workbook_page_default = {
 		"submit": { "required": "warn" }
 	}
 };
-//#endregion
-//#region packages/renderer/src/testing/form-workbook.ts
 var SINGLE_LINE = new Set([
 	"text",
 	"number",
@@ -1153,7 +1140,4 @@ function formWorkbookItem(cellId) {
 	};
 }
 var formWorkbookModel = () => fromPageSteps(form_workbook_page_default, formWorkbookItem);
-//#endregion
 export { ADVISOR_ORG, CLIENT_ORG, FIXTURE_BASE_PROPS, FIXTURE_EMAIL_DOMAIN, FIXTURE_ID, FIXTURE_ORG_SLUGS, GOLDEN_PAGES, dashboardPage, documentPage, components_exports as fixtureComponents, fixtureId, formWorkbookItem, formWorkbookModel, formWorkbookPage, goldenBundleRow, goldenBundles, goldenGraphSource, goldenScope, mixedPage, thinRefPage, walkPage };
-
-//# sourceMappingURL=testing.js.map

package/dist/theme.js

@@ -1,5 +1,4 @@
 import { SEMANTIC_TOKENS } from "@peripheries/runtime";
-//#region packages/renderer/src/theme/color.ts
 var NUMBER = /^[+-]?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i;
 var clamp01 = (n) => Math.min(1, Math.max(0, n));
 function hexColor(value) {
@@ -199,8 +198,6 @@ function contrastRatio(foreground, background) {
 	const b = relativeLuminance(bg);
 	return (Math.max(a, b) + .05) / (Math.min(a, b) + .05);
 }
-//#endregion
-//#region packages/renderer/src/theme/parse.ts
 var SEMANTIC = new Set(SEMANTIC_TOKENS);
 var UNSAFE = /[<>{};\\]|\/\*|\*\/|[\u0000-\u001f\u007f]/;
 var isSafeCssValue = (value) => value.trim() !== "" && !UNSAFE.test(value);
@@ -381,8 +378,6 @@ function parseTheme(raw) {
 	}
 	return read;
 }
-//#endregion
-//#region packages/renderer/src/theme/derive.ts
 var FALLBACK_BASE = {
 	"color-bg": "#ffffff",
 	"color-text": "#0a0a0a"
@@ -505,8 +500,6 @@ function themeCss(theme, base) {
 	const lines = Object.entries(themeTokens(theme, base)).filter(([name, value]) => /^[a-z0-9-]+$/.test(name) && typeof value === "string" && isSafeCssValue(value)).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([name, value]) => `    --${name}: ${value.trim()};`);
 	return lines.length ? `@layer theme {\n  :root {\n${lines.join("\n")}\n  }\n}\n` : "";
 }
-//#endregion
-//#region packages/renderer/src/theme/check.ts
 var CONTRAST_PAIRS = [
 	[
 		"color-text",
@@ -603,7 +596,4 @@ function checkTheme(theme, base = {}) {
 	}
 	return diagnostics;
 }
-//#endregion
 export { CONTRAST_PAIRS, checkTheme, contrastRatio, fromOklch, parseColor, parseTheme, relativeLuminance, themeCss, themeTokens, toHex, toOklch };
-
-//# sourceMappingURL=theme.js.map

package/dist/types/catalog/check.d.ts

@@ -3,29 +3,16 @@ import type { Diagnostic } from '../core/graph.js';
 import type { ProjectPage } from '../core/types.js';
 import { type Catalog } from '../core/validate.js';
 export type CatalogInput = {
-    /** `<org_slug>/<bundle_name>` of the bundle being emitted. */
     lineage: string;
     rows: KnowledgeRow[];
     links: KnowledgeLink[];
-    /** This bundle's registry: every component it exports, with its props contract. */
     registry: Record<string, {
         props_schema?: unknown;
     }>;
-    /** Components of other lineages in scope, which snippets may use (core, say). */
     scopeRegistry?: Record<string, {
         props_schema?: unknown;
     }>;
-    /** Whether another lineage's row is live in scope; undefined leaves such links unchecked. */
     inScope?: (lineage: string, kind: KnowledgeKind, key: string) => boolean | undefined;
 };
 export declare function checkCatalog(input: CatalogInput): Diagnostic[];
-/**
- * PROP_INVALID: each literal prop value of the page's inline cells against its
- * prop's schema in the catalog. A value holding a reference is left alone; its
- * type is known only once it resolves. An `@each` projection is judged by its
- * `map` instead (design/renderer.md §5.4): its keys against the items schema
- * (a required key missing is PROP_INVALID, an undeclared one PROP_UNKNOWN),
- * and its literal values against theirs. Run it beside validatePage, which
- * can't (core holds no JSON Schema validator).
- */
 export declare function validatePageProps(page: Pick<ProjectPage, 'content'>, catalog: Catalog): Diagnostic[];

package/dist/types/core/actions.d.ts

@@ -5,46 +5,22 @@ export type ActionDeclaration = string | {
     registry: string;
     entityKey?: string;
 };
-/** `registry#entityKey` when the action names an entity, else the registry key. */
 export declare const actionBindingKey: (registry: string, entityKey?: string) => string;
-/** A declaration's registry key, entity and binding key; null when it names no registry. */
 export declare function normalizeActionDeclaration(decl: unknown): {
     registry: string;
     entityKey?: string;
     bindingKey: string;
 } | null;
-/**
- * The cell's actions from the page's, by the PWA's lookup order: its binding
- * key, then its registry key, then the name the cell uses. Undefined when none match.
- */
 export declare function projectCellActions(declarations: Record<string, unknown> | undefined, pageActions: Record<string, CellAction> | undefined): Record<string, CellAction> | undefined;
-/**
- * What is wrong with a declared action, as messages: an unknown action, a
- * field it requires missing, a field it doesn't take, `append` without
- * exactly one of `patch` and `data` (append), `patch` or `name` (edit), a malformed reference, or a projection.
- */
 export declare function actionProblems(decl: GraphActionDeclaration): Array<{
     field?: string;
     message: string;
 }>;
-/** The references a declaration reads, by namespace or label (`input`, `period`…). */
 export declare function actionReferences(decl: GraphActionDeclaration): string[];
-/**
- * A declaration resolved for one call: the props resolver, with `@input` the
- * component's argument. A reference that resolves to nothing in a required
- * field makes it `INVALID`, so no write runs with a hole in it.
- */
 export declare function resolveAction(name: string, cellId: string, decl: GraphActionDeclaration, ctx: ResolutionContext, input: unknown): {
     action: ResolvedAction;
 } | {
     result: WriteResult;
 };
-/** Runs a resolved action as the viewer: the host's write path, or a harness's mock. Never throws. */
 export type RunAction = (action: ResolvedAction) => Promise<WriteResult>;
-/**
- * A cell's declared actions as the functions its component calls. Each
- * resolves its declaration against the cell's context and the call's input,
- * then hands it to `runAction`; a call never throws. Registry declarations
- * are left to `projectCellActions`.
- */
 export declare function declaredActions(cell: Pick<PageCell, 'id' | 'actions'>, ctx: ResolutionContext, runAction: RunAction | undefined): Record<string, CellAction> | undefined;

package/dist/types/core/bundles/load.d.ts

@@ -1,5 +1,4 @@
 import type { ComponentType } from 'react';
-/** A bundle row as the loader needs it. RLS decides which rows the viewer sees. */
 export type BundleRow = {
     id: string;
     org_id: string;
@@ -13,52 +12,30 @@ export type BundleRow = {
         component_name: string | null;
         exposed_export: string | null;
     }>;
-    /** A shared lineage's specifier: the loader imports it by this, never by URL. */
     specifier?: string | null;
 };
 export type LoadedBundle = {
     id: string;
     label: string;
-    /** Set for a shared lineage (`@stack/core`). */
     specifier?: string;
     components: Record<string, ComponentType<Record<string, unknown>>>;
-    /** `contracts.json`: per-component @data / @action / @printPolicy / @size. */
     contracts: Record<string, unknown>;
     documentProfiles?: unknown;
     paginatorBindings?: unknown;
 };
-/** A function, forwardRef, memo or lazy export: something React can render. */
 export declare function isComponentExport(value: unknown): value is ComponentType<Record<string, unknown>>;
-/** Map registry rows (`exposed_export` → `component_name`) onto a module, and lift the bundle-level exports. */
 export declare function projectModule(row: BundleRow, mod: Record<string, unknown>, contracts?: Record<string, unknown>): LoadedBundle;
 export type BundleFiles = {
-    /** A file of the bundle's version, or null when the row has no files. */
     url: (row: BundleRow, file: string) => string | null;
     import?: (url: string) => Promise<Record<string, unknown>>;
     fetch?: (url: string) => Promise<Response>;
 };
-/** Resolves once the host has installed its runtime (`@peripheries/renderer/runtime`'s installRuntime). */
 export declare function runtimeReady(g?: Record<string, unknown>): Promise<void>;
-/**
- * Load one bundle, once per bundle id (ids are immutable). Waits for the
- * shared runtime first, so the bundle's bare imports resolve to the host's.
- * A shared lineage is imported by its specifier, which the page's import map
- * points at its live version: dependents that import it get the same module
- * instance, and so the same React contexts (design/core-and-tokens.md §4).
- */
 export declare function loadBundle(row: BundleRow, files: BundleFiles): Promise<LoadedBundle>;
-/** What loading a page's bundles came to: the ones that imported, and the row ids of those that didn't. */
 export type LoadedBundles = {
     loaded: LoadedBundle[];
     failed: string[];
 };
-/**
- * Load every bundle in scope in parallel; a failure drops that bundle, not the
- * page, and is reported in `failed` so a host can show it and try again
- * rather than keep the partial set (shell audit S1).
- */
 export declare function loadBundlesSettled(rows: BundleRow[], files: BundleFiles): Promise<LoadedBundles>;
-/** Load every bundle in scope in parallel; a failure drops that bundle, not the page. */
 export declare function loadBundles(rows: BundleRow[], files: BundleFiles): Promise<LoadedBundle[]>;
-/** Test seam. */
 export declare function _clearBundleCache(): void;

package/dist/types/core/bundles/page-bundles.d.ts

@@ -1,19 +1,10 @@
 import type { PageCell } from '../types.js';
 import type { BundleRow, LoadedBundle } from './load.js';
 import { type LineageRef } from './refs.js';
-/** Every lineage the page and its cells reference: the scope, then any cell's own bundle_ref. */
 export declare function pageBundleRefs(scope: LineageRef[], cells: PageCell[], pageOrgId: string | null): LineageRef[];
-/** The bundles a page renders with: its scope, nearest first, and each cell's own bundle_ref. */
 export type PageBundles = {
-    /** null while the bundles load (and always on the server). */
     scope: LoadedBundle[] | null;
     forCell: (cell: PageCell) => LoadedBundle | null;
-    /** The rows couldn't be read, or a bundle didn't import: a cell without its component shows an error and a retry, not "not available". */
     failed: boolean;
 };
-/**
- * Match the loaded bundles to the page's scope and to cells' own refs. `rows`
- * are the bundle rows found for `pageBundleRefs(scope, …)`; `loaded` is null
- * until they have imported.
- */
 export declare function pageBundles(scope: LineageRef[], rows: BundleRow[], loaded: LoadedBundle[] | null, pageOrgId: string | null, failed?: boolean): PageBundles;