@lucasvu/scope-ui 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -875,7 +875,7 @@ type UiAiComponentDescriptor = {
 declare const uiAiManifest: {
     readonly packageName: "@lucasvu/scope-ui";
     readonly styleImport: "@lucasvu/scope-ui/styles.css";
-    readonly rules: readonly ["Import the stylesheet once at the app entry before rendering any component.", "Prefer the canonical component for each intent instead of mixing legacy MainFe components.", "Use Input/Textarea/Select label props directly for simple fields; use Field only to wrap custom controls or grouped content.", "Use Select for small fixed option lists, SearchableSelect for larger local lists, Combobox for type-and-pick flows, and AsyncCombobox for remote search.", "Always provide a stable rowKey to DataTable and use sortMode=\"server\" when sorting happens on the backend.", "Prefer Card as the outer layout section and keep alerts, stats, and tables inside CardContent when building dashboards or forms.", "Do not import MainFe components unless the target explicitly asks for legacy main-fe styling."];
+    readonly rules: readonly ["Import the stylesheet once at the app entry before rendering any component.", "If the project declares an approved theme preset in AGENTS.md or ui-theme.css, stay inside that preset and do not invent a second palette.", "Collect the screen brief first: route url, sidebar items, active sidebar item, page title, actions, and the page-specific content schema.", "Prefer the canonical component for each intent instead of mixing legacy MainFe components.", "Use Input/Textarea/Select label props directly for simple fields; use Field only to wrap custom controls or grouped content.", "Use Select for small fixed option lists, SearchableSelect for larger local lists, Combobox for type-and-pick flows, and AsyncCombobox for remote search.", "Always provide a stable rowKey to DataTable and use sortMode=\"server\" when sorting happens on the backend.", "Prefer Card as the outer layout section and keep alerts, stats, and tables inside CardContent when building dashboards or forms.", "Do not import MainFe components unless the target explicitly asks for legacy main-fe styling."];
     readonly components: ({
         name: string;
         importName: string;
@@ -911,6 +911,290 @@ declare const uiAiManifest: {
     })[];
 };
 
+type UiScreenKind = 'list' | 'form' | 'detail' | 'dashboard';
+type UiScreenBriefField = {
+    id: string;
+    label: string;
+    description: string;
+    required: boolean;
+    appliesTo: UiScreenKind[] | ['all'];
+    example: string;
+};
+declare const uiScreenBriefFields: readonly [{
+    readonly id: "pageKind";
+    readonly label: "Page kind";
+    readonly description: "Choose the base recipe for the screen.";
+    readonly required: true;
+    readonly appliesTo: ["all"];
+    readonly example: "list";
+}, {
+    readonly id: "routeUrl";
+    readonly label: "Route URL";
+    readonly description: "Final route for the screen or feature entry.";
+    readonly required: true;
+    readonly appliesTo: ["all"];
+    readonly example: "/admin/users";
+}, {
+    readonly id: "sidebarItems";
+    readonly label: "Sidebar items";
+    readonly description: "Sidebar entries with at least id, title, and href so the shell stays consistent.";
+    readonly required: true;
+    readonly appliesTo: ["all"];
+    readonly example: "[{ id: \"users\", title: \"Users\", href: \"/admin/users\" }]";
+}, {
+    readonly id: "activeSidebarItemId";
+    readonly label: "Active sidebar item id";
+    readonly description: "The sidebar item that should appear active on this screen.";
+    readonly required: true;
+    readonly appliesTo: ["all"];
+    readonly example: "users";
+}, {
+    readonly id: "breadcrumbs";
+    readonly label: "Breadcrumbs";
+    readonly description: "Ordered breadcrumb items for the page header.";
+    readonly required: false;
+    readonly appliesTo: ["all"];
+    readonly example: "[{ label: \"Admin\", href: \"/admin\" }, { label: \"Users\", current: true }]";
+}, {
+    readonly id: "pageTitle";
+    readonly label: "Page title";
+    readonly description: "Main page heading shown in the content header.";
+    readonly required: true;
+    readonly appliesTo: ["all"];
+    readonly example: "Users";
+}, {
+    readonly id: "pageSubtitle";
+    readonly label: "Page subtitle";
+    readonly description: "Short supporting text under the title.";
+    readonly required: false;
+    readonly appliesTo: ["all"];
+    readonly example: "Manage internal user accounts and permissions.";
+}, {
+    readonly id: "primaryAction";
+    readonly label: "Primary action";
+    readonly description: "The highest-emphasis action shown in the page header.";
+    readonly required: false;
+    readonly appliesTo: ["all"];
+    readonly example: "{ label: \"Create user\", href: \"/admin/users/create\" }";
+}, {
+    readonly id: "secondaryActions";
+    readonly label: "Secondary actions";
+    readonly description: "Additional header actions such as export, refresh, or cancel.";
+    readonly required: false;
+    readonly appliesTo: ["all"];
+    readonly example: "[{ label: \"Export\" }, { label: \"Refresh\" }]";
+}, {
+    readonly id: "summaryStats";
+    readonly label: "Summary stats";
+    readonly description: "Top-line numbers for dashboard or overview screens.";
+    readonly required: false;
+    readonly appliesTo: ["dashboard", "detail"];
+    readonly example: "[{ label: \"Active users\", value: \"1,204\", trend: \"up\", delta: \"+12%\" }]";
+}, {
+    readonly id: "filters";
+    readonly label: "Filters";
+    readonly description: "Filter bar controls shown above list or dashboard content.";
+    readonly required: false;
+    readonly appliesTo: ["list", "dashboard"];
+    readonly example: "[{ type: \"search\", label: \"Search user\" }, { type: \"select\", label: \"Role\" }]";
+}, {
+    readonly id: "tableColumns";
+    readonly label: "Table columns";
+    readonly description: "Columns for a list table, including label and render intent.";
+    readonly required: false;
+    readonly appliesTo: ["list", "detail", "dashboard"];
+    readonly example: "[{ key: \"name\", title: \"Name\" }, { key: \"role\", title: \"Role\" }]";
+}, {
+    readonly id: "rowActions";
+    readonly label: "Row actions";
+    readonly description: "Per-row actions for table screens.";
+    readonly required: false;
+    readonly appliesTo: ["list", "detail"];
+    readonly example: "[{ label: \"Edit\" }, { label: \"Reset password\" }]";
+}, {
+    readonly id: "formSections";
+    readonly label: "Form sections";
+    readonly description: "Grouped form sections and the fields inside each section.";
+    readonly required: false;
+    readonly appliesTo: ["form"];
+    readonly example: "[{ title: \"Basic info\", fields: [\"name\", \"email\", \"role\"] }]";
+}, {
+    readonly id: "fields";
+    readonly label: "Fields";
+    readonly description: "Detailed field list with type, label, required state, and helper text.";
+    readonly required: false;
+    readonly appliesTo: ["form", "detail"];
+    readonly example: "[{ name: \"email\", type: \"input\", label: \"Email\", required: true }]";
+}, {
+    readonly id: "detailSections";
+    readonly label: "Detail sections";
+    readonly description: "Cards or sections for detail pages such as profile, activity, permissions, or related records.";
+    readonly required: false;
+    readonly appliesTo: ["detail"];
+    readonly example: "[{ title: \"Profile\" }, { title: \"Recent activity\" }]";
+}, {
+    readonly id: "emptyState";
+    readonly label: "Empty state";
+    readonly description: "Fallback title, description, and action when there is no data.";
+    readonly required: false;
+    readonly appliesTo: ["list", "dashboard", "detail"];
+    readonly example: "{ title: \"No users yet\", description: \"Create the first user to get started.\" }";
+}, {
+    readonly id: "permissions";
+    readonly label: "Permissions";
+    readonly description: "Permission keys that affect sidebar visibility or action availability.";
+    readonly required: false;
+    readonly appliesTo: ["all"];
+    readonly example: "[\"user.read\", \"user.write\"]";
+}];
+declare const uiScreenBlueprint: {
+    readonly pageKinds: readonly [{
+        readonly id: "list";
+        readonly label: "List page";
+        readonly frame: readonly ["Sidebar shell", "Breadcrumb", "PageTitle with actions", "Optional stats", "Filter card", "DataTable card"];
+    }, {
+        readonly id: "form";
+        readonly label: "Form page";
+        readonly frame: readonly ["Sidebar shell", "Breadcrumb", "PageTitle with primary and cancel actions", "Sectioned form cards", "Bottom action row"];
+    }, {
+        readonly id: "detail";
+        readonly label: "Detail page";
+        readonly frame: readonly ["Sidebar shell", "Breadcrumb", "PageTitle with status/actions", "Summary stats or metadata card", "Detail cards and related tables"];
+    }, {
+        readonly id: "dashboard";
+        readonly label: "Dashboard page";
+        readonly frame: readonly ["Sidebar shell", "Breadcrumb", "PageTitle with actions", "Stat cards row", "Filters", "Main insight cards and tables"];
+    }];
+    readonly workflow: readonly ["Collect the screen brief before coding. Do not invent sidebar items, route urls, filters, fields, or table columns if the brief is missing.", "Use Sidebar plus Breadcrumb and PageTitle to lock the shell before building the page body.", "Choose only canonical root exports from @lucasvu/scope-ui.", "Use Card and ui-grid utilities to create the frame first, then place controls and data components inside.", "Keep all palette, radius, surface, and shadow decisions in the shared ui-theme.css preset file.", "End with a consistency check against the selected preset and the screen brief."];
+    readonly briefFields: readonly [{
+        readonly id: "pageKind";
+        readonly label: "Page kind";
+        readonly description: "Choose the base recipe for the screen.";
+        readonly required: true;
+        readonly appliesTo: ["all"];
+        readonly example: "list";
+    }, {
+        readonly id: "routeUrl";
+        readonly label: "Route URL";
+        readonly description: "Final route for the screen or feature entry.";
+        readonly required: true;
+        readonly appliesTo: ["all"];
+        readonly example: "/admin/users";
+    }, {
+        readonly id: "sidebarItems";
+        readonly label: "Sidebar items";
+        readonly description: "Sidebar entries with at least id, title, and href so the shell stays consistent.";
+        readonly required: true;
+        readonly appliesTo: ["all"];
+        readonly example: "[{ id: \"users\", title: \"Users\", href: \"/admin/users\" }]";
+    }, {
+        readonly id: "activeSidebarItemId";
+        readonly label: "Active sidebar item id";
+        readonly description: "The sidebar item that should appear active on this screen.";
+        readonly required: true;
+        readonly appliesTo: ["all"];
+        readonly example: "users";
+    }, {
+        readonly id: "breadcrumbs";
+        readonly label: "Breadcrumbs";
+        readonly description: "Ordered breadcrumb items for the page header.";
+        readonly required: false;
+        readonly appliesTo: ["all"];
+        readonly example: "[{ label: \"Admin\", href: \"/admin\" }, { label: \"Users\", current: true }]";
+    }, {
+        readonly id: "pageTitle";
+        readonly label: "Page title";
+        readonly description: "Main page heading shown in the content header.";
+        readonly required: true;
+        readonly appliesTo: ["all"];
+        readonly example: "Users";
+    }, {
+        readonly id: "pageSubtitle";
+        readonly label: "Page subtitle";
+        readonly description: "Short supporting text under the title.";
+        readonly required: false;
+        readonly appliesTo: ["all"];
+        readonly example: "Manage internal user accounts and permissions.";
+    }, {
+        readonly id: "primaryAction";
+        readonly label: "Primary action";
+        readonly description: "The highest-emphasis action shown in the page header.";
+        readonly required: false;
+        readonly appliesTo: ["all"];
+        readonly example: "{ label: \"Create user\", href: \"/admin/users/create\" }";
+    }, {
+        readonly id: "secondaryActions";
+        readonly label: "Secondary actions";
+        readonly description: "Additional header actions such as export, refresh, or cancel.";
+        readonly required: false;
+        readonly appliesTo: ["all"];
+        readonly example: "[{ label: \"Export\" }, { label: \"Refresh\" }]";
+    }, {
+        readonly id: "summaryStats";
+        readonly label: "Summary stats";
+        readonly description: "Top-line numbers for dashboard or overview screens.";
+        readonly required: false;
+        readonly appliesTo: ["dashboard", "detail"];
+        readonly example: "[{ label: \"Active users\", value: \"1,204\", trend: \"up\", delta: \"+12%\" }]";
+    }, {
+        readonly id: "filters";
+        readonly label: "Filters";
+        readonly description: "Filter bar controls shown above list or dashboard content.";
+        readonly required: false;
+        readonly appliesTo: ["list", "dashboard"];
+        readonly example: "[{ type: \"search\", label: \"Search user\" }, { type: \"select\", label: \"Role\" }]";
+    }, {
+        readonly id: "tableColumns";
+        readonly label: "Table columns";
+        readonly description: "Columns for a list table, including label and render intent.";
+        readonly required: false;
+        readonly appliesTo: ["list", "detail", "dashboard"];
+        readonly example: "[{ key: \"name\", title: \"Name\" }, { key: \"role\", title: \"Role\" }]";
+    }, {
+        readonly id: "rowActions";
+        readonly label: "Row actions";
+        readonly description: "Per-row actions for table screens.";
+        readonly required: false;
+        readonly appliesTo: ["list", "detail"];
+        readonly example: "[{ label: \"Edit\" }, { label: \"Reset password\" }]";
+    }, {
+        readonly id: "formSections";
+        readonly label: "Form sections";
+        readonly description: "Grouped form sections and the fields inside each section.";
+        readonly required: false;
+        readonly appliesTo: ["form"];
+        readonly example: "[{ title: \"Basic info\", fields: [\"name\", \"email\", \"role\"] }]";
+    }, {
+        readonly id: "fields";
+        readonly label: "Fields";
+        readonly description: "Detailed field list with type, label, required state, and helper text.";
+        readonly required: false;
+        readonly appliesTo: ["form", "detail"];
+        readonly example: "[{ name: \"email\", type: \"input\", label: \"Email\", required: true }]";
+    }, {
+        readonly id: "detailSections";
+        readonly label: "Detail sections";
+        readonly description: "Cards or sections for detail pages such as profile, activity, permissions, or related records.";
+        readonly required: false;
+        readonly appliesTo: ["detail"];
+        readonly example: "[{ title: \"Profile\" }, { title: \"Recent activity\" }]";
+    }, {
+        readonly id: "emptyState";
+        readonly label: "Empty state";
+        readonly description: "Fallback title, description, and action when there is no data.";
+        readonly required: false;
+        readonly appliesTo: ["list", "dashboard", "detail"];
+        readonly example: "{ title: \"No users yet\", description: \"Create the first user to get started.\" }";
+    }, {
+        readonly id: "permissions";
+        readonly label: "Permissions";
+        readonly description: "Permission keys that affect sidebar visibility or action availability.";
+        readonly required: false;
+        readonly appliesTo: ["all"];
+        readonly example: "[\"user.read\", \"user.write\"]";
+    }];
+};
+
 type UiThemeToken = {
     name: string;
     description: string;
@@ -918,6 +1202,233 @@ type UiThemeToken = {
     defaultDark: string;
     usedBy: string[];
 };
+type UiThemePreset = {
+    id: string;
+    label: string;
+    description: string;
+    recommendedFor: string[];
+    tokens: {
+        light: Record<string, string>;
+        dark: Record<string, string>;
+    };
+};
+declare const uiThemePresets: readonly [{
+    readonly id: "ocean";
+    readonly label: "Ocean Glass";
+    readonly description: "Blue-cyan preset with clean glass surfaces. Matches the current default visual language.";
+    readonly recommendedFor: ["Admin dashboards", "SaaS CRUD screens", "Projects that want the existing package look"];
+    readonly tokens: {
+        readonly light: {
+            readonly '--tw-background': "0 0% 100%";
+            readonly '--tw-foreground': "222.2 47.4% 11.2%";
+            readonly '--tw-primary': "221.2 83.2% 53.3%";
+            readonly '--tw-accent': "199 89% 48%";
+            readonly '--tw-success': "142.1 76.2% 36.3%";
+            readonly '--tw-destructive': "0 84.2% 60.2%";
+            readonly '--tw-border': "214.3 31.8% 91.4%";
+            readonly '--radius': "0.75rem";
+            readonly '--surface': "rgba(255, 255, 255, 0.92)";
+            readonly '--surface-strong': "rgba(241, 245, 249, 0.96)";
+            readonly '--grey': "rgba(248, 250, 252, 0.96)";
+            readonly '--grey-strong': "rgba(241, 245, 249, 0.98)";
+            readonly '--shadow-sm': "0 10px 28px -18px rgba(15, 23, 42, 0.22)";
+            readonly '--shadow': "0 24px 60px -28px rgba(15, 23, 42, 0.3)";
+            readonly '--primary-grad-from': "199 89% 48%";
+            readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+        };
+        readonly dark: {
+            readonly '--tw-background': "222.2 84% 4.9%";
+            readonly '--tw-foreground': "210 40% 98%";
+            readonly '--tw-primary': "217.2 91.2% 59.8%";
+            readonly '--tw-accent': "199 89% 48%";
+            readonly '--tw-success': "142.1 70.6% 45.3%";
+            readonly '--tw-destructive': "0 62.8% 30.6%";
+            readonly '--tw-border': "217.2 32.6% 17.5%";
+            readonly '--radius': "0.75rem";
+            readonly '--surface': "rgba(15, 23, 42, 0.78)";
+            readonly '--surface-strong': "rgba(30, 41, 59, 0.92)";
+            readonly '--grey': "rgba(30, 41, 59, 0.88)";
+            readonly '--grey-strong': "rgba(51, 65, 85, 0.92)";
+            readonly '--shadow-sm': "0 16px 32px -18px rgba(2, 6, 23, 0.48)";
+            readonly '--shadow': "0 28px 80px -32px rgba(2, 6, 23, 0.7)";
+            readonly '--primary-grad-from': "198.6 88.7% 48.4%";
+            readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+        };
+    };
+}, {
+    readonly id: "sunset";
+    readonly label: "Sunset Ember";
+    readonly description: "Warm orange-coral preset with softer cream surfaces for branded landing or growth products.";
+    readonly recommendedFor: ["Growth products", "Commerce backoffices", "Projects that want a warmer visual tone"];
+    readonly tokens: {
+        readonly light: {
+            readonly '--tw-background': "30 100% 98%";
+            readonly '--tw-foreground': "20 24% 14%";
+            readonly '--tw-primary': "14 90% 56%";
+            readonly '--tw-accent': "29 100% 58%";
+            readonly '--tw-success': "145 63% 38%";
+            readonly '--tw-destructive': "0 78% 58%";
+            readonly '--tw-border': "24 45% 89%";
+            readonly '--radius': "0.85rem";
+            readonly '--surface': "rgba(255, 247, 240, 0.92)";
+            readonly '--surface-strong': "rgba(255, 237, 223, 0.96)";
+            readonly '--grey': "rgba(255, 243, 231, 0.96)";
+            readonly '--grey-strong': "rgba(255, 232, 214, 0.98)";
+            readonly '--shadow-sm': "0 12px 30px -18px rgba(194, 65, 12, 0.18)";
+            readonly '--shadow': "0 28px 64px -30px rgba(154, 52, 18, 0.24)";
+            readonly '--primary-grad-from': "29 100% 58%";
+            readonly '--primary-grad-to': "14 90% 56%";
+        };
+        readonly dark: {
+            readonly '--tw-background': "20 24% 8%";
+            readonly '--tw-foreground': "40 33% 96%";
+            readonly '--tw-primary': "18 100% 62%";
+            readonly '--tw-accent': "35 100% 58%";
+            readonly '--tw-success': "145 60% 47%";
+            readonly '--tw-destructive': "0 73% 52%";
+            readonly '--tw-border': "18 24% 22%";
+            readonly '--radius': "0.85rem";
+            readonly '--surface': "rgba(41, 24, 18, 0.84)";
+            readonly '--surface-strong': "rgba(59, 34, 24, 0.9)";
+            readonly '--grey': "rgba(70, 42, 29, 0.88)";
+            readonly '--grey-strong': "rgba(92, 54, 38, 0.9)";
+            readonly '--shadow-sm': "0 18px 36px -20px rgba(67, 20, 7, 0.48)";
+            readonly '--shadow': "0 30px 84px -34px rgba(67, 20, 7, 0.62)";
+            readonly '--primary-grad-from': "35 100% 58%";
+            readonly '--primary-grad-to': "18 100% 62%";
+        };
+    };
+}, {
+    readonly id: "forest";
+    readonly label: "Forest Mist";
+    readonly description: "Emerald-teal preset with soft botanical surfaces for calmer productivity products.";
+    readonly recommendedFor: ["Operations tools", "Internal platforms", "Products that want a calmer green tone"];
+    readonly tokens: {
+        readonly light: {
+            readonly '--tw-background': "138 40% 98%";
+            readonly '--tw-foreground': "160 25% 14%";
+            readonly '--tw-primary': "158 64% 40%";
+            readonly '--tw-accent': "173 58% 44%";
+            readonly '--tw-success': "145 63% 36%";
+            readonly '--tw-destructive': "0 78% 58%";
+            readonly '--tw-border': "143 21% 88%";
+            readonly '--radius': "0.8rem";
+            readonly '--surface': "rgba(245, 252, 249, 0.92)";
+            readonly '--surface-strong': "rgba(232, 245, 239, 0.96)";
+            readonly '--grey': "rgba(240, 248, 244, 0.96)";
+            readonly '--grey-strong': "rgba(225, 240, 232, 0.98)";
+            readonly '--shadow-sm': "0 12px 28px -18px rgba(5, 86, 66, 0.18)";
+            readonly '--shadow': "0 26px 62px -30px rgba(6, 78, 59, 0.24)";
+            readonly '--primary-grad-from': "173 58% 44%";
+            readonly '--primary-grad-to': "158 64% 40%";
+        };
+        readonly dark: {
+            readonly '--tw-background': "164 35% 8%";
+            readonly '--tw-foreground': "144 35% 96%";
+            readonly '--tw-primary': "160 70% 46%";
+            readonly '--tw-accent': "174 72% 45%";
+            readonly '--tw-success': "145 68% 46%";
+            readonly '--tw-destructive': "0 70% 52%";
+            readonly '--tw-border': "160 20% 20%";
+            readonly '--radius': "0.8rem";
+            readonly '--surface': "rgba(16, 36, 31, 0.84)";
+            readonly '--surface-strong': "rgba(21, 51, 44, 0.9)";
+            readonly '--grey': "rgba(24, 61, 52, 0.88)";
+            readonly '--grey-strong': "rgba(31, 77, 65, 0.9)";
+            readonly '--shadow-sm': "0 18px 34px -20px rgba(1, 44, 34, 0.48)";
+            readonly '--shadow': "0 30px 82px -34px rgba(1, 44, 34, 0.6)";
+            readonly '--primary-grad-from': "174 72% 45%";
+            readonly '--primary-grad-to': "160 70% 46%";
+        };
+    };
+}, {
+    readonly id: "graphite";
+    readonly label: "Graphite Pulse";
+    readonly description: "Neutral slate preset with restrained blue accents for products that need a steadier enterprise tone.";
+    readonly recommendedFor: ["Enterprise admin panels", "B2B internal tools", "Projects that want a more neutral interface"];
+    readonly tokens: {
+        readonly light: {
+            readonly '--tw-background': "220 18% 97%";
+            readonly '--tw-foreground': "222 24% 14%";
+            readonly '--tw-primary': "221 24% 32%";
+            readonly '--tw-accent': "198 83% 44%";
+            readonly '--tw-success': "160 56% 38%";
+            readonly '--tw-destructive': "0 72% 54%";
+            readonly '--tw-border': "218 17% 86%";
+            readonly '--radius': "0.7rem";
+            readonly '--surface': "rgba(248, 250, 252, 0.94)";
+            readonly '--surface-strong': "rgba(226, 232, 240, 0.96)";
+            readonly '--grey': "rgba(241, 245, 249, 0.98)";
+            readonly '--grey-strong': "rgba(226, 232, 240, 0.99)";
+            readonly '--shadow-sm': "0 12px 30px -20px rgba(15, 23, 42, 0.18)";
+            readonly '--shadow': "0 28px 66px -30px rgba(15, 23, 42, 0.24)";
+            readonly '--primary-grad-from': "198 83% 44%";
+            readonly '--primary-grad-to': "221 24% 32%";
+        };
+        readonly dark: {
+            readonly '--tw-background': "222 32% 8%";
+            readonly '--tw-foreground': "210 25% 96%";
+            readonly '--tw-primary': "210 24% 82%";
+            readonly '--tw-accent': "192 92% 52%";
+            readonly '--tw-success': "158 64% 45%";
+            readonly '--tw-destructive': "0 72% 56%";
+            readonly '--tw-border': "217 19% 24%";
+            readonly '--radius': "0.7rem";
+            readonly '--surface': "rgba(15, 23, 42, 0.82)";
+            readonly '--surface-strong': "rgba(30, 41, 59, 0.92)";
+            readonly '--grey': "rgba(30, 41, 59, 0.9)";
+            readonly '--grey-strong': "rgba(51, 65, 85, 0.92)";
+            readonly '--shadow-sm': "0 18px 38px -22px rgba(2, 6, 23, 0.48)";
+            readonly '--shadow': "0 32px 88px -34px rgba(2, 6, 23, 0.68)";
+            readonly '--primary-grad-from': "192 92% 52%";
+            readonly '--primary-grad-to': "210 24% 82%";
+        };
+    };
+}];
+declare const uiDefaultThemePreset: {
+    readonly id: "ocean";
+    readonly label: "Ocean Glass";
+    readonly description: "Blue-cyan preset with clean glass surfaces. Matches the current default visual language.";
+    readonly recommendedFor: ["Admin dashboards", "SaaS CRUD screens", "Projects that want the existing package look"];
+    readonly tokens: {
+        readonly light: {
+            readonly '--tw-background': "0 0% 100%";
+            readonly '--tw-foreground': "222.2 47.4% 11.2%";
+            readonly '--tw-primary': "221.2 83.2% 53.3%";
+            readonly '--tw-accent': "199 89% 48%";
+            readonly '--tw-success': "142.1 76.2% 36.3%";
+            readonly '--tw-destructive': "0 84.2% 60.2%";
+            readonly '--tw-border': "214.3 31.8% 91.4%";
+            readonly '--radius': "0.75rem";
+            readonly '--surface': "rgba(255, 255, 255, 0.92)";
+            readonly '--surface-strong': "rgba(241, 245, 249, 0.96)";
+            readonly '--grey': "rgba(248, 250, 252, 0.96)";
+            readonly '--grey-strong': "rgba(241, 245, 249, 0.98)";
+            readonly '--shadow-sm': "0 10px 28px -18px rgba(15, 23, 42, 0.22)";
+            readonly '--shadow': "0 24px 60px -28px rgba(15, 23, 42, 0.3)";
+            readonly '--primary-grad-from': "199 89% 48%";
+            readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+        };
+        readonly dark: {
+            readonly '--tw-background': "222.2 84% 4.9%";
+            readonly '--tw-foreground': "210 40% 98%";
+            readonly '--tw-primary': "217.2 91.2% 59.8%";
+            readonly '--tw-accent': "199 89% 48%";
+            readonly '--tw-success': "142.1 70.6% 45.3%";
+            readonly '--tw-destructive': "0 62.8% 30.6%";
+            readonly '--tw-border': "217.2 32.6% 17.5%";
+            readonly '--radius': "0.75rem";
+            readonly '--surface': "rgba(15, 23, 42, 0.78)";
+            readonly '--surface-strong': "rgba(30, 41, 59, 0.92)";
+            readonly '--grey': "rgba(30, 41, 59, 0.88)";
+            readonly '--grey-strong': "rgba(51, 65, 85, 0.92)";
+            readonly '--shadow-sm': "0 16px 32px -18px rgba(2, 6, 23, 0.48)";
+            readonly '--shadow': "0 28px 80px -32px rgba(2, 6, 23, 0.7)";
+            readonly '--primary-grad-from': "198.6 88.7% 48.4%";
+            readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+        };
+    };
+};
 declare const uiThemeContract: {
     readonly packageName: "@lucasvu/scope-ui";
     readonly importOrder: readonly ["import '@lucasvu/scope-ui/styles.css'", "import './styles/ui-theme.css'"];
@@ -926,7 +1437,181 @@ declare const uiThemeContract: {
         readonly dark: readonly [".dark", "[data-ui-theme='dark']"];
     };
     readonly overrideFile: "src/styles/ui-theme.css";
-    readonly rules: readonly ["Import the package stylesheet before your project theme override stylesheet.", "Override tokens in one shared theme file instead of scattering colors across components.", "Use :root for the default light theme and .dark or [data-ui-theme='dark'] for dark theme.", "Only override tokens declared here. Do not patch component internals unless you are extending the library.", "For AI-generated screens, choose one theme source of truth and keep component code token-driven."];
+    readonly defaultPreset: "ocean";
+    readonly presets: readonly [{
+        readonly id: "ocean";
+        readonly label: "Ocean Glass";
+        readonly description: "Blue-cyan preset with clean glass surfaces. Matches the current default visual language.";
+        readonly recommendedFor: ["Admin dashboards", "SaaS CRUD screens", "Projects that want the existing package look"];
+        readonly tokens: {
+            readonly light: {
+                readonly '--tw-background': "0 0% 100%";
+                readonly '--tw-foreground': "222.2 47.4% 11.2%";
+                readonly '--tw-primary': "221.2 83.2% 53.3%";
+                readonly '--tw-accent': "199 89% 48%";
+                readonly '--tw-success': "142.1 76.2% 36.3%";
+                readonly '--tw-destructive': "0 84.2% 60.2%";
+                readonly '--tw-border': "214.3 31.8% 91.4%";
+                readonly '--radius': "0.75rem";
+                readonly '--surface': "rgba(255, 255, 255, 0.92)";
+                readonly '--surface-strong': "rgba(241, 245, 249, 0.96)";
+                readonly '--grey': "rgba(248, 250, 252, 0.96)";
+                readonly '--grey-strong': "rgba(241, 245, 249, 0.98)";
+                readonly '--shadow-sm': "0 10px 28px -18px rgba(15, 23, 42, 0.22)";
+                readonly '--shadow': "0 24px 60px -28px rgba(15, 23, 42, 0.3)";
+                readonly '--primary-grad-from': "199 89% 48%";
+                readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+            };
+            readonly dark: {
+                readonly '--tw-background': "222.2 84% 4.9%";
+                readonly '--tw-foreground': "210 40% 98%";
+                readonly '--tw-primary': "217.2 91.2% 59.8%";
+                readonly '--tw-accent': "199 89% 48%";
+                readonly '--tw-success': "142.1 70.6% 45.3%";
+                readonly '--tw-destructive': "0 62.8% 30.6%";
+                readonly '--tw-border': "217.2 32.6% 17.5%";
+                readonly '--radius': "0.75rem";
+                readonly '--surface': "rgba(15, 23, 42, 0.78)";
+                readonly '--surface-strong': "rgba(30, 41, 59, 0.92)";
+                readonly '--grey': "rgba(30, 41, 59, 0.88)";
+                readonly '--grey-strong': "rgba(51, 65, 85, 0.92)";
+                readonly '--shadow-sm': "0 16px 32px -18px rgba(2, 6, 23, 0.48)";
+                readonly '--shadow': "0 28px 80px -32px rgba(2, 6, 23, 0.7)";
+                readonly '--primary-grad-from': "198.6 88.7% 48.4%";
+                readonly '--primary-grad-to': "221.2 83.2% 53.3%";
+            };
+        };
+    }, {
+        readonly id: "sunset";
+        readonly label: "Sunset Ember";
+        readonly description: "Warm orange-coral preset with softer cream surfaces for branded landing or growth products.";
+        readonly recommendedFor: ["Growth products", "Commerce backoffices", "Projects that want a warmer visual tone"];
+        readonly tokens: {
+            readonly light: {
+                readonly '--tw-background': "30 100% 98%";
+                readonly '--tw-foreground': "20 24% 14%";
+                readonly '--tw-primary': "14 90% 56%";
+                readonly '--tw-accent': "29 100% 58%";
+                readonly '--tw-success': "145 63% 38%";
+                readonly '--tw-destructive': "0 78% 58%";
+                readonly '--tw-border': "24 45% 89%";
+                readonly '--radius': "0.85rem";
+                readonly '--surface': "rgba(255, 247, 240, 0.92)";
+                readonly '--surface-strong': "rgba(255, 237, 223, 0.96)";
+                readonly '--grey': "rgba(255, 243, 231, 0.96)";
+                readonly '--grey-strong': "rgba(255, 232, 214, 0.98)";
+                readonly '--shadow-sm': "0 12px 30px -18px rgba(194, 65, 12, 0.18)";
+                readonly '--shadow': "0 28px 64px -30px rgba(154, 52, 18, 0.24)";
+                readonly '--primary-grad-from': "29 100% 58%";
+                readonly '--primary-grad-to': "14 90% 56%";
+            };
+            readonly dark: {
+                readonly '--tw-background': "20 24% 8%";
+                readonly '--tw-foreground': "40 33% 96%";
+                readonly '--tw-primary': "18 100% 62%";
+                readonly '--tw-accent': "35 100% 58%";
+                readonly '--tw-success': "145 60% 47%";
+                readonly '--tw-destructive': "0 73% 52%";
+                readonly '--tw-border': "18 24% 22%";
+                readonly '--radius': "0.85rem";
+                readonly '--surface': "rgba(41, 24, 18, 0.84)";
+                readonly '--surface-strong': "rgba(59, 34, 24, 0.9)";
+                readonly '--grey': "rgba(70, 42, 29, 0.88)";
+                readonly '--grey-strong': "rgba(92, 54, 38, 0.9)";
+                readonly '--shadow-sm': "0 18px 36px -20px rgba(67, 20, 7, 0.48)";
+                readonly '--shadow': "0 30px 84px -34px rgba(67, 20, 7, 0.62)";
+                readonly '--primary-grad-from': "35 100% 58%";
+                readonly '--primary-grad-to': "18 100% 62%";
+            };
+        };
+    }, {
+        readonly id: "forest";
+        readonly label: "Forest Mist";
+        readonly description: "Emerald-teal preset with soft botanical surfaces for calmer productivity products.";
+        readonly recommendedFor: ["Operations tools", "Internal platforms", "Products that want a calmer green tone"];
+        readonly tokens: {
+            readonly light: {
+                readonly '--tw-background': "138 40% 98%";
+                readonly '--tw-foreground': "160 25% 14%";
+                readonly '--tw-primary': "158 64% 40%";
+                readonly '--tw-accent': "173 58% 44%";
+                readonly '--tw-success': "145 63% 36%";
+                readonly '--tw-destructive': "0 78% 58%";
+                readonly '--tw-border': "143 21% 88%";
+                readonly '--radius': "0.8rem";
+                readonly '--surface': "rgba(245, 252, 249, 0.92)";
+                readonly '--surface-strong': "rgba(232, 245, 239, 0.96)";
+                readonly '--grey': "rgba(240, 248, 244, 0.96)";
+                readonly '--grey-strong': "rgba(225, 240, 232, 0.98)";
+                readonly '--shadow-sm': "0 12px 28px -18px rgba(5, 86, 66, 0.18)";
+                readonly '--shadow': "0 26px 62px -30px rgba(6, 78, 59, 0.24)";
+                readonly '--primary-grad-from': "173 58% 44%";
+                readonly '--primary-grad-to': "158 64% 40%";
+            };
+            readonly dark: {
+                readonly '--tw-background': "164 35% 8%";
+                readonly '--tw-foreground': "144 35% 96%";
+                readonly '--tw-primary': "160 70% 46%";
+                readonly '--tw-accent': "174 72% 45%";
+                readonly '--tw-success': "145 68% 46%";
+                readonly '--tw-destructive': "0 70% 52%";
+                readonly '--tw-border': "160 20% 20%";
+                readonly '--radius': "0.8rem";
+                readonly '--surface': "rgba(16, 36, 31, 0.84)";
+                readonly '--surface-strong': "rgba(21, 51, 44, 0.9)";
+                readonly '--grey': "rgba(24, 61, 52, 0.88)";
+                readonly '--grey-strong': "rgba(31, 77, 65, 0.9)";
+                readonly '--shadow-sm': "0 18px 34px -20px rgba(1, 44, 34, 0.48)";
+                readonly '--shadow': "0 30px 82px -34px rgba(1, 44, 34, 0.6)";
+                readonly '--primary-grad-from': "174 72% 45%";
+                readonly '--primary-grad-to': "160 70% 46%";
+            };
+        };
+    }, {
+        readonly id: "graphite";
+        readonly label: "Graphite Pulse";
+        readonly description: "Neutral slate preset with restrained blue accents for products that need a steadier enterprise tone.";
+        readonly recommendedFor: ["Enterprise admin panels", "B2B internal tools", "Projects that want a more neutral interface"];
+        readonly tokens: {
+            readonly light: {
+                readonly '--tw-background': "220 18% 97%";
+                readonly '--tw-foreground': "222 24% 14%";
+                readonly '--tw-primary': "221 24% 32%";
+                readonly '--tw-accent': "198 83% 44%";
+                readonly '--tw-success': "160 56% 38%";
+                readonly '--tw-destructive': "0 72% 54%";
+                readonly '--tw-border': "218 17% 86%";
+                readonly '--radius': "0.7rem";
+                readonly '--surface': "rgba(248, 250, 252, 0.94)";
+                readonly '--surface-strong': "rgba(226, 232, 240, 0.96)";
+                readonly '--grey': "rgba(241, 245, 249, 0.98)";
+                readonly '--grey-strong': "rgba(226, 232, 240, 0.99)";
+                readonly '--shadow-sm': "0 12px 30px -20px rgba(15, 23, 42, 0.18)";
+                readonly '--shadow': "0 28px 66px -30px rgba(15, 23, 42, 0.24)";
+                readonly '--primary-grad-from': "198 83% 44%";
+                readonly '--primary-grad-to': "221 24% 32%";
+            };
+            readonly dark: {
+                readonly '--tw-background': "222 32% 8%";
+                readonly '--tw-foreground': "210 25% 96%";
+                readonly '--tw-primary': "210 24% 82%";
+                readonly '--tw-accent': "192 92% 52%";
+                readonly '--tw-success': "158 64% 45%";
+                readonly '--tw-destructive': "0 72% 56%";
+                readonly '--tw-border': "217 19% 24%";
+                readonly '--radius': "0.7rem";
+                readonly '--surface': "rgba(15, 23, 42, 0.82)";
+                readonly '--surface-strong': "rgba(30, 41, 59, 0.92)";
+                readonly '--grey': "rgba(30, 41, 59, 0.9)";
+                readonly '--grey-strong': "rgba(51, 65, 85, 0.92)";
+                readonly '--shadow-sm': "0 18px 38px -22px rgba(2, 6, 23, 0.48)";
+                readonly '--shadow': "0 32px 88px -34px rgba(2, 6, 23, 0.68)";
+                readonly '--primary-grad-from': "192 92% 52%";
+                readonly '--primary-grad-to': "210 24% 82%";
+            };
+        };
+    }];
+    readonly rules: readonly ["Import the package stylesheet before your project theme override stylesheet.", "Choose one approved preset and keep the entire project on that preset instead of mixing palettes page by page.", "Override tokens in one shared theme file instead of scattering colors across components.", "Use :root for the default light theme and .dark or [data-ui-theme='dark'] for dark theme.", "Only override tokens declared here. Do not patch component internals unless you are extending the library.", "For AI-generated screens, choose one theme source of truth and keep component code token-driven."];
     readonly tokens: {
         name: string;
         description: string;
@@ -934,11 +1619,11 @@ declare const uiThemeContract: {
         defaultDark: string;
         usedBy: string[];
     }[];
-    readonly exampleCss: ":root {\n  --tw-primary: 12 88% 56%;\n  --tw-accent: 24 95% 52%;\n  --primary-grad-from: 24 95% 52%;\n  --primary-grad-to: 12 88% 56%;\n  --surface: rgba(255, 248, 240, 0.92);\n}\n\n.dark {\n  --tw-primary: 18 100% 62%;\n  --tw-accent: 35 100% 58%;\n  --surface: rgba(24, 24, 27, 0.82);\n}";
+    readonly exampleCss: string;
 };
-declare const uiProjectAiRules: readonly ["Use @lucasvu/scope-ui as the default UI library.", "Import @lucasvu/scope-ui/styles.css once at the app entry.", "Import the project override theme file after the package stylesheet.", "Read uiAiManifest to choose the correct component by intent before coding.", "Read uiThemeContract before changing colors, shadows, or theme behavior.", "Prefer root exports and avoid MainFe unless the task explicitly targets a legacy screen."];
+declare const uiProjectAiRules: readonly ["Use @lucasvu/scope-ui as the default UI library.", "Import @lucasvu/scope-ui/styles.css once at the app entry.", "Import the project override theme file after the package stylesheet.", "Stay inside the approved theme preset declared by the project and do not invent a second palette.", "Read uiAiManifest to choose the correct component by intent before coding.", "Read uiThemeContract before changing colors, shadows, radius, or theme behavior.", "Prefer root exports and avoid MainFe unless the task explicitly targets a legacy screen."];
 
 type ClassValue = string | false | null | undefined;
 declare function cn(...values: ClassValue[]): string;
 
-export { Alert, type AlertProps, ArgonSidebar, AsyncCombobox, type AsyncComboboxProps, Badge, type BadgeProps, Breadcrumb, type BreadcrumbItem, Button$1 as Button, type ButtonProps$1 as ButtonProps, Card$1 as Card, CardAction$1 as CardAction, CardContent$1 as CardContent, CardDescription$1 as CardDescription, CardFooter$1 as CardFooter, CardHeader$1 as CardHeader, CardTitle$1 as CardTitle, Combobox$1 as Combobox, type ComboboxOption$2 as ComboboxOption, FormControl as Control, DataTable$1 as DataTable, type DataTableAlign$1 as DataTableAlign, type DataTableColumn$1 as DataTableColumn, type DataTablePagination$1 as DataTablePagination, type DataTableProps$1 as DataTableProps, type DataTableRowSelection$1 as DataTableRowSelection, type DataTableSortDirection$1 as DataTableSortDirection, type DataTableSortState$1 as DataTableSortState, FormDescription as Description, FormField as Field, Form, FormControl, FormDescription, FormField, type FormFieldProps, FormItem, FormLabel, FormMessage, Input$1 as Input, type InputProps$1 as InputProps, FormItem as Item, FormLabel as Label, LineClampTooltip, type LineClampTooltipProps, Loading, type LoadingProps, index as MainFe, FormMessage as Message, MultiSelect, type MultiSelectOption, NumericInput, type NumericInputProps, type Option, OverflowTooltip, type OverflowTooltipProps, PageTitle$1 as PageTitle, Pagination, type PaginationInfo, type PaginationProps, type PermissionChecker, SearchableSelect, type SearchableSelectOption, type SearchableSelectProps, SectionTitle$1 as SectionTitle, Select, type SelectOption, type SelectProps, Sidebar, SidebarItem, type SidebarProps, Stat, type StatProps, type TabItem, Table$1 as Table, TableBody$1 as TableBody, TableCell$1 as TableCell, TableHeader$1 as TableHeader, TableRow$1 as TableRow, Tabs, type TabsProps, Textarea, type TextareaProps, Tooltip, type Trend, TruncatedText, type TruncatedTextProps, type UiAiComponentDescriptor, type UiAiComponentProp, type UiThemeToken, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiProjectAiRules, uiThemeContract };
+export { Alert, type AlertProps, ArgonSidebar, AsyncCombobox, type AsyncComboboxProps, Badge, type BadgeProps, Breadcrumb, type BreadcrumbItem, Button$1 as Button, type ButtonProps$1 as ButtonProps, Card$1 as Card, CardAction$1 as CardAction, CardContent$1 as CardContent, CardDescription$1 as CardDescription, CardFooter$1 as CardFooter, CardHeader$1 as CardHeader, CardTitle$1 as CardTitle, Combobox$1 as Combobox, type ComboboxOption$2 as ComboboxOption, FormControl as Control, DataTable$1 as DataTable, type DataTableAlign$1 as DataTableAlign, type DataTableColumn$1 as DataTableColumn, type DataTablePagination$1 as DataTablePagination, type DataTableProps$1 as DataTableProps, type DataTableRowSelection$1 as DataTableRowSelection, type DataTableSortDirection$1 as DataTableSortDirection, type DataTableSortState$1 as DataTableSortState, FormDescription as Description, FormField as Field, Form, FormControl, FormDescription, FormField, type FormFieldProps, FormItem, FormLabel, FormMessage, Input$1 as Input, type InputProps$1 as InputProps, FormItem as Item, FormLabel as Label, LineClampTooltip, type LineClampTooltipProps, Loading, type LoadingProps, index as MainFe, FormMessage as Message, MultiSelect, type MultiSelectOption, NumericInput, type NumericInputProps, type Option, OverflowTooltip, type OverflowTooltipProps, PageTitle$1 as PageTitle, Pagination, type PaginationInfo, type PaginationProps, type PermissionChecker, SearchableSelect, type SearchableSelectOption, type SearchableSelectProps, SectionTitle$1 as SectionTitle, Select, type SelectOption, type SelectProps, Sidebar, SidebarItem, type SidebarProps, Stat, type StatProps, type TabItem, Table$1 as Table, TableBody$1 as TableBody, TableCell$1 as TableCell, TableHeader$1 as TableHeader, TableRow$1 as TableRow, Tabs, type TabsProps, Textarea, type TextareaProps, Tooltip, type Trend, TruncatedText, type TruncatedTextProps, type UiAiComponentDescriptor, type UiAiComponentProp, type UiScreenBriefField, type UiScreenKind, type UiThemePreset, type UiThemeToken, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemePresets };