@inf-monkeys-tech/monkeys 1.1.24 → 1.1.25

package/lib/runtime/page-composition.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilePageComposition = exports.PageCompositionSchema = exports.PageComponentDefinitionSchema = void 0;
+const zod_1 = require("zod");
+const declarative_control_1 = require("../contracts/declarative-control");
+const common_1 = require("../contracts/common");
+/** Source-level components expand at publication, so existing hosts keep the same Page contract. */
+const Name = zod_1.z.string().regex(/^[A-Za-z][A-Za-z0-9_.-]{0,127}$/);
+const Path = zod_1.z.array(zod_1.z.union([Name, zod_1.z.number().int().min(0).max(4095)])).min(1).max(32);
+exports.PageComponentDefinitionSchema = zod_1.z.object({
+    root: declarative_control_1.PageNodeSchema,
+    inputs: zod_1.z.record(Name, zod_1.z.object({ path: Path, default: common_1.JsonValueSchema.optional() }).strict()).optional(),
+    /** A slot names the local node whose children are supplied by the instance. */
+    slots: zod_1.z.record(Name, Name).optional(),
+}).strict();
+const SourceNode = zod_1.z.lazy(() => zod_1.z.union([
+    zod_1.z.object({ id: Name, use: Name, inputs: zod_1.z.record(Name, common_1.JsonValueSchema).optional(), slots: zod_1.z.record(Name, zod_1.z.array(SourceNode)).optional() }).strict(),
+    zod_1.z.object({ children: zod_1.z.array(SourceNode).optional() }).passthrough(),
+]));
+exports.PageCompositionSchema = zod_1.z.object({
+    contract: zod_1.z.literal('PageComposition'),
+    schemaVersion: zod_1.z.literal(1),
+    /** Page header and state declarations; body is supplied separately. */
+    page: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+    components: zod_1.z.record(Name, exports.PageComponentDefinitionSchema),
+    body: SourceNode,
+}).strict();
+const forbidden = new Set(['__proto__', 'prototype', 'constructor']);
+function assign(root, path, value) {
+    let target = root;
+    for (const [index, key] of path.entries()) {
+        if (forbidden.has(String(key)) || ['id', 'children', 'data', 'actions', 'programActions', 'on', 'effects'].includes(String(path[0])))
+            throw new TypeError('A component input must target presentation fields, not identities or executable declarations.');
+        if (index === path.length - 1) {
+            target[key] = structuredClone(value);
+            return;
+        }
+        if (target[key] === null || typeof target[key] !== 'object')
+            throw new TypeError('Component input path does not exist.');
+        target = target[key];
+    }
+}
+/** Reusable presentation trees with explicit inputs/slots; business state and operations stay in Page. */
+function compilePageComposition(input) {
+    const source = exports.PageCompositionSchema.parse(input);
+    let count = 0;
+    const ids = new Set();
+    const expand = (value, depth) => {
+        if (++count > 4096 || depth > 64)
+            throw new RangeError('Page composition exceeds its node budget.');
+        if ('use' in value) {
+            const definition = source.components[value.use];
+            if (!definition)
+                throw new TypeError(`Unknown Page component ${value.use}.`);
+            const root = structuredClone(definition.root);
+            const localNodes = new Map();
+            const namespace = (node, isRoot = false) => {
+                if (localNodes.has(node.id))
+                    throw new TypeError('Duplicate component-local node id.');
+                localNodes.set(node.id, node);
+                // Operations and scoped state belong to the instance's supplied slots, not a shared template.
+                if (node.data?.length || node.actions?.length || node.programActions?.length || node.on?.length || node.effects?.length)
+                    throw new TypeError('Component templates contain presentation only; supply business operations through slots.');
+                node.id = isRoot ? value.id : `${value.id}.${node.id}`;
+                node.children?.forEach(child => namespace(child));
+            };
+            namespace(root, true);
+            for (const node of localNodes.values()) {
+                if (node.slot && localNodes.has(node.slot))
+                    node.slot = localNodes.get(node.slot).id;
+                const slots = node.model?.slots;
+                if (slots && typeof slots === 'object' && !Array.isArray(slots)) {
+                    node.model.slots = Object.fromEntries(Object.entries(slots).map(([name, target]) => [
+                        name, typeof target === 'string' && localNodes.has(target) ? localNodes.get(target).id : target,
+                    ]));
+                }
+            }
+            for (const name of Object.keys(value.inputs ?? {}))
+                if (!definition.inputs?.[name])
+                    throw new TypeError(`Unknown component input ${name}.`);
+            for (const [name, binding] of Object.entries(definition.inputs ?? {})) {
+                const supplied = Object.prototype.hasOwnProperty.call(value.inputs ?? {}, name) ? value.inputs[name] : binding.default;
+                if (supplied === undefined)
+                    throw new TypeError(`Missing component input ${name}.`);
+                assign(root, binding.path, supplied);
+            }
+            for (const name of Object.keys(value.slots ?? {}))
+                if (!definition.slots?.[name])
+                    throw new TypeError(`Unknown component slot ${name}.`);
+            for (const [name, localId] of Object.entries(definition.slots ?? {})) {
+                const node = localNodes.get(localId);
+                if (!node)
+                    throw new TypeError(`Unknown component slot target ${localId}.`);
+                if (value.slots?.[name])
+                    node.children = value.slots[name];
+            }
+            return expand(root, depth + 1);
+        }
+        if (ids.has(value.id))
+            throw new TypeError(`Duplicate Page node ${value.id}.`);
+        ids.add(value.id);
+        return { ...value, ...(value.children ? { children: value.children.map((child) => expand(child, depth + 1)) } : {}) };
+    };
+    return declarative_control_1.PageSchema.parse({ ...source.page, contract: 'Page', schemaVersion: 1, body: expand(source.body, 0) });
+}
+exports.compilePageComposition = compilePageComposition;
+//# sourceMappingURL=page-composition.js.map

package/lib/runtime/page-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-composition.js","sourceRoot":"","sources":["../../src/runtime/page-composition.ts"],"names":[],"mappings":"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"}