@exponential-at/ui 0.0.0-stage → 0.1.0

package/catalog/basic-map.json

@@ -0,0 +1,104 @@
+{
+  "$comment": "VAPP-85 (D14): the ONE table from the A2UI basic catalog (vendor/a2ui/v0_9/basic_catalog.json) onto the core catalog. The reducer (src/reducer.ts, mirrored by the Rust core) applies it so painters never learn a second vocabulary; fixtures/catalog-basic-map.json locks the result. Per component: `to` = the core component, `props` = { coreProp: basicProp | {from, map?, default?} | {const} }, `children` = which basic field holds the child ids (`children` | `child`), `transform` = a NAMED structural step the reducer implements in code (listed under `transforms`, with what it does, so a second implementation knows the rules). A2UI dynamic values (`{path}` bindings, function calls) pass through untouched. `icons` maps the basic Icon names onto icons.json names (concept ids or registry Lucide names); `null` = no equivalent in the registry, painted as the placeholder icon `ui-icon-placeholder`. `functions` = identity, the core catalog exposes the same 14. A basic component absent from `components` becomes the `Unknown` placeholder (never an error).",
+  "from": "https://a2ui.org/specification/v0_9/basic_catalog.json",
+  "to": "https://ui.exponential.at/catalogs/core/v1",
+  "version": "v0.9",
+  "placeholderIcon": "ui-icon-placeholder",
+  "components": {
+    "Text": { "to": "Text", "props": { "text": "text" }, "transform": "textVariant" },
+    "Image": { "to": "Image", "props": { "src": "url", "alt": { "from": "description", "default": "" }, "fit": { "from": "fit", "default": "cover" } }, "transform": "imageVariant" },
+    "Icon": { "to": "Icon", "props": {}, "transform": "iconName" },
+    "Video": { "to": "Video", "props": { "src": "url" } },
+    "AudioPlayer": { "to": "AudioPlayer", "props": { "src": "url", "title": "description" } },
+    "Row": { "to": "Stack", "children": "children", "props": { "direction": { "const": "horizontal" }, "justify": { "from": "justify", "map": { "spaceBetween": "between", "spaceAround": "around", "spaceEvenly": "evenly", "stretch": "start" }, "default": "start" }, "align": { "from": "align", "default": "stretch" }, "gap": { "const": "sm" } } },
+    "Column": { "to": "Stack", "children": "children", "props": { "direction": { "const": "vertical" }, "justify": { "from": "justify", "map": { "spaceBetween": "between", "spaceAround": "around", "spaceEvenly": "evenly", "stretch": "start" }, "default": "start" }, "align": { "from": "align", "default": "stretch" }, "gap": { "const": "sm" } } },
+    "List": { "to": "List", "children": "children", "props": { "direction": { "from": "direction", "default": "vertical" }, "gap": { "const": "sm" } } },
+    "Card": { "to": "Card", "children": "child", "props": {} },
+    "Tabs": { "to": "Tabs", "props": {}, "transform": "tabs" },
+    "Modal": { "to": "Dialog", "props": {}, "transform": "modal" },
+    "Divider": { "to": "Separator", "props": { "orientation": { "from": "axis", "default": "horizontal" } } },
+    "Button": { "to": "Button", "props": { "variant": { "from": "variant", "map": { "primary": "default", "default": "secondary", "borderless": "ghost" }, "default": "secondary" } }, "transform": "buttonChild" },
+    "TextField": { "to": "Input", "props": { "label": "label", "value": "value", "checks": "checks" }, "transform": "textField" },
+    "CheckBox": { "to": "Checkbox", "props": { "label": "label", "checked": "value", "checks": "checks" }, "transform": "fieldName" },
+    "ChoicePicker": { "to": "Radio", "props": { "label": "label", "options": "options", "checks": "checks" }, "transform": "choicePicker" },
+    "Slider": { "to": "Slider", "props": { "label": "label", "min": { "from": "min", "default": 0 }, "max": "max", "value": "value" } },
+    "DateTimeInput": { "to": "DatePicker", "props": { "label": "label", "value": "value", "min": "min", "max": "max" }, "transform": "fieldName" }
+  },
+  "transforms": {
+    "textVariant": "variant h1..h4 → Heading{level}; h5 → Text{variant: label}; caption → Text{variant: caption}; body or absent → Text{variant: body}.",
+    "imageVariant": "variant avatar → Avatar{src: url, name: description}; icon → style width/height 24; smallFeature → style width/height 120; mediumFeature or absent → style width 100%, aspectRatio 1.7777778; largeFeature → the same; header → style width 100%, aspectRatio 3.",
+    "iconName": "name string → icons[name] (null or absent → placeholderIcon); name {path} (a custom glyph) → placeholderIcon.",
+    "tabs": "tabs[i] → props.tabs[i] = {label: title, value: child id}; children = the tab child ids in order; value = the first tab's child id.",
+    "modal": "trigger → slots.trigger; content → children[0]; props.open = false.",
+    "buttonChild": "child Text → props.label = its text (the Text node is consumed); child Icon → props.icon = the mapped icon name (consumed); any other child → children[0]; action → on.press (an A2UI Action verbatim); size icon when icon and no label.",
+    "textField": "name = id; variant longText → Textarea{label, value, checks}; number → Input{type: number}; obscured → Input{type: password}; shortText or absent → Input{type: text}; validationRegexp → one more check {condition: {call: regex, args: {value: {path: <the value binding's path, or the id>}, pattern}}, message: 'Invalid value'}.",
+    "fieldName": "name = id.",
+    "choicePicker": "name = id; options keep label/value; value (a list) → the first entry for single choice, comma-joined for multiple; filterable → Select{searchable: true, multiple: variant == multipleSelection}; else displayStyle chips → Segmented{type: single|multiple by variant, variant: outline, items: options}; else variant multipleSelection → Select{multiple: true}; else → Radio."
+  },
+  "icons": {
+    "accountCircle": "ui-assignee",
+    "add": "ui-add",
+    "arrowBack": "ui-back",
+    "arrowForward": "ui-arrow-right",
+    "attachFile": "ui-attach",
+    "calendarToday": "calendar",
+    "call": "phone",
+    "camera": "camera",
+    "check": "ui-check",
+    "close": "ui-close",
+    "delete": "ui-delete",
+    "download": "ui-download",
+    "edit": "ui-edit",
+    "event": "ui-due-date",
+    "error": "ui-error",
+    "fastForward": "media-fast-forward",
+    "favorite": "heart",
+    "favoriteOff": "ui-favorite-off",
+    "folder": "ui-folder",
+    "help": "ui-help",
+    "home": "house",
+    "info": "ui-info",
+    "locationOn": "map-pin",
+    "lock": "ui-private",
+    "lockOpen": "ui-unlock",
+    "mail": "ui-mail",
+    "menu": "ui-menu",
+    "moreVert": "ui-more-vertical",
+    "moreHoriz": "ui-more",
+    "notificationsOff": "ui-unsubscribe",
+    "notifications": "ui-subscribe",
+    "pause": "run-pause",
+    "payment": "credit-card",
+    "person": "ui-avatar-placeholder",
+    "phone": "smartphone",
+    "photo": "image",
+    "play": "action-run",
+    "print": "ui-print",
+    "refresh": "ui-refresh",
+    "rewind": "media-rewind",
+    "search": "nav-search",
+    "send": "ui-send",
+    "settings": "nav-settings",
+    "share": "ui-share",
+    "shoppingCart": "shopping-cart",
+    "skipNext": "media-skip-next",
+    "skipPrevious": "media-skip-previous",
+    "star": "star",
+    "starHalf": "ui-star-half",
+    "starOff": "ui-star-off",
+    "stop": "ui-stop",
+    "upload": "sc-push",
+    "visibility": "ui-watch",
+    "visibilityOff": "ui-hide",
+    "volumeDown": "media-volume-down",
+    "volumeMute": "media-volume-mute",
+    "volumeOff": "media-volume-off",
+    "volumeUp": "media-volume-up",
+    "warning": "ui-warning"
+  },
+  "functions": {
+    "required": "required", "regex": "regex", "length": "length", "numeric": "numeric", "email": "email",
+    "formatString": "formatString", "formatNumber": "formatNumber", "formatCurrency": "formatCurrency",
+    "formatDate": "formatDate", "pluralize": "pluralize", "openUrl": "openUrl", "and": "and", "or": "or", "not": "not"
+  }
+}

package/catalog/code.json

@@ -0,0 +1,58 @@
+{
+  "$comment": "Round 1 (docs/round-1-contract.md §3, CodeBlock): the BUILT-IN tokenizer every renderer mirrors so a CodeBlock colours the same on every platform (a host may still supply its own tokenizer; its kinds must be the `codeToken` enum). ONE scanner over the source (CRLF → LF), first rule that matches at the position wins: (1) `lineKinds` — at a line start (after spaces/tabs) a listed prefix makes the rest of the line that kind; (2) `lineComment` prefixes → comment to the end of the line; (3) `blockComment` [open, close] pairs → comment through close (or the end); (4) a quote in `strings` → string through the same unescaped quote (`\\` escapes the next char), stopping before a line break unless the quote is in `multiline`; with `keyStrings` a string followed by optional spaces and `:` is a `property`; (5) with `markup`, `<` followed by a letter, `/` or `!` opens a tag: `<`/`</` punctuation, the name `tag`, then whitespace plain, quotes string, `=` operator, names `attribute`, until `>`/`/>` punctuation (text outside tags is plain); (6) numbers (unless `numbers` is false): a digit, or `.` before a digit, then every [0-9A-Za-z_.]; (7) identifiers: [A-Za-z_$] plus `identExtra`, then the same plus digits: `keywords` (lower-cased first when `caseInsensitive`) → keyword; with `keyIdents` followed by spaces and a single `:` → property; followed by spaces and `(` → function; right after a `.` punctuation → property; in `typeNames` or (with `types: capitalized`) starting A–Z → type; else plain; (8) a run of spaces/tabs → plain; (9) a run of `operators` chars → operator; (10) one `punctuation` char → punctuation; (11) anything else, one char → plain. Then tokens split at line breaks into LINES and adjacent tokens of one kind merge; a line's tokens concatenate to exactly its text. src/code.ts is the reference, fixtures/code-tokens.json locks it. EXP-1324 `ansi` (the Terminal pattern: command output): BEFORE the scanner, every ANSI CSI escape (ESC `[` params 0x30-0x3F, intermediates 0x20-0x2F, one final 0x40-0x7E) is REMOVED from the source and the remaining text is split into runs by SGR (final `m`) colour: params 31/91 → `error`, 32/92 → `success`, 33/93 → `warning`, 2/90 → `comment`, 0/39/none → no colour, every other param leaves the colour as it was (params apply left to right). A run WITH a colour is that kind, verbatim (no rules). Runs without a colour go through the ordinary scanner with this language spec — which has only `lineKinds` (longest listed prefix wins), so an uncoloured line is either one lineKinds kind from its prefix on, or plain. Tokens then split into lines and merge as usual. The escapes never reach the text: a line's tokens concatenate to its text WITHOUT them (copy copies that text).",
+  "defaults": { "operators": "+-*/%=&|<>!?^~:@#", "punctuation": "()[]{},.;" },
+  "languages": {
+    "plain": { "plain": true },
+    "json": { "strings": ["\""], "keywords": ["true", "false", "null"], "keyStrings": true },
+    "js": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\"", "'", "`"], "multiline": ["`"], "types": "capitalized",
+      "keywords": ["async", "await", "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete", "do", "else", "export", "extends", "false", "finally", "for", "from", "function", "if", "import", "in", "instanceof", "let", "new", "null", "of", "return", "static", "super", "switch", "this", "throw", "true", "try", "typeof", "undefined", "var", "void", "while", "with", "yield"]
+    },
+    "ts": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\"", "'", "`"], "multiline": ["`"], "types": "capitalized",
+      "typeNames": ["any", "bigint", "boolean", "never", "number", "object", "string", "symbol", "unknown"],
+      "keywords": ["abstract", "as", "async", "await", "break", "case", "catch", "class", "const", "continue", "declare", "default", "delete", "do", "else", "enum", "export", "extends", "false", "finally", "for", "from", "function", "if", "implements", "import", "in", "infer", "instanceof", "interface", "is", "keyof", "let", "namespace", "new", "null", "of", "private", "protected", "public", "readonly", "return", "satisfies", "static", "super", "switch", "this", "throw", "true", "try", "type", "typeof", "undefined", "var", "void", "while", "yield"]
+    },
+    "tsx": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\"", "'", "`"], "multiline": ["`"], "types": "capitalized",
+      "typeNames": ["any", "bigint", "boolean", "never", "number", "object", "string", "symbol", "unknown"],
+      "keywords": ["abstract", "as", "async", "await", "break", "case", "catch", "class", "const", "continue", "declare", "default", "delete", "do", "else", "enum", "export", "extends", "false", "finally", "for", "from", "function", "if", "implements", "import", "in", "infer", "instanceof", "interface", "is", "keyof", "let", "namespace", "new", "null", "of", "private", "protected", "public", "readonly", "return", "satisfies", "static", "super", "switch", "this", "throw", "true", "try", "type", "typeof", "undefined", "var", "void", "while", "yield"]
+    },
+    "rust": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\""], "multiline": ["\""], "types": "capitalized",
+      "typeNames": ["bool", "char", "f32", "f64", "i8", "i16", "i32", "i64", "i128", "isize", "str", "u8", "u16", "u32", "u64", "u128", "usize"],
+      "keywords": ["as", "async", "await", "break", "const", "continue", "crate", "dyn", "else", "enum", "extern", "false", "fn", "for", "if", "impl", "in", "let", "loop", "match", "mod", "move", "mut", "pub", "ref", "return", "self", "Self", "static", "struct", "super", "trait", "true", "type", "unsafe", "use", "where", "while"]
+    },
+    "swift": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\""], "types": "capitalized",
+      "keywords": ["any", "as", "associatedtype", "async", "await", "break", "case", "catch", "class", "continue", "default", "defer", "do", "else", "enum", "extension", "fallthrough", "false", "for", "func", "guard", "if", "import", "in", "init", "inout", "internal", "is", "let", "nil", "private", "protocol", "public", "repeat", "rethrows", "return", "self", "Self", "some", "static", "struct", "subscript", "super", "switch", "throw", "throws", "true", "try", "typealias", "var", "where", "while"]
+    },
+    "kotlin": {
+      "lineComment": ["//"], "blockComment": [["/*", "*/"]], "strings": ["\"", "'"], "types": "capitalized",
+      "keywords": ["as", "break", "by", "catch", "class", "companion", "constructor", "continue", "data", "do", "else", "enum", "false", "finally", "for", "fun", "if", "import", "in", "init", "interface", "internal", "is", "lateinit", "null", "object", "open", "override", "package", "private", "protected", "public", "return", "sealed", "super", "suspend", "this", "throw", "true", "try", "typealias", "val", "var", "when", "while"]
+    },
+    "python": {
+      "lineComment": ["#"], "strings": ["\"", "'"], "types": "capitalized",
+      "keywords": ["False", "None", "True", "and", "as", "assert", "async", "await", "break", "class", "continue", "def", "del", "elif", "else", "except", "finally", "for", "from", "global", "if", "import", "in", "is", "lambda", "nonlocal", "not", "or", "pass", "raise", "return", "self", "try", "while", "with", "yield"]
+    },
+    "bash": {
+      "lineComment": ["#"], "strings": ["\"", "'"], "multiline": ["\"", "'"],
+      "keywords": ["case", "do", "done", "echo", "elif", "else", "esac", "exit", "export", "fi", "for", "function", "if", "in", "local", "readonly", "return", "then", "until", "while"]
+    },
+    "html": { "markup": true, "blockComment": [["<!--", "-->"]], "strings": ["\"", "'"], "numbers": false },
+    "css": {
+      "blockComment": [["/*", "*/"]], "strings": ["\"", "'"], "identExtra": "-@", "keyIdents": true, "operators": "+*/%=&|<>!?^~:#",
+      "keywords": ["@container", "@font-face", "@import", "@keyframes", "@layer", "@media", "@supports", "auto", "important", "inherit", "initial", "none", "unset"]
+    },
+    "sql": {
+      "lineComment": ["--"], "blockComment": [["/*", "*/"]], "strings": ["'", "\""], "caseInsensitive": true,
+      "keywords": ["all", "alter", "and", "as", "asc", "between", "by", "case", "create", "default", "delete", "desc", "distinct", "drop", "else", "end", "exists", "foreign", "from", "group", "having", "in", "index", "inner", "insert", "into", "is", "join", "key", "left", "like", "limit", "not", "null", "offset", "on", "or", "order", "outer", "primary", "references", "returning", "right", "select", "set", "table", "then", "union", "update", "values", "when", "where", "with"]
+    },
+    "yaml": { "lineComment": ["#"], "strings": ["\"", "'"], "keyIdents": true, "identExtra": "-", "keywords": ["true", "false", "null", "yes", "no"] },
+    "markdown": { "lineKinds": { "#": "keyword", ">": "comment" }, "strings": ["`"], "numbers": false, "operators": "", "punctuation": "" },
+    "ansi": {
+      "ansi": true, "numbers": false, "operators": "", "punctuation": "",
+      "lineKinds": { "$ ": "comment", "> ": "comment", "BUILD SUCCESSFUL": "success", "BUILD FAILED": "error", "PASS ": "success", "FAIL ": "error", "FAILED": "error", "(pass)": "success", "(fail)": "error", "test result: ok": "success", "test result: FAILED": "error", "error:": "error", "error[": "error", "Error:": "error", "warning:": "warning", "✓": "success", "✔": "success", "✗": "error", "✘": "error" }
+    }
+  }
+}