@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/schemas/crucible-ts/design/core/v1.0.0/semantic-colors.schema.json

@@ -0,0 +1,179 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/core/v1.0.0/semantic-colors.schema.json",
+  "title": "Semantic Color Vocabulary",
+  "description": "Universal semantic color roles for design systems. Implementation-agnostic vocabulary shared across TUI and web contexts.",
+  "type": "object",
+  "$defs": {
+    "semanticColorRole": {
+      "type": "string",
+      "enum": [
+        "primary",
+        "secondary",
+        "accent",
+        "success",
+        "warning",
+        "error",
+        "info",
+        "muted"
+      ],
+      "description": "Standard semantic color roles"
+    },
+    "surfaceRole": {
+      "type": "string",
+      "enum": [
+        "background",
+        "surface",
+        "surface-elevated",
+        "surface-sunken",
+        "overlay"
+      ],
+      "description": "Surface/background color roles"
+    },
+    "textRole": {
+      "type": "string",
+      "enum": [
+        "text-primary",
+        "text-secondary",
+        "text-muted",
+        "text-inverse",
+        "text-link",
+        "text-on-primary",
+        "text-on-secondary",
+        "text-on-accent"
+      ],
+      "description": "Text color roles for different contexts"
+    },
+    "borderRole": {
+      "type": "string",
+      "enum": [
+        "border-default",
+        "border-subtle",
+        "border-strong",
+        "border-focus",
+        "border-error"
+      ],
+      "description": "Border color roles"
+    },
+    "interactiveRole": {
+      "type": "string",
+      "enum": [
+        "interactive-default",
+        "interactive-hover",
+        "interactive-active",
+        "interactive-disabled"
+      ],
+      "description": "Interactive element state colors"
+    },
+    "contrastRequirement": {
+      "type": "object",
+      "description": "WCAG contrast ratio requirements",
+      "properties": {
+        "level": {
+          "type": "string",
+          "enum": [
+            "AA",
+            "AAA"
+          ],
+          "description": "WCAG conformance level"
+        },
+        "min_ratio": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 21,
+          "description": "Minimum contrast ratio (e.g., 4.5 for AA normal text)"
+        },
+        "context": {
+          "type": "string",
+          "enum": [
+            "normal-text",
+            "large-text",
+            "ui-component",
+            "graphical"
+          ],
+          "description": "Context for contrast requirement"
+        }
+      },
+      "required": [
+        "level",
+        "min_ratio",
+        "context"
+      ]
+    },
+    "colorIntent": {
+      "type": "object",
+      "description": "Semantic intent and accessibility metadata for a color",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Semantic role from one of the role enums"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of when to use this color"
+        },
+        "pairs_with": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Recommended color roles to pair with (for contrast)"
+        },
+        "wcag_contrast": {
+          "$ref": "#/$defs/contrastRequirement"
+        }
+      },
+      "required": [
+        "role"
+      ]
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the color vocabulary"
+    },
+    "semantic_roles": {
+      "type": "array",
+      "description": "Defined semantic color roles with metadata",
+      "items": {
+        "$ref": "#/$defs/colorIntent"
+      }
+    },
+    "surface_roles": {
+      "type": "array",
+      "description": "Defined surface/background roles",
+      "items": {
+        "$ref": "#/$defs/colorIntent"
+      }
+    },
+    "text_roles": {
+      "type": "array",
+      "description": "Defined text color roles",
+      "items": {
+        "$ref": "#/$defs/colorIntent"
+      }
+    },
+    "border_roles": {
+      "type": "array",
+      "description": "Defined border color roles",
+      "items": {
+        "$ref": "#/$defs/colorIntent"
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Implementation-specific extensions (TUI, web)",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "version"
+  ],
+  "additionalProperties": false
+}

package/schemas/crucible-ts/design/core/v1.0.0/spacing-scale.schema.json

@@ -0,0 +1,165 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/core/v1.0.0/spacing-scale.schema.json",
+  "title": "Spacing Scale Vocabulary",
+  "description": "Universal spacing and sizing scale for design systems. Implementation-agnostic vocabulary shared across TUI and web contexts.",
+  "type": "object",
+  "$defs": {
+    "spacingToken": {
+      "type": "string",
+      "enum": [
+        "none",
+        "3xs",
+        "2xs",
+        "xs",
+        "sm",
+        "md",
+        "lg",
+        "xl",
+        "2xl",
+        "3xl"
+      ],
+      "description": "Standard spacing scale tokens"
+    },
+    "sizeToken": {
+      "type": "string",
+      "enum": [
+        "xs",
+        "sm",
+        "md",
+        "lg",
+        "xl",
+        "full"
+      ],
+      "description": "Component size tokens"
+    },
+    "spacingDefinition": {
+      "type": "object",
+      "description": "A spacing token definition with semantic meaning",
+      "properties": {
+        "token": {
+          "$ref": "#/$defs/spacingToken"
+        },
+        "description": {
+          "type": "string",
+          "description": "When to use this spacing value"
+        },
+        "use_cases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Example use cases for this token"
+        }
+      },
+      "required": [
+        "token"
+      ]
+    },
+    "responsiveTier": {
+      "type": "string",
+      "enum": [
+        "compact",
+        "default",
+        "comfortable",
+        "spacious"
+      ],
+      "description": "Responsive density tiers"
+    },
+    "breakpointDefinition": {
+      "type": "object",
+      "description": "Abstract breakpoint definition (implementation provides units)",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Breakpoint name"
+        },
+        "tier": {
+          "$ref": "#/$defs/responsiveTier"
+        },
+        "description": {
+          "type": "string",
+          "description": "When this breakpoint applies"
+        }
+      },
+      "required": [
+        "name",
+        "tier"
+      ]
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the spacing vocabulary"
+    },
+    "spacing_tokens": {
+      "type": "array",
+      "description": "Defined spacing tokens with metadata",
+      "items": {
+        "$ref": "#/$defs/spacingDefinition"
+      }
+    },
+    "size_tokens": {
+      "type": "array",
+      "description": "Defined size tokens for components",
+      "items": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "$ref": "#/$defs/sizeToken"
+          },
+          "description": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "token"
+        ]
+      }
+    },
+    "breakpoints": {
+      "type": "array",
+      "description": "Responsive breakpoint definitions",
+      "items": {
+        "$ref": "#/$defs/breakpointDefinition"
+      }
+    },
+    "density_scale": {
+      "type": "object",
+      "description": "How spacing scales across density tiers",
+      "properties": {
+        "compact": {
+          "type": "number",
+          "description": "Multiplier for compact density (e.g., 0.75)"
+        },
+        "default": {
+          "type": "number",
+          "description": "Multiplier for default density (1.0)"
+        },
+        "comfortable": {
+          "type": "number",
+          "description": "Multiplier for comfortable density (e.g., 1.25)"
+        },
+        "spacious": {
+          "type": "number",
+          "description": "Multiplier for spacious density (e.g., 1.5)"
+        }
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Implementation-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "version"
+  ],
+  "additionalProperties": false
+}

package/schemas/crucible-ts/design/core/v1.0.0/typography-roles.schema.json

@@ -0,0 +1,195 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/core/v1.0.0/typography-roles.schema.json",
+  "title": "Typography Roles Vocabulary",
+  "description": "Universal typographic semantic roles for design systems. Implementation-agnostic vocabulary shared across TUI and web contexts.",
+  "type": "object",
+  "$defs": {
+    "textRole": {
+      "type": "string",
+      "enum": [
+        "display",
+        "headline",
+        "title",
+        "subtitle",
+        "body",
+        "body-emphasis",
+        "caption",
+        "overline",
+        "code",
+        "code-block",
+        "label",
+        "button"
+      ],
+      "description": "Semantic text roles"
+    },
+    "fontWeight": {
+      "type": "string",
+      "enum": [
+        "thin",
+        "light",
+        "regular",
+        "medium",
+        "semibold",
+        "bold",
+        "extrabold"
+      ],
+      "description": "Font weight tokens (implementation maps to numeric values)"
+    },
+    "textEmphasis": {
+      "type": "string",
+      "enum": [
+        "normal",
+        "italic",
+        "bold",
+        "bold-italic",
+        "underline",
+        "strikethrough",
+        "dim",
+        "inverse"
+      ],
+      "description": "Text emphasis/decoration styles"
+    },
+    "textAlignment": {
+      "type": "string",
+      "enum": [
+        "start",
+        "center",
+        "end",
+        "justify"
+      ],
+      "description": "Text alignment (direction-agnostic)"
+    },
+    "textTransform": {
+      "type": "string",
+      "enum": [
+        "none",
+        "uppercase",
+        "lowercase",
+        "capitalize"
+      ],
+      "description": "Text transformation"
+    },
+    "typographyRoleDefinition": {
+      "type": "object",
+      "description": "A typography role definition with semantic meaning",
+      "properties": {
+        "role": {
+          "$ref": "#/$defs/textRole"
+        },
+        "description": {
+          "type": "string",
+          "description": "When to use this typography role"
+        },
+        "semantic_level": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 6,
+          "description": "Heading level for accessibility (1-6, optional for non-headings)"
+        },
+        "default_weight": {
+          "$ref": "#/$defs/fontWeight"
+        },
+        "default_emphasis": {
+          "$ref": "#/$defs/textEmphasis"
+        },
+        "use_cases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Example use cases"
+        }
+      },
+      "required": [
+        "role"
+      ]
+    },
+    "lineHeightToken": {
+      "type": "string",
+      "enum": [
+        "tight",
+        "snug",
+        "normal",
+        "relaxed",
+        "loose"
+      ],
+      "description": "Line height tokens"
+    },
+    "letterSpacingToken": {
+      "type": "string",
+      "enum": [
+        "tighter",
+        "tight",
+        "normal",
+        "wide",
+        "wider",
+        "widest"
+      ],
+      "description": "Letter spacing tokens"
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the typography vocabulary"
+    },
+    "text_roles": {
+      "type": "array",
+      "description": "Defined typography roles with metadata",
+      "items": {
+        "$ref": "#/$defs/typographyRoleDefinition"
+      }
+    },
+    "font_weights": {
+      "type": "array",
+      "description": "Available font weights",
+      "items": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "$ref": "#/$defs/fontWeight"
+          },
+          "description": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "token"
+        ]
+      }
+    },
+    "line_heights": {
+      "type": "array",
+      "description": "Line height tokens",
+      "items": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "$ref": "#/$defs/lineHeightToken"
+          },
+          "description": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "token"
+        ]
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Implementation-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "version"
+  ],
+  "additionalProperties": false
+}