@ultrst-armada/kloks 1.10.1 → 1.10.3

package/.krusbl-release-attestation.json

@@ -1,8 +1,8 @@
 {
   "schema": 1,
   "packageName": "@ultrst-armada/kloks",
-  "version": "1.10.1",
-  "sourceCommit": "46425ef672a660fbc42ce877514d8e3eef1c3cbe",
+  "version": "1.10.3",
+  "sourceCommit": "2996ca27ffbccaf9a982b5423f63f8b67efda7e3",
   "releaseWorkflow": "npm Release",
-  "workflowRunId": "40311408079"
+  "workflowRunId": "40318694348"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultrst-armada/kloks",
-  "version": "1.10.1",
+  "version": "1.10.3",
   "private": false,
   "publishConfig": {
     "access": "public",

package/packages/contracts/dist/index.d.ts

@@ -628,6 +628,9 @@ interface UIAuthoringNode {
     assetRef?: AssetRef;
     parentId?: string;
     props: Record<string, string | number | boolean>;
+    slots?: Record<string, string[]>;
+    states?: Record<string, Record<string, string | number | boolean>>;
+    events?: Record<string, string>;
 }
 interface UIAuthoringBinding {
     componentId: string;

package/packages/contracts/dist/index.js

@@ -452,7 +452,9 @@ function getUIComponentPromotion(purpose) {
 function buildUIComponentArtifact(session) {
   const purpose = getUIComponentPurpose(session.context);
   const origin = session.metadata.origin === "kult" || session.metadata.origin === "theta" || session.metadata.origin === "kelt" ? session.metadata.origin : "other";
-  const root = session.nodes.find((node) => node.kind === "component" && !node.parentId)?.assetRef;
+  const requestedRootId = session.metadata.rootComponentId;
+  const root = session.nodes.find((node) => node.kind === "component" && node.id === requestedRootId) || session.nodes.find((node) => node.kind === "component");
+  const rootAsset = root?.assetRef;
   return {
     artifactId: "kloks.ui-artifact." + session.sessionId,
     schemaVersion: "1.0.0",
@@ -462,7 +464,7 @@ function buildUIComponentArtifact(session) {
     context: session.context,
     name: session.metadata.name || session.sessionId,
     description: session.metadata.description || "",
-    rootAsset: root,
+    rootAsset,
     session
   };
 }

package/packages/services/dist/index.js

@@ -1879,13 +1879,44 @@ function validateSession(session) {
     ids.add(node.id);
     if (node.parentId && !session.nodes.some((parent) => parent.id === node.parentId)) errors.push(`Missing parent for node: ${node.id}`);
     if (node.kind === "page" && node.parentId) errors.push(`Page cannot have a parent: ${node.id}`);
+    if (node.kind === "section" && !node.parentId) errors.push(`Section requires a page parent: ${node.id}`);
     if (node.kind === "section" && node.parentId && !session.nodes.some((parent) => parent.id === node.parentId && parent.kind === "page")) errors.push(`Section parent must be a page: ${node.id}`);
+    if (node.kind === "component" && !node.parentId) errors.push(`Component requires a section parent: ${node.id}`);
     if (node.kind === "component" && node.parentId && !session.nodes.some((parent) => parent.id === node.parentId && parent.kind === "section")) errors.push(`Component parent must be a section: ${node.id}`);
   }
   if (session.nodes.some((node) => node.kind === "component" && !node.assetRef)) errors.push("Every component node requires a FLOKS asset reference.");
   if (session.context === "service" && !session.metadata.serviceId) errors.push("Service authoring requires metadata.serviceId.");
+  for (const node of session.nodes) {
+    for (const [slotId, childIds] of Object.entries(node.slots || {})) {
+      if (!slotId.trim()) errors.push(`Slot id cannot be blank on node: ${node.id}`);
+      for (const childId of childIds) {
+        const child = session.nodes.find((candidate) => candidate.id === childId);
+        if (!child) errors.push(`Slot ${slotId} references missing child: ${childId}`);
+        else if (child.parentId !== node.id) errors.push(`Slot child ${childId} must be a direct child of node: ${node.id}`);
+      }
+    }
+    for (const [eventName, operationId] of Object.entries(node.events || {})) {
+      if (!eventName.trim()) errors.push(`Event name cannot be blank on node: ${node.id}`);
+      if (!operationId.trim() || !session.operations.some((operation) => operation.operationId === operationId)) {
+        errors.push(`Event ${eventName} references missing operation: ${operationId}`);
+      }
+    }
+  }
   for (const binding of session.bindings) {
-    if (!session.nodes.some((node) => node.id === binding.componentId)) errors.push(`Binding references missing component: ${binding.componentId}`);
+    const component = session.nodes.find((node) => node.id === binding.componentId);
+    if (!component) errors.push(`Binding references missing component: ${binding.componentId}`);
+    else if (component.kind !== "component") errors.push(`Binding target must be a component node: ${binding.componentId}`);
+    const operation = session.operations.find((item) => item.operationId === binding.target.apiId);
+    if (!operation) {
+      errors.push(`Binding references missing operation: ${binding.target.apiId}`);
+      continue;
+    }
+    const fields = binding.target.kind === "api-input" ? operation.inputFields : operation.outputFields;
+    const field = fields?.find((item) => item.name === binding.target.field);
+    if (!field) errors.push(`Binding references missing ${binding.target.kind === "api-input" ? "input" : "output"} field: ${binding.target.apiId}.${binding.target.field}`);
+    else if (field.type.toLowerCase() !== binding.target.fieldType.toLowerCase()) {
+      errors.push(`Binding field type mismatch for ${binding.target.apiId}.${binding.target.field}: expected ${field.type}, received ${binding.target.fieldType}`);
+    }
   }
   if (!session.operations.length) warnings.push("No service operations have been attached to this authoring session.");
   return { valid: errors.length === 0, errors, warnings };

package/packages/state-graph/dist/index.js

@@ -7,6 +7,15 @@ import {
   instantiateSubgraph
 } from "./chunk-S22PMERU.js";
 import "./chunk-RHRXPY2U.js";
+import {
+  LifecycleCycleError,
+  LifecycleGraph,
+  SKIPO_STATE,
+  SkipoStateEngine,
+  useLifecycleScope,
+  useSkipoBind,
+  useSkipoState
+} from "./chunk-EW4ACSZB.js";
 import {
   AttractionEngine,
   GhostInferenceEngine,
@@ -22,15 +31,6 @@ import {
   WireTypeRegistry,
   initializeDefaultGraphRules
 } from "./chunk-TZOL3RN7.js";
-import {
-  LifecycleCycleError,
-  LifecycleGraph,
-  SKIPO_STATE,
-  SkipoStateEngine,
-  useLifecycleScope,
-  useSkipoBind,
-  useSkipoState
-} from "./chunk-EW4ACSZB.js";
 import {
   CommandApi,
   GhostStore,