@vellira-ui/tokens 2.98.7 → 2.99.0

package/dist/preservation/token-migrations.js

@@ -203,10 +203,17 @@ const semanticVocabularyRemovalMigrationsV1 = semanticVocabularyRemovalPathsV1.m
     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 ambiguous surface.background after consumers are split by purpose: application roots use surface.canvas and bounded neutral containers use the explicit surface.panel role introduced by #912.'
         : 'Remove the unused legacy semantic.navigation namespace instead of preserving a duplicate component-history vocabulary.',
     from,
 }));
+const semanticPanelAdditionV1 = {
+    id: '912-surface-panel-addition',
+    kind: 'addition',
+    issue: '#912',
+    reason: 'Add an explicit bounded neutral panel/chrome role after the #883 audit missed authored CSS consumers of the removed surface.background variable; panel preserves those historical bounded-container values without changing canvas or elevated semantics.',
+    to: 'semantic.surface.panel',
+};
 const semanticVocabularyVisualMigrationsV1 = [
     {
         id: '883-dark-text-muted-hierarchy',
@@ -368,10 +375,75 @@ const semanticVocabularyDownstreamVisualMigrationsV1 = [
         approvalEvidence: semanticVocabularyVisualApproval,
     },
 ];
+const platformNeutralComponentRepresentationPathsV1 = [
+    'components.contextMenu.content.shadow',
+    'components.contextMenu.item.focus.ring.shadow',
+    'components.contextMenu.trigger.focus.ring.shadow',
+    'components.dropdown.content.shadow',
+    'components.dropdown.item.focus.ring.shadow',
+    'components.dropdown.trigger.focus.ring.shadow',
+    'components.modal.closeButton.focus.ring.shadow',
+    'components.modal.content.maxHeight',
+    'components.modal.content.shadow',
+    'components.select.dropdown.shadow',
+    'components.select.option.selected.shadow',
+    'components.tooltip.content.shadow',
+];
+const platformNeutralComponentRepresentationMigrationsV1 = platformNeutralComponentRepresentationPathsV1.map((from) => ({
+    id: `884-representation-${from.replaceAll('.', '-')}`,
+    kind: 'representation-change',
+    layer: 'canonical',
+    issue: '#884',
+    reason: 'Replace renderer-shaped canonical component storage with a renderer-neutral intent at the same logical token path.',
+    from,
+    equivalence: 'The canonical representation changes only; Web resolves the intent to the pre-#884 CSS value and React Native resolves consumed elevation/layout intents to the pre-#884 native presentation output.',
+    evidence: '#880 preservation locks serialized Web output while component-token-output-equivalence regressions cover Web and React Native adapters for Light, Dark, and High Contrast themes.',
+}));
+const platformNeutralLegacyCanonicalRemovalsV1 = [
+    'components.modal.content.nativeMaxHeight',
+    'components.popover.content.shadow.native.x',
+    'components.popover.content.shadow.native.y',
+    'components.popover.content.shadow.native.blur',
+    'components.popover.content.shadow.native.color',
+    'components.popover.content.shadow.native.opacity',
+    'components.popover.content.shadow.native.elevation',
+];
+const platformNeutralLegacyCanonicalRemovalMigrationsV1 = platformNeutralLegacyCanonicalRemovalsV1.map((from) => ({
+    id: `884-remove-${from.replaceAll('.', '-')}`,
+    kind: 'remove',
+    issue: '#884',
+    reason: 'Remove renderer-specific canonical storage after the same renderer output moved behind the platform-output adapter; the Web identity remains a compatibility alias until #889.',
+    platforms: ['react-native'],
+    from,
+}));
+const platformNeutralPopoverShadowMigrationV1 = {
+    id: '884-popover-shadow-web-to-canonical-intent',
+    kind: 'representation-change',
+    layer: 'canonical',
+    issue: '#884',
+    reason: 'Collapse the old Popover shadow.web branch into one renderer-neutral canonical shadow intent.',
+    from: 'components.popover.content.shadow.web',
+    to: 'components.popover.content.shadow',
+    equivalence: 'The new canonical lg elevation intent resolves to the same semantic lg Web shadow and the same structured native lg shadow used before #884.',
+    evidence: '#880 preservation retains the legacy Web output identity and component-token-output-equivalence regressions lock the Web/RN adapter results for all three themes.',
+};
+const platformNeutralPopoverWebAdditionV1 = {
+    id: '884-popover-normalized-web-shadow-output',
+    kind: 'addition',
+    issue: '#884',
+    reason: 'Expose the normalized Popover shadow path in Web platform output while retaining the old renderer-shaped CSS identities as compatibility aliases until #889.',
+    platforms: ['web'],
+    to: 'components.popover.content.shadow',
+};
 export const tokenMigrationManifestV1 = [
     ...stateVocabularyRenameMigrationsV1,
+    ...platformNeutralComponentRepresentationMigrationsV1,
+    ...platformNeutralLegacyCanonicalRemovalMigrationsV1,
+    platformNeutralPopoverShadowMigrationV1,
+    platformNeutralPopoverWebAdditionV1,
     ...semanticVocabularyRenameMigrationsV1,
     ...semanticVocabularyRemovalMigrationsV1,
+    semanticPanelAdditionV1,
     ...semanticVocabularyVisualMigrationsV1,
     ...semanticVocabularyDownstreamVisualMigrationsV1,
     {

package/dist/token-architecture.d.ts

@@ -143,8 +143,8 @@ export declare const legitimatePersistentActiveStateDomainsV1: readonly [{
 }];
 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 purpose: "Layer and interaction backgrounds with explicit root, bounded-panel, and elevated ownership.";
+        readonly roles: readonly ["canvas", "default", "panel", "subtle", "muted", "elevated", "hover", "active", "pressed", "disabled", "danger", "inverse"];
     };
     readonly text: {
         readonly purpose: "Text foreground hierarchy and text interaction roles.";
@@ -194,14 +194,14 @@ export declare const semanticVocabularyV1: {
     };
 };
 export declare const canonicalTokenVocabulary: {
-    readonly surface: readonly ["canvas", "default", "subtle", "muted", "elevated", "hover", "active", "pressed", "disabled", "danger", "inverse"];
+    readonly surface: readonly ["canvas", "default", "panel", "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", "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", "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 canonicalSemanticRolePaths: readonly ["surface.canvas", "surface.default", "surface.panel", "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;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGvB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;CA+C3B,CAAC;AAEX,eAAO,MAAM,0BAA0B,4+CA4E7B,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

@@ -298,10 +298,11 @@ export const legitimatePersistentActiveStateDomainsV1 = [
 ];
 export const semanticVocabularyV1 = {
     surface: {
-        purpose: 'Layer and interaction backgrounds.',
+        purpose: 'Layer and interaction backgrounds with explicit root, bounded-panel, and elevated ownership.',
         roles: [
             'canvas',
             'default',
+            'panel',
             'subtle',
             'muted',
             'elevated',
@@ -395,6 +396,7 @@ export const canonicalTokenVocabulary = {
     surface: [
         'canvas',
         'default',
+        'panel',
         'subtle',
         'muted',
         'elevated',
@@ -441,6 +443,7 @@ export const canonicalTokenVocabulary = {
 export const canonicalSemanticRolePaths = [
     'surface.canvas',
     'surface.default',
+    'surface.panel',
     'surface.subtle',
     'surface.muted',
     'surface.elevated',

package/package.json

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