@lucasvu/scope-ui 0.0.5 → 0.0.7

package/dist/index.js

@@ -6625,6 +6625,7 @@ var uiAiManifest = {
   rules: [
     "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.",
@@ -6840,6 +6841,213 @@ var uiAiManifest = {
   ]
 };
 
+// src/screen-blueprint.ts
+var uiScreenBriefFields = [
+  {
+    id: "pageKind",
+    label: "Page kind",
+    description: "Choose the base recipe for the screen.",
+    required: true,
+    appliesTo: ["all"],
+    example: "list"
+  },
+  {
+    id: "routeUrl",
+    label: "Route URL",
+    description: "Final route for the screen or feature entry.",
+    required: true,
+    appliesTo: ["all"],
+    example: "/admin/users"
+  },
+  {
+    id: "sidebarItems",
+    label: "Sidebar items",
+    description: "Sidebar entries with at least id, title, and href so the shell stays consistent.",
+    required: true,
+    appliesTo: ["all"],
+    example: '[{ id: "users", title: "Users", href: "/admin/users" }]'
+  },
+  {
+    id: "activeSidebarItemId",
+    label: "Active sidebar item id",
+    description: "The sidebar item that should appear active on this screen.",
+    required: true,
+    appliesTo: ["all"],
+    example: "users"
+  },
+  {
+    id: "breadcrumbs",
+    label: "Breadcrumbs",
+    description: "Ordered breadcrumb items for the page header.",
+    required: false,
+    appliesTo: ["all"],
+    example: '[{ label: "Admin", href: "/admin" }, { label: "Users", current: true }]'
+  },
+  {
+    id: "pageTitle",
+    label: "Page title",
+    description: "Main page heading shown in the content header.",
+    required: true,
+    appliesTo: ["all"],
+    example: "Users"
+  },
+  {
+    id: "pageSubtitle",
+    label: "Page subtitle",
+    description: "Short supporting text under the title.",
+    required: false,
+    appliesTo: ["all"],
+    example: "Manage internal user accounts and permissions."
+  },
+  {
+    id: "primaryAction",
+    label: "Primary action",
+    description: "The highest-emphasis action shown in the page header.",
+    required: false,
+    appliesTo: ["all"],
+    example: '{ label: "Create user", href: "/admin/users/create" }'
+  },
+  {
+    id: "secondaryActions",
+    label: "Secondary actions",
+    description: "Additional header actions such as export, refresh, or cancel.",
+    required: false,
+    appliesTo: ["all"],
+    example: '[{ label: "Export" }, { label: "Refresh" }]'
+  },
+  {
+    id: "summaryStats",
+    label: "Summary stats",
+    description: "Top-line numbers for dashboard or overview screens.",
+    required: false,
+    appliesTo: ["dashboard", "detail"],
+    example: '[{ label: "Active users", value: "1,204", trend: "up", delta: "+12%" }]'
+  },
+  {
+    id: "filters",
+    label: "Filters",
+    description: "Filter bar controls shown above list or dashboard content.",
+    required: false,
+    appliesTo: ["list", "dashboard"],
+    example: '[{ type: "search", label: "Search user" }, { type: "select", label: "Role" }]'
+  },
+  {
+    id: "tableColumns",
+    label: "Table columns",
+    description: "Columns for a list table, including label and render intent.",
+    required: false,
+    appliesTo: ["list", "detail", "dashboard"],
+    example: '[{ key: "name", title: "Name" }, { key: "role", title: "Role" }]'
+  },
+  {
+    id: "rowActions",
+    label: "Row actions",
+    description: "Per-row actions for table screens.",
+    required: false,
+    appliesTo: ["list", "detail"],
+    example: '[{ label: "Edit" }, { label: "Reset password" }]'
+  },
+  {
+    id: "formSections",
+    label: "Form sections",
+    description: "Grouped form sections and the fields inside each section.",
+    required: false,
+    appliesTo: ["form"],
+    example: '[{ title: "Basic info", fields: ["name", "email", "role"] }]'
+  },
+  {
+    id: "fields",
+    label: "Fields",
+    description: "Detailed field list with type, label, required state, and helper text.",
+    required: false,
+    appliesTo: ["form", "detail"],
+    example: '[{ name: "email", type: "input", label: "Email", required: true }]'
+  },
+  {
+    id: "detailSections",
+    label: "Detail sections",
+    description: "Cards or sections for detail pages such as profile, activity, permissions, or related records.",
+    required: false,
+    appliesTo: ["detail"],
+    example: '[{ title: "Profile" }, { title: "Recent activity" }]'
+  },
+  {
+    id: "emptyState",
+    label: "Empty state",
+    description: "Fallback title, description, and action when there is no data.",
+    required: false,
+    appliesTo: ["list", "dashboard", "detail"],
+    example: '{ title: "No users yet", description: "Create the first user to get started." }'
+  },
+  {
+    id: "permissions",
+    label: "Permissions",
+    description: "Permission keys that affect sidebar visibility or action availability.",
+    required: false,
+    appliesTo: ["all"],
+    example: '["user.read", "user.write"]'
+  }
+];
+var uiScreenBlueprint = {
+  pageKinds: [
+    {
+      id: "list",
+      label: "List page",
+      frame: [
+        "Sidebar shell",
+        "Breadcrumb",
+        "PageTitle with actions",
+        "Optional stats",
+        "Filter card",
+        "DataTable card"
+      ]
+    },
+    {
+      id: "form",
+      label: "Form page",
+      frame: [
+        "Sidebar shell",
+        "Breadcrumb",
+        "PageTitle with primary and cancel actions",
+        "Sectioned form cards",
+        "Bottom action row"
+      ]
+    },
+    {
+      id: "detail",
+      label: "Detail page",
+      frame: [
+        "Sidebar shell",
+        "Breadcrumb",
+        "PageTitle with status/actions",
+        "Summary stats or metadata card",
+        "Detail cards and related tables"
+      ]
+    },
+    {
+      id: "dashboard",
+      label: "Dashboard page",
+      frame: [
+        "Sidebar shell",
+        "Breadcrumb",
+        "PageTitle with actions",
+        "Stat cards row",
+        "Filters",
+        "Main insight cards and tables"
+      ]
+    }
+  ],
+  workflow: [
+    "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."
+  ],
+  briefFields: uiScreenBriefFields
+};
+
 // src/theme-contract.ts
 var uiThemePresets = [
   {
@@ -7215,4 +7423,4 @@ var uiProjectAiRules = [
   "Prefer root exports and avoid MainFe unless the task explicitly targets a legacy screen."
 ];
 
-export { Alert, ArgonSidebar, AsyncCombobox, Badge, Breadcrumb, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Combobox, FormControl as Control, DataTable, FormDescription as Description, FormField as Field, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, Input, FormItem as Item, FormLabel as Label, LineClampTooltip, Loading, main_fe_exports as MainFe, FormMessage as Message, MultiSelect, NumericInput, OverflowTooltip, PageTitle, Pagination, SearchableSelect, SectionTitle, Select, Sidebar, SidebarItem, Stat, Table, TableBody, TableCell, TableHeader, TableRow, Tabs, Textarea, Tooltip, TruncatedText, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiThemeContract, uiThemePresets };
+export { Alert, ArgonSidebar, AsyncCombobox, Badge, Breadcrumb, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Combobox, FormControl as Control, DataTable, FormDescription as Description, FormField as Field, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, Input, FormItem as Item, FormLabel as Label, LineClampTooltip, Loading, main_fe_exports as MainFe, FormMessage as Message, MultiSelect, NumericInput, OverflowTooltip, PageTitle, Pagination, SearchableSelect, SectionTitle, Select, Sidebar, SidebarItem, Stat, Table, TableBody, TableCell, TableHeader, TableRow, Tabs, Textarea, Tooltip, TruncatedText, cn, defaultPermissionChecker, filterSidebarItems, hasActiveDescendant, uiAiManifest, uiDefaultThemePreset, uiProjectAiRules, uiScreenBlueprint, uiScreenBriefFields, uiThemeContract, uiThemePresets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucasvu/scope-ui",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",