@tenerife.music/ui 4.0.0 → 5.0.0

package/README.md

@@ -1,379 +1,28 @@
-# Engine UI
+# @tenerife.music/ui — DEPRECATED
 
-### The UI Engine for AI Interfaces
+> **This package is deprecated and no longer maintained.**
+>
+> All imports will throw a runtime error.
 
-**Token-driven. Deterministic. Built for AI interfaces.**
+## Migration
 
-![Release](https://img.shields.io/badge/release-v3.2.0-blue?style=for-the-badge)
-![npm version](https://img.shields.io/badge/npm-v3.2.0-blue?style=for-the-badge)
-![React](https://img.shields.io/badge/React-18+-blue?style=for-the-badge)
-![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue?style=for-the-badge)
-![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3.4-38b2ac?style=for-the-badge)
-![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
-
-Turn AI output into **safe, deterministic user interfaces**.
-
-Engine UI is a deterministic execution layer that converts **AI-generated UI intent** into **validated React interfaces**.
-
-AI can suggest UI.  
-Engine UI decides what is **safe and architecture-compliant to render**.
-
-The canonical structural type for engine layout output is `UIIRNode` (UI-IR terminology).
-
----
-
-## Engine UI execution pipeline
-
-```mermaid
-flowchart LR
-    A[AI / User Input]
-    B[Intent<br/>DSL / IntentContract / LayoutIntent]
-    C[Planner]
-    D[UI-IR<br/>layoutTree<br/>Canonical engine representation]
-    E[intentSchema<br/>Derived deterministic compile format]
-    F[Validation]
-    G[Compiler]
-    H[Renderer]
-    I[React JSX / Runtime]
-    J[Direct DSL / intentSchema compatibility path]
-    K[Synthetic UI-IR reconstruction]
-
-    A --> B --> C --> D --> E --> F --> G --> H --> I
-    J --> K --> F
-
-    classDef canonical fill:#dff6dd,stroke:#1f6f43,stroke-width:2px,color:#123524;
-    classDef derived fill:#fff4cc,stroke:#8a6700,stroke-width:1.5px,color:#4d3b00;
-    class D canonical;
-    class E derived;
-```
-
-`UI-IR (layoutTree)` is the canonical engine representation. `intentSchema` is a derived deterministic compile format, not a competing architectural layer. Direct `dsl` and `intentSchema` execution paths are compatibility paths that reconstruct synthetic UI-IR before compilation.
-
----
-
-## Why Engine UI exists
-
-AI can generate UI.
-
-But raw AI output is unsafe.
-
-It can:
-
-- break layout rules
-- violate component boundaries
-- generate invalid props
-- drift away from design tokens
-- slowly destroy architectural consistency
-
-Engine UI solves this by adding a deterministic execution layer between AI output and the final interface.
-
-Instead of trusting arbitrary generated component trees, Engine UI validates structure, enforces architectural rules, and renders only safe UI.
-
----
-
-## From AI output to safe UI
-
-AI output should not go directly into production UI.
-
-Engine UI takes structured intent and turns it into a validated component tree.
-
-### AI Output
-
-```json
-{
-  "type": "grid",
-  "columns": { "md": 2, "lg": 3 },
-  "items": [
-    { "component": "eventCard" },
-    { "component": "eventCard" },
-    { "component": "eventCard" }
-  ]
-}
-```
-
-### Engine UI Rendering
-
-```tsx
-<Grid columns={{ md: 2, lg: 3 }}>
-  <EventCard />
-  <EventCard />
-  <EventCard />
-</Grid>
-```
-
-The important part is not that AI generated UI.
-
-The important part is that the result is **safe, predictable, and architecture-compliant**.
-
----
-
-## Quick Start
-
-### Install
+Use [`@engine-ui/core`](https://www.npmjs.com/package/@engine-ui/core) instead.
 
 ```bash
-pnpm add @tenerife.music/ui
-```
-
-or
-
-```bash
-npm install @tenerife.music/ui
-```
-
-### Minimal Example
-
-```tsx
-import "@tenerife.music/ui/styles";
-import { Button, Stack, Text } from "@tenerife.music/ui";
-import { ThemeProvider } from "@tenerife.music/ui/theme";
-
-export default function App() {
-  return (
-    <ThemeProvider defaultMode="night">
-      <Stack gap="md">
-        <Text>AI-native UI</Text>
-        <Button variant="primary">Run</Button>
-      </Stack>
-    </ThemeProvider>
-  );
-}
-```
-
----
-
-## The core idea
-
-Traditional UI systems assume humans write interfaces.
-
-Engine UI assumes AI may generate them.
-
-That changes the requirements completely.
-
-You need:
-
-- deterministic rendering
-- architectural boundaries
-- token-safe styling
-- machine-readable validation
-- constrained execution
-
-Engine UI is built around those requirements.
-
----
-
-## How it works
-
-Engine UI runs a deterministic UI execution pipeline:
-
-`AI / User Input → Intent → Planner → UI-IR (layoutTree) → intentSchema → Validation → Compiler → Renderer → Runtime`
-
-AI generates intent.  
-Engine UI decides what is valid to render.
-
-If the structure is invalid, the system fails with structured diagnostics instead of producing unsafe UI.
-
----
-
-## What Engine UI guarantees
-
-- deterministic UI output
-- architecture-safe rendering
-- token-driven visual constraints
-- bounded public surface
-- machine-readable validation failures
-- safe integration with AI systems
-
-This is not just a component library.
-
-It is a runtime layer for AI-generated interfaces.
-
----
-
-## Where Engine UI fits in the stack
-
-```
-AI Prompt
-↓
-Intent
-↓
-Engine UI
-↓
-React
-↓
-DOM
-```
-
-Engine UI sits between **AI generation** and **React rendering**.
-
----
-
-## Why not just React?
-
-The difference is not React vs components.
-
-The difference is **unbounded generation vs controlled execution**.
-
-|                           | Raw AI → React | AI → Engine UI → React |
-| ------------------------- | -------------- | ---------------------- |
-| Flexibility               | High           | Controlled             |
-| Safety                    | Low            | High                   |
-| Architecture drift        | Likely         | Constrained            |
-| Token enforcement         | Optional       | Built-in               |
-| Deterministic output      | No             | Yes                    |
-| Machine-readable failures | No             | Yes                    |
-
-React lets you build anything.
-
-Engine UI decides what AI is allowed to build safely.
-
----
-
-## Deterministic architecture
-
-Engine UI runs inside a closed execution model.
-
-Key guarantees:
-
-| Property                    | Guarantee                                                  |
-| --------------------------- | ---------------------------------------------------------- |
-| Closed props                | No `className` / `style` escape hatches in public surfaces |
-| Token-only styling          | Visual values come from finite token vocabularies          |
-| Controlled DOM passthrough  | Native attributes go through sanctioned gates              |
-| Deterministic SSR           | Stable rendering behavior                                  |
-| Machine-readable violations | TypeScript, ESLint, and runtime diagnostics                |
-
----
-
-## Architecture / Overview
-
-Engine UI is a deterministic AI-native UI execution layer built on top of the Tenerife UI architecture system.
-
-The system converts AI-generated UI intent into validated runtime UI through a deterministic pipeline:
-
-`AI Prompt -> Intent -> UI-IR -> Validation -> Compiler -> Renderer -> React Runtime`
-
-Tenerife UI provides:
-
-- the component architecture
-- token system
-- composition primitives
-- governance and validation rules
-
-Engine UI provides:
-
-- AI intent interpretation
-- UI-IR generation
-- deterministic compilation pipeline
-
-Engine UI is the AI execution layer.
-
-Tenerife UI is the architecture system.
-
-Engine UI does not replace the Tenerife UI architecture. It executes AI-generated intent within Tenerife UI's architectural constraints.
-
----
-
-## Architecture layers
-
-```
-FOUNDATION
-PRIMITIVES
-COMPOSITION
-PATTERNS
-DOMAIN
+npm uninstall @tenerife.music/ui
+npm install @engine-ui/core
 ```
 
-Rules:
-
-- lower layers cannot import higher layers
-- Foundation is immutable
-- token domains stay isolated
-- architecture boundaries are enforced
-
----
-
-## Architecture Score Engine
-
-Engine UI includes a built-in architecture scoring system.
-
-It aggregates:
-
-- ESLint architecture violations
-- governance checks
-- runtime diagnostics
-
-Example result:
-
-```
-Architecture Score: 100 / 100
-```
-
-CI can block merges if architecture health drops.
-
-This makes Engine UI feel less like a library and more like a structural integrity system for UI.
-
----
-
-## Comparison
-
-| Capability                  | Component Libraries | Engine UI |
-| --------------------------- | ------------------- | --------- |
-| Provide UI components       | ✅                  | ✅        |
-| Enforce architecture rules  | ❌                  | ✅        |
-| Deterministic UI execution  | ❌                  | ✅        |
-| Safe AI UI generation       | ❌                  | ✅        |
-| Machine-readable violations | ❌                  | ✅        |
-
-Component libraries provide components.
-
-Engine UI provides **deterministic UI execution for AI-generated interfaces**.
-
----
-
-## Use cases
-
-Engine UI is designed for teams building:
-
-- AI copilots
-- agent dashboards
-- AI-generated product interfaces
-- dynamic application shells
-- deterministic design systems
-- safe UI runtimes for LLM products
-
----
-
-## Vision
-
-AI will generate more and more interface code.
-
-But generated UI cannot be trusted by default.
-
-There needs to be a **deterministic execution layer between AI output and the user interface**.
-
-Engine UI is built to become that layer.
-
 ---
 
-## Contributing
+## 🎵 Tenerife Music
 
-Engine UI follows a strict architecture model.
+Looking for concert tickets and live music events on Tenerife?
 
-All contributions must respect:
-
-- token authority
-- layer boundaries
-- closed execution rules
-- sanctioned public surfaces
+Visit **[tenerife.music](https://tenerife.music)** — your guide to the island's best live music scene.
 
 ---
 
 ## License
 
 MIT
-
----
-
-**Engine UI is not a component library.  
-It is an execution engine for AI-generated interfaces.**

package/package.json

@@ -309,5 +309,5 @@
       "require": "./dist/agent-contract/index.cjs"
     }
   },
-  "version": "4.0.0"
+  "version": "5.0.0"
 }

package/dist/Link-B8gB8LrX.d.cts

@@ -1,78 +0,0 @@
-import * as class_variance_authority_types from 'class-variance-authority/types';
-import * as React from 'react';
-import { S as SafeNativeProps } from './safe-native-DQVUNMW7.cjs';
-
-/**
- * Link variant values (internal - used for type derivation only)
- *
- * @internal
- */
-declare const _LINK_VARIANTS: readonly ["primary", "secondary", "accent", "outline", "ghost", "text", "link", "wrapper", "destructive"];
-/**
- * Link variant type
- *
- * @public
- */
-type LinkVariant = (typeof _LINK_VARIANTS)[number];
-/**
- * Link size values (internal - used for type derivation only)
- *
- * @internal
- */
-declare const _LINK_SIZES: readonly ["sm", "md", "lg"];
-/**
- * Link size type
- *
- * @public
- */
-type LinkSize = (typeof _LINK_SIZES)[number];
-declare const linkVariants: (props?: ({
-    variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "link" | "text" | "ghost" | "wrapper" | null | undefined;
-    size?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface LinkProps {
-    /**
-     * Link variant style
-     * @default "text"
-     */
-    variant?: LinkVariant;
-    /**
-     * Link size
-     * @default "md"
-     */
-    size?: LinkSize;
-    /**
-     * Icon to display on the left side
-     */
-    leftIcon?: React.ReactNode;
-    /**
-     * Icon to display on the right side
-     */
-    rightIcon?: React.ReactNode;
-    /**
-     * Whether the link is disabled
-     * When disabled, the link will not be navigable and will be removed from the tab order
-     * @default false
-     */
-    disabled?: boolean;
-    href?: string;
-    target?: "_self" | "_blank" | "_parent" | "_top";
-    rel?: string;
-    onClick?: React.MouseEventHandler<HTMLAnchorElement>;
-    onFocus?: React.FocusEventHandler<HTMLAnchorElement>;
-    onBlur?: React.FocusEventHandler<HTMLAnchorElement>;
-    onMouseEnter?: React.MouseEventHandler<HTMLAnchorElement>;
-    onMouseLeave?: React.MouseEventHandler<HTMLAnchorElement>;
-    id?: string;
-    title?: string;
-    tabIndex?: number;
-    role?: string;
-    download?: string;
-    hrefLang?: string;
-    type?: string;
-    children?: React.ReactNode;
-    native?: SafeNativeProps;
-}
-declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
-
-export { type LinkProps as L, type LinkVariant as a, Link as b, type LinkSize as c, linkVariants as l };

package/dist/Link-Dg9GiZzj.d.ts

@@ -1,78 +0,0 @@
-import * as class_variance_authority_types from 'class-variance-authority/types';
-import * as React from 'react';
-import { S as SafeNativeProps } from './safe-native-DQVUNMW7.js';
-
-/**
- * Link variant values (internal - used for type derivation only)
- *
- * @internal
- */
-declare const _LINK_VARIANTS: readonly ["primary", "secondary", "accent", "outline", "ghost", "text", "link", "wrapper", "destructive"];
-/**
- * Link variant type
- *
- * @public
- */
-type LinkVariant = (typeof _LINK_VARIANTS)[number];
-/**
- * Link size values (internal - used for type derivation only)
- *
- * @internal
- */
-declare const _LINK_SIZES: readonly ["sm", "md", "lg"];
-/**
- * Link size type
- *
- * @public
- */
-type LinkSize = (typeof _LINK_SIZES)[number];
-declare const linkVariants: (props?: ({
-    variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "link" | "text" | "ghost" | "wrapper" | null | undefined;
-    size?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface LinkProps {
-    /**
-     * Link variant style
-     * @default "text"
-     */
-    variant?: LinkVariant;
-    /**
-     * Link size
-     * @default "md"
-     */
-    size?: LinkSize;
-    /**
-     * Icon to display on the left side
-     */
-    leftIcon?: React.ReactNode;
-    /**
-     * Icon to display on the right side
-     */
-    rightIcon?: React.ReactNode;
-    /**
-     * Whether the link is disabled
-     * When disabled, the link will not be navigable and will be removed from the tab order
-     * @default false
-     */
-    disabled?: boolean;
-    href?: string;
-    target?: "_self" | "_blank" | "_parent" | "_top";
-    rel?: string;
-    onClick?: React.MouseEventHandler<HTMLAnchorElement>;
-    onFocus?: React.FocusEventHandler<HTMLAnchorElement>;
-    onBlur?: React.FocusEventHandler<HTMLAnchorElement>;
-    onMouseEnter?: React.MouseEventHandler<HTMLAnchorElement>;
-    onMouseLeave?: React.MouseEventHandler<HTMLAnchorElement>;
-    id?: string;
-    title?: string;
-    tabIndex?: number;
-    role?: string;
-    download?: string;
-    hrefLang?: string;
-    type?: string;
-    children?: React.ReactNode;
-    native?: SafeNativeProps;
-}
-declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
-
-export { type LinkProps as L, type LinkVariant as a, Link as b, type LinkSize as c, linkVariants as l };

package/dist/agent-contract/index.d.cts

@@ -1,133 +0,0 @@
-import { a as UICapabilityDiscoveryResult, c as IntentDslAstDocument, C as CompileDslToIntentResult, I as IntentDslErrorCode } from '../types-CoqbRddt.cjs';
-export { b as IntentDslError, U as UICapabilityDiscoveryEntry, d as UICapabilityPropMetadata, e as UIDslKeywordCapability } from '../types-CoqbRddt.cjs';
-import { a as IntentDslKeyword } from '../ui-node-union-BNt_iPQO.cjs';
-export { D as DETERMINISTIC_INTENT_KIND_ALLOWLIST, r as DETERMINISTIC_INTENT_ROOT_KINDS, s as DETERMINISTIC_LAYOUT_SURFACE_ALLOWLIST, t as DETERMINISTIC_TYPED_DSL_ROOT_KINDS, u as INTENT_DSL_ALLOWED_CHILD_KINDS_BY_KIND, v as INTENT_DSL_ALLOWED_PROP_KEYS_BY_KIND, o as INTENT_DSL_GRAMMAR, p as INTENT_DSL_KEYWORDS, q as IntentDslGrammarEntry, I as IntentDslValueType, n as getDslWritablePropNames } from '../ui-node-union-BNt_iPQO.cjs';
-import { b as UIIntentCategory, U as UIIntentSchema, c as UIIntentValidationIssue } from '../types-BEG5B5HA.cjs';
-import '../index-4rLh47Jk.cjs';
-import '../typography-BsoBDDcG.cjs';
-import '../safe-native-DQVUNMW7.cjs';
-
-declare function getUiCapabilities(): UICapabilityDiscoveryResult;
-
-interface CapabilityIntrospectionEntry {
-    readonly kind: string;
-    readonly role: "layout_primitive" | "component_primitive";
-    readonly category: UIIntentCategory;
-    readonly allowedParentCategories: readonly UIIntentCategory[];
-    readonly allowedParentKinds: readonly string[];
-    readonly allowedChildKinds: readonly string[];
-    readonly supportedProps: readonly string[];
-    readonly supportedStates: readonly string[];
-    readonly supportedActions: readonly string[];
-    /** Convenience flag: true when allowedChildKinds is empty. */
-    readonly isLeaf: boolean;
-    readonly canonicalRef: string;
-}
-interface CapabilityIntrospectionResult {
-    readonly surfaces: readonly string[];
-    readonly entries: Readonly<Record<string, CapabilityIntrospectionEntry>>;
-    readonly forbiddenPropKeys: readonly string[];
-    readonly allowedChildCategoriesByCategory: Readonly<Record<UIIntentCategory, readonly UIIntentCategory[]>>;
-}
-
-declare function getCapabilities(): CapabilityIntrospectionResult;
-declare function getCapabilityKinds(): readonly string[];
-declare function getCapabilitiesByRole(role: "layout_primitive" | "component_primitive"): readonly CapabilityIntrospectionEntry[];
-/**
- * Returns the introspection entry for a kind, or `undefined` if unknown.
- * Unlike the internal `getCapabilityEntry`, this never throws.
- */
-declare function findCapabilityEntry(kind: string): CapabilityIntrospectionEntry | undefined;
-declare function getAllowedChildKinds(kind: string): readonly string[];
-declare function getAllowedParentKinds(kind: string): readonly string[];
-declare function getLeafCapabilities(): readonly CapabilityIntrospectionEntry[];
-declare function getForbiddenPropKeys(): readonly string[];
-
-type IntentDslAutocompleteEntry = {
-    keyword: IntentDslKeyword;
-    label: string;
-    snippet: string;
-    supportedProps: readonly string[];
-};
-declare function buildIntentDslAutocompleteSuggestions(): readonly IntentDslAutocompleteEntry[];
-
-declare function compileDslToIntent(input: IntentDslAstDocument | string): CompileDslToIntentResult;
-
-type AgentGenerateUISourceKind = "dsl" | "intent_schema";
-type AgentGenerateUIOptions = {
-    artifactsRoot?: string;
-    exampleName?: string;
-    artifactsMode?: "persistent" | "ephemeral";
-};
-type AgentGenerateUIRequest = {
-    dsl: string;
-    intentSchema?: never;
-    options?: AgentGenerateUIOptions;
-} | {
-    intentSchema: UIIntentSchema;
-    dsl?: never;
-    options?: AgentGenerateUIOptions;
-};
-type AgentGenerateUIIssue = {
-    code: string;
-    message: string;
-    path: string;
-    canonicalRef?: UIIntentValidationIssue["canonicalRef"];
-    category?: UIIntentValidationIssue["category"];
-    severity?: UIIntentValidationIssue["severity"];
-};
-type AgentGenerateUIDslError = {
-    code: IntentDslErrorCode;
-    line?: number;
-    column?: number;
-    path?: string;
-};
-type AgentGenerateUIValidationDiagnostics = {
-    valid: boolean;
-    errors: AgentGenerateUIIssue[];
-    warnings: AgentGenerateUIIssue[];
-    dslError?: AgentGenerateUIDslError;
-};
-type AgentGenerateUIScoreDiagnostics = {
-    gate: "pass" | "fail";
-    overallScore: number;
-    gateReasons: string[];
-    lintErrorCount: number;
-    lintWarningCount: number;
-    architectureRuleViolations: number;
-};
-type AgentGenerateUIDiagnostics = {
-    sourceKind: AgentGenerateUISourceKind;
-    validation: AgentGenerateUIValidationDiagnostics | null;
-    score?: AgentGenerateUIScoreDiagnostics;
-    warnings: AgentGenerateUIIssue[];
-};
-type AgentGenerateUIErrorCode = "AGENT_INPUT_CONTRACT_FAILED" | "AGENT_VALIDATION_FAILED" | "AGENT_COMPILER_FAILED" | "AGENT_SCORING_FAILED" | "AGENT_ARTIFACT_GATE_FAILED";
-type AgentGenerateUIError = {
-    code: AgentGenerateUIErrorCode;
-    message: string;
-    details?: {
-        engineCode?: string;
-        issues?: AgentGenerateUIIssue[];
-        warnings?: AgentGenerateUIIssue[];
-        dslError?: AgentGenerateUIDslError;
-        gateReasons?: string[];
-        cause?: unknown;
-    };
-};
-type AgentGenerateUISuccessResponse = {
-    ok: true;
-    jsx: string;
-    hash: string;
-    diagnostics: AgentGenerateUIDiagnostics;
-};
-type AgentGenerateUIFailureResponse = {
-    ok: false;
-    error: AgentGenerateUIError;
-    diagnostics: AgentGenerateUIDiagnostics;
-};
-type AgentGenerateUIResponse = AgentGenerateUISuccessResponse | AgentGenerateUIFailureResponse;
-
-declare function agentGenerateUI(input: AgentGenerateUIRequest): AgentGenerateUIResponse;
-
-export { type AgentGenerateUIDiagnostics, type AgentGenerateUIDslError, type AgentGenerateUIError, type AgentGenerateUIErrorCode, type AgentGenerateUIFailureResponse, type AgentGenerateUIIssue, type AgentGenerateUIOptions, type AgentGenerateUIRequest, type AgentGenerateUIResponse, type AgentGenerateUIScoreDiagnostics, type AgentGenerateUISourceKind, type AgentGenerateUISuccessResponse, type AgentGenerateUIValidationDiagnostics, type CapabilityIntrospectionEntry, type CapabilityIntrospectionResult, type IntentDslAutocompleteEntry, IntentDslErrorCode, IntentDslKeyword, UICapabilityDiscoveryResult, agentGenerateUI, buildIntentDslAutocompleteSuggestions, compileDslToIntent, findCapabilityEntry, getAllowedChildKinds, getAllowedParentKinds, getCapabilities, getCapabilitiesByRole, getCapabilityKinds, getForbiddenPropKeys, getLeafCapabilities, getUiCapabilities };