@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/schemas/crucible-ts/design/tui/v1.0.0/color-palette.schema.json

@@ -0,0 +1,303 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/tui/v1.0.0/color-palette.schema.json",
+  "title": "TUI Color Palette",
+  "description": "Terminal color palette with capability-based fallback support (truecolor -> 256 -> 16 -> basic)",
+  "type": "object",
+  "$defs": {
+    "hexColor": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$",
+      "description": "6-digit hex color (truecolor capable terminals)"
+    },
+    "ansi256": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 255,
+      "description": "ANSI 256-color palette index"
+    },
+    "ansi16": {
+      "type": "string",
+      "enum": [
+        "black",
+        "red",
+        "green",
+        "yellow",
+        "blue",
+        "magenta",
+        "cyan",
+        "white",
+        "bright-black",
+        "bright-red",
+        "bright-green",
+        "bright-yellow",
+        "bright-blue",
+        "bright-magenta",
+        "bright-cyan",
+        "bright-white"
+      ],
+      "description": "ANSI 16-color name"
+    },
+    "basicColor": {
+      "type": "string",
+      "enum": [
+        "default",
+        "inverse"
+      ],
+      "description": "Basic terminal color (no color support)"
+    },
+    "terminalColor": {
+      "type": "object",
+      "description": "Terminal color with fallback chain",
+      "properties": {
+        "truecolor": {
+          "$ref": "#/$defs/hexColor",
+          "description": "24-bit color for modern terminals"
+        },
+        "ansi256": {
+          "$ref": "#/$defs/ansi256",
+          "description": "256-color fallback"
+        },
+        "ansi16": {
+          "$ref": "#/$defs/ansi16",
+          "description": "16-color fallback"
+        },
+        "basic": {
+          "$ref": "#/$defs/basicColor",
+          "description": "No-color fallback"
+        }
+      },
+      "required": [
+        "truecolor",
+        "ansi16"
+      ],
+      "additionalProperties": false
+    },
+    "semanticColorDefinition": {
+      "type": "object",
+      "description": "A semantic color with terminal-specific values",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Semantic role (references core/semantic-colors)"
+        },
+        "foreground": {
+          "$ref": "#/$defs/terminalColor",
+          "description": "Foreground/text color"
+        },
+        "background": {
+          "$ref": "#/$defs/terminalColor",
+          "description": "Background color"
+        },
+        "wcag_contrast_ratio": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 21,
+          "description": "Calculated contrast ratio between fg/bg"
+        }
+      },
+      "required": [
+        "role",
+        "foreground"
+      ]
+    },
+    "colorCapability": {
+      "type": "string",
+      "enum": [
+        "truecolor",
+        "256",
+        "16",
+        "basic"
+      ],
+      "description": "Terminal color capability level"
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the color palette"
+    },
+    "name": {
+      "type": "string",
+      "description": "Palette name (e.g., 'fulmen-dark', 'high-contrast')"
+    },
+    "description": {
+      "type": "string",
+      "description": "Palette description and intended use"
+    },
+    "min_capability": {
+      "$ref": "#/$defs/colorCapability",
+      "description": "Minimum terminal capability required for this palette"
+    },
+    "semantic_colors": {
+      "type": "object",
+      "description": "Semantic color definitions",
+      "properties": {
+        "primary": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "secondary": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "accent": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "success": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "warning": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "error": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "info": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        },
+        "muted": {
+          "$ref": "#/$defs/semanticColorDefinition"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/semanticColorDefinition"
+      }
+    },
+    "surface_colors": {
+      "type": "object",
+      "description": "Surface/background color definitions",
+      "properties": {
+        "background": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "surface": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "surface_elevated": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "surface_sunken": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "overlay": {
+          "$ref": "#/$defs/terminalColor"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/terminalColor"
+      }
+    },
+    "text_colors": {
+      "type": "object",
+      "description": "Text color definitions",
+      "properties": {
+        "primary": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "secondary": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "muted": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "inverse": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "link": {
+          "$ref": "#/$defs/terminalColor"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/terminalColor"
+      }
+    },
+    "border_colors": {
+      "type": "object",
+      "description": "Border color definitions",
+      "properties": {
+        "default": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "subtle": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "strong": {
+          "$ref": "#/$defs/terminalColor"
+        },
+        "focus": {
+          "$ref": "#/$defs/terminalColor"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/terminalColor"
+      }
+    },
+    "ansi_overrides": {
+      "type": "object",
+      "description": "Optional overrides for standard ANSI colors (for themed terminals)",
+      "properties": {
+        "black": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "red": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "green": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "yellow": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "blue": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "magenta": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "cyan": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "white": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_black": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_red": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_green": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_yellow": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_blue": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_magenta": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_cyan": {
+          "$ref": "#/$defs/hexColor"
+        },
+        "bright_white": {
+          "$ref": "#/$defs/hexColor"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "version",
+    "name",
+    "semantic_colors",
+    "surface_colors",
+    "text_colors"
+  ],
+  "additionalProperties": false
+}

package/schemas/crucible-ts/design/tui/v1.0.0/component.schema.json

@@ -0,0 +1,374 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/tui/v1.0.0/component.schema.json",
+  "title": "TUI Component Patterns",
+  "description": "Terminal UI component/widget patterns with state styling and extensibility",
+  "type": "object",
+  "$defs": {
+    "componentState": {
+      "type": "string",
+      "enum": [
+        "default",
+        "hover",
+        "focus",
+        "active",
+        "disabled",
+        "selected",
+        "error",
+        "success",
+        "loading"
+      ],
+      "description": "Component state (references core/component-states)"
+    },
+    "stateStyle": {
+      "type": "object",
+      "description": "Styling for a component state",
+      "properties": {
+        "foreground": {
+          "type": "string",
+          "description": "Foreground color reference (semantic or literal)"
+        },
+        "background": {
+          "type": "string",
+          "description": "Background color reference"
+        },
+        "border": {
+          "type": "string",
+          "description": "Border color reference"
+        },
+        "emphasis": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "bold",
+              "dim",
+              "italic",
+              "underline",
+              "inverse",
+              "strikethrough"
+            ]
+          },
+          "description": "Text emphasis attributes"
+        },
+        "prefix": {
+          "type": "string",
+          "description": "State indicator prefix"
+        },
+        "suffix": {
+          "type": "string",
+          "description": "State indicator suffix"
+        }
+      }
+    },
+    "componentDefinition": {
+      "type": "object",
+      "description": "A component type definition",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Component type identifier"
+        },
+        "description": {
+          "type": "string",
+          "description": "Component purpose and usage"
+        },
+        "states": {
+          "type": "object",
+          "description": "Styling for each state",
+          "additionalProperties": {
+            "$ref": "#/$defs/stateStyle"
+          }
+        },
+        "variants": {
+          "type": "object",
+          "description": "Component variants (e.g., size, intent)",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "states": {
+                "type": "object",
+                "additionalProperties": {
+                  "$ref": "#/$defs/stateStyle"
+                }
+              }
+            }
+          }
+        },
+        "anatomy": {
+          "type": "object",
+          "description": "Component parts/slots",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "required": {
+                "type": "boolean"
+              }
+            }
+          }
+        }
+      },
+      "required": [
+        "id",
+        "states"
+      ]
+    },
+    "buttonComponent": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "min_width": {
+              "type": "integer",
+              "description": "Minimum button width in columns"
+            },
+            "padding_horizontal": {
+              "type": "integer",
+              "description": "Horizontal padding in columns"
+            }
+          }
+        }
+      ]
+    },
+    "inputComponent": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "cursor_char": {
+              "type": "string",
+              "maxLength": 1,
+              "description": "Cursor character"
+            },
+            "placeholder_style": {
+              "$ref": "#/$defs/stateStyle"
+            },
+            "selection_style": {
+              "$ref": "#/$defs/stateStyle"
+            }
+          }
+        }
+      ]
+    },
+    "listComponent": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "item_prefix": {
+              "type": "string",
+              "description": "Prefix for list items"
+            },
+            "selected_prefix": {
+              "type": "string",
+              "description": "Prefix for selected item"
+            },
+            "scrollbar": {
+              "type": "object",
+              "properties": {
+                "track_char": {
+                  "type": "string",
+                  "maxLength": 1
+                },
+                "thumb_char": {
+                  "type": "string",
+                  "maxLength": 1
+                },
+                "position": {
+                  "type": "string",
+                  "enum": [
+                    "left",
+                    "right"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "tableComponent": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "header_style": {
+              "$ref": "#/$defs/stateStyle"
+            },
+            "row_alternate": {
+              "type": "boolean",
+              "description": "Alternate row styling"
+            },
+            "row_alternate_style": {
+              "$ref": "#/$defs/stateStyle"
+            },
+            "cell_padding": {
+              "type": "integer",
+              "description": "Cell padding in columns"
+            },
+            "border_style": {
+              "type": "string",
+              "enum": [
+                "none",
+                "ascii",
+                "single",
+                "double",
+                "rounded"
+              ],
+              "description": "Table border style"
+            }
+          }
+        }
+      ]
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the component patterns"
+    },
+    "components": {
+      "type": "object",
+      "description": "Component definitions by type",
+      "properties": {
+        "button": {
+          "$ref": "#/$defs/buttonComponent"
+        },
+        "input": {
+          "$ref": "#/$defs/inputComponent"
+        },
+        "select": {
+          "$ref": "#/$defs/inputComponent"
+        },
+        "checkbox": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "radio": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "toggle": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "list": {
+          "$ref": "#/$defs/listComponent"
+        },
+        "table": {
+          "$ref": "#/$defs/tableComponent"
+        },
+        "tabs": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "modal": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "toast": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "progress": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "spinner": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "tooltip": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "menu": {
+          "$ref": "#/$defs/listComponent"
+        },
+        "breadcrumb": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "panel": {
+          "$ref": "#/$defs/componentDefinition"
+        },
+        "card": {
+          "$ref": "#/$defs/componentDefinition"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/componentDefinition"
+      }
+    },
+    "focus_ring": {
+      "type": "object",
+      "description": "Focus indicator styling",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enum": [
+            "outline",
+            "background",
+            "underline",
+            "bracket"
+          ],
+          "description": "Focus indicator style"
+        },
+        "color": {
+          "type": "string",
+          "description": "Focus ring color reference"
+        },
+        "char_left": {
+          "type": "string",
+          "maxLength": 1,
+          "description": "Left bracket character (for bracket style)"
+        },
+        "char_right": {
+          "type": "string",
+          "maxLength": 1,
+          "description": "Right bracket character (for bracket style)"
+        }
+      }
+    },
+    "icons": {
+      "type": "object",
+      "description": "Component icon definitions",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "nerd_font": {
+            "type": "string"
+          },
+          "unicode": {
+            "type": "string"
+          },
+          "ascii": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "ascii"
+        ]
+      }
+    }
+  },
+  "required": [
+    "version",
+    "components"
+  ],
+  "additionalProperties": true
+}