@3fn/core 13.0.0 → 14.0.0

package/src/tokens/semantic/BlendTokens.ts

@@ -16,7 +16,7 @@
  * - blendHoverLighter: Hover feedback on dark backgrounds (8% lighter)
  * - blendPressedDarker: Pressed state feedback with darkening (12% darker)
  * - blendFocusSaturate: Focus state with increased saturation (8% more saturated)
- * - blendDisabledDesaturate: Disabled state with decreased saturation (12% less saturated)
+ * - blendDisabledDesaturate: DEPRECATED 2026-07-15 — DesignerPunk has no disabled states
  * - blendContainerHoverDarker: Subtle container hover feedback (4% darker)
  * - color.icon.opticalBalance: Icon optical weight compensation (8% lighter)
  * 
@@ -49,6 +49,15 @@ export interface SemanticBlendToken {
 
   /** Detailed description of semantic meaning and appropriate usage */
   description: string;
+
+  /** Token is deprecated — do not use in new work; flows to DTCG $extensions.designerpunk.deprecated */
+  deprecated?: boolean;
+
+  /** ISO date the deprecation took effect */
+  deprecatedSince?: string;
+
+  /** Why the token was deprecated and what to do instead */
+  deprecatedReason?: string;
 }
 
 /**
@@ -111,6 +120,14 @@ export const blendTokens: Record<string, SemanticBlendToken> = {
     description: 'Blend for focus states with saturation increase (8% more saturated) - creates energized, attention-drawing appearance for focused interactive elements'
   },
 
+  /**
+   * @deprecated 2026-07-15 — DesignerPunk does not support disabled states
+   * (Button-CTA disabled-state adjudication, ruled REMOVE; the no-disabled-states
+   * philosophy holds corpus-wide). If an action is unavailable, do not render the
+   * component. Retained for backward compatibility; scheduled for removal in the
+   * next major version of @3fn/core. For non-disabled desaturation needs, use the
+   * generic desaturate utilities with primitive blend tokens.
+   */
   'blend.disabledDesaturate': {
     name: 'blend.disabledDesaturate',
     primitiveReferences: {
@@ -118,8 +135,11 @@ export const blendTokens: Record<string, SemanticBlendToken> = {
     },
     direction: BlendDirection.DESATURATE,
     category: 'interaction',
-    context: 'Disabled state appearance - muted, inactive color',
-    description: 'Blend for disabled states with desaturation (12% less saturated) - creates muted, inactive appearance indicating non-interactive state'
+    context: 'DEPRECATED - disabled states are not supported in DesignerPunk',
+    description: 'DEPRECATED (2026-07-15): DesignerPunk does not support disabled states — if an action is unavailable, do not render the component. Formerly: blend for disabled states with desaturation (12% less saturated). Scheduled for removal in the next major version.',
+    deprecated: true,
+    deprecatedSince: '2026-07-15',
+    deprecatedReason: 'No-disabled-states philosophy holds corpus-wide (Button-CTA adjudication, 2026-07-15). Unavailable actions should not be rendered; state_loading covers in-flight async actions.'
   },
 
   'blend.containerHoverDarker': {
@@ -200,8 +220,9 @@ export function validateBlendTokenCount(): boolean {
  *    → Creates vibrant, attention-drawing appearance for focused elements
  * 
  * 5. Disabled states?
- *    → Use blend.disabledDesaturate (12% less saturated)
- *    → Creates muted appearance indicating non-interactive state
+ *    → DO NOT style disabled states. DesignerPunk does not support disabled states —
+ *      if an action is unavailable, do not render the component (adjudicated 2026-07-15).
+ *    → blend.disabledDesaturate is DEPRECATED and scheduled for removal at the next major.
  * 
  * 6. Large container/surface hover?
  *    → Use blend.containerHoverDarker (4% darker)

package/src/tokens/semantic/OpacityTokens.ts

@@ -6,10 +6,10 @@
  * the design system while maintaining semantic meaning.
  * 
  * Opacity values:
- * - subtle: 0.9 (90%) - Minimal transparency for subtle effects
- * - medium: 0.7 (70%) - Moderate transparency for overlays
- * - heavy: 0.5 (50%) - Strong transparency for backgrounds
- * - ghost: 0.3 (30%) - Maximum transparency for ghost effects
+ * - subtle: opacity088 (88%) - Minimal transparency for subtle effects
+ * - medium: opacity072 (72%) - Moderate transparency for overlays
+ * - heavy: opacity048 (48%) - Strong transparency for backgrounds
+ * - ghost: opacity032 (32%) - Maximum transparency for ghost effects
  * 
  * All opacity tokens reference primitive opacity values that can be applied
  * to any color or surface for consistent transparency effects.

package/src/tools/release/__tests__/ReleasePipeline.test.ts

@@ -159,7 +159,7 @@ describe('ReleasePipeline', () => {
     });
 
     it('should skip GitHub publish when GITHUB_TOKEN is not set', async () => {
-      const configWithRepo = JSON.stringify({ npmPublishEnabled: false, repoUrl: 'https://github.com/3fn/DesignerPunkv2', outputDir: 'docs/releases' });
+      const configWithRepo = JSON.stringify({ npmPublishEnabled: false, repoUrl: 'https://github.com/3fn/DesignerPunk', outputDir: 'docs/releases' });
       mockedReadFileSync.mockImplementation((p: any) => {
         if (String(p).includes('release-config.json')) return configWithRepo;
         return FIXTURE_SUMMARY;

package/src/types/ComponentTypes.ts

@@ -65,7 +65,7 @@
  * }
  * ```
  * 
- * @see {@link https://github.com/3fn/DesignerPunkv2/blob/main/.kiro/specs/011-inset-token-renaming/design.md | Inset Token Renaming Design}
+ * @see {@link https://github.com/3fn/DesignerPunk/blob/main/.kiro/specs/011-inset-token-renaming/design.md | Inset Token Renaming Design}
  */
 export type InsetPadding = 
   | 'inset050' 

package/src/types/generated/TokenTypes.ts

@@ -6,7 +6,7 @@
  * 
  * To regenerate: npm run generate:types
  * 
- * Generated: 2026-07-05T14:35:59.520Z
+ * Generated: 2026-08-12T03:23:16.669Z
  */
 
 /**

package/src/validators/StemmaTokenUsageValidator.ts

@@ -294,9 +294,10 @@ export const TOKEN_CATEGORIES = {
     'border.default', 'border.strong',
     'radius.100', 'radius.150', 'radius.200',
   ],
+  // blend.disabledDesaturate removed 2026-07-15: deprecated (no-disabled-states
+  // philosophy) — the validator must not suggest it for new component work
   blend: [
-    'blend.hoverDarker', 'blend.pressedDarker',
-    'blend.disabledDesaturate', 'blend.iconLighter',
+    'blend.hoverDarker', 'blend.pressedDarker', 'blend.iconLighter',
   ],
 };
 

package/token-index/semantics.yaml

@@ -1418,8 +1418,7 @@ tokens:
       web: '--blend-disabled-desaturate'
       ios: blendDisabledDesaturate
       android: blend_disabled_desaturate
-    consumers:
-      - Button-CTA
+    consumers: []
   blend.containerHoverDarker:
     category: interaction
     primitiveReferences: