@vellira-ui/tokens 2.98.6 → 2.98.7

package/dist/preservation/token-migrations.js

@@ -15,6 +15,7 @@ export const tokenMigrationThemeNames = [
 export const tokenMigrationPlatforms = ['web', 'react-native'];
 const valueKindWebFixApproval = '#881 explicitly requires correcting invalid unitless CSS serialization; targeted serializer regressions and the pinned Linux visual suite are the approval evidence.';
 const stateVocabularyVisualApproval = '#879/#882 explicitly authorizes removal of pressed/active semantic conflation; the change stays inside the existing Vellira palette and requires pinned Linux visual regression.';
+const semanticVocabularyVisualApproval = '#879/#883 explicitly authorizes Semantic Vocabulary V1 normalization and the narrowly scoped hierarchy/status corrections inside existing Vellira palettes; token preservation plus pinned Linux visual regression are required evidence.';
 const stateVocabularyRenamePairsV1 = [
     [
         'control-active-bg',
@@ -61,36 +62,6 @@ const stateVocabularyRenamePairsV1 = [
         'semantic.action.primary.active.border',
         'semantic.action.primary.pressed.border',
     ],
-    [
-        'action-secondary-active-bg',
-        'semantic.action.secondary.active.bg',
-        'semantic.action.secondary.pressed.bg',
-    ],
-    [
-        'action-secondary-active-fg',
-        'semantic.action.secondary.active.fg',
-        'semantic.action.secondary.pressed.fg',
-    ],
-    [
-        'action-secondary-active-border',
-        'semantic.action.secondary.active.border',
-        'semantic.action.secondary.pressed.border',
-    ],
-    [
-        'action-close-active-bg',
-        'semantic.action.close.active.bg',
-        'semantic.action.close.pressed.bg',
-    ],
-    [
-        'action-close-active-fg',
-        'semantic.action.close.active.fg',
-        'semantic.action.close.pressed.fg',
-    ],
-    [
-        'action-close-active-border',
-        'semantic.action.close.active.border',
-        'semantic.action.close.pressed.border',
-    ],
     [
         'action-danger-active-bg',
         'semantic.action.danger.active.bg',
@@ -135,6 +106,169 @@ const stateVocabularyRenameMigrationsV1 = stateVocabularyRenamePairsV1.flatMap((
         evidence: 'Token preservation validates the canonical/RN value-preserving rename; generated CSS checks and pinned Linux visual regression validate Web output.',
     },
 ]);
+const semanticActionRoleRenamePairsV1 = [
+    ['secondary', 'accent'],
+    ['close', 'neutral'],
+].flatMap(([fromRole, toRole]) => ['default', 'hover', 'active', 'muted', 'subtle'].flatMap((fromState) => ['bg', 'fg', 'border'].map((field) => {
+    const toState = fromState === 'active' ? 'pressed' : fromState;
+    return [
+        `action-${fromRole}-${fromState}-${field}`,
+        `semantic.action.${fromRole}.${fromState}.${field}`,
+        `semantic.action.${toRole}.${toState}.${field}`,
+    ];
+})));
+const semanticStatusEmphasisRenamePairsV1 = ['success', 'error', 'warning', 'info'].map((status) => [
+    `status-${status}-strong`,
+    `semantic.status.${status}.strong`,
+    `semantic.status.${status}.emphasisFg`,
+]);
+const semanticVocabularySimpleRenamePairsV1 = [
+    ['icons-primary', 'semantic.icons.primary', 'semantic.icons.interactive'],
+    ['icons-hover', 'semantic.icons.hover', 'semantic.icons.interactiveHover'],
+    ['border-focus', 'semantic.border.focus', 'semantic.border.interactive'],
+    [
+        'focus-ring-offset',
+        'semantic.focus.ring.offset',
+        'semantic.focus.ring.offsetColor',
+    ],
+    [
+        'overlay-popover-bg',
+        'semantic.overlay.popover.bg',
+        'semantic.overlay.floating.bg',
+    ],
+    [
+        'overlay-popover-border',
+        'semantic.overlay.popover.border',
+        'semantic.overlay.floating.border',
+    ],
+    [
+        'overlay-modal-bg',
+        'semantic.overlay.modal.bg',
+        'semantic.overlay.dialog.bg',
+    ],
+    [
+        'overlay-modal-border',
+        'semantic.overlay.modal.border',
+        'semantic.overlay.dialog.border',
+    ],
+];
+const semanticVocabularyRenamePairsV1 = [
+    ...semanticActionRoleRenamePairsV1,
+    ...semanticStatusEmphasisRenamePairsV1,
+    ...semanticVocabularySimpleRenamePairsV1,
+];
+const semanticVocabularyRenameMigrationsV1 = semanticVocabularyRenamePairsV1.flatMap(([id, from, to]) => [
+    {
+        id: `883-${id}-rename`,
+        kind: 'rename',
+        issue: '#883',
+        reason: 'Rename a public semantic role to Semantic Vocabulary V1 while preserving its resolved design value.',
+        platforms: ['react-native'],
+        from,
+        to,
+    },
+    {
+        id: `883-${id}-web-identity`,
+        kind: 'representation-change',
+        layer: 'platform-output',
+        issue: '#883',
+        reason: 'Align the public Web CSS variable identity with the normalized Semantic Vocabulary V1 role.',
+        platforms: ['web'],
+        from,
+        to,
+        equivalence: 'The paired canonical #883 rename preserves the resolved design value; only the public Web CSS variable identity changes.',
+        evidence: 'Token preservation validates the canonical/RN rename; generated CSS and pinned Linux visual regression validate Web output identity.',
+    },
+]);
+const semanticVocabularyRemovalPathsV1 = [
+    'semantic.surface.background',
+    'semantic.navigation.hover.bg',
+    'semantic.navigation.hover.fg',
+    'semantic.navigation.active.bg',
+    'semantic.navigation.active.fg',
+    'semantic.navigation.brandHover.bg',
+    'semantic.navigation.brandHover.fg',
+    'semantic.navigation.tabHover.fg',
+    'semantic.navigation.tabFocus.ring',
+    'semantic.navigation.optionHover.bg',
+    'semantic.navigation.optionHover.fg',
+    'semantic.navigation.optionActive.bg',
+    'semantic.navigation.optionActive.fg',
+    'semantic.navigation.triggerHover.bg',
+    'semantic.navigation.triggerHover.fg',
+    'semantic.navigation.border',
+];
+const semanticVocabularyRemovalMigrationsV1 = semanticVocabularyRemovalPathsV1.map((from) => ({
+    id: `883-remove-${from.replaceAll('.', '-')}`,
+    kind: 'remove',
+    issue: '#883',
+    reason: from === 'semantic.surface.background'
+        ? 'Remove the ambiguous surface.background alias after application roots move to the canonical surface.canvas role.'
+        : 'Remove the unused legacy semantic.navigation namespace instead of preserving a duplicate component-history vocabulary.',
+    from,
+}));
+const semanticVocabularyVisualMigrationsV1 = [
+    {
+        id: '883-dark-text-muted-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Correct the Dark text hierarchy so muted remains stronger than subtle using only existing Vellira palette values.',
+        from: 'semantic.text.muted',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-text-subtle-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Correct the Dark text hierarchy so subtle remains below muted using only existing Vellira palette values.',
+        from: 'semantic.text.subtle',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-icons-muted-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Correct the High Contrast icon hierarchy so muted remains stronger than subtle using the existing gray scale.',
+        from: 'semantic.icons.muted',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-icons-subtle-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Correct the High Contrast icon hierarchy so subtle remains below muted using the existing gray scale.',
+        from: 'semantic.icons.subtle',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-warning-ring-own-palette',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Correct warning.ring to use the existing warning palette instead of the unrelated error palette.',
+        from: 'semantic.status.warning.ring',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-info-ring-own-palette',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Correct info.ring to use the existing info palette instead of the unrelated error palette.',
+        from: 'semantic.status.info.ring',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+];
 /**
  * Migration/test metadata only. This is not a runtime token registry.
  *
@@ -142,8 +276,104 @@ const stateVocabularyRenameMigrationsV1 = stateVocabularyRenamePairsV1.flatMap((
  * change, or intentionally approved visual change must be recorded here before
  * the preservation baseline is allowed to accept it.
  */
+const semanticVocabularyDownstreamVisualMigrationsV1 = [
+    {
+        id: '883-dark-dropdown-separator-muted-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Dropdown separator follows the corrected Dark muted text hierarchy without introducing a new palette value.',
+        from: 'components.dropdown.separator.fg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-form-field-helper-muted-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'FormField helper text follows the corrected Dark muted text hierarchy without introducing a new palette value.',
+        from: 'components.formField.helperText.default.fg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-input-readonly-placeholder-muted-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Input read-only placeholder follows the corrected Dark muted text hierarchy without introducing a new palette value.',
+        from: 'components.input.readOnly.placeholder',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-dark-modal-close-button-pressed-state',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['dark'],
+        reason: 'Modal close-button physical press now consumes the canonical surface.pressed state instead of the persistent surface.active state.',
+        from: 'components.modal.closeButton.pressed.bg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-input-clear-button-icon-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Input clear-button foreground follows the corrected High Contrast muted icon hierarchy.',
+        from: 'components.input.clearButton.fg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-input-muted-icon-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Input muted icon follows the corrected High Contrast muted/subtle icon hierarchy.',
+        from: 'components.input.icon.muted',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-input-readonly-icon-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Input read-only icon follows the corrected High Contrast muted icon hierarchy.',
+        from: 'components.input.readOnly.icon',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-input-spinner-icon-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Input spinner foreground follows the corrected High Contrast muted icon hierarchy.',
+        from: 'components.input.spinner.fg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+    {
+        id: '883-high-contrast-select-clear-button-icon-hierarchy',
+        kind: 'visual-change',
+        issue: '#883',
+        themes: ['high-contrast'],
+        reason: 'Select clear-button foreground follows the corrected High Contrast muted icon hierarchy.',
+        from: 'components.select.clearButton.fg',
+        approved: true,
+        approvalEvidence: semanticVocabularyVisualApproval,
+    },
+];
 export const tokenMigrationManifestV1 = [
     ...stateVocabularyRenameMigrationsV1,
+    ...semanticVocabularyRenameMigrationsV1,
+    ...semanticVocabularyRemovalMigrationsV1,
+    ...semanticVocabularyVisualMigrationsV1,
+    ...semanticVocabularyDownstreamVisualMigrationsV1,
     {
         id: '882-radio-active-scale-remove',
         kind: 'remove',

package/dist/token-architecture.d.ts

@@ -128,12 +128,6 @@ export declare const legitimatePersistentActiveStateDomainsV1: readonly [{
 }, {
     readonly pattern: "semantic.menu.item.danger.active";
     readonly meaning: "Current/highlighted danger menu item.";
-}, {
-    readonly pattern: "semantic.navigation.active";
-    readonly meaning: "Current navigation destination.";
-}, {
-    readonly pattern: "semantic.navigation.optionActive";
-    readonly meaning: "Current/highlighted navigation option.";
 }, {
     readonly pattern: "components.contextMenu.item.active";
     readonly meaning: "Current/highlighted context-menu item.";
@@ -147,15 +141,67 @@ export declare const legitimatePersistentActiveStateDomainsV1: readonly [{
     readonly pattern: "components.tabs.*.*.active";
     readonly meaning: "Current active tab presentation; physical press is a separate interaction.";
 }];
+export declare const semanticVocabularyV1: {
+    readonly surface: {
+        readonly purpose: "Layer and interaction backgrounds.";
+        readonly roles: readonly ["canvas", "default", "subtle", "muted", "elevated", "hover", "active", "pressed", "disabled", "danger", "inverse"];
+    };
+    readonly text: {
+        readonly purpose: "Text foreground hierarchy and text interaction roles.";
+        readonly roles: readonly ["primary", "secondary", "muted", "subtle", "disabled", "brand", "interactive", "interactiveHover", "interactivePressed", "inverse"];
+    };
+    readonly icons: {
+        readonly purpose: "Icon foreground hierarchy; interactive roles are distinct from brand identity.";
+        readonly roles: readonly ["default", "secondary", "muted", "subtle", "disabled", "interactive", "brand", "interactiveHover", "success", "danger", "inverse"];
+    };
+    readonly border: {
+        readonly purpose: "Structural border strength plus generic interactive border emphasis.";
+        readonly roles: readonly ["subtle", "muted", "default", "strong", "elevated", "disabled", "interactive"];
+    };
+    readonly divider: {
+        readonly purpose: "Non-interactive separators.";
+        readonly roles: readonly ["muted", "default", "strong"];
+    };
+    readonly focus: {
+        readonly purpose: "Input-focus indication only; independent from hover and pressed states.";
+        readonly roles: readonly ["ring.color", "ring.width", "ring.shadow", "ring.offsetColor"];
+    };
+    readonly status: {
+        readonly purpose: "Status intent paint using explicit consumption roles.";
+        readonly intents: readonly ["success", "error", "warning", "info"];
+        readonly roles: readonly ["fg", "bg", "border", "ring", "emphasisFg"];
+    };
+    readonly action: {
+        readonly purpose: "Action intent palettes; accent is the cyan secondary-brand hue, neutral is non-brand action chrome.";
+        readonly roles: readonly ["primary", "accent", "neutral", "danger"];
+        readonly states: readonly ["default", "hover", "pressed", "muted", "subtle"];
+    };
+    readonly control: {
+        readonly purpose: "Generic form-control state paint; pressed is physical press and selected is persistent choice.";
+        readonly roles: readonly ["default", "hover", "pressed", "selected", "disabled", "focus"];
+    };
+    readonly menu: {
+        readonly purpose: "Menu-item roles where active/current is a legitimate domain state.";
+        readonly roles: readonly ["item", "item.danger"];
+    };
+    readonly overlay: {
+        readonly purpose: "Reusable overlay surfaces named by presentation purpose, not component history.";
+        readonly roles: readonly ["backdrop", "tooltip", "floating", "dialog"];
+    };
+    readonly shadow: {
+        readonly purpose: "Semantic elevation references; renderer ownership is normalized separately.";
+        readonly roles: readonly ["sm", "md", "lg", "xl"];
+    };
+};
 export declare const canonicalTokenVocabulary: {
     readonly surface: readonly ["canvas", "default", "subtle", "muted", "elevated", "hover", "active", "pressed", "disabled", "danger", "inverse"];
     readonly state: readonly ["default", "hover", "pressed", "active", "selected", "disabled", "focus"];
     readonly foreground: readonly ["primary", "secondary", "muted", "subtle", "disabled", "brand", "interactive", "interactiveHover", "interactivePressed", "inverse"];
-    readonly border: readonly ["subtle", "muted", "default", "strong", "elevated", "disabled"];
-    readonly intent: readonly ["primary", "neutral", "success", "warning", "danger"];
+    readonly border: readonly ["subtle", "muted", "default", "strong", "elevated", "disabled", "interactive"];
+    readonly intent: readonly ["primary", "accent", "neutral", "success", "warning", "danger"];
     readonly status: readonly ["success", "error", "warning", "info"];
 };
-export declare const canonicalSemanticRolePaths: readonly ["surface.canvas", "surface.default", "surface.subtle", "surface.muted", "surface.elevated", "surface.hover", "surface.active", "surface.pressed", "surface.disabled", "surface.danger", "surface.inverse", "text.primary", "text.secondary", "text.muted", "text.subtle", "text.disabled", "text.brand", "text.interactive", "text.interactiveHover", "text.interactivePressed", "text.inverse", "border.subtle", "border.muted", "border.default", "border.strong", "border.elevated", "border.disabled", "border.focus", "divider.muted", "divider.default", "divider.strong", "focus.ring.color", "focus.ring.width", "focus.ring.shadow", "focus.ring.offset", "status.success.fg", "status.success.bg", "status.success.border", "status.success.ring", "status.success.strong", "status.error.fg", "status.error.bg", "status.error.border", "status.error.ring", "status.error.strong", "status.warning.fg", "status.warning.bg", "status.warning.border", "status.warning.ring", "status.warning.strong", "status.info.fg", "status.info.bg", "status.info.border", "status.info.ring", "status.info.strong", "overlay.backdrop", "overlay.tooltip.bg", "overlay.tooltip.fg", "overlay.tooltip.border", "overlay.popover.bg", "overlay.popover.border", "overlay.modal.bg", "overlay.modal.border"];
+export declare const canonicalSemanticRolePaths: readonly ["surface.canvas", "surface.default", "surface.subtle", "surface.muted", "surface.elevated", "surface.hover", "surface.active", "surface.pressed", "surface.disabled", "surface.danger", "surface.inverse", "text.primary", "text.secondary", "text.muted", "text.subtle", "text.disabled", "text.brand", "text.interactive", "text.interactiveHover", "text.interactivePressed", "text.inverse", "icons.default", "icons.secondary", "icons.muted", "icons.subtle", "icons.disabled", "icons.interactive", "icons.brand", "icons.interactiveHover", "icons.success", "icons.danger", "icons.inverse", "border.subtle", "border.muted", "border.default", "border.strong", "border.elevated", "border.disabled", "border.interactive", "divider.muted", "divider.default", "divider.strong", "focus.ring.color", "focus.ring.width", "focus.ring.shadow", "focus.ring.offsetColor", "status.success.fg", "status.success.bg", "status.success.border", "status.success.ring", "status.success.emphasisFg", "status.error.fg", "status.error.bg", "status.error.border", "status.error.ring", "status.error.emphasisFg", "status.warning.fg", "status.warning.bg", "status.warning.border", "status.warning.ring", "status.warning.emphasisFg", "status.info.fg", "status.info.bg", "status.info.border", "status.info.ring", "status.info.emphasisFg", "overlay.backdrop", "overlay.tooltip.bg", "overlay.tooltip.fg", "overlay.tooltip.border", "overlay.floating.bg", "overlay.floating.border", "overlay.dialog.bg", "overlay.dialog.border"];
 export declare const componentTokenFactoryModel: {
     readonly canonicalName: "create<Component>Tokens";
     readonly legacyPaletteName: "create<Component>Palette is retained when the component exposes intent palettes.";

package/dist/token-architecture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-architecture.d.ts","sourceRoot":"","sources":["../src/token-architecture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB,qGAO1B,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAChC,wFAAiG,CAAC;AAEpG,eAAO,MAAM,eAAe,wLAelB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;CA2BqB,CAAC;AAsHxE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,cAAc,GAAG,IAAI,CAwCvB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,cAAc,CAQhB;AAED,eAAO,MAAM,0BAA0B,qFAQ7B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC3C,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;CAsC3B,CAAC;AAEX,eAAO,MAAM,0BAA0B,uvCAgE7B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;;;;;CAS7B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqG/B,CAAC;AAEX,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;EA+BjC,CAAC"}
+{"version":3,"file":"token-architecture.d.ts","sourceRoot":"","sources":["../src/token-architecture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB,qGAO1B,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAChC,wFAAiG,CAAC;AAEpG,eAAO,MAAM,eAAe,wLAelB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;CA2BqB,CAAC;AAsHxE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,cAAc,GAAG,IAAI,CAwCvB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GACrB,cAAc,CAQhB;AAED,eAAO,MAAM,0BAA0B,qFAQ7B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;EAiC3C,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGvB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;CA8C3B,CAAC;AAEX,eAAO,MAAM,0BAA0B,29CA2E7B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;;;;;CAS7B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqG/B,CAAC;AAEX,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;EA+BjC,CAAC"}

package/dist/token-architecture.js

@@ -279,14 +279,6 @@ export const legitimatePersistentActiveStateDomainsV1 = [
         pattern: 'semantic.menu.item.danger.active',
         meaning: 'Current/highlighted danger menu item.',
     },
-    {
-        pattern: 'semantic.navigation.active',
-        meaning: 'Current navigation destination.',
-    },
-    {
-        pattern: 'semantic.navigation.optionActive',
-        meaning: 'Current/highlighted navigation option.',
-    },
     {
         pattern: 'components.contextMenu.item.active',
         meaning: 'Current/highlighted context-menu item.',
@@ -304,6 +296,101 @@ export const legitimatePersistentActiveStateDomainsV1 = [
         meaning: 'Current active tab presentation; physical press is a separate interaction.',
     },
 ];
+export const semanticVocabularyV1 = {
+    surface: {
+        purpose: 'Layer and interaction backgrounds.',
+        roles: [
+            'canvas',
+            'default',
+            'subtle',
+            'muted',
+            'elevated',
+            'hover',
+            'active',
+            'pressed',
+            'disabled',
+            'danger',
+            'inverse',
+        ],
+    },
+    text: {
+        purpose: 'Text foreground hierarchy and text interaction roles.',
+        roles: [
+            'primary',
+            'secondary',
+            'muted',
+            'subtle',
+            'disabled',
+            'brand',
+            'interactive',
+            'interactiveHover',
+            'interactivePressed',
+            'inverse',
+        ],
+    },
+    icons: {
+        purpose: 'Icon foreground hierarchy; interactive roles are distinct from brand identity.',
+        roles: [
+            'default',
+            'secondary',
+            'muted',
+            'subtle',
+            'disabled',
+            'interactive',
+            'brand',
+            'interactiveHover',
+            'success',
+            'danger',
+            'inverse',
+        ],
+    },
+    border: {
+        purpose: 'Structural border strength plus generic interactive border emphasis.',
+        roles: [
+            'subtle',
+            'muted',
+            'default',
+            'strong',
+            'elevated',
+            'disabled',
+            'interactive',
+        ],
+    },
+    divider: {
+        purpose: 'Non-interactive separators.',
+        roles: ['muted', 'default', 'strong'],
+    },
+    focus: {
+        purpose: 'Input-focus indication only; independent from hover and pressed states.',
+        roles: ['ring.color', 'ring.width', 'ring.shadow', 'ring.offsetColor'],
+    },
+    status: {
+        purpose: 'Status intent paint using explicit consumption roles.',
+        intents: ['success', 'error', 'warning', 'info'],
+        roles: ['fg', 'bg', 'border', 'ring', 'emphasisFg'],
+    },
+    action: {
+        purpose: 'Action intent palettes; accent is the cyan secondary-brand hue, neutral is non-brand action chrome.',
+        roles: ['primary', 'accent', 'neutral', 'danger'],
+        states: ['default', 'hover', 'pressed', 'muted', 'subtle'],
+    },
+    control: {
+        purpose: 'Generic form-control state paint; pressed is physical press and selected is persistent choice.',
+        roles: ['default', 'hover', 'pressed', 'selected', 'disabled', 'focus'],
+    },
+    menu: {
+        purpose: 'Menu-item roles where active/current is a legitimate domain state.',
+        roles: ['item', 'item.danger'],
+    },
+    overlay: {
+        purpose: 'Reusable overlay surfaces named by presentation purpose, not component history.',
+        roles: ['backdrop', 'tooltip', 'floating', 'dialog'],
+    },
+    shadow: {
+        purpose: 'Semantic elevation references; renderer ownership is normalized separately.',
+        roles: ['sm', 'md', 'lg', 'xl'],
+    },
+};
 export const canonicalTokenVocabulary = {
     surface: [
         'canvas',
@@ -339,8 +426,16 @@ export const canonicalTokenVocabulary = {
         'interactivePressed',
         'inverse',
     ],
-    border: ['subtle', 'muted', 'default', 'strong', 'elevated', 'disabled'],
-    intent: ['primary', 'neutral', 'success', 'warning', 'danger'],
+    border: [
+        'subtle',
+        'muted',
+        'default',
+        'strong',
+        'elevated',
+        'disabled',
+        'interactive',
+    ],
+    intent: ['primary', 'accent', 'neutral', 'success', 'warning', 'danger'],
     status: ['success', 'error', 'warning', 'info'],
 };
 export const canonicalSemanticRolePaths = [
@@ -365,48 +460,59 @@ export const canonicalSemanticRolePaths = [
     'text.interactiveHover',
     'text.interactivePressed',
     'text.inverse',
+    'icons.default',
+    'icons.secondary',
+    'icons.muted',
+    'icons.subtle',
+    'icons.disabled',
+    'icons.interactive',
+    'icons.brand',
+    'icons.interactiveHover',
+    'icons.success',
+    'icons.danger',
+    'icons.inverse',
     'border.subtle',
     'border.muted',
     'border.default',
     'border.strong',
     'border.elevated',
     'border.disabled',
-    'border.focus',
+    'border.interactive',
     'divider.muted',
     'divider.default',
     'divider.strong',
     'focus.ring.color',
     'focus.ring.width',
     'focus.ring.shadow',
-    'focus.ring.offset',
+    'focus.ring.offsetColor',
     'status.success.fg',
     'status.success.bg',
     'status.success.border',
     'status.success.ring',
-    'status.success.strong',
+    'status.success.emphasisFg',
     'status.error.fg',
     'status.error.bg',
     'status.error.border',
     'status.error.ring',
-    'status.error.strong',
+    'status.error.emphasisFg',
     'status.warning.fg',
     'status.warning.bg',
     'status.warning.border',
     'status.warning.ring',
-    'status.warning.strong',
+    'status.warning.emphasisFg',
     'status.info.fg',
     'status.info.bg',
     'status.info.border',
     'status.info.ring',
-    'status.info.strong',
+    'status.info.emphasisFg',
     'overlay.backdrop',
     'overlay.tooltip.bg',
     'overlay.tooltip.fg',
     'overlay.tooltip.border',
-    'overlay.popover.bg',
-    'overlay.popover.border',
-    'overlay.modal.bg',
-    'overlay.modal.border',
+    'overlay.floating.bg',
+    'overlay.floating.border',
+    'overlay.dialog.bg',
+    'overlay.dialog.border',
 ];
 export const componentTokenFactoryModel = {
     canonicalName: 'create<Component>Tokens',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellira-ui/tokens",
-  "version": "2.98.6",
+  "version": "2.98.7",
   "description": "Design tokens for Vellira Design System",
   "keywords": [
     "vellira",

package/dist/dark/semantic/navigation.d.ts

@@ -1,34 +0,0 @@
-export declare const navigation: {
-    readonly hover: {
-        readonly bg: "#2F2A42";
-        readonly fg: "#F4F1FB";
-    };
-    readonly active: {
-        readonly bg: "#3D3754";
-        readonly fg: "#F4F1FB";
-    };
-    readonly brandHover: {
-        readonly bg: "#2F2A42";
-        readonly fg: "#D4CCFF";
-    };
-    readonly tabHover: {
-        readonly fg: "#D4CCFF";
-    };
-    readonly tabFocus: {
-        readonly ring: "#F59E0B";
-    };
-    readonly optionHover: {
-        readonly bg: "#2F2A42";
-        readonly fg: "#F4F1FB";
-    };
-    readonly optionActive: {
-        readonly bg: "#3D3754";
-        readonly fg: "#F4F1FB";
-    };
-    readonly triggerHover: {
-        readonly bg: "#2F2A42";
-        readonly fg: "#F4F1FB";
-    };
-    readonly border: "#3D3754";
-};
-//# sourceMappingURL=navigation.d.ts.map

package/dist/dark/semantic/navigation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/dark/semantic/navigation.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCb,CAAC"}