@timeax/digital-service-engine 0.0.1 → 0.0.2

package/dist/schema/index.d.cts

@@ -32,12 +32,13 @@ interface BaseFieldUI {
     name?: string;
     label: string;
     required?: boolean;
-    /** Host-defined prop names → typed UI nodes */
-    ui?: Record<string, Ui>;
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
-type Ui = UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject;
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
 /** string */
 interface UiString {
     type: "string";
@@ -72,8 +73,17 @@ interface UiAnyOf {
 /** arrays: homogeneous (item) or tuple (items) */
 interface UiArray {
     type: "array";
+    label: string;
+    description: string;
     item?: Ui;
     items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;
@@ -81,7 +91,16 @@ interface UiArray {
 /** objects: nested props */
 interface UiObject {
     type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
     fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
     required?: string[];
     order?: string[];
 }
@@ -190,6 +209,8 @@ type ServiceProps = {
     excludes_for_buttons?: Record<string, string[]>;
     schema_version?: string;
     fallbacks?: ServiceFallback;
+    name?: string;
+    notices?: ServicePropsNotice[];
 };
 type ServiceIdRef = number | string;
 type NodeIdRef = string;
@@ -199,6 +220,34 @@ type ServiceFallback = {
     /** Primary→fallback list used when no node-scoped entry is present */
     global?: Record<ServiceIdRef, ServiceIdRef[]>;
 };
+type NoticeType = "public" | "private";
+type NoticeSeverity = "info" | "warning" | "error";
+/**
+ * “label” is lightweight + UI-friendly (best, sale, hot, etc).
+ * Others remain semantic / governance oriented.
+ */
+type NoticeKind = "label" | "warning" | "deprecation" | "compat" | "migration" | "policy";
+type NoticeTarget = {
+    scope: "global";
+} | {
+    scope: "node";
+    node_kind: "tag" | "field" | "option";
+    node_id: string;
+};
+interface ServicePropsNotice {
+    id: string;
+    type: NoticeType;
+    kind: NoticeKind;
+    severity: NoticeSeverity;
+    target: NoticeTarget;
+    title: string;
+    description?: string;
+    reason?: string;
+    marked_at?: string;
+    icon?: string;
+    color?: string;
+    meta?: Record<string, unknown>;
+}
 
 type NodeKind = "tag" | "field" | "comment" | "option";
 type EdgeKind = "child" | "bind" | "include" | "exclude" | "error" | "anchor";
@@ -438,6 +487,22 @@ type DgpServiceCapability = {
 };
 type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
 
+type NodeRef = {
+    kind: "tag";
+    id: string;
+    node: Tag;
+} | {
+    kind: "field";
+    id: string;
+    node: Field;
+} | {
+    kind: "option";
+    id: string;
+    node: FieldOption;
+    fieldId: string;
+};
+type NodeMap = Map<string, NodeRef>;
+
 type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
 type ValidationError = {
     code: ValidationCode;
@@ -486,6 +551,7 @@ type DynamicRule = {
 };
 type ValidatorOptions = {
     serviceMap?: DgpServiceMap;
+    nodeMap?: NodeMap;
     allowUnsafe?: boolean;
     selectedOptionKeys?: string[];
     globalUtilityGuard?: boolean;
@@ -512,56 +578,6 @@ type FallbackSettings = {
     mode?: "strict" | "dev";
 };
 
-type Env = "client" | "workspace";
-type SelectionOptions = {
-    env?: Env;
-    rootTagId?: string;
-    /** Resolve service capability from an id (used for `services` array) */
-    resolveService?: (id: any) => DgpServiceCapability | undefined;
-};
-
-type EditorEvents = {
-    "editor:command": {
-        name: string;
-        payload?: any;
-    };
-    "editor:change": {
-        props: ServiceProps;
-        reason: string;
-        command?: string;
-    };
-    "editor:undo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:redo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:error": {
-        message: string;
-        code?: string;
-        meta?: any;
-    };
-};
-type Command = {
-    name: string;
-    do(): void;
-    undo(): void;
-};
-type EditorOptions = {
-    historyLimit?: number;
-    validateAfterEach?: boolean;
-    /** Sync existence check; return true if the service exists. */
-    serviceExists?: (id: number) => boolean;
-    /** Optional local index; used if serviceExists is not provided. */
-    serviceMap?: Record<number, unknown>;
-    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
-    policiesRaw?: unknown;
-    selectionProps?: SelectionOptions;
-};
-type ConnectKind = "bind" | "include" | "exclude";
-
 interface ButtonValue {
     id: string;
     value: string | number;
@@ -641,6 +657,8 @@ type OrderSnapshot = {
         rule?: QuantityRule;
         defaultedFromHost?: boolean;
     };
+    min: number;
+    max: number;
     services: Array<string | number>;
     serviceMap: Record<string, Array<string | number>>;
     fallbacks?: {
@@ -665,7 +683,57 @@ type OrderSnapshot = {
     };
 };
 
+type Env = "client" | "workspace";
+type SelectionOptions = {
+    env?: Env;
+    rootTagId?: string;
+    /** Resolve service capability from an id (used for `services` array) */
+    resolveService?: (id: any) => DgpServiceCapability | undefined;
+};
+
+type EditorEvents = {
+    "editor:command": {
+        name: string;
+        payload?: any;
+    };
+    "editor:change": {
+        props: ServiceProps;
+        reason: string;
+        command?: string;
+    };
+    "editor:undo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:redo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:error": {
+        message: string;
+        code?: string;
+        meta?: any;
+    };
+};
+type Command = {
+    name: string;
+    do(): void;
+    undo(): void;
+};
+type EditorOptions = {
+    historyLimit?: number;
+    validateAfterEach?: boolean;
+    /** Sync existence check; return true if the service exists. */
+    serviceExists?: (id: number) => boolean;
+    /** Optional local index; used if serviceExists is not provided. */
+    serviceMap?: Record<number, unknown>;
+    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
+    policiesRaw?: unknown;
+    selectionProps?: SelectionOptions;
+};
+type ConnectKind = "bind" | "include" | "exclude";
+
 /** Exported alias so the schema generator can target an array */
 type AdminPolicies = DynamicRule[];
 
-export type { AdminPolicies, BaseFieldUI, ButtonValue, CanvasEvents, CanvasOptions, CanvasState, Command, CommentAnchor, CommentId, CommentMessage, CommentNode, CommentThread, ConnectKind, ConstraintKey, DgpServiceCapability, DgpServiceMap, DraftWire, DynamicRule, EdgeKind, EdgeRoute, EdgeView, EditorEvents, EditorOptions, EditorSnapshot, FallbackDiagnostics, FallbackSettings, Field, FieldOption, FieldType, FieldWithTypedDefaults, FlagKey, FlowNode, GraphEdge, GraphNode, GraphSnapshot, IdType, LayoutState, NodeIdRef, NodeKind, NodePos, NodePositions, NodeView, OrderSnapshot, PricingRole, QuantityMark, QuantityRule, RatePolicy, Scalar, ServiceEstimates, ServiceFallback, ServiceFallbacks, ServiceFlag, ServiceFlags, ServiceIdRef, ServiceProps, ServiceWhereClause, ServiceWhereOp, SnapshotContext, SpeedEstimate, Tag, ThreadId, TimeRangeEstimate, Ui, UiAnyOf, UiArray, UiBoolean, UiNumber, UiObject, UiString, UiValue, UtilityLineItem, UtilityMark, UtilityMode, ValidationCode, ValidationError, ValidatorOptions, Viewport, WithQuantityDefault };
+export type { AdminPolicies, BaseFieldUI, ButtonValue, CanvasEvents, CanvasOptions, CanvasState, Command, CommentAnchor, CommentId, CommentMessage, CommentNode, CommentThread, ConnectKind, ConstraintKey, DgpServiceCapability, DgpServiceMap, DraftWire, DynamicRule, EdgeKind, EdgeRoute, EdgeView, EditorEvents, EditorOptions, EditorSnapshot, FallbackDiagnostics, FallbackSettings, Field, FieldOption, FieldType, FieldWithTypedDefaults, FlagKey, FlowNode, GraphEdge, GraphNode, GraphSnapshot, IdType, LayoutState, NodeIdRef, NodeKind, NodePos, NodePositions, NodeView, NoticeKind, NoticeSeverity, NoticeTarget, NoticeType, OrderSnapshot, PricingRole, QuantityMark, QuantityRule, RatePolicy, Scalar, ServiceEstimates, ServiceFallback, ServiceFallbacks, ServiceFlag, ServiceFlags, ServiceIdRef, ServiceProps, ServicePropsNotice, ServiceWhereClause, ServiceWhereOp, SnapshotContext, SpeedEstimate, Tag, ThreadId, TimeRangeEstimate, Ui, UiAnyOf, UiArray, UiBoolean, UiNumber, UiObject, UiString, UiValue, UtilityLineItem, UtilityMark, UtilityMode, ValidationCode, ValidationError, ValidatorOptions, Viewport, WithQuantityDefault };

package/dist/schema/index.d.ts

@@ -32,12 +32,13 @@ interface BaseFieldUI {
     name?: string;
     label: string;
     required?: boolean;
-    /** Host-defined prop names → typed UI nodes */
-    ui?: Record<string, Ui>;
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
-type Ui = UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject;
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
 /** string */
 interface UiString {
     type: "string";
@@ -72,8 +73,17 @@ interface UiAnyOf {
 /** arrays: homogeneous (item) or tuple (items) */
 interface UiArray {
     type: "array";
+    label: string;
+    description: string;
     item?: Ui;
     items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;
@@ -81,7 +91,16 @@ interface UiArray {
 /** objects: nested props */
 interface UiObject {
     type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
     fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
     required?: string[];
     order?: string[];
 }
@@ -190,6 +209,8 @@ type ServiceProps = {
     excludes_for_buttons?: Record<string, string[]>;
     schema_version?: string;
     fallbacks?: ServiceFallback;
+    name?: string;
+    notices?: ServicePropsNotice[];
 };
 type ServiceIdRef = number | string;
 type NodeIdRef = string;
@@ -199,6 +220,34 @@ type ServiceFallback = {
     /** Primary→fallback list used when no node-scoped entry is present */
     global?: Record<ServiceIdRef, ServiceIdRef[]>;
 };
+type NoticeType = "public" | "private";
+type NoticeSeverity = "info" | "warning" | "error";
+/**
+ * “label” is lightweight + UI-friendly (best, sale, hot, etc).
+ * Others remain semantic / governance oriented.
+ */
+type NoticeKind = "label" | "warning" | "deprecation" | "compat" | "migration" | "policy";
+type NoticeTarget = {
+    scope: "global";
+} | {
+    scope: "node";
+    node_kind: "tag" | "field" | "option";
+    node_id: string;
+};
+interface ServicePropsNotice {
+    id: string;
+    type: NoticeType;
+    kind: NoticeKind;
+    severity: NoticeSeverity;
+    target: NoticeTarget;
+    title: string;
+    description?: string;
+    reason?: string;
+    marked_at?: string;
+    icon?: string;
+    color?: string;
+    meta?: Record<string, unknown>;
+}
 
 type NodeKind = "tag" | "field" | "comment" | "option";
 type EdgeKind = "child" | "bind" | "include" | "exclude" | "error" | "anchor";
@@ -438,6 +487,22 @@ type DgpServiceCapability = {
 };
 type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
 
+type NodeRef = {
+    kind: "tag";
+    id: string;
+    node: Tag;
+} | {
+    kind: "field";
+    id: string;
+    node: Field;
+} | {
+    kind: "option";
+    id: string;
+    node: FieldOption;
+    fieldId: string;
+};
+type NodeMap = Map<string, NodeRef>;
+
 type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
 type ValidationError = {
     code: ValidationCode;
@@ -486,6 +551,7 @@ type DynamicRule = {
 };
 type ValidatorOptions = {
     serviceMap?: DgpServiceMap;
+    nodeMap?: NodeMap;
     allowUnsafe?: boolean;
     selectedOptionKeys?: string[];
     globalUtilityGuard?: boolean;
@@ -512,56 +578,6 @@ type FallbackSettings = {
     mode?: "strict" | "dev";
 };
 
-type Env = "client" | "workspace";
-type SelectionOptions = {
-    env?: Env;
-    rootTagId?: string;
-    /** Resolve service capability from an id (used for `services` array) */
-    resolveService?: (id: any) => DgpServiceCapability | undefined;
-};
-
-type EditorEvents = {
-    "editor:command": {
-        name: string;
-        payload?: any;
-    };
-    "editor:change": {
-        props: ServiceProps;
-        reason: string;
-        command?: string;
-    };
-    "editor:undo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:redo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:error": {
-        message: string;
-        code?: string;
-        meta?: any;
-    };
-};
-type Command = {
-    name: string;
-    do(): void;
-    undo(): void;
-};
-type EditorOptions = {
-    historyLimit?: number;
-    validateAfterEach?: boolean;
-    /** Sync existence check; return true if the service exists. */
-    serviceExists?: (id: number) => boolean;
-    /** Optional local index; used if serviceExists is not provided. */
-    serviceMap?: Record<number, unknown>;
-    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
-    policiesRaw?: unknown;
-    selectionProps?: SelectionOptions;
-};
-type ConnectKind = "bind" | "include" | "exclude";
-
 interface ButtonValue {
     id: string;
     value: string | number;
@@ -641,6 +657,8 @@ type OrderSnapshot = {
         rule?: QuantityRule;
         defaultedFromHost?: boolean;
     };
+    min: number;
+    max: number;
     services: Array<string | number>;
     serviceMap: Record<string, Array<string | number>>;
     fallbacks?: {
@@ -665,7 +683,57 @@ type OrderSnapshot = {
     };
 };
 
+type Env = "client" | "workspace";
+type SelectionOptions = {
+    env?: Env;
+    rootTagId?: string;
+    /** Resolve service capability from an id (used for `services` array) */
+    resolveService?: (id: any) => DgpServiceCapability | undefined;
+};
+
+type EditorEvents = {
+    "editor:command": {
+        name: string;
+        payload?: any;
+    };
+    "editor:change": {
+        props: ServiceProps;
+        reason: string;
+        command?: string;
+    };
+    "editor:undo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:redo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:error": {
+        message: string;
+        code?: string;
+        meta?: any;
+    };
+};
+type Command = {
+    name: string;
+    do(): void;
+    undo(): void;
+};
+type EditorOptions = {
+    historyLimit?: number;
+    validateAfterEach?: boolean;
+    /** Sync existence check; return true if the service exists. */
+    serviceExists?: (id: number) => boolean;
+    /** Optional local index; used if serviceExists is not provided. */
+    serviceMap?: Record<number, unknown>;
+    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
+    policiesRaw?: unknown;
+    selectionProps?: SelectionOptions;
+};
+type ConnectKind = "bind" | "include" | "exclude";
+
 /** Exported alias so the schema generator can target an array */
 type AdminPolicies = DynamicRule[];
 
-export type { AdminPolicies, BaseFieldUI, ButtonValue, CanvasEvents, CanvasOptions, CanvasState, Command, CommentAnchor, CommentId, CommentMessage, CommentNode, CommentThread, ConnectKind, ConstraintKey, DgpServiceCapability, DgpServiceMap, DraftWire, DynamicRule, EdgeKind, EdgeRoute, EdgeView, EditorEvents, EditorOptions, EditorSnapshot, FallbackDiagnostics, FallbackSettings, Field, FieldOption, FieldType, FieldWithTypedDefaults, FlagKey, FlowNode, GraphEdge, GraphNode, GraphSnapshot, IdType, LayoutState, NodeIdRef, NodeKind, NodePos, NodePositions, NodeView, OrderSnapshot, PricingRole, QuantityMark, QuantityRule, RatePolicy, Scalar, ServiceEstimates, ServiceFallback, ServiceFallbacks, ServiceFlag, ServiceFlags, ServiceIdRef, ServiceProps, ServiceWhereClause, ServiceWhereOp, SnapshotContext, SpeedEstimate, Tag, ThreadId, TimeRangeEstimate, Ui, UiAnyOf, UiArray, UiBoolean, UiNumber, UiObject, UiString, UiValue, UtilityLineItem, UtilityMark, UtilityMode, ValidationCode, ValidationError, ValidatorOptions, Viewport, WithQuantityDefault };
+export type { AdminPolicies, BaseFieldUI, ButtonValue, CanvasEvents, CanvasOptions, CanvasState, Command, CommentAnchor, CommentId, CommentMessage, CommentNode, CommentThread, ConnectKind, ConstraintKey, DgpServiceCapability, DgpServiceMap, DraftWire, DynamicRule, EdgeKind, EdgeRoute, EdgeView, EditorEvents, EditorOptions, EditorSnapshot, FallbackDiagnostics, FallbackSettings, Field, FieldOption, FieldType, FieldWithTypedDefaults, FlagKey, FlowNode, GraphEdge, GraphNode, GraphSnapshot, IdType, LayoutState, NodeIdRef, NodeKind, NodePos, NodePositions, NodeView, NoticeKind, NoticeSeverity, NoticeTarget, NoticeType, OrderSnapshot, PricingRole, QuantityMark, QuantityRule, RatePolicy, Scalar, ServiceEstimates, ServiceFallback, ServiceFallbacks, ServiceFlag, ServiceFlags, ServiceIdRef, ServiceProps, ServicePropsNotice, ServiceWhereClause, ServiceWhereOp, SnapshotContext, SpeedEstimate, Tag, ThreadId, TimeRangeEstimate, Ui, UiAnyOf, UiArray, UiBoolean, UiNumber, UiObject, UiString, UiValue, UtilityLineItem, UtilityMark, UtilityMode, ValidationCode, ValidationError, ValidatorOptions, Viewport, WithQuantityDefault };