@peripheries/renderer 0.25.0 → 0.27.0

package/README.md

@@ -83,6 +83,14 @@ bundle's `ThemeProvider` export.
 
 ## Versions
 
+- **Unreleased:** `RENDER_FUNCTIONS` adds `advisor_add_allowed(p_org_id)`: whether the viewer may
+  add advisors (a bare Boolean; bind it with `result.path: 'advisor_add_allowed'`). It also adds
+  `pages_awaiting_release(p_project_id)`:
+  a project's pages whose newest main page-state is newer than the one their
+  client channel's release holds, for staff (an empty array for anyone else).
+  - **Removable in the next minor:** `GraphSource.processSystems` (the process's cached system
+    columns, read only by a source without `graphSystems`). The host no longer implements it;
+    `graphSystems` is the way, and the process columns it reads are being dropped.
 - **0.25.0** (2026-10-24): `hide_when_empty`, a cell-level list of prop names.
   - **A cell with `hide_when_empty: ["title", "items"]`** renders nothing, and leaves no gap,
     when every prop it names is empty once bound: null, undefined, text that is blank once

package/dist/catalog.js

@@ -1,5 +1,5 @@
-import { x as isEach } from "./chunks/query-D6xQbTFK.js";
-import { i as eachFormProblems, s as validatePage } from "./chunks/validate-CrHGlwey.js";
+import { x as isEach } from "./chunks/query-DOXxGTO2.js";
+import { a as eachFormProblems, c as validatePage, i as componentsFor } from "./chunks/validate-y5_6ws0s.js";
 import { KNOWLEDGE_BUDGETS, KNOWLEDGE_KEY } from "@peripheries/runtime";
 import Ajv2020 from "ajv/dist/2020.js";
 var ref = (kind, key) => `${kind}:${key}`;
@@ -216,7 +216,7 @@ var asNode = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : void 0
 function propsAgainstSchemas(page, catalog, ajv) {
 	const out = [];
 	(Array.isArray(page.content?.cells) ? page.content.cells : []).forEach((cell, i) => {
-		const properties = cell?.component ? catalog.components[cell.component]?.props_schema?.properties : void 0;
+		const properties = cell?.component ? componentsFor(catalog, cell)[cell.component]?.props_schema?.properties : void 0;
 		for (const [prop, value] of Object.entries(cell.props ?? {})) {
 			const schema = properties?.[prop];
 			const path = `content.cells[${i}].props.${prop}`;

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

@@ -43,15 +43,51 @@ function loadBundle(row, files) {
 	}
 	return pending;
 }
+var escapeRe = (v) => v.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+async function sharedDependencies(rows, files) {
+	const get = files.fetch ?? ((u) => fetch(u));
+	const bySpecifier = new Map(rows.map((r) => [r.specifier, r.id]));
+	const deps = new Map();
+	try {
+		await Promise.all(rows.map(async (r) => {
+			if (r.requires) return void deps.set(r.id, r.requires.map((s) => bySpecifier.get(s)).filter((id) => !!id && id !== r.id));
+			const url = files.url(r, "index.js");
+			const res = url ? await get(url) : null;
+			if (!res?.ok) throw new Error("unreadable");
+			const source = await res.text();
+			deps.set(r.id, rows.filter((o) => o.id !== r.id && new RegExp(`(?:from|import)\\s*\\(?\\s*(["'\`])${escapeRe(o.specifier)}\\1`).test(source)).map((o) => o.id));
+		}));
+	} catch {
+		return null;
+	}
+	return deps;
+}
+async function loadWaves(rows, files) {
+	const shared = rows.filter((r) => r.specifier);
+	const rest = rows.filter((r) => !r.specifier);
+	const waves = [];
+	const deps = shared.length > 1 ? await sharedDependencies(shared, files) : null;
+	if (!deps) return [rows];
+	const done = new Set();
+	let left = shared;
+	while (left.length) {
+		const wave = left.filter((r) => (deps.get(r.id) ?? []).every((d) => done.has(d)));
+		if (!wave.length) return [rows];
+		waves.push(wave);
+		wave.forEach((r) => done.add(r.id));
+		left = left.filter((r) => !done.has(r.id));
+	}
+	if (rest.length) waves.push(rest);
+	return waves;
+}
 async function loadBundlesSettled(rows, files) {
-	const settled = await Promise.allSettled(rows.map((r) => loadBundle(r, files)));
 	const loaded = [];
 	const failed = [];
-	settled.forEach((s, i) => {
+	for (const wave of await loadWaves(rows, files)) (await Promise.allSettled(wave.map((r) => loadBundle(r, files)))).forEach((s, i) => {
 		if (s.status === "fulfilled") loaded.push(s.value);
 		else {
-			failed.push(rows[i].id);
-			console.warn(`[bundles] ${rows[i].org_slug}/${rows[i].bundle_name} failed to load:`, s.reason);
+			failed.push(wave[i].id);
+			console.warn(`[bundles] ${wave[i].org_slug}/${wave[i].bundle_name} failed to load:`, s.reason);
 		}
 	});
 	return {

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

@@ -15,16 +15,22 @@ function rowMatches(ref, row) {
 	if (ref.kind === "pinned") return row.id === ref.bundleId;
 	return row.bundle_name === ref.bundle && (ref.kind === "lineage-in-org" ? row.org_id === ref.orgId : row.org_slug === ref.orgSlug);
 }
+function rowsInScope(rows, scope) {
+	return rows.filter((row) => scope.some((r) => rowMatches(r, row)));
+}
+function rowForCell(rows, cell, pageOrgId) {
+	const ref = normalizeRef(cell.bundle_ref, pageOrgId);
+	return ref && rows.find((r) => rowMatches(ref, r)) || null;
+}
 function pageBundles(scope, rows, loaded, pageOrgId, failed = false) {
 	const byRow = new Map((loaded ?? []).map((b) => [b.id, b]));
 	return {
 		failed,
-		scope: loaded ? rows.filter((row) => scope.some((r) => rowMatches(r, row))).flatMap((row) => byRow.get(row.id) ?? []) : null,
+		scope: loaded ? rowsInScope(rows, scope).flatMap((row) => byRow.get(row.id) ?? []) : null,
 		forCell: (cell) => {
-			const ref = normalizeRef(cell.bundle_ref, pageOrgId);
-			const row = ref && rows.find((r) => rowMatches(ref, r));
+			const row = rowForCell(rows, cell, pageOrgId);
 			return (row && byRow.get(row.id)) ?? null;
 		}
 	};
 }
-export { pageBundles as n, pageBundleRefs as t };
+export { rowsInScope as i, pageBundles as n, rowForCell as r, pageBundleRefs as t };

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

@@ -299,6 +299,17 @@ var RENDER_FUNCTIONS = {
 		"edge",
 		"graph"
 	],
+	pages_awaiting_release: [
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system",
+		"edge",
+		"system_version",
+		"system_node_version",
+		"system_node_state"
+	],
 	versions_for: ["system_version"],
 	version_diff: [
 		"system_version",
@@ -316,6 +327,102 @@ var RENDER_FUNCTIONS = {
 		"system_node_state",
 		"graph_node",
 		"edge"
+	],
+	page_read: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	page_by_type: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	page_list: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	form_status_read: [
+		"client_project",
+		"edge",
+		"graph",
+		"graph_edge",
+		"graph_node",
+		"node",
+		"process",
+		"system",
+		"system_node_state",
+		"system_version"
+	],
+	page_read_many: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	page_list_recent: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	page_anchor_of_scope: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	page_summaries: [
+		"edge",
+		"graph",
+		"graph_node",
+		"node",
+		"process",
+		"system_node_state",
+		"system_node_version",
+		"system_version"
+	],
+	edit_proposal_rows: ["system_node_state"],
+	graph_list_items: [
+		"edge",
+		"edge_type",
+		"graph_edge",
+		"graph_node",
+		"node"
+	],
+	advisor_add_allowed: [
+		"advisor",
+		"organization",
+		"org_member",
+		"client"
 	]
 };
 var RENDER_FUNCTIONS_AHEAD = { form_answers: "SCH M3b" };

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

@@ -1,4 +1,4 @@
-import { T as settled, w as resolveReferences, x as isEach } from "./query-D6xQbTFK.js";
+import { T as settled, w as resolveReferences, x as isEach } from "./query-DOXxGTO2.js";
 import { ACTION_FIELDS, ACTION_KINDS, SECTION_KINDS as SECTION_KINDS$1, isGraphAction } from "@peripheries/runtime";
 var actionBindingKey = (registry, entityKey) => entityKey ? `${registry}#${entityKey}` : registry;
 function normalizeActionDeclaration(decl) {
@@ -147,6 +147,31 @@ function declaredActions(cell, ctx, runAction) {
 	}
 	return Object.keys(out).length ? out : void 0;
 }
+var HOST_READ_KEY = "@host";
+var NAME = /^[a-z][a-z0-9_]{0,63}$/;
+var isHostRead = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && "@host" in value;
+function hostReadProblem(value) {
+	const keys = Object.keys(value);
+	if (keys.length !== 1) return `a host read takes only "@host", not ${keys.filter((k) => k !== HOST_READ_KEY).map((k) => `"${k}"`).join(", ")}`;
+	const name = value[HOST_READ_KEY];
+	if (typeof name !== "string" || !NAME.test(name)) return "\"@host\" must be a name of lowercase letters, digits and underscores, starting with a letter";
+	return null;
+}
+function bindHostReads(props, reads, onUnknown) {
+	let out = null;
+	for (const [prop, value] of Object.entries(props)) {
+		if (!isHostRead(value)) continue;
+		out ??= { ...props };
+		const problem = hostReadProblem(value);
+		const name = value[HOST_READ_KEY];
+		if (!problem && reads && Object.hasOwn(reads, name) && typeof reads[name] === "function") out[prop] = reads[name];
+		else {
+			delete out[prop];
+			onUnknown?.(prop, problem ?? `the host lists no read named "${name}"`);
+		}
+	}
+	return out ?? props;
+}
 var PAGE_DOCUMENT = "__page__";
 function normalizeStructure(nodes) {
 	if (!Array.isArray(nodes)) return [];
@@ -380,4 +405,4 @@ function tableOfContents(structure, cells = []) {
 	});
 	return walk(normalizeStructure(structure), 1, PAGE_DOCUMENT);
 }
-export { resolveAction as C, projectCellActions as S, actionBindingKey as _, deriveSectionReferences as a, declaredActions as b, nodePrintStyle as c, referencesFor as d, sectionAnchor as f, usesStructureLayout as g, tableOfContents as h, deriveSectionNumbering as i, normalizeStructure as l, structureIssues as m, SECTION_KINDS$1 as n, isSectionNode as o, sortByOrder as p, deriveElementReferences as r, mergeSectionReferences as s, PAGE_DOCUMENT as t, numberingFor as u, actionProblems as v, normalizeActionDeclaration as x, actionReferences as y };
+export { actionReferences as C, resolveAction as D, projectCellActions as E, actionProblems as S, normalizeActionDeclaration as T, HOST_READ_KEY as _, deriveSectionReferences as a, isHostRead as b, nodePrintStyle as c, referencesFor as d, sectionAnchor as f, usesStructureLayout as g, tableOfContents as h, deriveSectionNumbering as i, normalizeStructure as l, structureIssues as m, SECTION_KINDS$1 as n, isSectionNode as o, sortByOrder as p, deriveElementReferences as r, mergeSectionReferences as s, PAGE_DOCUMENT as t, numberingFor as u, bindHostReads as v, declaredActions as w, actionBindingKey as x, hostReadProblem as y };

package/dist/chunks/{validate-CrHGlwey.js → validate-y5_6ws0s.js}

@@ -1,5 +1,5 @@
-import { _ as EACH, h as variableLabels, m as validateDescriptor, o as descriptorShape, p as shapeAt, v as EACH_DEFAULT_AS, x as isEach } from "./query-D6xQbTFK.js";
-import { g as usesStructureLayout, m as structureIssues, v as actionProblems } from "./structure-CKBtQHJq.js";
+import { _ as EACH, h as variableLabels, m as validateDescriptor, o as descriptorShape, p as shapeAt, v as EACH_DEFAULT_AS, x as isEach } from "./query-DOXxGTO2.js";
+import { S as actionProblems, b as isHostRead, g as usesStructureLayout, m as structureIssues, y as hostReadProblem } from "./structure-B1PsD-AJ.js";
 import { DEFAULT_STATE, STATE_NAMES, WALK_DEFAULTS, isDescriptorBinding, isGraphAction, isStateName } from "@peripheries/runtime";
 var TIER_OF_GRAPH_TYPE = {
 	"meta-process": "meta",
@@ -270,6 +270,7 @@ function selectionIssues(cell, queries, at) {
 	visit(cell.conditions, `${at}.conditions`, top);
 	return out;
 }
+var componentsFor = (catalog, cell) => catalog.forCell?.(cell) ?? catalog.components;
 var words = (name) => name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().split(/[\s_-]+/).filter(Boolean);
 function editDistance(a, b) {
 	let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
@@ -491,6 +492,25 @@ function checkProjections(value, path, push, cellId) {
 	});
 	checkProjections(value.map, `${path}.map`, push, cellId);
 }
+function checkHostReads(props, path, push, cellId) {
+	if (!props || typeof props !== "object" || Array.isArray(props)) return;
+	for (const [key, value] of Object.entries(props)) if (isHostRead(value)) {
+		const problem = hostReadProblem(value);
+		if (problem) push({
+			severity: "error",
+			code: "HOST_READ_INVALID",
+			cellId,
+			path: `${path}.${key}`,
+			message: problem
+		});
+	} else if (value && typeof value === "object" && JSON.stringify(value).includes(`"@host"`)) push({
+		severity: "error",
+		code: "HOST_READ_INVALID",
+		cellId,
+		path: `${path}.${key}`,
+		message: "a host read is a prop of its own: it is not read inside another value"
+	});
+}
 function checkActions(cell, path, push) {
 	if (cell.actions === void 0) return;
 	if (!cell.actions || typeof cell.actions !== "object" || Array.isArray(cell.actions)) {
@@ -617,9 +637,10 @@ function validateCell(cell, catalog, path = "cell", ids, options = {}) {
 		message: "an inline cell needs a component"
 	});
 	if (cell.component && catalog && !cell.component.startsWith("@core/")) {
-		const entry = catalog.components[cell.component];
+		const components = componentsFor(catalog, cell);
+		const entry = components[cell.component];
 		if (!entry) {
-			const suggestions = nearestNames(cell.component, Object.keys(catalog.components));
+			const suggestions = nearestNames(cell.component, Object.keys(components));
 			push({
 				severity: nodeManaged ? "warning" : "error",
 				code: "CELL_UNKNOWN_COMPONENT",
@@ -694,6 +715,7 @@ function validateCell(cell, catalog, path = "cell", ids, options = {}) {
 	});
 	checkBindings(cell.data?.queries, `${path}.data.queries`, push, cellId, options.template);
 	checkActions(cell, path, push);
+	checkHostReads(cell.props, `${path}.props`, push, cellId);
 	checkProjections(cell.props, `${path}.props`, push, cellId);
 	checkProjections(cell.conditions, `${path}.conditions`, push, cellId);
 	checkTraversal(cell.traversal, `${path}.traversal`, push, cellId);
@@ -793,7 +815,7 @@ function slotIssues(cells, catalog) {
 	cells.forEach((parent) => {
 		if (!parent?.component) return;
 		const kids = parent.children ?? [];
-		const entry = catalog.components[parent.component];
+		const entry = componentsFor(catalog, parent)[parent.component];
 		if (!entry) return;
 		const slots = declaredSlots(entry.props_schema);
 		const filled = new Map();
@@ -844,4 +866,4 @@ function slotIssues(cells, catalog) {
 	});
 	return out;
 }
-export { stateValue as _, nearestNames as a, walkKey as b, selectionIssues as c, needsWalk as d, readField as f, stateNames as g, resolveWalkStart as h, eachFormProblems as i, RESERVED_LABELS as l, referencedLabels as m, STORE_SCOPES as n, validateCell as o, readWalk as p, WALK_DIRECTIONS as r, validatePage as s, RESPONSIVE_BUCKETS as t, mergeStates as u, systemsFromGraphs as v, walkRequest as x, systemsFromProcess as y };
+export { walkRequest as S, stateNames as _, eachFormProblems as a, systemsFromProcess as b, validatePage as c, mergeStates as d, needsWalk as f, resolveWalkStart as g, referencedLabels as h, componentsFor as i, selectionIssues as l, readWalk as m, STORE_SCOPES as n, nearestNames as o, readField as p, WALK_DIRECTIONS as r, validateCell as s, RESPONSIVE_BUCKETS as t, RESERVED_LABELS as u, stateValue as v, walkKey as x, systemsFromGraphs as y };

package/dist/core.js

@@ -1,10 +1,10 @@
 import { C as HYDRATED_CELL_FIELDS, D as normalizeCell, E as hasRef, O as resolveCell, S as CONTENT_FIELDS, T as STORE_FIELDS, a as projectSelections, b as isEmptyPropValue, c as pageScopeKey, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, k as rootCells, l as projectScopeKey, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, r as collectScopeIds, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as hiddenWhenEmpty, w as RENDER_FIELDS, x as projectCellData, y as hideWhenEmptyProblem } from "./chunks/projection-e8MHn6Bt.js";
-import { C as passesConditions, S as pageContext, T as settled, _ as EACH, a as VARIABLE_NAMESPACES, b as cellResolutionContext, c as pageVariables, d as resolveDescriptorVariables, f as selectionShape, g as variableReferences, h as variableLabels, i as UnsafeDocumentError, l as prepareDocument, m as validateDescriptor, n as RENDER_FUNCTIONS, o as descriptorShape, p as shapeAt, r as RENDER_FUNCTIONS_AHEAD, s as orderByVariable, t as PAGING_VARIABLES, u as queryKey, v as EACH_DEFAULT_AS, w as resolveReferences, x as isEach, y as cellContext } from "./chunks/query-D6xQbTFK.js";
-import { _ as stateValue, a as nearestNames, b as walkKey, c as selectionIssues, d as needsWalk, f as readField, g as stateNames, h as resolveWalkStart, i as eachFormProblems, l as RESERVED_LABELS, m as referencedLabels, n as STORE_SCOPES, o as validateCell, p as readWalk, r as WALK_DIRECTIONS, s as validatePage, t as RESPONSIVE_BUCKETS, u as mergeStates, v as systemsFromGraphs, x as walkRequest, y as systemsFromProcess } from "./chunks/validate-CrHGlwey.js";
-import { C as resolveAction, S as projectCellActions, _ as actionBindingKey, a as deriveSectionReferences, b as declaredActions, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, h as tableOfContents, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, n as SECTION_KINDS, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor, v as actionProblems, x as normalizeActionDeclaration, y as actionReferences } from "./chunks/structure-CKBtQHJq.js";
-import { a as loadBundlesSettled, i as loadBundles, n as isComponentExport, o as projectModule, r as loadBundle, s as runtimeReady, t as _clearBundleCache } from "./chunks/load-b38vUiZM.js";
+import { C as passesConditions, S as pageContext, T as settled, _ as EACH, a as VARIABLE_NAMESPACES, b as cellResolutionContext, c as pageVariables, d as resolveDescriptorVariables, f as selectionShape, g as variableReferences, h as variableLabels, i as UnsafeDocumentError, l as prepareDocument, m as validateDescriptor, n as RENDER_FUNCTIONS, o as descriptorShape, p as shapeAt, r as RENDER_FUNCTIONS_AHEAD, s as orderByVariable, t as PAGING_VARIABLES, u as queryKey, v as EACH_DEFAULT_AS, w as resolveReferences, x as isEach, y as cellContext } from "./chunks/query-DOXxGTO2.js";
+import { S as walkRequest, _ as stateNames, a as eachFormProblems, b as systemsFromProcess, c as validatePage, d as mergeStates, f as needsWalk, g as resolveWalkStart, h as referencedLabels, i as componentsFor, l as selectionIssues, m as readWalk, n as STORE_SCOPES, o as nearestNames, p as readField, r as WALK_DIRECTIONS, s as validateCell, t as RESPONSIVE_BUCKETS, u as RESERVED_LABELS, v as stateValue, x as walkKey, y as systemsFromGraphs } from "./chunks/validate-y5_6ws0s.js";
+import { C as actionReferences, D as resolveAction, E as projectCellActions, S as actionProblems, T as normalizeActionDeclaration, _ as HOST_READ_KEY, a as deriveSectionReferences, b as isHostRead, c as nodePrintStyle, d as referencesFor, f as sectionAnchor, g as usesStructureLayout, h as tableOfContents, i as deriveSectionNumbering, l as normalizeStructure, m as structureIssues, n as SECTION_KINDS, r as deriveElementReferences, s as mergeSectionReferences, t as PAGE_DOCUMENT, u as numberingFor, v as bindHostReads, w as declaredActions, x as actionBindingKey, y as hostReadProblem } from "./chunks/structure-B1PsD-AJ.js";
+import { a as loadBundlesSettled, i as loadBundles, n as isComponentExport, o as projectModule, r as loadBundle, s as runtimeReady, t as _clearBundleCache } from "./chunks/load-H7hUCwPc.js";
 import { a as normalizeRef, i as bundleScope, n as MAIN, o as refKey, r as PUBLIC, t as CORE_SPECIFIER } from "./chunks/refs-Csgh6rXq.js";
-import { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-CPj_vx-J.js";
+import { i as rowsInScope, n as pageBundles, r as rowForCell, t as pageBundleRefs } from "./chunks/page-bundles-_wsGO9WU.js";
 import { a as createStackStore, i as saveScope, n as clearScope, r as loadScope } from "./chunks/persistence-hurkUUQ0.js";
 import { ACTION_KINDS, QUERY_DESCRIPTOR_KEY, SECTION_KINDS as SECTION_KINDS$1, STATE_ROLES, STATE_TIERS, WALK_DEFAULTS, isDescriptorBinding, isLiveQueryState, isReadOnlyVersion } from "@peripheries/runtime";
 function resolveDeclarations(queries, systems, diagnostics = [], cellId) {
@@ -801,6 +801,14 @@ var DIAGNOSTICS = {
 		meaning: "A literal prop value fails its schema.",
 		fix: "Write the value in the shape `props_schema` gives, or bind it with a whole-string `@label.path` reference."
 	},
+	HOST_READ_INVALID: {
+		meaning: "A `{ \"@host\": … }` prop value is malformed.",
+		fix: "Write exactly `{ \"@host\": \"<name>\" }`, a name of lowercase letters, digits and underscores, as a top-level prop."
+	},
+	HOST_READ_UNKNOWN: {
+		meaning: "A `{ \"@host\": \"<name>\" }` prop names a read the host does not list, so the prop is dropped and the component runs without it.",
+		fix: "Use a name the host lists in `hostReads`, or remove the prop."
+	},
 	HIDE_WHEN_EMPTY_INVALID: {
 		meaning: "A cell’s `hide_when_empty` isn’t a list of prop names.",
 		fix: "Write `hide_when_empty: [\"title\", \"items\"]`: the props that, all empty once bound (null, blank text, `[]`, `{}`), leave the cell out."
@@ -1136,4 +1144,4 @@ function manifestPageFrom(graphNodeId, data) {
 		}
 	};
 }
-export { CONTENT_FIELDS, CORE_SPECIFIER, DIAGNOSTICS, EACH, EACH_DEFAULT_AS, HYDRATED_CELL_FIELDS, LAYER_ROLES, LAYOUT_TYPES, MAIN, PAGE_DOCUMENT, PAGE_RULES, PAGING_VARIABLES, PUBLIC, RENDER_FIELDS, RENDER_FUNCTIONS, RENDER_FUNCTIONS_AHEAD, RESERVED_LABELS, RESPONSIVE_BUCKETS, SECTION_KINDS, STORE_FIELDS, STORE_SCOPES, STRUCTURE_FIELDS, TOOL_OWNED_KEYS, UnsafeDocumentError, VARIABLE_NAMESPACES, WALK_DIRECTIONS, _clearBundleCache, actionBindingKey, actionProblems, actionReferences, assembleCellProps, attachSelectionSetters, attachViewStateSetters, buildDataContext, bundleScope, cellAttributes, cellContext, cellPlacementStyle, cellPropSources, cellResolutionContext, clearScope, collectDeclarations, collectDescriptors, collectScopeIds, collectStatic, createStackStore, declaredActions, deriveElementReferences, deriveSectionNumbering, deriveSectionReferences, descriptorShape, eachFormProblems, editTarget, hasRef, hiddenWhenEmpty, hideWhenEmptyProblem, isComponentExport, isEach, isEmptyPropValue, layerName, loadBundle, loadBundles, loadBundlesSettled, loadPageData, loadScope, manifestPageFrom, mergeSectionReferences, mergeStates, nearestNames, needsWalk, nodePrintStyle, normalizeActionDeclaration, normalizeCell, normalizeRef, normalizeStructure, numberingFor, orderByVariable, pageBundleRefs, pageBundles, pageContainerStyle, pageContext, pageRuntimeFromValues, pageScopeKey, pageVariables, passesConditions, patchAt, prepareDocument, projectCellActions, projectCellData, projectLive, projectModule, projectScopeKey, projectSelections, projectViewState, queryKey, readField, readWalk, refKey, referencedLabels, referencesFor, resolveAction, resolveCell, resolveComponent, resolveDataSystem, resolveDeclarations, resolveDescriptorVariables, resolveReferences, resolveScopeId, resolveSystems, resolveWalkStart, rootCells, runtimeReady, saveScope, sectionAnchor, selectionIssues, selectionShape, settled, shallowEqualBundle, shapeAt, stateNames, stateValue, structureIssues, systemsFromGraphs, systemsFromProcess, tableOfContents, usesStructureLayout, validateCell, validateDescriptor, validateManifest, validatePage, variableLabels, variableReferences, walkKey, walkRequest };
+export { CONTENT_FIELDS, CORE_SPECIFIER, DIAGNOSTICS, EACH, EACH_DEFAULT_AS, HOST_READ_KEY, HYDRATED_CELL_FIELDS, LAYER_ROLES, LAYOUT_TYPES, MAIN, PAGE_DOCUMENT, PAGE_RULES, PAGING_VARIABLES, PUBLIC, RENDER_FIELDS, RENDER_FUNCTIONS, RENDER_FUNCTIONS_AHEAD, RESERVED_LABELS, RESPONSIVE_BUCKETS, SECTION_KINDS, STORE_FIELDS, STORE_SCOPES, STRUCTURE_FIELDS, TOOL_OWNED_KEYS, UnsafeDocumentError, VARIABLE_NAMESPACES, WALK_DIRECTIONS, _clearBundleCache, actionBindingKey, actionProblems, actionReferences, assembleCellProps, attachSelectionSetters, attachViewStateSetters, bindHostReads, buildDataContext, bundleScope, cellAttributes, cellContext, cellPlacementStyle, cellPropSources, cellResolutionContext, clearScope, collectDeclarations, collectDescriptors, collectScopeIds, collectStatic, componentsFor, createStackStore, declaredActions, deriveElementReferences, deriveSectionNumbering, deriveSectionReferences, descriptorShape, eachFormProblems, editTarget, hasRef, hiddenWhenEmpty, hideWhenEmptyProblem, hostReadProblem, isComponentExport, isEach, isEmptyPropValue, isHostRead, layerName, loadBundle, loadBundles, loadBundlesSettled, loadPageData, loadScope, manifestPageFrom, mergeSectionReferences, mergeStates, nearestNames, needsWalk, nodePrintStyle, normalizeActionDeclaration, normalizeCell, normalizeRef, normalizeStructure, numberingFor, orderByVariable, pageBundleRefs, pageBundles, pageContainerStyle, pageContext, pageRuntimeFromValues, pageScopeKey, pageVariables, passesConditions, patchAt, prepareDocument, projectCellActions, projectCellData, projectLive, projectModule, projectScopeKey, projectSelections, projectViewState, queryKey, readField, readWalk, refKey, referencedLabels, referencesFor, resolveAction, resolveCell, resolveComponent, resolveDataSystem, resolveDeclarations, resolveDescriptorVariables, resolveReferences, resolveScopeId, resolveSystems, resolveWalkStart, rootCells, rowForCell, rowsInScope, runtimeReady, saveScope, sectionAnchor, selectionIssues, selectionShape, settled, shallowEqualBundle, shapeAt, stateNames, stateValue, structureIssues, systemsFromGraphs, systemsFromProcess, tableOfContents, usesStructureLayout, validateCell, validateDescriptor, validateManifest, validatePage, variableLabels, variableReferences, walkKey, walkRequest };

package/dist/react.js

@@ -1,6 +1,6 @@
 import { _ as failedLabels, a as projectSelections, d as resolveComponent, f as cellAttributes, g as assembleCellProps, h as pageContainerStyle, i as projectLive, k as rootCells, m as documentProfile, n as attachViewStateSetters, o as projectViewState, p as cellPlacementStyle, s as shallowEqualBundle, t as attachSelectionSetters, u as resolveScopeId, v as hiddenWhenEmpty, x as projectCellData, y as hideWhenEmptyProblem } from "./chunks/projection-e8MHn6Bt.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 { 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-DOXxGTO2.js";
+import { a as deriveSectionReferences, 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, v as bindHostReads, w as declaredActions } from "./chunks/structure-B1PsD-AJ.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";
@@ -236,7 +236,7 @@ function mergeActions(a, b) {
 	} : void 0;
 }
 function boundProps(cell, ctx, env, injectedProps) {
-	const out = { ...resolveReferences(cell.props ?? {}, ctx) };
+	const out = { ...bindHostReads(resolveReferences(cell.props ?? {}, ctx), env.hostReads) };
 	for (const id of cell.children ?? []) {
 		const child = env.cellsById.get(id);
 		if (!child) continue;
@@ -252,6 +252,14 @@ function boundProps(cell, ctx, env, injectedProps) {
 		...env.cellProps?.(cell)
 	};
 }
+var reportedMissing = new Set();
+function reportMissing(component) {
+	if (!reportedMissing.has(component)) {
+		reportedMissing.add(component);
+		console.warn(`[render] no bundle holds the component "${component}"`);
+	}
+	return null;
+}
 function CellView({ cell, env, nested = false, injectedProps }) {
 	const frame = useRef(null);
 	const store = useCellStore(cell, env.scope, env.store);
@@ -370,7 +378,7 @@ function CellView({ cell, env, nested = false, injectedProps }) {
 	else if (!resolved) body = jsxs(CellNotice, {
 		state: "not-found",
 		component: cell.component,
-		children: [cell.component, " isn't available here."]
+		children: [reportMissing(cell.component), "This section isn't available right now."]
 	});
 	else {
 		const slotted = {};
@@ -426,7 +434,13 @@ function CellView({ cell, env, nested = false, injectedProps }) {
 				source
 			}) } : {}
 		};
-		const resolvedProps = resolveReferences(cell.props ?? {}, propsCtx);
+		const resolvedProps = bindHostReads(resolveReferences(cell.props ?? {}, propsCtx), env.hostReads, (prop, why) => env.onDiagnostic?.({
+			severity: "warning",
+			code: "HOST_READ_UNKNOWN",
+			cellId: cell.id,
+			path: `props.${prop}`,
+			message: `${cell.component ?? cell.id}.${prop}: ${why}`
+		}));
 		if (found) env.onPropSources({
 			id: cell.id,
 			source: cell.source
@@ -572,7 +586,7 @@ var warn = (d) => console.warn(`[render] ${d.code}${d.cellId ? ` (cell ${d.cellI
 function PageRenderer({ runtime, bundles, params, baseProps, context, viewer, environment }) {
 	const { page, cells } = runtime;
 	const declared = useMemo(() => new Set(runtime.declared), [runtime.declared]);
-	const { core, navigate, store, onDiagnostic = warn, actionsFor, runAction, loadPage, onCellError, onUnresolvedReference, onPropSources, frameProps, cellProps, retry, showHiddenCells, showProblemCodes } = environment;
+	const { core, navigate, store, onDiagnostic = warn, actionsFor, runAction, loadPage, onCellError, onUnresolvedReference, onPropSources, frameProps, cellProps, hostReads, retry, showHiddenCells, showProblemCodes } = environment;
 	useEffect(() => {
 		for (const d of runtime.diagnostics) onDiagnostic(d);
 	}, [runtime.diagnostics, onDiagnostic]);
@@ -600,6 +614,7 @@ function PageRenderer({ runtime, bundles, params, baseProps, context, viewer, en
 			onDiagnostic,
 			frameProps,
 			cellProps,
+			hostReads,
 			showHiddenCells,
 			showProblemCodes,
 			renderEmbed: (cellId) => {
@@ -652,6 +667,7 @@ function PageRenderer({ runtime, bundles, params, baseProps, context, viewer, en
 		onDiagnostic,
 		frameProps,
 		cellProps,
+		hostReads,
 		retry,
 		showHiddenCells,
 		showProblemCodes,

package/dist/runtime.js

@@ -1,4 +1,4 @@
-import { s as runtimeReady } from "./chunks/load-b38vUiZM.js";
+import { s as runtimeReady } from "./chunks/load-H7hUCwPc.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";
@@ -16,6 +16,7 @@ function importMapJson(shared = []) {
 	return JSON.stringify(importMapFor(shared)).replace(/</g, "\\u003c");
 }
 var IMPORT_MAP_JSON = importMapJson();
+var LOAD_GLOBAL = "__STACK_RUNTIME_LOAD__";
 var singleton = null;
 function getStackStore() {
 	return singleton ??= createStackStore();
@@ -52,11 +53,28 @@ function buildRuntime(extra = {}) {
 		...extra
 	};
 }
-function installRuntime(g = globalThis, extra = {}) {
+function installRuntime(g = globalThis, extra = {}, lazy = {}) {
 	const runtime = g[RUNTIME_GLOBAL] ?? buildRuntime(extra);
 	g[RUNTIME_GLOBAL] = runtime;
+	if (typeof g["__STACK_RUNTIME_LOAD__"] !== "function") {
+		const loading = new Map();
+		g[LOAD_GLOBAL] = (specifier) => {
+			const load = lazy[specifier];
+			if (!load || specifier in runtime) return void 0;
+			let pending = loading.get(specifier);
+			if (!pending) {
+				pending = load().then((mod) => void (runtime[specifier] = mod), (error) => {
+					loading.delete(specifier);
+					throw error;
+				});
+				loading.set(specifier, pending);
+			}
+			return pending;
+		};
+	}
 	if (typeof g.require !== "function") g.require = (specifier) => {
 		if (specifier in runtime) return runtime[specifier];
+		if (specifier in lazy) throw new Error(`[runtime] "${specifier}" is lent lazily by the host and is not loaded yet: import it as an ES module, not with require().`);
 		throw new Error(`[runtime] No host module for require("${specifier}"). Add it to PINNED_RUNTIMES or bundle it.`);
 	};
 	if (!g[READY_GLOBAL]) g[READY_GLOBAL] = Promise.resolve();
@@ -75,6 +93,7 @@ function renderShim(specifier, names, hasDefault) {
 		"// Generated by scripts/build-shims.ts. Do not edit.",
 		`// Forwards ${key} to globalThis.${RUNTIME_GLOBAL}[${key}].`,
 		`await globalThis.${READY_GLOBAL};`,
+		`await globalThis.${LOAD_GLOBAL}?.(${key});`,
 		`const R = globalThis.${RUNTIME_GLOBAL}?.[${key}];`,
 		`if (!R) throw new Error('[runtime] ${RUNTIME_GLOBAL}[${key}] is not installed; the host has not booted.');`
 	];

package/dist/testing.js

@@ -1,7 +1,7 @@
-import { l as prepareDocument } from "./chunks/query-D6xQbTFK.js";
-import { o as projectModule } from "./chunks/load-b38vUiZM.js";
+import { l as prepareDocument } from "./chunks/query-DOXxGTO2.js";
+import { o as projectModule } from "./chunks/load-H7hUCwPc.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 { n as pageBundles, t as pageBundleRefs } from "./chunks/page-bundles-_wsGO9WU.js";
 import { r as fromPageSteps } from "./chunks/forms-DxA9WzCt.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 var __defProp = Object.defineProperty;

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

@@ -13,6 +13,7 @@ export type BundleRow = {
         exposed_export: string | null;
     }>;
     specifier?: string | null;
+    requires?: readonly string[] | null;
 };
 export type LoadedBundle = {
     id: string;
@@ -36,6 +37,7 @@ export type LoadedBundles = {
     loaded: LoadedBundle[];
     failed: string[];
 };
+export declare function loadWaves(rows: BundleRow[], files: BundleFiles): Promise<BundleRow[][]>;
 export declare function loadBundlesSettled(rows: BundleRow[], files: BundleFiles): Promise<LoadedBundles>;
 export declare function loadBundles(rows: BundleRow[], files: BundleFiles): Promise<LoadedBundle[]>;
 export declare function _clearBundleCache(): void;

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

@@ -2,6 +2,8 @@ import type { PageCell } from '../types.js';
 import type { BundleRow, LoadedBundle } from './load.js';
 import { type LineageRef } from './refs.js';
 export declare function pageBundleRefs(scope: LineageRef[], cells: PageCell[], pageOrgId: string | null): LineageRef[];
+export declare function rowsInScope<R extends Pick<BundleRow, 'id' | 'bundle_name' | 'org_slug' | 'org_id'>>(rows: readonly R[], scope: LineageRef[]): R[];
+export declare function rowForCell<R extends Pick<BundleRow, 'id' | 'bundle_name' | 'org_slug' | 'org_id'>>(rows: readonly R[], cell: PageCell, pageOrgId: string | null): R | null;
 export type PageBundles = {
     scope: LoadedBundle[] | null;
     forCell: (cell: PageCell) => LoadedBundle | null;

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

@@ -51,6 +51,14 @@ export declare const DIAGNOSTICS: {
         readonly meaning: "A literal prop value fails its schema.";
         readonly fix: "Write the value in the shape `props_schema` gives, or bind it with a whole-string `@label.path` reference.";
     };
+    readonly HOST_READ_INVALID: {
+        readonly meaning: "A `{ \"@host\": … }` prop value is malformed.";
+        readonly fix: "Write exactly `{ \"@host\": \"<name>\" }`, a name of lowercase letters, digits and underscores, as a top-level prop.";
+    };
+    readonly HOST_READ_UNKNOWN: {
+        readonly meaning: "A `{ \"@host\": \"<name>\" }` prop names a read the host does not list, so the prop is dropped and the component runs without it.";
+        readonly fix: "Use a name the host lists in `hostReads`, or remove the prop.";
+    };
     readonly HIDE_WHEN_EMPTY_INVALID: {
         readonly meaning: "A cell’s `hide_when_empty` isn’t a list of prop names.";
         readonly fix: "Write `hide_when_empty: [\"title\", \"items\"]`: the props that, all empty once bound (null, blank text, `[]`, `{}`), leave the cell out.";

package/dist/types/core/host-reads.d.ts

@@ -0,0 +1,6 @@
+export declare const HOST_READ_KEY = "@host";
+export type HostRead = (...args: never[]) => unknown;
+export type HostReads = Readonly<Record<string, HostRead>>;
+export declare const isHostRead: (value: unknown) => value is Record<string, unknown>;
+export declare function hostReadProblem(value: Record<string, unknown>): string | null;
+export declare function bindHostReads(props: Record<string, unknown>, reads: HostReads | undefined, onUnknown?: (prop: string, why: string) => void): Record<string, unknown>;

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

@@ -6,8 +6,9 @@ export { loadPageData, resolveDataSystem, resolveSystems, type CellData, type Ce
 export { descriptorShape, orderByVariable, PAGING_VARIABLES, pageVariables, prepareDocument, queryKey, RENDER_FUNCTIONS, RENDER_FUNCTIONS_AHEAD, resolveDescriptorVariables, selectionShape, shapeAt, UnsafeDocumentError, validateDescriptor, VARIABLE_NAMESPACES, variableLabels, variableReferences, type PreparedDocument, type ResolvedVariables, type SelectionShape, } from './query.js';
 export { selectionIssues } from './selected.js';
 export { cellPropSources, editTarget, patchAt, STRUCTURE_FIELDS, TOOL_OWNED_KEYS, type EditCell, type EditRefusal, type EditTarget, type OnSource, type PropSource, type PropSourceEntry } from './sources.js';
+export { bindHostReads, HOST_READ_KEY, hostReadProblem, isHostRead, type HostRead, type HostReads } from './host-reads.js';
 export { cellContext, cellResolutionContext, EACH, pageContext, EACH_DEFAULT_AS, isEach, passesConditions, resolveReferences, settled, type CellScope, type Each, type ResolutionContext } from './references.js';
-export { eachFormProblems, nearestNames, RESPONSIVE_BUCKETS, STORE_SCOPES, validateCell, validatePage, WALK_DIRECTIONS, type Catalog, type ValidateOptions } from './validate.js';
+export { componentsFor, eachFormProblems, nearestNames, RESPONSIVE_BUCKETS, STORE_SCOPES, validateCell, validatePage, WALK_DIRECTIONS, type Catalog, type ValidateOptions } from './validate.js';
 export { DIAGNOSTICS, type DiagnosticCode, type DiagnosticEntry } from './diagnostics.js';
 export { LAYOUT_TYPES, PAGE_RULES } from './rules.js';
 export { pageRuntimeFromValues } from './values.js';
@@ -18,7 +19,7 @@ export { assembleCellProps, hiddenWhenEmpty, hideWhenEmptyProblem, isEmptyPropVa
 export { cellAttributes, cellPlacementStyle, pageContainerStyle } from './layout.js';
 export { deriveElementReferences, deriveSectionNumbering, deriveSectionReferences, mergeSectionReferences, nodePrintStyle, normalizeStructure, numberingFor, PAGE_DOCUMENT, referencesFor, SECTION_KINDS, sectionAnchor, structureIssues, tableOfContents, usesStructureLayout, type ContentsEntry, type LayoutNode, type SectionNumbering, type SectionReference, type SectionReferences, } from './structure.js';
 export { _clearBundleCache, isComponentExport, loadBundle, loadBundles, loadBundlesSettled, projectModule, runtimeReady, type BundleFiles, type BundleRow, type LoadedBundle, type LoadedBundles, } from './bundles/load.js';
-export { pageBundleRefs, pageBundles, type PageBundles } from './bundles/page-bundles.js';
+export { pageBundleRefs, pageBundles, rowForCell, rowsInScope, type PageBundles } from './bundles/page-bundles.js';
 export { bundleScope, CORE_SPECIFIER, MAIN, normalizeRef, PUBLIC, refKey, type BundleRef, type BundleScopeInput, type LineageRef, type SharedLineage } from './bundles/refs.js';
 export { resolveComponent, type CoreRegistry, type ResolvedComponent } from './bundles/resolve.js';
 export { createStackStore, type StackStoreApi } from './store/create-store.js';

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

@@ -1,15 +1,18 @@
 import { type Diagnostic } from './graph.js';
 import { type Each } from './references.js';
 import type { PageCell, ProjectPage } from './types.js';
+type CatalogEntries = Record<string, {
+    props_schema?: {
+        required?: readonly string[];
+        properties?: Record<string, unknown>;
+        additionalProperties?: unknown;
+    } | null;
+} | undefined>;
 export type Catalog = {
-    components: Record<string, {
-        props_schema?: {
-            required?: readonly string[];
-            properties?: Record<string, unknown>;
-            additionalProperties?: unknown;
-        } | null;
-    } | undefined>;
+    components: CatalogEntries;
+    forCell?: (cell: PageCell) => CatalogEntries | undefined;
 };
+export declare const componentsFor: (catalog: Catalog, cell: PageCell) => CatalogEntries;
 export declare function nearestNames(name: string, names: Iterable<string>, limit?: number): string[];
 export declare const RESPONSIVE_BUCKETS: readonly ["narrow", "compact", "wide"];
 export declare const STORE_SCOPES: readonly ["page", "project"];
@@ -30,3 +33,4 @@ export type SlotDeclaration = {
 export declare function declaredSlots(schema: {
     properties?: Record<string, unknown>;
 } | null | undefined): Map<string, SlotDeclaration>;
+export {};

package/dist/types/react/cell-view.d.ts

@@ -4,6 +4,7 @@ import type { LoadedBundle } from '../core/bundles/load.js';
 import type { Diagnostic } from '../core/graph.js';
 import { type CoreRegistry } from '../core/bundles/resolve.js';
 import { type RunAction } from '../core/actions.js';
+import { type HostReads } from '../core/host-reads.js';
 import type { CellData } from '../core/load-page.js';
 import { type ResolutionContext } from '../core/references.js';
 import type { StackStoreApi } from '../core/store/create-store.js';
@@ -35,6 +36,7 @@ export type CellEnvironment = {
     onUnresolvedReference?: (cellId: string, ref: string) => void;
     onPropSources?: (cell: EditCell, sources: PropSourceEntry[]) => void;
     renderEmbed?: (cellId: string) => ReactNode;
+    hostReads?: HostReads;
     onDiagnostic?: (d: Diagnostic) => void;
     frameProps?: (cell: PageCell, contract: ComponentContract | undefined) => FrameProps | undefined;
     cellProps?: (cell: PageCell) => Record<string, unknown> | undefined;

package/dist/types/react/page-renderer.d.ts

@@ -2,6 +2,7 @@ import type { CellAction, ComponentContract } from '@peripheries/runtime';
 import type { RunAction } from '../core/actions.js';
 import type { PageBundles } from '../core/bundles/page-bundles.js';
 import type { CoreRegistry } from '../core/bundles/resolve.js';
+import type { HostReads } from '../core/host-reads.js';
 import type { Diagnostic } from '../core/graph.js';
 import type { PageRuntime } from '../core/load-page.js';
 import type { EditCell, PropSourceEntry } from '../core/sources.js';
@@ -17,6 +18,7 @@ export type RendererEnvironment = {
     actionsFor?: (cell: PageCell) => Record<string, CellAction> | undefined;
     runAction?: RunAction;
     loadPage?: LoadPage;
+    hostReads?: HostReads;
     onCellError?: (cellId: string, error: Error) => void;
     onUnresolvedReference?: (cellId: string, ref: string) => void;
     onPropSources?: (cell: EditCell, sources: PropSourceEntry[]) => void;

package/dist/types/runtime/install.d.ts

@@ -1,11 +1,13 @@
 import { READY_GLOBAL, RESOLVE_GLOBAL, RUNTIME_GLOBAL, type RuntimeSpecifier } from '@peripheries/runtime';
+import { LOAD_GLOBAL } from './load-global.js';
 export type StackRuntime = Record<Exclude<RuntimeSpecifier, '@peripheries/ui'>, unknown> & Record<string, unknown>;
 type RuntimeGlobals = {
     [RUNTIME_GLOBAL]?: StackRuntime;
     [READY_GLOBAL]?: Promise<void>;
     [RESOLVE_GLOBAL]?: () => void;
+    [LOAD_GLOBAL]?: (specifier: string) => Promise<void> | undefined;
     require?: (specifier: string) => unknown;
 };
 export declare function buildRuntime(extra?: Record<string, unknown>): StackRuntime;
-export declare function installRuntime(g?: RuntimeGlobals, extra?: Record<string, unknown>): StackRuntime;
+export declare function installRuntime(g?: RuntimeGlobals, extra?: Record<string, unknown>, lazy?: Record<string, () => Promise<unknown>>): StackRuntime;
 export { runtimeReady } from '../core/bundles/load.js';

package/dist/types/runtime/load-global.d.ts

@@ -0,0 +1 @@
+export declare const LOAD_GLOBAL = "__STACK_RUNTIME_LOAD__";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peripheries/renderer",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "The one renderer for pages of federated component bundles: a framework-free core, a React renderer, the runtime a page boots with, and golden pages for testing.",
   "type": "module",
   "sideEffects": [
@@ -47,7 +47,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@peripheries/runtime": "0.23.1",
+    "@peripheries/runtime": "0.25.0",
     "ajv": "8.20.0",
     "graphql": "17.0.2"
   },