@lostgradient/cinder 0.3.0 → 0.4.0

package/dist/components/invocation-rule-builder/invocation-rule-builder.schema.js

@@ -26,10 +26,134 @@ var schema = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
   type: "object",
   properties: {
+    rules: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Unique identifier for the rule."
+          },
+          label: {
+            type: "string",
+            description: "Display label for the rule."
+          },
+          conditions: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                id: {
+                  type: "string",
+                  description: "Identifies the condition row; must be unique within its rule."
+                },
+                field: {
+                  type: "string",
+                  description: 'The field being tested, e.g. "path" or "label". Consumer-defined.'
+                },
+                operator: {
+                  type: "string",
+                  description: 'The comparison operator, e.g. "matches" or "is". Consumer-defined.'
+                },
+                value: {
+                  type: "string",
+                  description: "The value being compared against. Consumer-defined."
+                }
+              },
+              additionalProperties: false,
+              required: ["field", "id", "operator", "value"]
+            },
+            description: "Zero or more conditions (implicit AND)."
+          },
+          actions: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                id: {
+                  type: "string",
+                  description: "Identifies the action row; must be unique within its rule."
+                },
+                target: {
+                  type: "string",
+                  description: "The action target, e.g. a review-agent slug. Consumer-defined."
+                }
+              },
+              additionalProperties: false,
+              required: ["id", "target"]
+            },
+            description: "Zero or more actions to invoke when conditions match."
+          }
+        },
+        additionalProperties: false,
+        required: ["actions", "conditions", "id", "label"]
+      },
+      description: "The current list of automation rules. Controlled — pass the updated\nlist returned from `onchange` back into this prop to commit a change."
+    },
+    fieldOptions: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          value: {
+            type: "string",
+            description: "The value stored on the condition or action."
+          },
+          label: {
+            type: "string",
+            description: "The human-readable label shown in the select."
+          }
+        },
+        additionalProperties: false,
+        required: ["label", "value"]
+      },
+      description: `Options for the condition field selector. Consumer-provided list of
+fields that a condition can test, e.g. "path", "label", "author".`
+    },
+    operatorOptions: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          value: {
+            type: "string",
+            description: "The value stored on the condition or action."
+          },
+          label: {
+            type: "string",
+            description: "The human-readable label shown in the select."
+          }
+        },
+        additionalProperties: false,
+        required: ["label", "value"]
+      },
+      description: `Options for the condition operator selector. Consumer-provided list
+of operators, e.g. "matches", "is", "is-not", "contains".`
+    },
+    actionOptions: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          value: {
+            type: "string",
+            description: "The value stored on the condition or action."
+          },
+          label: {
+            type: "string",
+            description: "The human-readable label shown in the select."
+          }
+        },
+        additionalProperties: false,
+        required: ["label", "value"]
+      },
+      description: `Options for the action target selector. Consumer-provided list of
+targets, e.g. review-agent slugs or step identifiers.`
+    },
     readonly: {
-      type: "boolean",
-      description: `When true, renders a readonly summary of each rule instead of editable
-controls. Default is false (editable mode).`
+      const: true,
+      description: "Must be true for schema-driven usage because editable mode requires\nthe unsupported `onchange` callback. Runtime consumers may omit this\nwhen passing `onchange` directly."
     },
     addRuleLabel: {
       type: "string",
@@ -53,42 +177,16 @@ controls. Default is false (editable mode).`
     }
   },
   additionalProperties: false,
+  required: ["actionOptions", "fieldOptions", "operatorOptions", "readonly", "rules"],
   metadata: {
     unsupportedProps: [
-      {
-        name: "actionOptions",
-        reason: "unknown-shape",
-        required: true,
-        description: `Options for the action target selector. Consumer-provided list of
-targets, e.g. review-agent slugs or step identifiers.`
-      },
-      {
-        name: "fieldOptions",
-        reason: "unknown-shape",
-        required: true,
-        description: `Options for the condition field selector. Consumer-provided list of
-fields that a condition can test, e.g. "path", "label", "author".`
-      },
       {
         name: "onchange",
         reason: "function-or-snippet",
-        required: true,
-        description: `Called whenever the user makes any edit. Receives the next rule
-array (pure, not mutated) and a change descriptor. Consumer owns
-persistence, validation, and execution.`
-      },
-      {
-        name: "operatorOptions",
-        reason: "unknown-shape",
-        required: true,
-        description: `Options for the condition operator selector. Consumer-provided list
-of operators, e.g. "matches", "is", "is-not", "contains".`
-      },
-      {
-        name: "rules",
-        reason: "unknown-shape",
-        required: true,
-        description: "The current list of automation rules. Controlled — pass the updated\nlist returned from `onchange` back into this prop to commit a change."
+        description: `Called whenever the user makes any edit. Required for editable runtime
+usage because editable controls must commit controlled state changes.
+Receives the next rule array (pure, not mutated) and a change descriptor.
+Consumer owns persistence, validation, and execution.`
       }
     ]
   }
@@ -98,4 +196,4 @@ export {
   invocation_rule_builder_schema_default as default
 };
 
-//# debugId=A7624929A0D710E964756E2164756E21
+//# debugId=4E3817978B8C26C964756E2164756E21

package/dist/components/invocation-rule-builder/invocation-rule-builder.svelte.d.ts

@@ -1,7 +1,7 @@
 /**
  * @cinder
  * @category form
- * @status alpha
+ * @status beta
  * @purpose Render and edit conditional automation rules composed of conditions and actions.
  * @tag automation
  * @tag rules
@@ -9,7 +9,7 @@
  * @avoidWhen You need to execute, validate, or persist rules — cinder owns none of that logic.
  * @related capability-gate, steps, review-editor
  */
-export type { InvocationRule, InvocationRuleAction, InvocationRuleBuilderProps, InvocationRuleChange, InvocationRuleCondition, InvocationRuleOption, } from './invocation-rule-builder.types.ts';
+export type { InvocationRule, InvocationRuleAction, InvocationRuleBuilderProps, InvocationRuleBuilderSchemaProps, InvocationRuleChange, InvocationRuleCondition, InvocationRuleOption, } from './invocation-rule-builder.types.ts';
 import type { InvocationRuleBuilderProps } from './invocation-rule-builder.types.ts';
 declare const InvocationRuleBuilder: import("svelte").Component<InvocationRuleBuilderProps, {}, "">;
 type InvocationRuleBuilder = ReturnType<typeof InvocationRuleBuilder>;

package/dist/components/invocation-rule-builder/invocation-rule-builder.types.d.ts

@@ -2,6 +2,8 @@ import type { HTMLAttributes } from 'svelte/elements';
 /**
  * A single condition within a rule. The field, operator, and value
  * are all consumer-defined strings — cinder does not interpret them.
+ *
+ * @schemaObject
  */
 export type InvocationRuleCondition = {
     /** Identifies the condition row; must be unique within its rule. */
@@ -16,6 +18,8 @@ export type InvocationRuleCondition = {
 /**
  * A single action within a rule. The target is a consumer-defined
  * identifier naming the agent, service, or step to invoke.
+ *
+ * @schemaObject
  */
 export type InvocationRuleAction = {
     /** Identifies the action row; must be unique within its rule. */
@@ -27,6 +31,8 @@ export type InvocationRuleAction = {
  * A single automation rule. A rule fires when ALL of its conditions are
  * met and then triggers all of its actions. Cinder does not execute,
  * persist, or validate rules — consumers own that logic entirely.
+ *
+ * @schemaObject
  */
 export type InvocationRule = {
     /** Unique identifier for the rule. */
@@ -40,6 +46,8 @@ export type InvocationRule = {
 };
 /**
  * An option in a field, operator, or action-target select list.
+ *
+ * @schemaObject
  */
 export type InvocationRuleOption = {
     /** The value stored on the condition or action. */
@@ -54,6 +62,9 @@ export type InvocationRuleOption = {
 export type InvocationRuleChange = {
     type: 'add-rule';
     ruleId: string;
+} | {
+    type: 'rename-rule';
+    ruleId: string;
 } | {
     type: 'remove-rule';
     ruleId: string;
@@ -96,18 +107,82 @@ export type InvocationRuleChange = {
  * prop. Every user action calls `onchange` with the next rule array and
  * a change descriptor; the consumer decides what to persist.
  */
-export type InvocationRuleBuilderProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'children' | 'onchange'> & {
+type InvocationRuleBuilderBaseProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'children' | 'onchange'> & {
     /**
      * The current list of automation rules. Controlled — pass the updated
      * list returned from `onchange` back into this prop to commit a change.
      */
     rules: InvocationRule[];
     /**
-     * Called whenever the user makes any edit. Receives the next rule
-     * array (pure, not mutated) and a change descriptor. Consumer owns
-     * persistence, validation, and execution.
+     * Options for the condition field selector. Consumer-provided list of
+     * fields that a condition can test, e.g. "path", "label", "author".
+     */
+    fieldOptions: InvocationRuleOption[];
+    /**
+     * Options for the condition operator selector. Consumer-provided list
+     * of operators, e.g. "matches", "is", "is-not", "contains".
+     */
+    operatorOptions: InvocationRuleOption[];
+    /**
+     * Options for the action target selector. Consumer-provided list of
+     * targets, e.g. review-agent slugs or step identifiers.
+     */
+    actionOptions: InvocationRuleOption[];
+    /**
+     * Label for the "Add rule" button. Defaults to "Add rule".
+     */
+    addRuleLabel?: string;
+    /**
+     * Label for the "Add condition" button. Defaults to "Add condition".
+     */
+    addConditionLabel?: string;
+    /**
+     * Label for the "Add action" button. Defaults to "Add action".
+     */
+    addActionLabel?: string;
+    /** Accessible label for the entire rule builder region. */
+    label?: string;
+    /** Additional CSS classes applied to the root element. */
+    class?: string;
+};
+type InvocationRuleBuilderChangeHandler = (nextRules: InvocationRule[], change: InvocationRuleChange) => void;
+export type InvocationRuleBuilderProps = (InvocationRuleBuilderBaseProps & {
+    /**
+     * Called whenever the user makes any edit. Required for editable runtime
+     * usage because editable controls must commit controlled state changes.
+     * Receives the next rule array (pure, not mutated) and a change descriptor.
+     * Consumer owns persistence, validation, and execution.
      */
-    onchange: (nextRules: InvocationRule[], change: InvocationRuleChange) => void;
+    onchange: InvocationRuleBuilderChangeHandler;
+    /**
+     * When false or omitted, renders editable controls. Editable mode requires
+     * `onchange` so controls cannot become interactive-but-no-op.
+     */
+    readonly?: false;
+}) | (InvocationRuleBuilderBaseProps & {
+    /**
+     * Optional in readonly usage because no edit controls are rendered.
+     * Runtime consumers may still pass it when sharing props between modes.
+     */
+    onchange?: InvocationRuleBuilderChangeHandler;
+    /**
+     * When true, renders a readonly summary of each rule instead of editable
+     * controls.
+     */
+    readonly: true;
+});
+/**
+ * Cinder-specific schema surface for InvocationRuleBuilder.
+ *
+ * The `onchange` callback is documented but marked unsupported because
+ * functions cannot be represented as JSON Schema controls.
+ */
+export type InvocationRuleBuilderSchemaProps = {
+    /**
+     * The current list of automation rules. Controlled — pass the updated
+     * list returned from `onchange` back into this prop to commit a change.
+     */
+    rules: InvocationRule[];
     /**
      * Options for the condition field selector. Consumer-provided list of
      * fields that a condition can test, e.g. "path", "label", "author".
@@ -124,10 +199,11 @@ export type InvocationRuleBuilderProps = Omit<HTMLAttributes<HTMLElement>, 'clas
      */
     actionOptions: InvocationRuleOption[];
     /**
-     * When true, renders a readonly summary of each rule instead of editable
-     * controls. Default is false (editable mode).
+     * Must be true for schema-driven usage because editable mode requires
+     * the unsupported `onchange` callback. Runtime consumers may omit this
+     * when passing `onchange` directly.
      */
-    readonly?: boolean;
+    readonly: true;
     /**
      * Label for the "Add rule" button. Defaults to "Add rule".
      */
@@ -145,3 +221,4 @@ export type InvocationRuleBuilderProps = Omit<HTMLAttributes<HTMLElement>, 'clas
     /** Additional CSS classes applied to the root element. */
     class?: string;
 };
+export {};

package/dist/components/json-schema-editor/form-view.svelte.d.ts

@@ -2,6 +2,7 @@ import type { EditorState } from './json-schema-editor-state.svelte.ts';
 export type FormViewProps = {
     state: EditorState;
     idPrefix: string;
+    onvalidationerrorcount?: ((count: number) => void) | undefined;
     class?: string;
 };
 declare const FormView: import("svelte").Component<FormViewProps, {}, "">;