@peripheries/renderer 0.23.0 → 0.23.1

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) => {
@@ -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;

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

@@ -10,60 +10,33 @@ export type LineageRef = {
 } | {
     kind: 'pinned';
     bundleId: string;
-}
-/** A shared lineage (design/core-and-tokens.md §4), imported by its specifier. */
- | {
+} | {
     kind: 'shared';
     specifier: string;
     orgSlug: string;
     bundle: string;
 };
-/** A row of `shared_lineage_live`, as the scope needs it. */
 export type SharedLineage = {
     specifier: string;
     org_slug: string;
     bundle_name: string;
 };
-/** The shared lineage `@core/Name` resolves from first. */
 export declare const CORE_SPECIFIER = "@stack/core";
 export declare const MAIN = "main";
 export declare const PUBLIC = "public";
-/**
- * Normalise a config ref. An org slug means that org's main lineage. A named
- * lineage without `org_slug` belongs to the page's org, so it needs `pageOrgId`;
- * without one it is dropped rather than guessed.
- */
 export declare function normalizeRef(ref: unknown, pageOrgId?: string | null): LineageRef | null;
 export declare const refKey: (r: LineageRef) => string;
-/** Where a page's bundles come from, nearest level first (cell refs are per cell). */
 export type BundleScopeInput = {
     pageOrgId?: string | null;
-    /** `project_page.metadata.bundle_refs` */
     pageRefs?: unknown[] | null;
-    /** `project_template.{org_id, bundle_name}` */
     projectTemplate?: {
         orgId: string;
         bundleName: string | null;
     } | null;
-    /** The section's route entry `bundle_ref` (R3). */
     sectionRef?: unknown;
-    /**
-     * The orgs whose main lineages are fallbacks: the page's own org first, then
-     * the org template's advisor org. Only the first comes before the shared
-     * lineages.
-     */
     orgs?: Array<{
         id: string;
     }>;
-    /** `shared_lineage_live`: the shared lineages, after the page's own lineages. */
     shared?: readonly SharedLineage[];
 };
-/**
- * The ordered, de-duplicated lineage list for a page: page → project →
- * section → the page org's main → shared lineages → the advisor org's main
- * (design/core-and-tokens.md §3). The page's own lineages replace a shared
- * component by exporting the same name; the advisor's main only fills names
- * that neither they nor the shared lineages export, so an advisor org's
- * legacy copy of a core component never shadows core on a client's page.
- */
 export declare function bundleScope(input: BundleScopeInput): LineageRef[];

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

@@ -3,18 +3,8 @@ import type { LoadedBundle } from './load.js';
 export type CoreRegistry = Record<string, ComponentType<Record<string, unknown>>>;
 export type ResolvedComponent = {
     Component: ComponentType<Record<string, unknown>>;
-    /** Which bundle supplied it, or 'core'. */
     source: string;
 };
-/**
- * One cascade (design/core.md §6, design/bundles.md §2, design/core-and-tokens.md §3):
- * - `@core/Name` comes from `stack/core`, then the host's registry;
- * - a cell with its own bundle_ref resolves from that bundle, then the host;
- * - otherwise the page's bundles, nearest level first (org lineages, then the
- *   shared ones), then the host.
- * The nearest wins on a name collision: that is how an org lineage replaces a
- * shared component. `host:Name` is retired (renderer.md §10): no cell used it.
- */
 export declare function resolveComponent(name: string, { cellBundle, scope, core }: {
     cellBundle?: LoadedBundle | null;
     scope: LoadedBundle[];

package/dist/types/core/cell-props.d.ts

@@ -4,22 +4,10 @@ export type CellStatus = {
     isError: boolean;
     errors?: Error[];
 };
-/**
- * A cell's own `data` prop (the PWA's projectDataBundle): its static values,
- * then each declared key read from the page context. Every declared key is
- * present, `undefined` while loading.
- */
 export declare function projectCellData(cell: PageCell, ctx: DataContext): {
     data: Record<string, unknown>;
     status: CellStatus;
 } | null;
-/**
- * The labels a cell reads whose query failed and left nothing (shell audit
- * S1): its declared data keys and the labels its props and conditions refer
- * to. A failed read must not render as an empty list. A query that never ran because a
- * reference resolved to nothing (a client-scoped read with no client in view, a page with no
- * data yet) hasn't failed: the cell renders without it, and the diagnostic says why.
- */
 export declare function failedLabels(cell: PageCell, data: DataContext): string[];
 export type AssembledInputs = {
     resolvedProps: Record<string, unknown>;
@@ -27,7 +15,6 @@ export type AssembledInputs = {
     baseProps: unknown;
     cellData: ReturnType<typeof projectCellData>;
     actions: Record<string, unknown> | undefined;
-    /** Paged labels the cell reads (apps.md §6), each with hasMore and loadMore. */
     paging?: Record<string, {
         hasMore: boolean;
         isLoadingMore: boolean;
@@ -45,11 +32,4 @@ export type AssembledInputs = {
     context: Record<string, unknown>;
     renderComponent?: (key: string, props?: Record<string, unknown>) => unknown;
 };
-/**
- * The PWA's order (CellRenderer.tsx:973-989), so contract props win over
- * `cell.props`: props, children, isLoading / error, baseProps, data / status,
- * actions, the store bundles; then what's new here: size, navigate, context
- * (design/core.md §4). `isLoading` / `error` come from the cell's own data,
- * not, as in the PWA, from whichever page key came first.
- */
 export declare function assembleCellProps(i: AssembledInputs): Record<string, unknown>;

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

@@ -1,39 +1,18 @@
 import type { Diagnostic } from './graph.js';
 import type { PageCell } from './types.js';
-/** The config fields a thin ref took from its DSNS (the PWA's HYDRATED_CELL_FIELDS, which the agency's publish mirrors). */
 export declare const HYDRATED_CELL_FIELDS: readonly ["component", "props", "layout", "conditions", "children", "traversal", "data", "bundle_ref", "actions", "embed"];
-/** Also kept, unlike the PWA, whose hydration and publish dropped them (design/core.md §3). */
 export declare const STORE_FIELDS: readonly ["selections", "viewState", "live"];
-/** What a ref's node owns: everything but the cell's placement. A field its config sets wins, as a whole. */
 export declare const CONTENT_FIELDS: readonly [...("data" | "component" | "props" | "conditions" | "children" | "traversal" | "bundle_ref" | "actions" | "embed")[], "selections", "viewState", "live"];
-/** Where a rendered cell's content came from. */
 export type CellSource = 'inline' | 'node' | 'fallback' | 'pending';
-/** A cell as the renderer reads it: its content resolved, `graph_node_id` its own node (if any). */
 export type ResolvedCell = PageCell & {
     source: CellSource;
 };
-/**
- * The one place the authored forms are read (design/renderer.md §3.1):
- *   1 inline; 2 inline with a `ref`; 3 `{ id, graph_node_id }` (legacy thin ref,
- *   read as 2); 4 inline with a `graph_node_id` (legacy, read as 1, walking
- *   from that node). Legacy forms are reported, so their use can be counted.
- */
 export declare function normalizeCell(cell: PageCell, path?: string): {
     cell: PageCell;
     diagnostics: Diagnostic[];
 };
-/** Whether a (normalized) cell's content is managed by a node. */
 export declare const hasRef: (cell: PageCell) => cell is PageCell & {
     ref: NonNullable<PageCell["ref"]>;
 };
-/**
- * A normalized cell with its node's `page_cell_config` (design/renderer.md §3.2):
- * - the node owns the content (CONTENT_FIELDS): a field the config sets wins;
- * - the page owns the placement: `id`, and `layout` when the entry has one;
- * - `name` from the entry if it has one; `metadata` merged, entry then config;
- * - no config: the entry renders as it is when it names a component
- *   (`fallback`), else the cell is `pending`.
- */
 export declare function resolveCell(cell: PageCell, config: Record<string, unknown> | null | undefined): ResolvedCell;
-/** Cells no other cell lists in `children`: what a flat page renders, in content order. */
 export declare function rootCells<T extends PageCell>(cells: T[]): T[];