@almadar/core 9.8.0 → 9.10.0

package/dist/index.js

@@ -1445,6 +1445,19 @@ var OrbitalConfigSchema = z.object({
     timeout: z.number().optional()
   }).optional()
 });
+var ConfigProvenanceRecordSchema = z.object({
+  trait: z.string(),
+  patternPath: z.string().optional(),
+  prop: z.string(),
+  knob: z.string()
+});
+var SchemaMetadataSchema = z.object({
+  version: z.number().optional(),
+  createdAt: z.number().optional(),
+  source: z.string().optional(),
+  updatedAt: z.number().optional(),
+  configProvenance: z.record(z.array(ConfigProvenanceRecordSchema)).optional()
+});
 var OrbitalSchemaSchema = z.object({
   name: z.string().min(1, "Schema name is required"),
   description: z.string().optional(),
@@ -1456,7 +1469,8 @@ var OrbitalSchemaSchema = z.object({
   customPatterns: CustomPatternMapSchema,
   orbitals: z.array(OrbitalSchema).min(1, "At least one orbital is required"),
   services: z.array(ServiceDefinitionSchema).optional(),
-  config: OrbitalConfigSchema.optional()
+  config: OrbitalConfigSchema.optional(),
+  _metadata: SchemaMetadataSchema.optional()
 });
 function parseOrbitalSchema(data) {
   return OrbitalSchemaSchema.parse(data);
@@ -1897,6 +1911,182 @@ function widenTier(tier) {
   return tier;
 }
 
+// src/render-ui-edit.ts
+function navigatePatternPath(root, path) {
+  if (!path || path === "root") return root;
+  const parts = path.split(".");
+  let current = root;
+  for (const part of parts) {
+    if (current === null || current === void 0 || typeof current !== "object") return null;
+    if (Array.isArray(current)) {
+      const idx = Number.parseInt(part, 10);
+      if (Number.isNaN(idx) || idx < 0 || idx >= current.length) return null;
+      current = current[idx];
+    } else {
+      const record = current;
+      if (part === "children" && Array.isArray(record.children)) {
+        current = record.children;
+      } else {
+        current = record[part];
+      }
+    }
+  }
+  return typeof current === "object" && current !== null && !Array.isArray(current) ? current : null;
+}
+function splitChildPath(path) {
+  const lastDot = path.lastIndexOf(".");
+  if (lastDot === -1) return null;
+  const index = Number.parseInt(path.slice(lastDot + 1), 10);
+  if (Number.isNaN(index)) return null;
+  return { parentPath: path.slice(0, lastDot), index };
+}
+function setPropAtPath(root, path, prop, value) {
+  const node = navigatePatternPath(root, path);
+  if (!node) return false;
+  node[prop] = value;
+  return true;
+}
+function replaceChildAtPath(root, path, node) {
+  const split = splitChildPath(path);
+  if (!split) return false;
+  const parent = navigatePatternPath(root, split.parentPath);
+  if (!parent || !Array.isArray(parent.children)) return false;
+  if (split.index < 0 || split.index >= parent.children.length) return false;
+  parent.children[split.index] = node;
+  return true;
+}
+function insertChildAtPath(root, parentPath, index, node) {
+  const parent = navigatePatternPath(root, parentPath);
+  if (!parent) return false;
+  const children = parent.children ?? [];
+  const i = index < 0 || index > children.length ? children.length : index;
+  children.splice(i, 0, node);
+  parent.children = children;
+  return true;
+}
+function removeChildAtPath(root, path) {
+  const split = splitChildPath(path);
+  if (!split) return false;
+  const parent = navigatePatternPath(root, split.parentPath);
+  if (!parent || !Array.isArray(parent.children)) return false;
+  if (split.index < 0 || split.index >= parent.children.length) return false;
+  parent.children.splice(split.index, 1);
+  return true;
+}
+function replaceNodeInPlace(target, source) {
+  for (const key of Object.keys(target)) {
+    delete target[key];
+  }
+  Object.assign(target, source);
+}
+function stableValue(value) {
+  if (value === void 0) return "u";
+  if (value === null) return "n";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return JSON.stringify(value);
+  }
+  if (value instanceof Date) return value.toISOString();
+  if (Array.isArray(value)) return `[${value.map(stableValue).join(",")}]`;
+  const nodeType = "type" in value ? value.type : void 0;
+  return `{${typeof nodeType === "string" ? nodeType : ""}}`;
+}
+function fingerprintNode(node) {
+  const props = Object.keys(node).filter((k) => k !== "children").sort().map((k) => `${k}=${stableValue(node[k])}`).join(",");
+  const childCount = Array.isArray(node.children) ? node.children.length : 0;
+  return `t:${node.type ?? ""}|${props}|c:${childCount}`;
+}
+function findByFingerprint(node, path, fp) {
+  if (fingerprintNode(node) === fp) return path;
+  if (Array.isArray(node.children)) {
+    for (let i = 0; i < node.children.length; i++) {
+      const r = findByFingerprint(node.children[i], `${path}.children.${i}`, fp);
+      if (r) return r;
+    }
+  }
+  return null;
+}
+function readRenderUi(eff) {
+  if (eff[0] !== "render-ui") return null;
+  const slot = eff[1];
+  const config = eff[2];
+  if (typeof slot !== "string") return null;
+  if (config === null || typeof config !== "object" || Array.isArray(config)) return null;
+  return { slot, node: config };
+}
+function asInlineTrait(ref2) {
+  if (typeof ref2 === "object" && ref2 !== null && "stateMachine" in ref2) {
+    return ref2;
+  }
+  return null;
+}
+function findRenderUiRoot(orbital, address) {
+  for (const ref2 of orbital.traits) {
+    const trait = asInlineTrait(ref2);
+    if (!trait || trait.name !== address.trait) continue;
+    for (const t of trait.stateMachine?.transitions ?? []) {
+      if (t.event !== address.transition) continue;
+      if (address.state !== void 0 && t.from !== address.state) continue;
+      for (const eff of t.effects ?? []) {
+        const ru = readRenderUi(eff);
+        if (ru && ru.slot === address.slot) return ru.node;
+      }
+    }
+  }
+  return null;
+}
+function resolvePath(root, patch) {
+  if (patch.op === "insert") {
+    return navigatePatternPath(root, patch.address.path) ? patch.address.path : null;
+  }
+  const atPath = navigatePatternPath(root, patch.address.path);
+  if (atPath && (patch.fingerprint === void 0 || fingerprintNode(atPath) === patch.fingerprint)) {
+    return patch.address.path;
+  }
+  if (patch.fingerprint !== void 0) {
+    return findByFingerprint(root, "root", patch.fingerprint);
+  }
+  return null;
+}
+function applyOnePatch(orbital, patch) {
+  const root = findRenderUiRoot(orbital, patch.address);
+  if (!root) return false;
+  const path = resolvePath(root, patch);
+  if (path === null) return false;
+  switch (patch.op) {
+    case "set-prop":
+    case "rebind":
+      return patch.prop !== void 0 && setPropAtPath(root, path, patch.prop, patch.value);
+    case "remove":
+      return removeChildAtPath(root, path);
+    case "insert":
+      return patch.node !== void 0 && insertChildAtPath(root, path, patch.index ?? Number.MAX_SAFE_INTEGER, patch.node);
+    case "replace": {
+      if (patch.node === void 0) return false;
+      if (path === "root") {
+        const target = navigatePatternPath(root, "root");
+        if (!target) return false;
+        replaceNodeInPlace(target, patch.node);
+        return true;
+      }
+      return replaceChildAtPath(root, path, patch.node);
+    }
+    default:
+      return false;
+  }
+}
+function applyRenderOverlay(orbital, patches) {
+  let applied = 0;
+  const stale = [];
+  for (const patch of patches) {
+    if (applyOnePatch(orbital, patch)) {
+      applied += 1;
+    } else {
+      stale.push(patch);
+    }
+  }
+  return { applied, stale };
+}
+
 // src/resolver.ts
 var schemaCache = /* @__PURE__ */ new WeakMap();
 function clearSchemaCache() {
@@ -2796,8 +2986,28 @@ function buildConfigKeyQuestion(call, trait, param) {
   if (param.tier) {
     out.tier = param.tier;
   }
+  if (param.description) {
+    out.helpText = param.description;
+  }
+  const weight = tierWeight(param.tier);
+  out.weight = weight;
+  out.priority = weight;
   return out;
 }
+function tierWeight(tier) {
+  switch (tier) {
+    case "domain":
+    case "policy":
+      return 3;
+    case "infra":
+      return 2;
+    case "internal":
+      return 0;
+    case "presentation":
+    default:
+      return 1;
+  }
+}
 function callSiteOverrideValue(call, traitName, configKey) {
   const override = call.params.traitOverrides?.[traitName];
   if (!override?.config) return void 0;
@@ -2867,7 +3077,10 @@ function capabilityQuestions(call, signature, ruleCapabilities) {
           capability: cap,
           appliesTo: [entityName]
         },
-        suggestedAnswers: ["yes", "skip"]
+        suggestedAnswers: ["yes", "skip"],
+        // Capabilities encode governance/policy decisions — high impact.
+        weight: 3,
+        priority: 3
       });
     }
   }
@@ -4040,6 +4253,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, extractPayloadFieldRef, findService, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEntity, getInteractionModelForDomain, getOperator, getPage, getPages, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, ref, renderUI, requiresConfirmation, safeParseOrbitalSchema, schemaToIR, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyRenderOverlay, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, extractPayloadFieldRef, findService, fingerprintNode, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEntity, getInteractionModelForDomain, getOperator, getPage, getPages, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, inferTsType, insertChildAtPath, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, navigatePatternPath, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, ref, removeChildAtPath, renderUI, replaceChildAtPath, requiresConfirmation, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map