@peripheries/renderer 0.22.0 → 0.23.1

package/dist/testing.js

@@ -1,9 +1,9 @@
-import { c as prepareDocument } from "./chunks/query-BPuCJC1C.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 { 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 = {};
@@ -14,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"];
@@ -28,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),
@@ -46,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,
@@ -182,8 +176,6 @@ var advisorKit = {
 	}),
 	Badge
 };
-//#endregion
-//#region packages/renderer/src/testing/golden.ts
 var bundle = (n, org, module, contracts) => ({
 	row: {
 		id: fixtureId(n),
@@ -829,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));
@@ -942,7 +932,212 @@ function goldenBundles(g, cells, { loaded = true } = {}) {
 	const modules = loaded ? rows.map((row) => projectModule(row, all.find((b) => b.row.id === row.id).golden.module, all.find((b) => b.row.id === row.id).golden.contracts)) : null;
 	return pageBundles(scope, rows, modules, g.page.org_id);
 }
-//#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, goldenBundleRow, goldenBundles, goldenGraphSource, goldenScope, mixedPage, thinRefPage, walkPage };
-
-//# sourceMappingURL=testing.js.map
+var form_workbook_page_default = {
+	id: "form-workbook",
+	name: "Planning workbook",
+	org_id: "example-advisor",
+	project_id: "example-project",
+	process_id: null,
+	graph_node_id: null,
+	page_type: "planning-workbook",
+	status: "published",
+	is_template: false,
+	metadata: null,
+	content: { "cells": [
+		{
+			"id": "welcome",
+			"component": "Prose",
+			"props": { "blocks": [{ "text": "This workbook takes about twenty minutes. Your answers save as you go." }] }
+		},
+		{
+			"id": "q-name",
+			"component": "ShortText",
+			"props": { "question": {
+				"key": "full_name",
+				"label": "Your full name",
+				"type": "text",
+				"required": true
+			} }
+		},
+		{
+			"id": "q-birth",
+			"component": "Date",
+			"props": { "question": {
+				"key": "birth_date",
+				"label": "Date of birth",
+				"type": "date",
+				"required": true
+			} }
+		},
+		{
+			"id": "q-children",
+			"component": "Choice",
+			"props": { "question": {
+				"key": "has_children",
+				"label": "Do you have children?",
+				"type": "radio",
+				"required": true,
+				"options": [{
+					"value": "yes",
+					"label": "Yes"
+				}, {
+					"value": "no",
+					"label": "No"
+				}]
+			} }
+		},
+		{
+			"id": "q-children-names",
+			"component": "LongText",
+			"props": { "question": {
+				"key": "children_names",
+				"label": "Their names",
+				"type": "textarea",
+				"required": true
+			} },
+			"when": { "all": [{
+				"q": "has_children",
+				"op": "eq",
+				"value": "yes"
+			}] }
+		},
+		{
+			"id": "q-guardians",
+			"component": "LongText",
+			"props": { "question": {
+				"key": "guardians",
+				"label": "Who would look after them?",
+				"type": "textarea",
+				"required": false
+			} },
+			"when": { "all": [{
+				"q": "has_children",
+				"op": "eq",
+				"value": "yes"
+			}] }
+		},
+		{
+			"id": "draft",
+			"component": "Prose",
+			"props": { "blocks": [{ "text": "Read the draft clause before you answer the next questions." }] }
+		},
+		{
+			"id": "q-executor",
+			"component": "ShortText",
+			"props": { "question": {
+				"key": "executor",
+				"label": "Who should be your executor?",
+				"type": "text",
+				"required": true
+			} }
+		},
+		{
+			"id": "upload",
+			"component": "Upload",
+			"props": { "question": {
+				"key": "id_document",
+				"label": "A photo of your ID",
+				"type": "file",
+				"required": false
+			} }
+		},
+		{
+			"id": "review",
+			"component": "Review",
+			"props": {}
+		},
+		{
+			"id": "submit",
+			"component": "SubmitButton",
+			"props": {}
+		}
+	] },
+	layout: {
+		"type": "flow",
+		"chapters": [{
+			"id": "about-you",
+			"title": "About you"
+		}, {
+			"id": "your-plan",
+			"title": "Your plan"
+		}],
+		"steps": [
+			{
+				"id": "welcome",
+				"title": "Welcome",
+				"chapter": "about-you",
+				"cell_ids": ["welcome"]
+			},
+			{
+				"id": "you",
+				"title": "You",
+				"chapter": "about-you",
+				"cell_ids": ["q-name", "q-birth"]
+			},
+			{
+				"id": "family",
+				"title": "Your family",
+				"chapter": "about-you",
+				"cell_ids": [
+					"q-children",
+					"q-children-names",
+					"q-guardians"
+				]
+			},
+			{
+				"id": "executor",
+				"title": "Your executor",
+				"chapter": "your-plan",
+				"cell_ids": ["draft", "q-executor"]
+			},
+			{
+				"id": "documents",
+				"title": "Documents",
+				"chapter": "your-plan",
+				"cell_ids": ["upload"]
+			},
+			{
+				"id": "review",
+				"title": "Review and submit",
+				"chapter": "your-plan",
+				"cell_ids": ["review", "submit"]
+			}
+		],
+		"submit": { "required": "warn" }
+	}
+};
+var SINGLE_LINE = new Set([
+	"text",
+	"number",
+	"date",
+	"datetime",
+	"email",
+	"phone"
+]);
+var KIND = {
+	Prose: "content",
+	Review: "review",
+	Upload: "upload",
+	SubmitButton: "other"
+};
+var formWorkbookPage = form_workbook_page_default;
+function formWorkbookItem(cellId) {
+	const cell = form_workbook_page_default.content.cells.find((c) => c.id === cellId);
+	if (!cell) return null;
+	const q = cell.props.question;
+	const kind = KIND[cell.component] ?? (q ? "question" : "other");
+	return {
+		id: cell.id,
+		kind,
+		questions: q ? [{
+			key: q.key,
+			label: q.label,
+			required: q.required,
+			singleLine: SINGLE_LINE.has(q.type),
+			definition: { type: q.type }
+		}] : [],
+		...cell.when ? { when: cell.when } : {}
+	};
+}
+var formWorkbookModel = () => fromPageSteps(form_workbook_page_default, formWorkbookItem);
+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 };

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[];