@jxsuite/schema 0.22.0 → 0.23.0

package/src/schema.js

@@ -285,6 +285,8 @@ export async function generateSchema() {
           { $ref: "#/$defs/FunctionDef" },
           // Shape 4: External class / data source ($prototype: <other>)
           { $ref: "#/$defs/ExternalClassDef" },
+          // Shape 5: Expression ($expression)
+          { $ref: "#/$defs/ExpressionEntry" },
           // Shape 1: Naked object (plain object, no reserved keys)
           {
             type: "object",
@@ -293,6 +295,7 @@ export async function generateSchema() {
                 { required: ["$prototype"] },
                 { required: ["default"] },
                 { required: ["type"] },
+                { required: ["$expression"] },
               ],
             },
           },
@@ -893,6 +896,149 @@ export async function generateSchema() {
         examples: ["$map/item", "$map/index", "$map/item/text", "$map/item/done"],
       },
 
+      // ── Expression ($expression) ──────────────────────────────────────
+
+      ExpressionPointer: {
+        description: "A JSON Pointer $ref operand within an expression node.",
+        type: "object",
+        properties: {
+          $ref: {
+            type: "string",
+            pattern: "^(\\$map/|\\$reduce/|event#/|#/|parent#/|window#/|document#/)",
+          },
+        },
+        required: ["$ref"],
+        additionalProperties: false,
+      },
+
+      ExpressionLiteral: {
+        description: "A non-reactive operand: scalar or array of operands.",
+        anyOf: [
+          { type: "string", not: { pattern: "\\$\\{" } },
+          { type: "number" },
+          { type: "boolean" },
+          { type: "null" },
+          { type: "array", items: { $ref: "#/$defs/ExpressionOperand" } },
+        ],
+      },
+
+      ExpressionOperand: {
+        description:
+          "Anything that may appear in target or value: a pointer, a literal, or a nested expression node.",
+        anyOf: [
+          { $ref: "#/$defs/ExpressionPointer" },
+          { $ref: "#/$defs/ExpressionNode" },
+          { $ref: "#/$defs/ExpressionLiteral" },
+        ],
+      },
+
+      UnaryOperator: { enum: ["!", "-"] },
+      BinaryOperator: {
+        enum: ["+", "-", "*", "/", "%", "===", "!==", "<", "<=", ">", ">=", "&&", "||"],
+      },
+      AssignmentOperator: { enum: ["=", "+=", "-=", "*=", "/="] },
+      NoArgMethod: { enum: ["pop", "shift"] },
+      OneArgMethod: { enum: ["push", "unshift"] },
+      SpliceMethod: { const: "splice" },
+      ReduceMethod: { const: "reduce" },
+      MapFilterMethod: { enum: ["map", "filter"] },
+
+      ExpressionNode: {
+        description: "The core expression node. operator + target, with value gated by arity.",
+        type: "object",
+        required: ["operator", "target"],
+        additionalProperties: false,
+        properties: {
+          operator: { type: "string" },
+          target: { $ref: "#/$defs/ExpressionOperand" },
+          value: { $ref: "#/$defs/ExpressionOperand" },
+          initial: { $ref: "#/$defs/ExpressionOperand" },
+        },
+        oneOf: [
+          {
+            title: "Unary — target only, no value",
+            properties: { operator: { $ref: "#/$defs/UnaryOperator" } },
+            required: ["operator"],
+            not: { anyOf: [{ required: ["value"] }, { required: ["initial"] }] },
+          },
+          {
+            title: "Binary — left in target, right in value",
+            properties: { operator: { $ref: "#/$defs/BinaryOperator" } },
+            required: ["operator", "value"],
+            not: { required: ["initial"] },
+          },
+          {
+            title: "Assignment — writable target, value required",
+            properties: {
+              operator: { $ref: "#/$defs/AssignmentOperator" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+            },
+            required: ["operator", "value"],
+            not: { required: ["initial"] },
+          },
+          {
+            title: "pop / shift — array receiver, no value",
+            properties: {
+              operator: { $ref: "#/$defs/NoArgMethod" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+            },
+            required: ["operator"],
+            not: { anyOf: [{ required: ["value"] }, { required: ["initial"] }] },
+          },
+          {
+            title: "push / unshift — array receiver, single value argument",
+            properties: {
+              operator: { $ref: "#/$defs/OneArgMethod" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+            },
+            required: ["operator", "value"],
+            not: { required: ["initial"] },
+          },
+          {
+            title: "splice — array receiver, [start, deleteCount, ...items]",
+            properties: {
+              operator: { $ref: "#/$defs/SpliceMethod" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+              value: { type: "array", items: { $ref: "#/$defs/ExpressionOperand" }, minItems: 1 },
+            },
+            required: ["operator", "value"],
+            not: { required: ["initial"] },
+          },
+          {
+            title: "reduce — pure fold; per-item expression in value, seed in initial",
+            properties: {
+              operator: { $ref: "#/$defs/ReduceMethod" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+              value: { $ref: "#/$defs/ExpressionNode" },
+            },
+            required: ["operator", "value", "initial"],
+          },
+          {
+            title: "map / filter — pure; per-item expression in value, no initial",
+            properties: {
+              operator: { $ref: "#/$defs/MapFilterMethod" },
+              target: { $ref: "#/$defs/ExpressionPointer" },
+              value: { $ref: "#/$defs/ExpressionNode" },
+            },
+            required: ["operator", "value"],
+            not: { required: ["initial"] },
+          },
+        ],
+      },
+
+      ExpressionEntry: {
+        description:
+          "A declarative expression entry (Shape 5). Used as a state entry or inline event handler.",
+        type: "object",
+        required: ["$expression"],
+        properties: {
+          $expression: { $ref: "#/$defs/ExpressionNode" },
+          $title: { type: "string" },
+          $description: { type: "string" },
+        },
+        additionalProperties: false,
+      },
+
       // ── Property value types ──────────────────────────────────────────────
       ElementPropertyValue: {
         oneOf: [
@@ -983,7 +1129,7 @@ function buildEventHandlerProperties(eventHandlers) {
   for (const name of eventHandlers) {
     properties[name] = {
       description: `Event handler for the "${name.slice(2)}" event.`,
-      $ref: "#/$defs/RefObject",
+      oneOf: [{ $ref: "#/$defs/RefObject" }, { $ref: "#/$defs/ExpressionEntry" }],
     };
   }
   return properties;