@golemui/schemas 1.2.1

package/schemas/core/common.schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://golemui.com/schemas/core/common.schema.json",
+  "$comment": "Owned by @golemui/schemas (libs/schemas/src/lib/core/). Implementation trees contain a generated vendored copy, identical apart from an `$id` rebased onto the implementation's own tree. Edit the source file, then run `npm run generate:schemas`.",
+  "title": "Golem Common Definitions",
+  "$defs": {
+    "reactiveExpression": {
+      "type": "string",
+      "description": "A reactive expression string. Use `$form` to access form data e.g. `$form.termsAccepted === true`"
+    },
+    "dotPath": {
+      "type": "string",
+      "description": "A dot-separated path to a property in the form data"
+    },
+    "uid": {
+      "type": "string",
+      "description": "Unique identifier for the widget"
+    },
+    "chunkRef": {
+      "type": "object",
+      "description": "A reference to an external chunk file whose widget array will be inlined at this position in the form",
+      "properties": {
+        "$ref": { "type": "string", "description": "Relative path to a JSON chunk file" }
+      },
+      "required": ["$ref"],
+      "additionalProperties": false
+    },
+    "localizable": {
+      "description": "A value that can be a plain string or an i18n key object. Use a plain string for static text, or `{key, default, params}` to reference a translation key.",
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "The i18n translation key"
+            },
+            "default": {
+              "type": "string",
+              "description": "Fallback text shown when the translation key is not found"
+            },
+            "params": {
+              "type": "object",
+              "description": "Interpolation parameters passed to the translation function"
+            }
+          },
+          "required": ["key"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "include": {
+      "description": "Show this widget only in certain form states (`{in: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is always shown.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "in": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of state names (defined in the form `states` map) in which this widget should be visible"
+            }
+          },
+          "required": ["in"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "when": {
+              "$ref": "#/$defs/reactiveExpression"
+            }
+          },
+          "required": ["when"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "exclude": {
+      "description": "Hide this widget in certain form states (`{from: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is never hidden.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "from": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of state names (defined in the form `states` map) in which this widget should be hidden"
+            }
+          },
+          "required": ["from"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "when": {
+              "$ref": "#/$defs/reactiveExpression"
+            }
+          },
+          "required": ["when"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "boolOrWhen": {
+      "description": "A static boolean or a conditional `{when: reactiveExpression}` object evaluated at runtime. Use `{when: '$form.someField === true'}` for dynamic behavior.",
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "when": {
+              "$ref": "#/$defs/reactiveExpression"
+            }
+          },
+          "required": ["when"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "on": {
+      "type": "object",
+      "description": "Event handlers for this widget. Values are action names dispatched to the form's event bus. Each key also accepts a state-suffixed variant (`\"click.<stateName>\"`) that overrides the base handler when the named state is active.",
+      "properties": {
+        "load": {
+          "type": "string",
+          "description": "Action dispatched when the widget is first mounted"
+        },
+        "click": {
+          "type": "string",
+          "description": "Action dispatched when the user clicks the widget"
+        },
+        "change": {
+          "type": "string",
+          "description": "Action dispatched when the widget value changes"
+        },
+        "filter": {
+          "type": "string",
+          "description": "Action dispatched on search/filter input, typically used with async data sources"
+        },
+        "blur": {
+          "type": "string",
+          "description": "Action dispatched when the widget loses focus"
+        }
+      },
+      "patternProperties": {
+        "^load\\.[^.]+$": {
+          "type": "string",
+          "description": "State-suffixed load handler: used instead of `load` when the named state is active (e.g. `\"load.myState\"`)"
+        },
+        "^click\\.[^.]+$": {
+          "type": "string",
+          "description": "State-suffixed click handler: used instead of `click` when the named state is active (e.g. `\"click.myState\"`)"
+        },
+        "^change\\.[^.]+$": {
+          "type": "string",
+          "description": "State-suffixed change handler: used instead of `change` when the named state is active (e.g. `\"change.myState\"`)"
+        },
+        "^filter\\.[^.]+$": {
+          "type": "string",
+          "description": "State-suffixed filter handler: used instead of `filter` when the named state is active (e.g. `\"filter.myState\"`)"
+        },
+        "^blur\\.[^.]+$": {
+          "type": "string",
+          "description": "State-suffixed blur handler: used instead of `blur` when the named state is active (e.g. `\"blur.myState\"`)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "baseWidget": {
+      "type": "object",
+      "description": "Base properties shared by all widgets. Root-level props that support state-suffixing (e.g. `\"label.myState\"`) are: `label`, `disabled`, `readonly`, `validator`, `size`. Any key inside `props` can also be suffixed. State names must be declared in the form `states` map.",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "uid": {
+          "$ref": "#/$defs/uid"
+        },
+        "type": {
+          "type": "string"
+        },
+        "size": {
+          "type": "number",
+          "description": "Column span in the form grid (1-12). Defaults to full width when omitted.",
+          "minimum": 1,
+          "maximum": 12
+        },
+        "include": {
+          "$ref": "#/$defs/include"
+        },
+        "exclude": {
+          "$ref": "#/$defs/exclude"
+        }
+      },
+      "required": ["type"]
+    }
+  }
+}