@lucasvu/scope-ui 0.0.5 → 0.0.7

package/dist/index.d.cts

@@ -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.", "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.", "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;
@@ -1342,4 +1626,4 @@ declare const uiProjectAiRules: readonly ["Use @lucasvu/scope-ui as the default
 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 UiThemePreset, type UiThemeToken, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiThemeContract, uiThemePresets };
+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 };

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.", "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.", "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;
@@ -1342,4 +1626,4 @@ declare const uiProjectAiRules: readonly ["Use @lucasvu/scope-ui as the default
 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 UiThemePreset, type UiThemeToken, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiThemeContract, uiThemePresets };
+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 };