@decantr/content 3.8.0

package/archetypes/service-requests.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "service-requests",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Service Requests",
+  "description": "Citizen service request system with submission forms, map pin placement, kanban tracking, and status timelines. Enables residents to report issues and track resolution.",
+  "tags": [
+    "service-requests",
+    "311",
+    "civic",
+    "mapping",
+    "citizen-reports",
+    "kanban"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "service requests",
+        "311 system",
+        "citizen reports",
+        "issue reporting",
+        "civic requests"
+      ],
+      "secondary": [
+        "report pothole",
+        "issue tracking",
+        "municipal requests"
+      ],
+      "negative": [
+        "customer support",
+        "enterprise ticketing"
+      ]
+    },
+    "implies": [
+      "service-requests",
+      "mapping"
+    ],
+    "weight": 0.8,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "requests",
+      "path": "/requests",
+      "patterns": [
+        {
+          "pattern": "data-table",
+          "preset": "standard",
+          "as": "request-table"
+        },
+        {
+          "pattern": "kanban-board",
+          "preset": "standard",
+          "as": "request-board"
+        }
+      ],
+      "default_layout": [
+        "request-table",
+        "request-board"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "new-request",
+      "path": "/requests/new",
+      "patterns": [
+        {
+          "pattern": "form-sections",
+          "preset": "standard",
+          "as": "request-form"
+        },
+        {
+          "pattern": "map-view",
+          "preset": "pins",
+          "as": "location-picker"
+        }
+      ],
+      "default_layout": [
+        "request-form",
+        "location-picker"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "request-detail",
+      "path": "/requests/:id",
+      "patterns": [
+        {
+          "pattern": "detail-header",
+          "preset": "standard",
+          "as": "request-header"
+        },
+        {
+          "pattern": "timeline",
+          "preset": "standard",
+          "as": "status-timeline"
+        }
+      ],
+      "default_layout": [
+        "request-header",
+        "status-timeline"
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "requests": "Service request management page offers both a data table view with sortable columns for request id, category, location, reporter, status, assigned crew, priority, and SLA age, and a kanban board view with columns for Submitted, Triaged, In Progress, Resolved, and Closed. Users can toggle between views for different workflows.",
+    "new-request": "New request submission page splits into a form-sections panel on the left with category selector, description textarea, photo uploader, and contact fields, paired with a pin-mode map view on the right where the citizen drops a marker on the exact location of the issue. The selected coordinates auto-populate the form.",
+    "request-detail": "Request detail page shows a detail header with request id, category icon, reporter, location address, current status pill, assigned crew, and priority. Below, a status timeline renders every event from submission through triage, assignment, work orders, resolution, and closure, each entry timestamped with the actor and attached photos or notes."
+  },
+  "features": [
+    "service-requests",
+    "mapping"
+  ],
+  "shells": {
+    "sidebar-main": "Left sidebar with request categories and main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "data-table": ">=1.0.0",
+      "kanban-board": ">=1.0.0",
+      "form-sections": ">=1.0.0",
+      "map-view": ">=1.0.0",
+      "detail-header": ">=1.0.0",
+      "timeline": ">=1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "civic",
+      "professional"
+    ],
+    "modes": [
+      "light",
+      "dark"
+    ]
+  }
+}

package/archetypes/session-rooms.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "session-rooms",
+  "role": "auxiliary",
+  "version": "2.1.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Session Rooms",
+  "description": "Live producer rooms for co-production with shared transport, voice presence, cue markers, take queue, room chat, and synchronized session state.",
+  "visual_brief": "Live studio room surface, not a generic meeting UI or sparse room-card grid. The room should foreground synchronized session state: shared transport, current cue, take queue, room latency, voice activity, participant roles, and the track being edited. Room browser cards need explicit BPM/key/latency chips with real gaps or separators; never concatenate metadata like BPM, key, and milliseconds. Desktop should show room previews plus a monitor sidecar, and room detail should be a live-room console with stage, take queue, shared transport, chat notes, and voice sync. Participant visuals are compact and utility-driven. Chat is present but subordinate to the shared session.",
+  "responsive": {
+    "mobile": "Stage first, then horizontal participant strip. Chat, cue markers, and take queue are tabs. Shared transport remains reachable.",
+    "tablet": "Stage and shared transport stay primary; participant and chat rails may stack.",
+    "desktop": "Stage, participant presence, shared transport, cue queue, room monitor, and chat preview can be visible without feeling like a video-call clone."
+  },
+  "accessibility": {
+    "landmarks": ["main", "complementary"],
+    "keyboard": ["Space toggles shared playback", "V mutes voice", "C focuses chat", "Q adds a cue marker"],
+    "notes": "Announce active speaker, room latency changes, and new cue markers."
+  },
+  "tags": ["live-sessions", "voice", "rooms", "music", "co-production", "collaboration"],
+  "classification": {
+    "triggers": {
+      "primary": ["session rooms", "live rooms", "co-producing", "live collab", "studio room"],
+      "secondary": ["voice chat", "video session", "jam rooms", "shared transport"],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 1,
+    "tier": "recommended"
+  },
+  "directives": [
+    "Live rooms should feel like synchronized co-production, not generic video conferencing.",
+    "Shared transport, latency, cue markers, and take queue must be visible.",
+    "Room metadata must use separated chips or aligned columns so BPM, key, and latency never visually run together."
+  ],
+  "pages": [
+    {
+      "id": "rooms",
+      "patterns": [
+        { "pattern": "live-room-stage", "preset": "compact", "as": "room-preview" },
+        { "pattern": "card-grid", "preset": "content", "as": "rooms" },
+        { "pattern": "activity-feed", "preset": "compact", "as": "feed" }
+      ],
+      "default_layout": ["live-room-stage", "card-grid", "activity-feed"],
+      "directives": [
+        "Desktop room browser should combine live room cards with a monitor sidecar for latency, armed takes, next cue, and master-bus status.",
+        "Every room card should show host, status, participants, BPM, key, and latency with explicit spacing."
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "room-detail",
+      "patterns": [
+        { "pattern": "live-room-stage", "preset": "room", "as": "stage" },
+        { "pattern": "daw-transport-bar", "preset": "studio", "as": "shared-transport" },
+        { "pattern": "chat-thread", "preset": "standard", "as": "chat" }
+      ],
+      "default_layout": [
+        "live-room-stage",
+        "daw-transport-bar",
+        "chat-thread"
+      ],
+      "directives": [
+        "The stage should prioritize shared session state, participants, cue markers, and take queue; chat is secondary.",
+        "Desktop room detail should feel like a live-room console, not a tall empty hero panel."
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "rooms": "Browse active and scheduled production rooms. Each room preview shows host, participants, separated BPM/key/latency chips, shared track, status, and join action. Desktop includes a monitor sidecar plus lower cue traffic, patchbay health, and operator roster panels so the page feels like a studio control surface rather than a short card gallery.",
+    "room-detail": "Active live room stage. Shared transport and session state anchor the room, participant tiles show voice/edit status, cue markers and take queue guide recording, and chat supports coordination without overpowering the music workflow. Desktop should show stage, transport, take queue, notes, and voice sync in one composed console."
+  },
+  "features": ["live-sessions", "voice-chat", "shared-transport", "take-queue", "cue-markers"],
+  "shells": {
+    "sidebar-main": "Left navigation sidebar with primary content column"
+  },
+  "dependencies": {
+    "patterns": {
+      "live-room-stage": "^1.1.0",
+      "card-grid": "^1.0.0",
+      "activity-feed": "^1.0.0",
+      "daw-transport-bar": "^1.0.0",
+      "chat-thread": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": ["studio-dark", "carbon-neon"],
+    "modes": ["dark"]
+  }
+}

package/archetypes/settings-full.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "settings-full",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Settings Full",
+  "description": "Complete account settings with profile, security (password, MFA, sessions), preferences (theme, notifications, language), and danger zone.",
+  "tags": [
+    "settings",
+    "account",
+    "profile",
+    "security",
+    "preferences"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "settings",
+        "account settings",
+        "user settings",
+        "preferences"
+      ],
+      "secondary": [
+        "profile",
+        "security",
+        "password",
+        "theme"
+      ],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 1,
+    "tier": "core"
+  },
+  "pages": [
+    {
+      "id": "profile",
+      "patterns": [
+        {
+          "pattern": "account-settings",
+          "preset": "profile",
+          "as": "settings"
+        }
+      ],
+      "default_layout": [
+        "account-settings"
+      ],
+      "shell": "inherit"
+    },
+    {
+      "id": "security",
+      "patterns": [
+        {
+          "pattern": "account-settings",
+          "preset": "security",
+          "as": "security-settings"
+        },
+        {
+          "pattern": "session-manager",
+          "preset": "standard",
+          "as": "sessions"
+        }
+      ],
+      "default_layout": [
+        "account-settings",
+        "sessions"
+      ],
+      "shell": "inherit"
+    },
+    {
+      "id": "preferences",
+      "patterns": [
+        {
+          "pattern": "account-settings",
+          "preset": "preferences",
+          "as": "settings"
+        }
+      ],
+      "default_layout": [
+        "account-settings"
+      ],
+      "shell": "inherit"
+    },
+    {
+      "id": "danger",
+      "patterns": [
+        {
+          "pattern": "account-settings",
+          "preset": "danger-zone",
+          "as": "settings"
+        }
+      ],
+      "default_layout": [
+        "account-settings"
+      ],
+      "shell": "inherit"
+    }
+  ],
+  "page_briefs": {
+    "profile": "Profile settings form with avatar upload, display name, email, and bio fields. Save button at the bottom of each section. Clean grouped form layout.",
+    "security": "Security settings with password change form (current + new password fields), MFA toggle with setup flow, and active sessions table showing device, location, and last-active with revoke buttons.",
+    "preferences": "Preferences form with theme selector (light/dark/auto toggle), notification preference checkboxes, language dropdown, and timezone selector.",
+    "danger": "Danger zone section with red-bordered cards for destructive actions. Export data button, deactivate account toggle, and delete account button with confirmation dialog warning."
+  },
+  "features": [
+    "profile-edit",
+    "password-change",
+    "mfa-management",
+    "session-management",
+    "theme-toggle",
+    "account-deletion"
+  ],
+  "directives": [
+    "Settings pages use the blueprint's primary shell (`sidebar-main` or `top-nav-main` depending on blueprint). Sidebar nav shows settings sub-pages as `d-nav-link` entries.",
+    "Forms use `d-surface` cards with `d-control` inputs. Each settings section is a distinct `d-surface` — do NOT nest one d-surface inside another.",
+    "Dangerous actions (delete account, revoke all sessions) use `d-interactive[data-variant=\"danger\"]` + `d-annotation[data-status=\"warning\"]` for the warning text. A confirmation dialog uses `d-modal` + `d-modal-panel[data-size=\"sm\"]`.",
+    "Theme toggle is a compact `d-icon-btn[data-size=\"sm\"]` in the shell header AND a labeled control in settings/preferences. State flows through the document root `data-mode` attribute, not through inline styles. Persist user choice to `localStorage.setItem('decantr_theme_mode', mode)` and hydrate via `document.documentElement.setAttribute('data-mode', localStorage.getItem('decantr_theme_mode') ?? '<blueprint.theme.mode>')` BEFORE React mounts (place in index.html or a sync top-level script) — avoids flash-of-wrong-theme. The fallback MUST match the blueprint's declared `theme.mode` (look it up in the scaffold-pack); never hardcode `'dark'` for a `light`-mode blueprint.",
+    "MFA toggle rendering: use `d-step-chip[data-step-state=\"done|pending\"]` for completed/pending MFA methods. Session list rows use `d-data` table family.",
+    "Breadcrumbs (when present in the shell header) derive from the current route + the scaffold-pack route table — do NOT hand-map breadcrumbs in each settings page. Use a small helper that reads `window.location.pathname`, splits on `/`, and looks up labels from the navigation_items list. This keeps breadcrumbs in sync when routes change.",
+    "When a settings sub-route is active, the parent shell's primary sidebar MUST collapse the ACCOUNT section to a single \"Settings\" entry (or hide the section entirely) so users do not see the same nav links twice — once in the main sidebar and once in the settings sub-nav middle column. The settings sub-nav (left column inside the settings page itself) is the canonical navigation when within /settings/*; the main sidebar should yield. This is a shell-behavior contract."
+  ],
+  "navigation_items": [
+    {
+      "label": "Profile",
+      "route": "/settings/profile",
+      "icon": "user"
+    },
+    {
+      "label": "Security",
+      "route": "/settings/security",
+      "icon": "shield-check"
+    },
+    {
+      "label": "Preferences",
+      "route": "/settings/preferences",
+      "icon": "sliders-horizontal"
+    },
+    {
+      "label": "Danger zone",
+      "route": "/settings/danger",
+      "icon": "alert-triangle"
+    }
+  ],
+  "shells": {
+    "inherit": "Inherits shell from parent archetype or app context"
+  },
+  "dependencies": {
+    "patterns": {
+      "account-settings": "^1.0.0",
+      "session-manager": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "carbon"
+    ],
+    "modes": [
+      "dark",
+      "light"
+    ]
+  }
+}

package/archetypes/settings.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "settings",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Settings",
+  "description": "Application settings and preferences page",
+  "tags": [
+    "settings",
+    "preferences",
+    "configuration"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "settings",
+        "preferences",
+        "configuration"
+      ],
+      "secondary": [
+        "profile",
+        "account settings",
+        "app config"
+      ],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 0.8,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "settings",
+      "default_layout": [
+        {
+          "pattern": "form-sections",
+          "preset": "settings"
+        }
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "settings": "Single-page settings form with grouped sections separated by dividers. Toggle switches, dropdowns, and text inputs organized by category. Save button at the bottom."
+  },
+  "features": [],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "form-sections": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "auradecantism",
+      "clean"
+    ],
+    "modes": [
+      "dark",
+      "auto"
+    ]
+  }
+}

package/archetypes/source-catalog.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "source-catalog",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Source Catalog",
+  "description": "Data source management with browsable connector catalog, setup wizards, and active connection monitoring.",
+  "tags": [
+    "data",
+    "sources",
+    "connectors",
+    "catalog",
+    "integrations"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "data source catalog",
+        "connector catalog",
+        "source management",
+        "data connectors"
+      ],
+      "secondary": [
+        "database connections",
+        "integration catalog",
+        "data sources",
+        "connector setup"
+      ],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 0.8,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "sources",
+      "patterns": [
+        {
+          "pattern": "data-source-connector",
+          "preset": "catalog",
+          "as": "source-catalog"
+        }
+      ],
+      "default_layout": [
+        "data-source-connector"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "source-detail",
+      "patterns": [
+        {
+          "pattern": "data-source-connector",
+          "preset": "setup",
+          "as": "source-config"
+        },
+        {
+          "pattern": "json-viewer",
+          "preset": "standard",
+          "as": "schema-viewer"
+        }
+      ],
+      "default_layout": [
+        "data-source-connector",
+        "json-viewer"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "connections",
+      "patterns": [
+        {
+          "pattern": "data-source-connector",
+          "preset": "connected",
+          "as": "active-connections"
+        }
+      ],
+      "default_layout": [
+        "data-source-connector"
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "sources": "Source catalog at /sources. Grid of available connector cards organized by category (databases, APIs, file systems, SaaS apps). Each card shows connector icon, name, description, and popularity badge. Search bar and category filter tabs at top. Cards link to setup flow.",
+    "source-detail": "Source configuration at /sources/:id. Setup wizard for the selected connector with credential fields, connection string builder, and test-connection button. Below the config form, a JSON schema viewer shows the discovered schema with tables/collections, column names, and data types after successful connection.",
+    "connections": "Active connections at /connections. Connected-state view shows all configured data sources with health status (connected, degraded, disconnected), last sync time, row count, and latency. Action buttons for editing, re-syncing, and disconnecting. Alert badges on unhealthy connections."
+  },
+  "features": [
+    "sources",
+    "connectors",
+    "schemas"
+  ],
+  "shells": {
+    "sidebar-main": "Persistent left sidebar with navigation, main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "data-source-connector": "^1.0.0",
+      "json-viewer": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "carbon",
+      "technical"
+    ],
+    "modes": [
+      "dark",
+      "light"
+    ]
+  }
+}