@vadimcomanescu/nadicode-design-system 2.0.6 → 2.0.8

package/contracts/consumer-intent-map.json

@@ -0,0 +1,707 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedFrom": {
+    "registryPath": "contracts/public-surface-registry.json",
+    "registrySchemaVersion": "1.0.0"
+  },
+  "intents": {
+    "agents-chat": {
+      "pageKitSubpath": "./agents-chat-page-kit",
+      "pageKitExport": "AgentsChatPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/agents-chat-page-kit",
+      "routePatterns": [
+        "/workspace/agents"
+      ],
+      "requiredStates": [
+        "empty",
+        "loading",
+        "thinking",
+        "blocked-approval",
+        "failed",
+        "running",
+        "complete"
+      ],
+      "shellDependencies": [
+        "./navigation-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Agentic chat routes compose inside the authenticated navigation shell contract.",
+        "Consumers provide run orchestration and approval callbacks while Seed owns layout scaffolding."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/agents-chat.md",
+      "suite": "workspace-shell"
+    },
+    "analytics": {
+      "pageKitSubpath": "./analytics-page-kit",
+      "pageKitExport": "AnalyticsPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/analytics-page-kit",
+      "routePatterns": [
+        "/analytics"
+      ],
+      "requiredStates": [
+        "loading",
+        "empty",
+        "error",
+        "filtered",
+        "has-data",
+        "partial-data"
+      ],
+      "shellDependencies": [
+        "./navigation-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Analytics routes compose this page kit inside the stable navigation shell contract.",
+        "Consumers own filtering logic and query orchestration while Seed owns structural chart and grid coordination."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/analytics.md",
+      "suite": "workspace-shell"
+    },
+    "auth-account-locked": {
+      "pageKitSubpath": "./account-locked-page-kit",
+      "pageKitExport": "AccountLockedPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/account-locked-page-kit",
+      "routePatterns": [
+        "/auth/locked"
+      ],
+      "requiredStates": [
+        "too-many-attempts",
+        "suspicious-activity",
+        "admin-lock",
+        "support-contact"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Locked-account routes can render this page kit directly without custom layout overrides.",
+        "Consumers provide support and back-to-login handlers as app-owned inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-login": {
+      "pageKitSubpath": "./login-page-kit",
+      "pageKitExport": "LoginPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/login-page-kit",
+      "routePatterns": [
+        "/login"
+      ],
+      "requiredStates": [
+        "default",
+        "submitting",
+        "error",
+        "social-enabled",
+        "social-disabled"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Unauthenticated sign-in routes can compose this page kit directly.",
+        "Consumers supply auth action wiring, provider hooks, and route links as inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-recovery": {
+      "pageKitSubpath": "./recovery-page-kit",
+      "pageKitExport": "RecoveryPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/recovery-page-kit",
+      "routePatterns": [
+        "/recover"
+      ],
+      "requiredStates": [
+        "reset-link",
+        "magic-link",
+        "submitting",
+        "success"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Password-recovery routes can render this page kit without app-specific layout rewrites.",
+        "Consumers provide recovery submission handlers and retry/back navigation callbacks."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-reset": {
+      "pageKitSubpath": "./reset-page-kit",
+      "pageKitExport": "ResetPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/reset-page-kit",
+      "routePatterns": [
+        "/reset-password"
+      ],
+      "requiredStates": [
+        "default",
+        "validating",
+        "submitting",
+        "error"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Password-reset routes can compose this page kit as a standalone page artifact.",
+        "Consumers supply password reset submission and route fallback callbacks."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-signup": {
+      "pageKitSubpath": "./signup-page-kit",
+      "pageKitExport": "SignupPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/signup-page-kit",
+      "routePatterns": [
+        "/signup"
+      ],
+      "requiredStates": [
+        "default",
+        "submitting",
+        "error",
+        "social-enabled",
+        "social-disabled"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Unauthenticated signup routes can compose this page kit directly.",
+        "Consumers provide signup action wiring and account-route destinations."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-success": {
+      "pageKitSubpath": "./success-page-kit",
+      "pageKitExport": "SuccessPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/success-page-kit",
+      "routePatterns": [
+        "/auth/success"
+      ],
+      "requiredStates": [
+        "default",
+        "auto-redirect",
+        "manual-continue"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Consumers can use this page kit for generic auth completion success routes.",
+        "Consumers pass success copy, optional redirect timing, and continue actions as inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-two-factor": {
+      "pageKitSubpath": "./two-factor-page-kit",
+      "pageKitExport": "TwoFactorPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/two-factor-page-kit",
+      "routePatterns": [
+        "/auth/2fa"
+      ],
+      "requiredStates": [
+        "challenge",
+        "setup",
+        "invalid-code",
+        "verification-success",
+        "backup-codes"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Two-factor routes can render this page kit for both challenge and setup states.",
+        "Consumers wire verification callbacks, backup-code flows, and navigation handlers."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "auth-verify-email": {
+      "pageKitSubpath": "./verify-email-page-kit",
+      "pageKitExport": "VerifyEmailPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/verify-email-page-kit",
+      "routePatterns": [
+        "/auth/verify-email"
+      ],
+      "requiredStates": [
+        "verification-success",
+        "auto-redirect",
+        "manual-continue"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Email-verification completion routes can render this page kit as a terminal auth flow state.",
+        "Consumers pass continue actions and optional redirect timing policy as inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/auth.md",
+      "suite": "auth"
+    },
+    "blog-content": {
+      "pageKitSubpath": "./blog-content-page-kit",
+      "pageKitExport": "BlogContentPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/blog-content-page-kit",
+      "routePatterns": [
+        "/blog",
+        "/blog/:slug",
+        "/changelog"
+      ],
+      "requiredStates": [
+        "loading",
+        "has-data",
+        "filtered",
+        "paginated",
+        "empty"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Blog and changelog routes compose through the stable marketing shell contract.",
+        "Consumers provide content data, taxonomy, and pagination callbacks as declared inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/blog-content.md",
+      "suite": "marketing-shell"
+    },
+    "checkout": {
+      "pageKitSubpath": "./checkout-page-kit",
+      "pageKitExport": "CheckoutPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/checkout-page-kit",
+      "routePatterns": [
+        "/checkout",
+        "/checkout/success"
+      ],
+      "requiredStates": [
+        "default",
+        "submitting",
+        "processing",
+        "error",
+        "success"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Checkout routes compose within the stable marketing shell contract.",
+        "Consumers own payment orchestration and billing actions while Seed owns structure and state presentation."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/checkout.md",
+      "suite": "marketing-shell"
+    },
+    "company-suite": {
+      "pageKitSubpath": "./company-suite-page-kit",
+      "pageKitExport": "CompanySuitePageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/company-suite-page-kit",
+      "routePatterns": [
+        "/company/about",
+        "/company/contact"
+      ],
+      "requiredStates": [
+        "company-about",
+        "company-contact",
+        "optional-sections"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Company-facing about and contact routes compose through the stable marketing shell contract.",
+        "Consumers keep contact handling app-owned while Seed owns route composition."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/company-about.md",
+      "suite": "marketing-shell"
+    },
+    "crud-form": {
+      "pageKitSubpath": "./crud-form-page-kit",
+      "pageKitExport": "CrudFormPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/crud-form-page-kit",
+      "routePatterns": [
+        "/resources/:resourceType/new",
+        "/resources/:resourceType/:id/edit"
+      ],
+      "requiredStates": [
+        "pristine",
+        "dirty",
+        "validating",
+        "validation-error",
+        "submitting",
+        "saved",
+        "fatal-error"
+      ],
+      "shellDependencies": [
+        "./navigation-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Create and edit routes compose this page kit inside stable app shell contracts.",
+        "Consumers own validation schemas and persistence while Seed owns form section and action layout scaffolding."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/crud-form.md",
+      "suite": "workspace-shell"
+    },
+    "crud-list-detail": {
+      "pageKitSubpath": "./crud-list-detail-page-kit",
+      "pageKitExport": "CrudListDetailPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/crud-list-detail-page-kit",
+      "routePatterns": [
+        "/resources/:resourceType",
+        "/resources/:resourceType/:id"
+      ],
+      "requiredStates": [
+        "loading",
+        "empty",
+        "filtered",
+        "selected-row",
+        "error",
+        "has-data"
+      ],
+      "shellDependencies": [
+        "./navigation-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Entity management routes compose this page kit inside the stable navigation shell contract.",
+        "Consumers own query and mutation wiring while Seed owns list, detail, filter, and pagination structure."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/crud-list-detail.md",
+      "suite": "workspace-shell"
+    },
+    "dashboard": {
+      "pageKitSubpath": "./dashboard-page-kit",
+      "pageKitExport": "DashboardPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/dashboard-page-kit",
+      "routePatterns": [
+        "/dashboard"
+      ],
+      "requiredStates": [
+        "loading",
+        "empty",
+        "error",
+        "has-data",
+        "partial-data"
+      ],
+      "shellDependencies": [
+        "./navigation-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Authenticated dashboard routes compose this page kit inside the stable navigation shell contract.",
+        "Consumers provide KPI and chart datasets while Seed owns layout, state scaffolding, and empty-state behavior."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/dashboard.md",
+      "suite": "workspace-shell"
+    },
+    "error": {
+      "pageKitSubpath": "./error-page-kit",
+      "pageKitExport": "ErrorPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/error-page-kit",
+      "routePatterns": [
+        "/404",
+        "/500",
+        "/*"
+      ],
+      "requiredStates": [
+        "not-found",
+        "server-error",
+        "generic-fallback"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Error routes can render standalone without requiring app or marketing shell wrappers.",
+        "Consumers provide recovery actions and metadata while Seed owns fallback layout and branding scaffolding."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/error-pages.md",
+      "suite": "fallback",
+      "tieBreakGroup": "fallback",
+      "tieBreakPriority": 0
+    },
+    "kanban-board": {
+      "pageKitSubpath": "./kanban-board-page-kit",
+      "pageKitExport": "KanbanBoardPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/kanban-board-page-kit",
+      "routePatterns": [
+        "/boards/:boardId",
+        "/pipelines/:pipelineId"
+      ],
+      "requiredStates": [
+        "loading",
+        "empty",
+        "dragging",
+        "move-failed",
+        "has-data"
+      ],
+      "shellDependencies": [
+        "./crud-list-detail-page-kit"
+      ],
+      "shellAssumptions": [
+        "Board-style execution routes compose this page kit under authenticated shell contracts.",
+        "Consumers own board mutation and persistence while Seed owns board structure and move-failure presentation."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/crud-list-detail.md",
+      "suite": "workspace-shell"
+    },
+    "marketing-landing": {
+      "pageKitSubpath": "./landing-page-kit",
+      "pageKitExport": "LandingPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/landing-page-kit",
+      "routePatterns": [
+        "/"
+      ],
+      "requiredStates": [
+        "default",
+        "mobile-navigation",
+        "optional-sections",
+        "reordered-sections"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Primary marketing routes such as / and /landing compose through the stable marketing shell.",
+        "Consumers pass section copy, links, and optionality through declared props without shell rewrites."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/marketing-landing.md",
+      "suite": "marketing-shell"
+    },
+    "onboarding": {
+      "pageKitSubpath": "./onboarding-page-kit",
+      "pageKitExport": "OnboardingPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/onboarding-page-kit",
+      "routePatterns": [
+        "/onboarding",
+        "/onboarding/:step"
+      ],
+      "requiredStates": [
+        "default",
+        "active-step",
+        "validation-error",
+        "saving",
+        "complete"
+      ],
+      "shellDependencies": [
+        "./crud-form-page-kit"
+      ],
+      "shellAssumptions": [
+        "Onboarding routes use this page kit to structure steps while app logic owns completion persistence.",
+        "Consumers provide step content and transitions as data, not by patching internal layout."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/onboarding.md",
+      "suite": "workspace-shell"
+    },
+    "pricing": {
+      "pageKitSubpath": "./pricing-page-kit",
+      "pageKitExport": "PricingPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/pricing-page-kit",
+      "routePatterns": [
+        "/pricing"
+      ],
+      "requiredStates": [
+        "default",
+        "billing-toggle",
+        "loading-action",
+        "empty-plan"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Dedicated pricing routes compose through the stable marketing shell contract.",
+        "Plan data, checkout links, and billing behavior are app-owned inputs."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/pricing.md",
+      "suite": "marketing-shell"
+    },
+    "profile-settings": {
+      "pageKitSubpath": "./profile-settings-page-kit",
+      "pageKitExport": "ProfileSettingsPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/profile-settings-page-kit",
+      "routePatterns": [
+        "/settings/profile"
+      ],
+      "requiredStates": [
+        "view",
+        "edit",
+        "dirty",
+        "saving",
+        "saved",
+        "validation-error",
+        "fatal-error"
+      ],
+      "shellDependencies": [
+        "./settings-page-kit"
+      ],
+      "shellAssumptions": [
+        "Profile settings routes can render standalone or inside the broader settings-page-kit navigation model.",
+        "Consumers own account persistence, upload transport, and auth-ownership checks while Seed owns profile form structure."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/settings.md",
+      "suite": "workspace-shell"
+    },
+    "service-suite": {
+      "pageKitSubpath": "./service-suite-page-kit",
+      "pageKitExport": "ServiceSuitePageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/service-suite-page-kit",
+      "routePatterns": [
+        "/services",
+        "/services/digital-workers",
+        "/services/:slug"
+      ],
+      "requiredStates": [
+        "agency-home",
+        "digital-workers",
+        "service-detail",
+        "optional-sections"
+      ],
+      "shellDependencies": [
+        "./marketing-shell-page-kit"
+      ],
+      "shellAssumptions": [
+        "Service-family marketing routes compose through the stable marketing shell contract.",
+        "Route variants are selected through explicit props, not bespoke per-route shell implementations."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/service-detail.md",
+      "suite": "marketing-shell"
+    },
+    "settings": {
+      "pageKitSubpath": "./settings-page-kit",
+      "pageKitExport": "SettingsPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/settings-page-kit",
+      "routePatterns": [
+        "/settings"
+      ],
+      "requiredStates": [
+        "loading",
+        "default",
+        "dirty",
+        "saving",
+        "saved",
+        "validation-error",
+        "fatal-error"
+      ],
+      "shellDependencies": [],
+      "shellAssumptions": [
+        "Settings routes use this page kit to unify section navigation and save-state messaging.",
+        "Consumers own validation and persistence while Seed owns navigation, state banners, and section scaffolding."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/settings.md",
+      "suite": "workspace-shell"
+    },
+    "team-settings": {
+      "pageKitSubpath": "./team-settings-page-kit",
+      "pageKitExport": "TeamSettingsPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/team-settings-page-kit",
+      "routePatterns": [
+        "/settings/team"
+      ],
+      "requiredStates": [
+        "loading",
+        "empty",
+        "filtered",
+        "invited-member",
+        "active-member",
+        "saving",
+        "fatal-error"
+      ],
+      "shellDependencies": [
+        "./crud-list-detail-page-kit"
+      ],
+      "shellAssumptions": [
+        "Workspace-member settings routes use this page kit as the canonical team roster contract.",
+        "Consumers own invite workflow, seat rules, and authorization policy while Seed owns roster presentation structure."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/settings.md",
+      "suite": "workspace-shell"
+    },
+    "voice-agents": {
+      "pageKitSubpath": "./voice-agents-page-kit",
+      "pageKitExport": "VoiceAgentsPageKit",
+      "canonicalImport": "@vadimcomanescu/nadicode-design-system/voice-agents-page-kit",
+      "routePatterns": [
+        "/workspace/voice-agents"
+      ],
+      "requiredStates": [
+        "agent-selection",
+        "active-conversation",
+        "streaming",
+        "agent-disconnected",
+        "no-agents"
+      ],
+      "shellDependencies": [
+        "./agents-chat-page-kit"
+      ],
+      "shellAssumptions": [
+        "Voice routes switch between agent-selection and active-conversation without consumer page rewrites.",
+        "Consumers provide microphone and transport wiring while Seed owns roster and session presentation structure."
+      ],
+      "scaffoldSafe": true,
+      "recipe": "recipes/agents-chat.md",
+      "suite": "workspace-shell"
+    }
+  },
+  "suites": {
+    "auth": {
+      "description": "Auth flow intents with deterministic route ownership.",
+      "pageKitSubpaths": [],
+      "intentIds": [
+        "auth-login",
+        "auth-signup",
+        "auth-recovery",
+        "auth-reset",
+        "auth-two-factor",
+        "auth-account-locked",
+        "auth-verify-email",
+        "auth-success"
+      ]
+    },
+    "fallback": {
+      "description": "Fallback and unmatched-route handling intents.",
+      "pageKitSubpaths": [],
+      "intentIds": [
+        "error"
+      ]
+    },
+    "marketing-shell": {
+      "description": "Marketing shell contract and routed marketing/commerce intents.",
+      "pageKitSubpaths": [
+        "./marketing-shell-page-kit"
+      ],
+      "intentIds": [
+        "marketing-landing",
+        "service-suite",
+        "company-suite",
+        "pricing",
+        "blog-content",
+        "checkout"
+      ]
+    },
+    "workspace-shell": {
+      "description": "Authenticated workspace shell contract and app route intents.",
+      "pageKitSubpaths": [
+        "./navigation-shell-page-kit"
+      ],
+      "intentIds": [
+        "dashboard",
+        "analytics",
+        "settings",
+        "profile-settings",
+        "crud-list-detail",
+        "crud-form",
+        "team-settings",
+        "onboarding",
+        "kanban-board",
+        "agents-chat",
+        "voice-agents"
+      ]
+    }
+  }
+}