@peripheries/renderer 0.22.0 → 0.23.1

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

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

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

@@ -1,6 +1,5 @@
 import { DESCRIPTOR_VERSION, GRAPHQL_MAX_ROWS } from "@peripheries/runtime";
 import { Kind, parse, print, visit } from "graphql";
-//#region packages/renderer/src/core/references.ts
 var STRICT_REF$1 = /^@[A-Za-z0-9_$-]+(\.[A-Za-z0-9_$[\]-]+)*$/;
 var INTERPOLATION = /\$\{(?:context\.)?([^}]+)\}/g;
 var UnresolvedReference = class extends Error {
@@ -215,15 +214,16 @@ function passesConditions(conditions, ctx) {
 	if (hideIf !== void 0 && hideIf !== "" && resolveReferences(hideIf, ctx)) return false;
 	return true;
 }
-//#endregion
-//#region packages/renderer/src/core/query.ts
 var RENDER_FUNCTIONS = {
 	walk_graph: [
 		"edge",
 		"graph_edge",
 		"graph_node",
 		"node",
-		"system_node_state"
+		"system_node_state",
+		"system_version",
+		"system_node_version",
+		"system_edge_version"
 	],
 	resolve_placements: [
 		"edge",
@@ -234,7 +234,9 @@ var RENDER_FUNCTIONS = {
 		"object_source",
 		"process",
 		"system",
-		"system_node_state"
+		"system_node_state",
+		"system_version",
+		"system_node_version"
 	],
 	event_occurrences: ["event", "event_type"],
 	creatable_event_types: ["event_type"],
@@ -264,11 +266,93 @@ var RENDER_FUNCTIONS = {
 		"feed_producer",
 		"feed_subscription"
 	],
-	host_chat_threads: ["session"]
+	host_chat_threads: ["session"],
+	node_states_as_of: [
+		"system_node_state",
+		"system_version",
+		"system_node_version",
+		"system",
+		"system_layer"
+	],
+	node_state_view: [
+		"graph_node",
+		"system",
+		"system_node_state",
+		"system_version",
+		"system_node_version",
+		"system_layer"
+	],
+	version_context_for: [
+		"system_version",
+		"graph_node",
+		"edge",
+		"graph_edge"
+	],
+	version_scope_members: [
+		"graph_node",
+		"graph_edge",
+		"edge"
+	],
+	auto_release_status: [
+		"graph_node",
+		"node",
+		"edge",
+		"graph"
+	],
+	versions_for: ["system_version"],
+	version_diff: [
+		"system_version",
+		"system_node_version",
+		"system_edge_version",
+		"graph_node",
+		"node",
+		"edge",
+		"graph_edge",
+		"system",
+		"system_node_state",
+		"system_edge_state"
+	],
+	form_answers: [
+		"system_node_state",
+		"graph_node",
+		"edge"
+	]
 };
+var RENDER_FUNCTIONS_AHEAD = { form_answers: "SCH M3b" };
 var UnsafeDocumentError = class extends Error {
 	name = "UnsafeDocumentError";
+	code;
+	constructor(message, options) {
+		super(message);
+		if (options) this.code = options.code;
+	}
 };
+var MAIN_ONLY_COLLECTIONS = new Set([
+	"systemCollection",
+	"graph_nodeCollection",
+	"graph_edgeCollection"
+]);
+var SYSTEM_SCOPED_COLLECTIONS = new Set([
+	"system_node_stateCollection",
+	"system_edge_stateCollection",
+	"node_state_latestCollection",
+	"cell_config_latestCollection",
+	"system_runCollection",
+	"system_stateCollection"
+]);
+var SCOPING_PARENTS = new Set([
+	"systemCollection",
+	"system_runCollection",
+	"system_stateCollection"
+]);
+var SCOPING_COLUMNS = new Set([
+	"id",
+	"system_id",
+	"system_run_id",
+	"source_system_id",
+	"target_system_id"
+]);
+var CONNECTION_FIELDS = new Set(["edges", "node"]);
 var ENTITY_ROOT = /^(.+?)(Collection|ByPk)$/;
 var prepared = new Map();
 function prepareDocument(source) {
@@ -280,7 +364,7 @@ function prepareDocument(source) {
 		if (selection.kind !== Kind.FIELD) throw new UnsafeDocumentError("Fragments are not allowed at the root of a render-time query");
 		for (const e of rootEntities(selection)) entities.add(e);
 	}
-	const text = print(withTypename(doc));
+	const text = print(withTypename(mainOnly(doc)));
 	const out = {
 		text,
 		operationName: op.name?.value,
@@ -315,6 +399,73 @@ function rootEntities(field) {
 	if (!match) throw new UnsafeDocumentError(`Root field "${name}" is not a table or view collection, or a render function. Other function fields (RPCs, rls_* helpers) and introspection are not allowed at render time.`);
 	return [match[1]];
 }
+var IS_NULL = {
+	kind: Kind.OBJECT_FIELD,
+	name: {
+		kind: Kind.NAME,
+		value: "version"
+	},
+	value: {
+		kind: Kind.OBJECT,
+		fields: [{
+			kind: Kind.OBJECT_FIELD,
+			name: {
+				kind: Kind.NAME,
+				value: "is"
+			},
+			value: {
+				kind: Kind.ENUM,
+				value: "NULL"
+			}
+		}]
+	}
+};
+function namesVersion(value) {
+	if (value.kind === Kind.LIST) return value.values.some(namesVersion);
+	if (value.kind !== Kind.OBJECT) return false;
+	return value.fields.some((f) => f.name.value === "version" || namesVersion(f.value));
+}
+function scopedByFilter(node) {
+	const filter = node.arguments?.find((a) => a.name.value === "filter")?.value;
+	if (filter?.kind !== Kind.OBJECT) return false;
+	return filter.fields.some((f) => SCOPING_COLUMNS.has(f.name.value) && f.value.kind === Kind.OBJECT && f.value.fields.some((op) => op.name.value === "eq" || op.name.value === "in"));
+}
+function parentField(ancestors) {
+	for (let i = ancestors.length - 1; i >= 0; i--) {
+		const a = ancestors[i];
+		if (a?.kind === Kind.FRAGMENT_DEFINITION || a?.kind === Kind.OPERATION_DEFINITION) return void 0;
+		if (a?.kind === Kind.FIELD && a.name && !CONNECTION_FIELDS.has(a.name.value)) return a.name.value;
+	}
+}
+function mainOnly(doc) {
+	return visit(doc, { Field(node, _key, _parent, _path, ancestors) {
+		if (SYSTEM_SCOPED_COLLECTIONS.has(node.name.value)) {
+			const parent = parentField(ancestors);
+			if (!(parent && SCOPING_PARENTS.has(parent)) && !scopedByFilter(node)) throw new UnsafeDocumentError(`${node.name.value} would read every system's rows, a branch's included: read it under a systemCollection, or filter its id, system_id or run by eq or in`, { code: "DESCRIPTOR_STATE_UNSCOPED" });
+			return;
+		}
+		if (!MAIN_ONLY_COLLECTIONS.has(node.name.value)) return void 0;
+		const filter = node.arguments?.find((a) => a.name.value === "filter");
+		if (filter && filter.value.kind !== Kind.OBJECT) throw new UnsafeDocumentError(`${node.name.value} reads main rows only, so its filter is written in the document, not passed as a variable`, { code: "DESCRIPTOR_VERSION_FILTER" });
+		if (filter && namesVersion(filter.value)) throw new UnsafeDocumentError(`${node.name.value} reads main rows only; a branch is read through a version context, not a version filter`, { code: "DESCRIPTOR_VERSION_FILTER" });
+		const value = {
+			kind: Kind.OBJECT,
+			fields: [...filter?.value.kind === Kind.OBJECT ? filter.value.fields : [], IS_NULL]
+		};
+		const others = (node.arguments ?? []).filter((a) => a !== filter);
+		return {
+			...node,
+			arguments: [...others, {
+				kind: Kind.ARGUMENT,
+				name: {
+					kind: Kind.NAME,
+					value: "filter"
+				},
+				value
+			}]
+		};
+	} });
+}
 function withTypename(doc) {
 	return visit(doc, { SelectionSet: { leave(node, _key, parent) {
 		if (parent && "kind" in parent && parent.kind === Kind.OPERATION_DEFINITION) return node;
@@ -607,12 +758,18 @@ function validateDescriptor(descriptor, path = "descriptor") {
 	} catch (e) {
 		push({
 			severity: "error",
-			code: "DESCRIPTOR_DOCUMENT_INVALID",
+			code: e instanceof UnsafeDocumentError && e.code || "DESCRIPTOR_DOCUMENT_INVALID",
 			path: `${path}.document`,
 			message: e.message
 		});
 		return out;
 	}
+	for (const sel of op.selectionSet.selections) if (sel.kind === Kind.FIELD && sel.alias && !sel.selectionSet && Object.hasOwn(RENDER_FUNCTIONS, sel.name.value)) push({
+		severity: "error",
+		code: "DESCRIPTOR_ALIAS_JSON_ROOT",
+		path: `${path}.document`,
+		message: `${sel.name.value} returns JSON; name it without the alias "${sel.alias.value}"`
+	});
 	const declared = new Map(op.variableDefinitions?.map((v) => [v.variable.name.value, v]) ?? []);
 	for (const [name, def] of declared) {
 		const required = def.type.kind === Kind.NON_NULL_TYPE && !def.defaultValue;
@@ -788,7 +945,4 @@ var queryKey = (descriptor, variables) => JSON.stringify([
 	descriptor.result?.path ?? null,
 	descriptor.result?.flatten_connections !== false
 ]);
-//#endregion
-export { resolveReferences as C, passesConditions as S, EACH_DEFAULT_AS as _, descriptorShape as a, isEach as b, prepareDocument as c, selectionShape as d, shapeAt as f, EACH as g, variableReferences as h, VARIABLE_NAMESPACES as i, queryKey as l, variableLabels as m, RENDER_FUNCTIONS as n, orderByVariable as o, validateDescriptor as p, UnsafeDocumentError as r, pageVariables as s, PAGING_VARIABLES as t, resolveDescriptorVariables as u, cellContext as v, settled as w, pageContext as x, cellResolutionContext as y };
-
-//# sourceMappingURL=query-BPuCJC1C.js.map
+export { passesConditions as C, pageContext as S, settled as T, EACH as _, VARIABLE_NAMESPACES as a, cellResolutionContext as b, pageVariables as c, resolveDescriptorVariables as d, selectionShape as f, variableReferences as g, variableLabels as h, UnsafeDocumentError as i, prepareDocument as l, validateDescriptor as m, RENDER_FUNCTIONS as n, descriptorShape as o, shapeAt as p, RENDER_FUNCTIONS_AHEAD as r, orderByVariable as s, PAGING_VARIABLES as t, queryKey as u, EACH_DEFAULT_AS as v, resolveReferences as w, isEach as x, cellContext as y };

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

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

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

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

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

@@ -1,7 +1,21 @@
-import { _ as EACH_DEFAULT_AS, a as descriptorShape, b as isEach, f as shapeAt, g as EACH, m as variableLabels, p as validateDescriptor } from "./query-BPuCJC1C.js";
-import { g as usesStructureLayout, m as structureIssues, v as actionProblems } from "./structure-o9pYoDjD.js";
+import { _ as EACH, h as variableLabels, m as validateDescriptor, o as descriptorShape, p as shapeAt, v as EACH_DEFAULT_AS, x as isEach } from "./query-D6xQbTFK.js";
+import { g as usesStructureLayout, m as structureIssues, v as actionProblems } from "./structure-CKBtQHJq.js";
 import { DEFAULT_STATE, STATE_NAMES, WALK_DEFAULTS, isDescriptorBinding, isGraphAction, isStateName } from "@peripheries/runtime";
-//#region packages/renderer/src/core/graph.ts
+var TIER_OF_GRAPH_TYPE = {
+	"meta-process": "meta",
+	"process-eng": "eng",
+	"process-ops": "ops"
+};
+function systemsFromGraphs(rows) {
+	const out = {};
+	for (const r of rows ?? []) {
+		const tier = r.graph_type ? TIER_OF_GRAPH_TYPE[r.graph_type] : void 0;
+		if (!tier || !r.role) continue;
+		const name = `${tier}_${r.role}`;
+		if (isStateName(name) && !out[name]) out[name] = r.id;
+	}
+	return out;
+}
 function systemsFromProcess(row) {
 	const out = {};
 	for (const name of STATE_NAMES) {
@@ -117,7 +131,7 @@ function walkRequest(config, start, systems) {
 	for (const u of unknown) diagnostics.push({
 		severity: "error",
 		code: "STATE_UNKNOWN_NAME",
-		message: `include_state "${u}" isn't a system name (${STATE_NAMES.join(", ")})`
+		message: `include_state "${u}" isn't a system name: expected <tier>_<role> (tier meta, eng or ops; e.g. eng_data)`
 	});
 	const states = [];
 	for (const name of names) {
@@ -208,8 +222,6 @@ function readWalk(raw, request) {
 		diagnostics
 	};
 }
-//#endregion
-//#region packages/renderer/src/core/selected.ts
 var STRICT_REF$1 = /^@([A-Za-z0-9_$-]+)((?:\.[A-Za-z0-9_$[\]-]+)*)$/;
 var shapes = new Map();
 function shapeOf(d) {
@@ -258,8 +270,6 @@ function selectionIssues(cell, queries, at) {
 	visit(cell.conditions, `${at}.conditions`, top);
 	return out;
 }
-//#endregion
-//#region packages/renderer/src/core/validate.ts
 var words = (name) => name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase().split(/[\s_-]+/).filter(Boolean);
 function editDistance(a, b) {
 	let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
@@ -406,7 +416,7 @@ function checkBindings(queries, path, push, cellId, template = false) {
 			cellId,
 			label,
 			path: `${at}.state`,
-			message: `"${label}" names state "${String(s)}"; expected one of ${STATE_NAMES.join(", ")}`
+			message: `"${label}" names state "${String(s)}"; expected <tier>_<role> (tier meta, eng or ops; e.g. eng_data)`
 		});
 	}
 }
@@ -816,7 +826,4 @@ function slotIssues(cells, catalog) {
 	});
 	return out;
 }
-//#endregion
-export { stateValue as _, nearestNames as a, walkRequest 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, systemsFromProcess as v, walkKey as y };
-
-//# sourceMappingURL=validate-4LgH8QMJ.js.map
+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 };