docs: add nodedc ui guideline registry

2026-05-01 22:28:34 +03:00
parent 85aa322990
commit c99c91c826
26 changed files with 1209 additions and 0 deletions
@@ -0,0 +1,47 @@
+{
+  "id": "admin-catalog",
+  "name": "AdminCatalogRecipe",
+  "summary": "Composition for launcher admin panel and catalog-style admin sections.",
+  "components": [
+    "admin-side-nav",
+    "admin-table",
+    "status-control",
+    "calendar-popover",
+    "circle-action-button",
+    "entity-modal",
+    "media-source-field",
+    "dropdown-surface",
+    "action-dropdown"
+  ],
+  "layout": {
+    "base": "left AdminSideNav + optional AdminTable content + decorative compressed stage media",
+    "navOnly": "stage squeezes but keeps showcase controls",
+    "contentOpen": "content table opens next to nav; stage becomes narrow decorative media"
+  },
+  "compositionRules": [
+    "Admin nav buttons use the same row geometry as project quick-select buttons.",
+    "Table create actions are circular plus buttons.",
+    "Inline status fields use StatusControl, not native select UI.",
+    "Dates use CalendarPopover, with Task Manager calendar as reference.",
+    "Edit opens EntityModal; content/media uses MediaSourceField.",
+    "All dropdowns use portal/fixed layer."
+  ],
+  "sourceRefs": [
+    {
+      "project": "nodedc_launcher",
+      "files": [
+        "src/widgets/admin-overlay/AdminOverlay.tsx",
+        "src/styles/globals.css"
+      ]
+    },
+    {
+      "project": "nodedc_taskmanager",
+      "files": [
+        "plane-src/apps/web/core/components/dropdowns/date.tsx",
+        "plane-src/packages/ui/src/dropdowns/action-dropdown.tsx",
+        "plane-src/apps/web/styles/globals.css"
+      ]
+    }
+  ]
+}
+
@@ -0,0 +1,39 @@
+{
+  "id": "launcher-shell",
+  "name": "LauncherShellRecipe",
+  "summary": "Composition for NODE.DC launcher main screen.",
+  "components": [
+    "app-header",
+    "segmented-nav",
+    "launcher-showcase-stage",
+    "service-rail-card",
+    "circle-action-button",
+    "status-control",
+    "glass-panel"
+  ],
+  "layout": {
+    "root": "dark monocolor app background",
+    "top": "NodeDcAppHeader",
+    "center": "LauncherShowcaseStage",
+    "bottom": "ServiceRailCard collection in rail strip"
+  },
+  "compositionRules": [
+    "Header stays visually identical to Task Manager header where possible.",
+    "Stage and rail respect pagePad and panelGap tokens.",
+    "Selected service opens the stage detail; repeat click can close detail where the screen supports collapsed state.",
+    "Rail uses ambient media under glass, clipped to the strip."
+  ],
+  "sourceRefs": [
+    {
+      "project": "nodedc_launcher",
+      "files": [
+        "src/app/LauncherApp.tsx",
+        "src/widgets/top-bar/TopBar.tsx",
+        "src/widgets/service-stage/ServiceStage.tsx",
+        "src/widgets/service-rail/ServiceRail.tsx",
+        "src/styles/globals.css"
+      ]
+    }
+  ]
+}
+
@@ -0,0 +1,40 @@
+{
+  "id": "task-manager-board",
+  "name": "TaskManagerBoardRecipe",
+  "summary": "Composition for Task Manager project board, including kanban cards, action dropdowns, profile menu, and calendar.",
+  "components": [
+    "app-header",
+    "segmented-nav",
+    "work-item-card",
+    "action-dropdown",
+    "dropdown-surface",
+    "calendar-popover",
+    "profile-menu",
+    "circle-action-button"
+  ],
+  "layout": {
+    "top": "Task Manager header with active route segmented nav and profile cluster",
+    "board": "kanban columns with WorkItemCard items",
+    "floatingMenus": "ActionDropdown and selection dropdowns on portal layer",
+    "date": "CalendarPopover for task start/target dates"
+  },
+  "compositionRules": [
+    "Card ellipsis uses ActionDropdown.",
+    "Date chips open CalendarPopover.",
+    "Profile avatar opens ProfileMenu through ActionDropdown menuContent.",
+    "All popovers use DropdownSurface and never render inline inside cards."
+  ],
+  "sourceRefs": [
+    {
+      "project": "nodedc_taskmanager",
+      "files": [
+        "plane-src/apps/web/core/components/issues/issue-layouts/shared/nodedc-work-item-card.tsx",
+        "plane-src/apps/web/core/components/workspace/sidebar/user-menu-root.tsx",
+        "plane-src/apps/web/core/components/dropdowns/date.tsx",
+        "plane-src/packages/ui/src/dropdowns/action-dropdown.tsx",
+        "plane-src/apps/web/styles/globals.css"
+      ]
+    }
+  ]
+}
+