@decantr/content 3.8.0

package/archetypes/track-library.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "track-library",
+  "role": "auxiliary",
+  "version": "2.1.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Track Library",
+  "description": "Producer track and stem catalog with waveform previews, searchable production metadata, version history, and quick-open session context.",
+  "visual_brief": "Premium production crate, not an admin table and not a sparse card gallery. Track rows should scan like a music tool: waveform preview, BPM/key chips, status, collaborator initials, version count, last bounce, and quick-open session action. Desktop should combine a dense track browser with a compact session queue or inspector sidecar so the route feels populated and purposeful at wide widths. Use compact rows, quiet borders, subtle selected states, and one accent color for active/hover affordance. Avoid generic card grids unless each card contains real audio/product signal.",
+  "responsive": {
+    "mobile": "Search stays visible. Filters become horizontal chips. Track rows stack waveform first, then metadata, then status/actions.",
+    "tablet": "Use two-column detail/list where space allows; keep waveform previews readable.",
+    "desktop": "Dense list or table with aligned metadata columns, waveform previews, version state, quick actions, and a supporting queue/inspector sidecar visible."
+  },
+  "accessibility": {
+    "landmarks": ["main"],
+    "keyboard": ["Arrow keys move through stems or tracks", "Enter opens selected track", "A adds selected stem to session"],
+    "notes": "Treat waveform previews as decorative unless interactive; label preview and open actions clearly."
+  },
+  "tags": ["music", "tracks", "library", "versions", "catalog", "stems"],
+  "classification": {
+    "triggers": {
+      "primary": ["track library", "song catalog", "music files", "tracks list", "stem library"],
+      "secondary": ["versions", "revisions", "track manager", "sample crate"],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 1,
+    "tier": "recommended"
+  },
+  "directives": [
+    "The library should feel like a production crate, not a generic admin table.",
+    "Every track or stem row needs audio-specific metadata and waveform preview where practical."
+  ],
+  "pages": [
+    {
+      "id": "tracks",
+      "patterns": [
+        { "pattern": "stem-browser", "preset": "library", "as": "browser" },
+        { "pattern": "data-table", "preset": "standard", "as": "catalog" },
+        { "pattern": "search-filter-bar", "preset": "standard", "as": "filters" }
+      ],
+      "default_layout": ["search-filter-bar", "stem-browser", "data-table"],
+      "directives": [
+        "Prioritize waveform previews, BPM, key, status, collaborators, and last bounce over generic table columns.",
+        "On desktop, avoid leaving the lower viewport empty; pair the stem browser with a queue, inspector, or selected-track sidecar."
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "track-detail",
+      "patterns": [
+        { "pattern": "daw-transport-bar", "preset": "studio", "as": "transport" },
+        { "pattern": "arrangement-canvas", "preset": "preview", "as": "arrangement-preview" },
+        { "pattern": "version-history", "preset": "sidebar", "as": "versions" },
+        { "pattern": "session-inspector", "preset": "aside", "as": "inspector" }
+      ],
+      "default_layout": [
+        "daw-transport-bar",
+        { "cols": ["arrangement-canvas", "version-history"], "at": "lg", "span": { "arrangement-canvas": 8, "version-history": 4 } },
+        "session-inspector"
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "tracks": "Searchable producer crate. Search and facets filter by status, BPM, key, collaborator, genre, and usage. The main browser shows dense waveform preview rows with current mix status, contributors, version count, and quick-open session action. Desktop includes a compact session queue or selected-track sidecar so the page does not collapse into sparse cards.",
+    "track-detail": "Track review surface with compact transport, read-only arrangement preview, version timeline, bounce notes, and inspector details for selected version/stem. Version rows must separate label, author/time metadata, and notes with explicit spacing so text never appears concatenated."
+  },
+  "features": ["track-management", "versions", "stem-browser", "waveform-preview"],
+  "shells": {
+    "sidebar-main": "Responsive left navigation sidebar with primary content column"
+  },
+  "dependencies": {
+    "patterns": {
+      "stem-browser": "^1.1.0",
+      "data-table": "^1.0.0",
+      "search-filter-bar": "^1.0.0",
+      "daw-transport-bar": "^1.0.0",
+      "arrangement-canvas": "^1.0.0",
+      "version-history": "^1.0.0",
+      "session-inspector": "^1.1.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": ["studio-dark", "carbon-neon"],
+    "modes": ["dark"]
+  }
+}

package/archetypes/transaction-history.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "transaction-history",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Transaction History",
+  "description": "Financial transaction ledger with filterable data tables, sparkline trend indicators, and transaction detail views.",
+  "tags": ["finance", "transactions", "ledger", "history", "filtering", "2026"],
+  "classification": {
+    "triggers": {
+      "primary": ["transaction history", "transaction ledger", "financial transactions", "account transactions"],
+      "secondary": ["payment history", "transfer history", "transaction list", "bank statement"],
+      "negative": ["ecommerce", "admin", "social"]
+    },
+    "implies": ["filtering", "search"],
+    "weight": 1,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "transactions",
+      "patterns": [
+        {
+          "pattern": "data-table",
+          "preset": "standard",
+          "as": "transaction-table"
+        },
+        {
+          "pattern": "filter-bar",
+          "preset": "standard",
+          "as": "transaction-filters"
+        },
+        {
+          "pattern": "sparkline-cell",
+          "preset": "standard",
+          "as": "trend-sparklines"
+        }
+      ],
+      "default_layout": ["transaction-filters", "transaction-table", "trend-sparklines"],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "transaction-detail",
+      "patterns": [
+        {
+          "pattern": "detail-header",
+          "preset": "standard",
+          "as": "transaction-header"
+        }
+      ],
+      "default_layout": ["transaction-header"],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "transactions": "Filter bar with date range picker, account selector, transaction type chips (income, expense, transfer), and amount range. Data table with date, description, category, amount in monospace (green for credit, red for debit), running balance, and status. Sparkline cells show spending trend per category.",
+    "transaction-detail": "Detail header with transaction amount (large monospace), date, merchant/payee name, category badge, account, and status. Below, metadata fields showing reference number, notes, receipt attachment, and related transactions."
+  },
+  "features": ["filtering", "search", "data-export"],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "suggested_theme": {
+    "ids": ["carbon", "clean"],
+    "modes": ["dark", "auto"]
+  },
+  "dependencies": {
+    "patterns": {
+      "data-table": ">=1.0.0",
+      "filter-bar": ">=1.0.0",
+      "sparkline-cell": ">=1.0.0",
+      "detail-header": ">=1.0.0"
+    },
+    "styles": {}
+  }
+}

package/archetypes/transformation-editor.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "transformation-editor",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Transformation Editor",
+  "description": "SQL and code transformation editor with split-pane layout for writing queries alongside live data preview.",
+  "tags": [
+    "data",
+    "sql",
+    "transformation",
+    "code-editor",
+    "etl"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "transformation editor",
+        "sql editor",
+        "data transformation",
+        "transform builder"
+      ],
+      "secondary": [
+        "query editor",
+        "code transformation",
+        "data mapping",
+        "etl transforms"
+      ],
+      "negative": []
+    },
+    "implies": [],
+    "weight": 0.8,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "transforms",
+      "patterns": [
+        {
+          "pattern": "data-table",
+          "preset": "standard",
+          "as": "transform-list"
+        }
+      ],
+      "default_layout": [
+        "data-table"
+      ],
+      "shell": "sidebar-aside"
+    },
+    {
+      "id": "transform-editor",
+      "patterns": [
+        {
+          "pattern": "split-pane",
+          "preset": "horizontal",
+          "as": "editor-preview"
+        }
+      ],
+      "default_layout": [
+        "split-pane"
+      ],
+      "shell": "sidebar-aside"
+    },
+    {
+      "id": "data-preview",
+      "patterns": [
+        {
+          "pattern": "data-table",
+          "preset": "standard",
+          "as": "sample-data"
+        },
+        {
+          "pattern": "json-viewer",
+          "preset": "standard",
+          "as": "raw-output"
+        }
+      ],
+      "default_layout": [
+        "data-table",
+        "json-viewer"
+      ],
+      "shell": "sidebar-aside"
+    }
+  ],
+  "page_briefs": {
+    "transforms": "Transform list at /transforms. Data table of saved transformations with columns for name, type (SQL, Python, dbt), input source, output destination, last modified, and author. Row actions for editing, duplicating, and deleting. Create-new button opens a blank editor.",
+    "transform-editor": "Transform editor at /transforms/:id. Horizontal split pane with code editor on top (syntax-highlighted SQL or Python with autocomplete for table and column names) and live data preview table on the bottom. Run button executes the transform against sample data and populates the preview. Right aside panel shows column mapping and type inference.",
+    "data-preview": "Data preview at /transforms/:id/preview. Full sample data view with paginated data table showing transformed output rows. Toggle between table view and raw JSON viewer for inspecting individual records. Column headers show inferred types. Row count and execution time displayed in a status bar."
+  },
+  "features": [
+    "sql-editor",
+    "transformations",
+    "data-preview"
+  ],
+  "shells": {
+    "sidebar-aside": "Left sidebar navigation, main content area, right aside panel for context"
+  },
+  "dependencies": {
+    "patterns": {
+      "data-table": "^1.0.0",
+      "split-pane": "^1.0.0",
+      "json-viewer": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "carbon",
+      "technical"
+    ],
+    "modes": [
+      "dark",
+      "light"
+    ]
+  }
+}

package/archetypes/usage-billing.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "usage-billing",
+  "role": "auxiliary",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Usage & Billing",
+  "description": "Usage metering dashboard, plan management, payment configuration, and invoice history for consumption-based SaaS billing.",
+  "tags": [
+    "billing",
+    "usage",
+    "metering",
+    "invoices",
+    "subscription"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "usage billing",
+        "usage metering",
+        "consumption billing",
+        "usage dashboard",
+        "plan management"
+      ],
+      "secondary": [
+        "invoices",
+        "payment method",
+        "billing history",
+        "usage breakdown",
+        "overage"
+      ],
+      "negative": [
+        "free-only",
+        "no-billing"
+      ]
+    },
+    "implies": [
+      "tenant-switcher-dashboard"
+    ],
+    "weight": 0.8,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "usage",
+      "patterns": [
+        {
+          "pattern": "usage-meter",
+          "preset": "breakdown",
+          "as": "meters"
+        },
+        {
+          "pattern": "chart-grid",
+          "preset": "standard",
+          "as": "charts"
+        },
+        {
+          "pattern": "data-table",
+          "preset": "compact",
+          "as": "usage-details"
+        }
+      ],
+      "default_layout": [
+        "meters",
+        "charts",
+        "usage-details"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "billing",
+      "patterns": [
+        {
+          "pattern": "pricing",
+          "preset": "standard",
+          "as": "plan-selector"
+        },
+        {
+          "pattern": "form-sections",
+          "preset": "standard",
+          "as": "payment-form"
+        },
+        {
+          "pattern": "payment-history",
+          "preset": "standard",
+          "as": "recent-payments"
+        }
+      ],
+      "default_layout": [
+        "plan-selector",
+        "payment-form",
+        "recent-payments"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "invoices",
+      "patterns": [
+        {
+          "pattern": "data-table",
+          "preset": "standard",
+          "as": "invoices-table"
+        }
+      ],
+      "default_layout": [
+        "invoices-table"
+      ],
+      "shell": "sidebar-main"
+    }
+  ],
+  "page_briefs": {
+    "usage": "Usage metering dashboard with breakdown meters showing API calls, storage, bandwidth, and compute against plan limits. Chart grid below visualizes usage trends over time with line and bar charts. Compact data table at the bottom lists per-resource usage details with date, quantity, and cost columns.",
+    "billing": "Billing management page. Current plan card at top with upgrade/downgrade options via pricing tier selector. Payment form section for updating card details and billing address. Recent payment history table showing date, amount, status, and receipt download links. Next invoice preview card.",
+    "invoices": "Full invoice history in a standard data table with columns for invoice number, date, amount, status, and PDF download. Filter bar at top for date range and status filtering. Pagination for large invoice histories."
+  },
+  "features": [
+    "billing",
+    "usage-metering",
+    "invoices",
+    "plans"
+  ],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "usage-meter": "^1.0.0",
+      "chart-grid": "^1.0.0",
+      "data-table": "^1.0.0",
+      "pricing": "^1.0.0",
+      "form-sections": "^1.0.0",
+      "payment-history": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "carbon",
+      "clean"
+    ],
+    "modes": [
+      "dark",
+      "light"
+    ]
+  }
+}

package/archetypes/user-dashboard.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://decantr.ai/schemas/archetype.v2.json",
+  "id": "user-dashboard",
+  "role": "primary",
+  "version": "1.1.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "User Dashboard",
+  "description": "Authenticated user area with content management, billing, API key management, team governance, account settings, and activity overview. The shell and page surfaces should all read from one coherent workspace state for identity, entitlements, and active organization.",
+  "tags": [
+    "dashboard",
+    "user",
+    "account",
+    "settings",
+    "api-keys"
+  ],
+  "classification": {
+    "triggers": {
+      "primary": [
+        "dashboard",
+        "account",
+        "user-area",
+        "my-content"
+      ],
+      "secondary": [
+        "api-keys",
+        "settings",
+        "profile",
+        "activity"
+      ],
+      "negative": []
+    },
+    "implies": [
+      "auth"
+    ],
+    "weight": 0.9,
+    "tier": "recommended"
+  },
+  "pages": [
+    {
+      "id": "overview",
+      "path": "/dashboard",
+      "default_layout": [
+        "kpi-grid",
+        "reputation-badge",
+        "activity-feed"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "content",
+      "path": "/dashboard/content",
+      "default_layout": [
+        "content-card-grid"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "content-new",
+      "path": "/dashboard/content/new",
+      "default_layout": [
+        "form",
+        "json-viewer"
+      ],
+      "shell": "sidebar-main",
+      "notes": "Create new content item. Form with metadata fields + JSON editor."
+    },
+    {
+      "id": "api-keys",
+      "path": "/dashboard/api-keys",
+      "default_layout": [
+        "api-key-row"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "settings",
+      "path": "/dashboard/settings",
+      "default_layout": [
+        "account-settings"
+      ],
+      "shell": "sidebar-main"
+    },
+    {
+      "id": "billing",
+      "path": "/dashboard/billing",
+      "default_layout": [
+        "tier-upgrade-card",
+        "kpi-grid"
+      ],
+      "shell": "sidebar-main",
+      "notes": "Billing and subscription management."
+    },
+    {
+      "id": "team",
+      "path": "/dashboard/team",
+      "default_layout": [
+        "kpi-grid",
+        "team-member-row"
+      ],
+      "shell": "sidebar-main",
+      "notes": "Team overview and member management."
+    },
+    {
+      "id": "governance",
+      "path": "/dashboard/governance",
+      "default_layout": [
+        "org-governance-panel"
+      ],
+      "shell": "sidebar-main",
+      "notes": "Organization governance workspace for approval policy, pending reviews, and audit history."
+    }
+  ],
+  "page_briefs": {
+    "overview": "User home dashboard. KPI cards at top showing published items, downloads, and reputation score. Reputation badge below. Activity feed at the bottom. The page should remain readable inside the sidebar shell across desktop, tablet, and drawer-based mobile layouts. KPI and reputation surfaces should agree with the same workspace identity and entitlement state used by billing, settings, and the shell.",
+    "content": "Content management workspace. When a single section contains both a discovery/filter panel and results, they should be grouped through a workspace-region-stack so the search surface and the result grid never visually collide. Private/org package visibility and registry actions should respect the active organization and entitlement state instead of recomputing them page-locally.",
+    "content-new": "Content creation page. Form and live contract preview sit side-by-side when space allows, then stack vertically below tablet widths without either pane feeling artificially cramped. Target options, organization selection, and private visibility rules must all flow from the same workspace entitlement model used by the shell and billing surface.",
+    "api-keys": "API key management page. Prefer responsive key cards or rows that can collapse into stacked surfaces on smaller widths instead of holding a rigid multi-column table. Personal vs organization key creation should use the shared workspace entitlement and active-organization state rather than separate profile fetches.",
+    "settings": "Account settings workspace with responsive navigation. Vertical tabs on larger widths, horizontal scrollable tabs or segmented navigation on smaller widths. Forms stay aligned to the shell spacing rhythm. Profile fields should hydrate from the same workspace identity summary shown in the shell.",
+    "billing": "Billing overview with current plan summary, usage stats, and responsive plan comparison cards. KPI regions, entitlement summaries, and plan comparison regions should stack through a workspace-region-stack inside labeled sections. Pricing cards should use staged or auto-fit columns, never a fixed four-up comparison grid. Current-plan state must come from the same normalized commercial model used by shell and route gating.",
+    "team": "Team dashboard with member and seat KPIs at top. When a members section contains both an invite/control surface and a results list or empty state, those children must flow through a workspace-region-stack. Member management rows degrade into stacked or card-like compositions on narrow widths. Invite and organization controls stack instead of compressing, and only appear when the shared workspace state says organization collaboration is actually available.",
+    "governance": "Organization governance workspace with one strong intro/action panel, policy controls, pending approval review, and a compact audit log. CTA language should feel like purposeful workspace navigation rather than generic button rows. Organization selection, permission to manage policy, and approval visibility should all be grounded in the active workspace organization state."
+  },
+  "features": [
+    "auth",
+    "api-keys"
+  ],
+  "shells": {
+    "sidebar-main": "Sidebar navigation with main content area"
+  },
+  "dependencies": {
+    "patterns": {
+      "kpi-grid": "^1.1.0",
+      "reputation-badge": "^1.0.0",
+      "activity-feed": "^1.1.0",
+      "content-card-grid": "^1.3.0",
+      "workspace-region-stack": "^1.0.0",
+      "api-key-row": "^1.1.0",
+      "account-settings": "^1.1.0",
+      "form": "^1.0.0",
+      "json-viewer": "^1.0.0",
+      "tier-upgrade-card": "^1.1.0",
+      "team-member-row": "^1.1.0",
+      "org-governance-panel": "^1.0.0"
+    },
+    "styles": {}
+  },
+  "suggested_theme": {
+    "ids": [
+      "luminarum"
+    ],
+    "modes": [
+      "dark"
+    ]
+  }
+}