demo.widgentic.dev

widgentic_widget_draft_load

Replace the draft in the widget designer with a complete definition { kind, template, descriptor, load? } — kind: a unique id that is not a built-in (card, table, tree, group); template: the widgentic template DSL (data SELECTS, you supply every literal; no expressions); descriptor: { description (required), dataSchema? | dataSchemaRef?, dataExample?, … }; load?: an http action binding run on first render. The designer validates it: applied → { ok: true, diagnostics } and the person sees it immediately; refused → { ok: false, code: 'REJECTED', errors } with the exact messages the designer shows. Keep the person's kind unless asked to change it. Nothing is saved by this tool: the person reviews the result in the designer and saves. TEMPLATE DSL (data, not code): nodes are a STRING, { bind } (text of a dot path; '.' = the scope; $root.x, $parent.x, $index, $meta.x), { each: "path", template, empty? }, { when: "path", template, else? }, or { tag, attrs?, children? }. Value transforms, ONE per value and always with bind: map { " ": " ", default? } (the value SELECTS a literal you wrote — semantic classes, status wording), prefix "mailto:" (attribute values only), format { type: number|currency|date|count|join|truncate|pluralize, decimals?, locale?, currency?, currencyDisplay?, pattern?, separator?, last?, field?, length?, ellipsis?, forms? } (render-time presentation, payload keeps the typed value; count/join/truncate/pluralize present lists and text, e.g. pluralize forms { one: "{count} item", other: "{count} items" }). A text bind may instead carry markdown: true (paragraphs, lists, emphasis, code, links — the parser chooses the tags, raw HTML stays text; never with map or format). Forbidden: script/iframe/object/embed/style/link/meta/base/template/noscript tags, on*/srcdoc attributes, non-https URLs (mailto:/tel: allowed on href), expressions of any kind. descriptor.description is REQUIRED; give dataShape and dataExample; dataSchema (type/properties/required/items/e…

Input schema

{
  "type": "object",
  "properties": {
    "definition": {
      "type": "object",
      "description": "The widget definition in export shape."
    }
  },
  "required": [
    "definition"
  ],
  "additionalProperties": false
}