@stackonward/cli 1.2.1 → 1.3.0

package/dist/resources/components/nuxt/site-source/app/types/site-shell.ts

@@ -1,85 +1,172 @@
+import type { ComputedRef, DeepReadonly, Ref } from "vue";
+
+export interface LocalizedNavigationItemConfig {
+  readonly labelKey: string;
+  readonly to?: string;
+  readonly external?: boolean;
+  readonly descriptionKey?: string;
+  readonly children?: readonly LocalizedNavigationItemConfig[];
+}
+
 export interface MarketingNavigationItem {
-  label: string;
-  to?: string;
-  external?: boolean;
-  description?: string;
-  children?: MarketingNavigationItem[];
+  readonly label: string;
+  readonly to?: string;
+  readonly external?: boolean;
+  readonly description?: string;
+  readonly children?: readonly MarketingNavigationItem[];
+}
+
+export interface AppNavigationItemConfig {
+  readonly labelKey: string;
+  readonly to: string;
+  readonly icon?: string;
+  readonly badge?: string;
+}
+
+export interface AppNavigationItem extends Omit<AppNavigationItemConfig, "labelKey"> {
+  readonly label: string;
 }
 
-export interface AppNavigationItem {
-  label: string;
-  to: string;
-  icon?: string;
-  badge?: string;
+export interface NavigationGroupConfig {
+  readonly labelKey?: string;
+  readonly items: readonly AppNavigationItemConfig[];
 }
 
 export interface NavigationGroup {
-  label?: string;
-  items: AppNavigationItem[];
+  readonly label?: string;
+  readonly items: readonly AppNavigationItem[];
+}
+
+export interface FooterGroupConfig {
+  readonly titleKey: string;
+  readonly links: readonly LocalizedNavigationItemConfig[];
 }
 
 export interface FooterGroup {
-  title: string;
-  links: MarketingNavigationItem[];
+  readonly title: string;
+  readonly links: readonly MarketingNavigationItem[];
 }
 
-export interface LegalLink {
-  label: string;
-  to: string;
+export interface SocialLinkConfig {
+  readonly labelKey: string;
+  readonly href: string;
 }
 
 export interface SocialLink {
-  label: string;
-  href: string;
+  readonly label: string;
+  readonly href: string;
 }
 
 export interface ContentListItem {
-  title: string;
-  description?: string;
-  to: string;
-  category?: string;
-  date?: string;
-  author?: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly to: string;
+  readonly category?: string;
+  readonly date?: string;
+  readonly author?: string;
 }
 
 export interface ContentArticle {
-  title: string;
-  description?: string;
-  category?: string;
-  author?: string;
-  date?: string;
-  updatedAt?: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly category?: string;
+  readonly author?: string;
+  readonly date?: string;
+  readonly updatedAt?: string;
+}
+
+export interface StorageDisclosureConfig {
+  readonly name: string;
+  readonly category: "necessary" | "preferences" | "analytics";
+  readonly purposeKey: string;
+  readonly retentionKey: string;
+  readonly providerKey: string;
+}
+
+export interface SiteShellConsentConfig {
+  readonly enabled: boolean;
+  readonly storageKey: string;
+  readonly policyRevision: string;
+  readonly retentionDays: number;
+  readonly policyPath: string;
 }
 
 export interface SiteShellConfig {
-  name: string;
-  description: string;
-  url: string;
-  defaultLocale: string;
-  homePath: string;
-  appPath: string;
-  logoText: string;
-  primaryActionLabel: string;
-  secondaryActionLabel: string;
-  secondaryActionPath: string;
-  consent: {
-    enabled: boolean;
-    storageKey: string;
-    message: string;
-    acceptLabel: string;
-    rejectLabel: string;
-  };
-  navigation: {
-    marketing: MarketingNavigationItem[];
-    app: NavigationGroup[];
-    footer: FooterGroup[];
-    legal: LegalLink[];
-    social: SocialLink[];
+  readonly name: string;
+  readonly descriptionKey: string;
+  readonly url: string;
+  readonly defaultLocale: string;
+  readonly homePath: string;
+  readonly appPath: string;
+  readonly logoText: string;
+  readonly primaryActionLabelKey: string;
+  readonly secondaryActionLabelKey: string;
+  readonly secondaryActionPath: string;
+  readonly consent: SiteShellConsentConfig;
+  readonly storageDisclosures: readonly StorageDisclosureConfig[];
+  readonly navigation: {
+    readonly marketing: readonly LocalizedNavigationItemConfig[];
+    readonly app: readonly NavigationGroupConfig[];
+    readonly footer: readonly FooterGroupConfig[];
+    readonly legal: readonly LocalizedNavigationItemConfig[];
+    readonly social: readonly SocialLinkConfig[];
   };
-  content: {
-    blogPath: string;
-    authorPath: string;
-    previewPath: string;
-    sitemapSourcePath: string;
+  readonly content: {
+    readonly blogPath: string;
+    readonly authorPath: string;
+    readonly previewPath: string;
+    readonly sitemapSourcePath: string;
   };
 }
+
+export interface ResolvedSiteNavigation {
+  readonly marketingNav: Readonly<ComputedRef<readonly MarketingNavigationItem[]>>;
+  readonly appNavGroups: Readonly<ComputedRef<readonly NavigationGroup[]>>;
+  readonly footerGroups: Readonly<ComputedRef<readonly FooterGroup[]>>;
+  readonly legalLinks: Readonly<ComputedRef<readonly MarketingNavigationItem[]>>;
+  readonly socialLinks: Readonly<ComputedRef<readonly SocialLink[]>>;
+  readonly primaryActionLabel: Readonly<ComputedRef<string>>;
+  readonly secondaryActionLabel: Readonly<ComputedRef<string>>;
+}
+
+export type ConsentValue = "accepted" | "rejected";
+
+export type ConsentPersistenceError =
+  | "read-failed"
+  | "write-failed"
+  | "clear-failed"
+  | "write-and-clear-failed";
+
+export interface ConsentState {
+  decision: ConsentValue | null;
+  ready: boolean;
+  settingsOpen: boolean;
+  persistence: "none" | "persisted" | "cleared" | "cleanup-failed" | "session-only";
+  error: ConsentPersistenceError | null;
+}
+
+export type ConsentInitializationResult =
+  | { status: "restored"; value: ConsentValue }
+  | { status: "undecided"; cleanup: "not-required" | "cleared" }
+  | { status: "undecided"; cleanup: "failed"; error: "clear-failed" }
+  | { status: "storage-unavailable"; error: "read-failed" };
+
+export type ConsentMutationResult =
+  | { status: "persisted"; value: ConsentValue }
+  | { status: "cleared"; value: "rejected"; error: "write-failed" }
+  | {
+      status: "session-only";
+      value: ConsentValue;
+      error: "write-failed" | "write-and-clear-failed";
+    };
+
+export interface SiteConsentController {
+  readonly state: DeepReadonly<Ref<ConsentState>>;
+  readonly visible: Readonly<ComputedRef<boolean>>;
+  initialize(): ConsentInitializationResult;
+  accept(): ConsentMutationResult;
+  reject(): ConsentMutationResult;
+  openSettings(): void;
+  closeSettings(): void;
+  dispose(): void;
+}

package/dist/resources/components/registry.json

@@ -2,6 +2,7 @@
   "button": {
     "name": "Button",
     "description": "Versatile button component with variants and sizes",
+    "installContext": "standalone",
     "files": ["ui/Button.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -12,6 +13,7 @@
   "input": {
     "name": "Input",
     "description": "Text input component with validation support",
+    "installContext": "standalone",
     "files": ["ui/Input.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -22,6 +24,7 @@
   "modal": {
     "name": "Modal",
     "description": "Modal dialog component with animations",
+    "installContext": "standalone",
     "files": ["ui/Modal.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -32,6 +35,7 @@
   "card": {
     "name": "Card",
     "description": "Card container component",
+    "installContext": "standalone",
     "files": ["ui/Card.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -42,6 +46,7 @@
   "app-image": {
     "name": "AppImage",
     "description": "Responsive image component with loading, placeholder, source-set, and error states",
+    "installContext": "standalone",
     "files": ["ui/AppImage.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -52,6 +57,7 @@
   "tooltip": {
     "name": "Tooltip",
     "description": "Accessible hover and focus tooltip primitive",
+    "installContext": "standalone",
     "files": ["ui/Tooltip.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -62,6 +68,7 @@
   "bottom-sheet": {
     "name": "BottomSheet",
     "description": "Mobile-friendly bottom sheet dialog with scroll lock and safe-area support",
+    "installContext": "standalone",
     "files": ["ui/BottomSheet.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -72,6 +79,7 @@
   "scroll-area": {
     "name": "ScrollArea",
     "description": "Controlled scroll container with exposed scroll helpers and reach-end events",
+    "installContext": "standalone",
     "files": ["ui/ScrollArea.vue"],
     "dependencies": [],
     "devDependencies": [],
@@ -82,6 +90,7 @@
   "file-upload": {
     "name": "FileUpload",
     "description": "Drag-and-drop file upload primitive wired to @stackonward/file validation",
+    "installContext": "standalone",
     "files": ["media/FileUpload.vue"],
     "dependencies": ["@stackonward/file"],
     "devDependencies": [],
@@ -92,6 +101,7 @@
   "video-player": {
     "name": "VideoPlayer",
     "description": "Video player primitive wired to @stackonward/composables playback state",
+    "installContext": "standalone",
     "files": ["media/VideoPlayer.vue"],
     "dependencies": ["@stackonward/composables"],
     "devDependencies": [],
@@ -102,6 +112,7 @@
   "toast": {
     "name": "Toast",
     "description": "Toast notification component",
+    "installContext": "standalone",
     "files": ["feedback/Toast.vue", "feedback/useToast.ts"],
     "dependencies": [],
     "devDependencies": [],
@@ -112,6 +123,7 @@
   "react-button": {
     "name": "Button",
     "description": "Versatile button component with variants and sizes",
+    "installContext": "standalone",
     "files": ["ui/Button.tsx"],
     "dependencies": [],
     "devDependencies": [],
@@ -122,6 +134,7 @@
   "react-input": {
     "name": "Input",
     "description": "Text input component with validation support",
+    "installContext": "standalone",
     "files": ["ui/Input.tsx"],
     "dependencies": [],
     "devDependencies": [],
@@ -132,6 +145,7 @@
   "nuxt-site-source": {
     "name": "Nuxt Site Source",
     "description": "Editable Nuxt product-site source: app shell, marketing shell, content shell, UI primitives, composables, plugins, theme tokens, and CSS.",
+    "installContext": "template",
     "files": [
       {
         "path": "site-source/app/app.vue",
@@ -173,10 +187,18 @@
         "path": "site-source/app/components/site/ContentListPage.vue",
         "target": "app/components/site/ContentListPage.vue"
       },
+      {
+        "path": "site-source/app/components/site/ConsentSettingsButton.vue",
+        "target": "app/components/site/ConsentSettingsButton.vue"
+      },
       {
         "path": "site-source/app/components/site/CookieConsent.vue",
         "target": "app/components/site/CookieConsent.vue"
       },
+      {
+        "path": "site-source/app/components/site/LocaleSwitcher.vue",
+        "target": "app/components/site/LocaleSwitcher.vue"
+      },
       {
         "path": "site-source/app/components/site/MarketingFooter.vue",
         "target": "app/components/site/MarketingFooter.vue"
@@ -201,6 +223,10 @@
         "path": "site-source/app/components/site/ToastViewport.vue",
         "target": "app/components/site/ToastViewport.vue"
       },
+      {
+        "path": "site-source/app/components/site/ThemeSwitcher.vue",
+        "target": "app/components/site/ThemeSwitcher.vue"
+      },
       {
         "path": "site-source/app/components/ui/BaseButton.vue",
         "target": "app/components/ui/BaseButton.vue"
@@ -277,6 +303,10 @@
         "path": "site-source/app/layouts/default.vue",
         "target": "app/layouts/default.vue"
       },
+      {
+        "path": "site-source/app/plugins/consent.ts",
+        "target": "app/plugins/consent.ts"
+      },
       {
         "path": "site-source/app/plugins/google-identity.client.ts",
         "target": "app/plugins/google-identity.client.ts"

package/dist/resources/registry.json

@@ -21,7 +21,7 @@
     "name": "@stackonward/cli",
     "description": "StackOnward project and resource CLI",
     "type": "npm",
-    "version": "^1.2.1"
+    "version": "^1.3.0"
   },
   "@stackonward/cms-client": {
     "name": "@stackonward/cms-client",
@@ -69,7 +69,7 @@
     "name": "@stackonward/google-tag-manager-nuxt",
     "description": "Consent-aware Google Tag Manager analytics integration for Nuxt",
     "type": "npm",
-    "version": "^0.2.1"
+    "version": "^0.2.2"
   },
   "@stackonward/google-tag-manager": {
     "name": "@stackonward/google-tag-manager",
@@ -111,7 +111,7 @@
     "name": "@stackonward/nuxt-site-shell",
     "description": "Brand-free Nuxt product-site shell",
     "type": "layer",
-    "version": "^0.1.0"
+    "version": "^0.2.0"
   },
   "@stackonward/onex-cms-client": {
     "name": "@stackonward/onex-cms-client",

package/dist/resources/templates/nuxt/app/app.config.ts

@@ -4,94 +4,139 @@ export default defineAppConfig({
   ui: siteUiTheme,
   siteShell: {
     name: "{{projectName}}",
-    description:
-      "A premium product media workspace for generating product images, campaign sets, and short-form ad videos.",
+    descriptionKey: "site.description",
     url: "",
     defaultLocale: "en",
     homePath: "/",
     appPath: "/app",
     logoText: "{{projectName}}",
-    primaryActionLabel: "Start creating",
-    secondaryActionLabel: "Sign in",
+    primaryActionLabelKey: "actions.start",
+    secondaryActionLabelKey: "actions.signIn",
     secondaryActionPath: "/app",
     consent: {
       enabled: true,
-      storageKey: "{{projectName}}-consent",
-      message:
-        "Store preference cookies to keep campaign previews, consent, and analytics choices consistent on this device.",
-      acceptLabel: "Allow",
-      rejectLabel: "Decline",
+      storageKey: "{{projectName}}-analytics-consent-v1",
+      policyRevision: "1",
+      retentionDays: 180,
+      policyPath: "/legal/cookies",
     },
+    storageDisclosures: [
+      {
+        name: "{{projectName}}-analytics-consent-v1",
+        category: "necessary",
+        purposeKey: "legal.cookies.storage.consentPurpose",
+        retentionKey: "legal.cookies.storage.consentRetention",
+        providerKey: "legal.cookies.storage.firstParty",
+      },
+      {
+        name: "nuxt-color-mode",
+        category: "preferences",
+        purposeKey: "legal.cookies.storage.themePurpose",
+        retentionKey: "legal.cookies.storage.persistent",
+        providerKey: "legal.cookies.storage.firstParty",
+      },
+      {
+        name: "{{projectName}}_locale",
+        category: "preferences",
+        purposeKey: "legal.cookies.storage.localePurpose",
+        retentionKey: "legal.cookies.storage.localeRetention",
+        providerKey: "legal.cookies.storage.firstParty",
+      },
+      {
+        name: "_ga, _ga_*",
+        category: "analytics",
+        purposeKey: "legal.cookies.storage.analyticsPurpose",
+        retentionKey: "legal.cookies.storage.analyticsRetention",
+        providerKey: "legal.cookies.storage.google",
+      },
+    ],
     navigation: {
       marketing: [
-        { label: "Product", to: "/" },
+        { labelKey: "navigation.items.product", to: "/" },
         {
-          label: "Solutions",
+          labelKey: "navigation.items.solutions",
           children: [
             {
-              label: "Creative workspace",
+              labelKey: "navigation.items.workspace",
               to: "/app",
-              description: "Application shell for production workflows",
+              descriptionKey: "navigation.descriptions.workspace",
             },
             {
-              label: "Design system",
+              labelKey: "navigation.items.designSystem",
               to: "/ui",
-              description:
-                "Tokens, components, checkout, identity, video, and infinite-scroll examples",
+              descriptionKey: "navigation.descriptions.designSystem",
             },
           ],
         },
         {
-          label: "Resources",
+          labelKey: "navigation.items.resources",
           children: [
             {
-              label: "Playbook",
+              labelKey: "navigation.items.playbook",
               to: "/blog/creative-playbook",
-              description: "Content detail shell for product education and SEO",
+              descriptionKey: "navigation.descriptions.playbook",
+            },
+            {
+              labelKey: "navigation.items.privacy",
+              to: "/legal/privacy",
+              descriptionKey: "navigation.descriptions.privacy",
             },
-            { label: "Privacy", to: "/legal/privacy", description: "Static policy page" },
           ],
         },
-        { label: "Pricing", to: "/#pricing" },
-        { label: "Blog", to: "/blog" },
+        { labelKey: "navigation.items.pricing", to: "/#pricing" },
+        { labelKey: "navigation.items.blog", to: "/blog" },
       ],
       app: [
         {
-          label: "Production",
+          labelKey: "navigation.groups.production",
           items: [
-            { label: "Workspace board", to: "/app", icon: "i-lucide-layout-dashboard" },
-            { label: "Design system", to: "/ui", icon: "i-lucide-palette" },
-            { label: "Content hub", to: "/blog", icon: "i-lucide-newspaper" },
+            {
+              labelKey: "navigation.items.workspaceBoard",
+              to: "/app",
+              icon: "i-lucide-layout-dashboard",
+            },
+            {
+              labelKey: "navigation.items.designSystem",
+              to: "/ui",
+              icon: "i-lucide-palette",
+            },
+            {
+              labelKey: "navigation.items.contentHub",
+              to: "/blog",
+              icon: "i-lucide-newspaper",
+            },
           ],
         },
       ],
       footer: [
         {
-          title: "Product",
+          titleKey: "navigation.items.product",
           links: [
-            { label: "Overview", to: "/" },
-            { label: "Workspace board", to: "/app" },
-            { label: "Design system", to: "/ui" },
+            { labelKey: "navigation.items.overview", to: "/" },
+            { labelKey: "navigation.items.workspaceBoard", to: "/app" },
+            { labelKey: "navigation.items.designSystem", to: "/ui" },
           ],
         },
         {
-          title: "Resources",
+          titleKey: "navigation.items.resources",
           links: [
-            { label: "Content hub", to: "/blog" },
-            { label: "Creative playbook", to: "/blog/creative-playbook" },
+            { labelKey: "navigation.items.contentHub", to: "/blog" },
+            { labelKey: "navigation.items.creativePlaybook", to: "/blog/creative-playbook" },
           ],
         },
         {
-          title: "Company",
+          titleKey: "navigation.items.company",
           links: [
-            { label: "Terms", to: "/legal/terms" },
-            { label: "Privacy", to: "/legal/privacy" },
+            { labelKey: "navigation.items.terms", to: "/legal/terms" },
+            { labelKey: "navigation.items.privacy", to: "/legal/privacy" },
+            { labelKey: "navigation.items.cookies", to: "/legal/cookies" },
           ],
         },
       ],
       legal: [
-        { label: "Terms", to: "/legal/terms" },
-        { label: "Privacy", to: "/legal/privacy" },
+        { labelKey: "navigation.items.terms", to: "/legal/terms" },
+        { labelKey: "navigation.items.privacy", to: "/legal/privacy" },
+        { labelKey: "navigation.items.cookies", to: "/legal/cookies" },
       ],
       social: [],
     },