@3fn/core 13.0.0 → 14.1.0

package/dist/mcp/docs-mcp.js

@@ -14341,6 +14341,7 @@ function resolveSection(content, filePath, opts) {
 }
 
 // mcp-server/src/indexer/cross-ref-parser.ts
+var BARE_ID_GRAMMAR = /^[a-z0-9][a-z0-9-]*$/;
 function extractCrossReferences(content, _filePath) {
   const lines = content.split("\n");
   const references = [];
@@ -14363,6 +14364,14 @@ function extractCrossReferences(content, _filePath) {
           section: currentSection,
           lineNumber: i + 1
         });
+      } else if (BARE_ID_GRAMMAR.test(target) && !/[/.:#]/.test(target)) {
+        references.push({
+          target,
+          context,
+          section: currentSection,
+          lineNumber: i + 1,
+          kind: "id-candidate"
+        });
       }
     }
   }
@@ -14380,7 +14389,7 @@ function estimateTokenCount(content) {
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 function determineIndexHealth(options) {
-  const { indexedDocuments, directoryPath, lastIndexTime } = options;
+  const { indexedDocuments, directoryPath, lastIndexTime, crossRefTotals } = options;
   const errors = [];
   const warnings = [];
   const expectedDocs = getExpectedDocuments(directoryPath);
@@ -14400,7 +14409,15 @@ function determineIndexHealth(options) {
   if (malformedDocs.length > 0) {
     warnings.push(`Malformed metadata: ${malformedDocs.join(", ")}`);
   }
+  if (crossRefTotals && crossRefTotals.droppedBareIdCount > 0) {
+    warnings.push(
+      `${crossRefTotals.droppedBareIdCount} unresolved bare-id link targets \u2014 run scan-cross-references.sh for the list`
+    );
+  }
   const metrics = calculateIndexMetrics(indexedDocuments);
+  if (crossRefTotals) {
+    metrics.totalCrossReferences = crossRefTotals.validatedCount;
+  }
   let status;
   if (errors.length > 0) {
     status = "failed";
@@ -14664,6 +14681,25 @@ var DocumentIndexer = class {
     this.idIndex = /* @__PURE__ */ new Map();
     // id → indexedKey
     this.legacyPathIndex = /* @__PURE__ */ new Map();
+    // normalizedLegacyPath → indexedKey
+    /**
+     * Validated cross-references per indexed key (Spec 119-B OB-1, Decision 1:
+     * extract-then-validate at INDEX time, one validation point). indexFile
+     * stores the raw parser output (bare-id candidates still tagged); the
+     * post-index validation pass (or reindexFile's inline pass) replaces it with
+     * the validated, TAG-STRIPPED set — the candidate tag never escapes the
+     * indexer. All read surfaces (list_cross_references, getDocumentSummary,
+     * index-health metrics) consume THIS map, never re-extract, so the
+     * crossReferences count is a stable index property.
+     */
+    this.crossRefsByKey = /* @__PURE__ */ new Map();
+    /**
+     * Bare-id candidates dropped by validation (target not in idIndex) — the
+     * typo-suspicious class. Surfaced on two channels (design Component 6):
+     * scan-cross-references.sh lists individually; index-health emits ONE
+     * aggregate warning when count > 0.
+     */
+    this.droppedIdCandidates = [];
     this.logsDirectory = logsDirectory;
   }
   /**
@@ -14682,11 +14718,14 @@ var DocumentIndexer = class {
     this.documentContent.clear();
     this.idIndex.clear();
     this.legacyPathIndex.clear();
+    this.crossRefsByKey.clear();
+    this.droppedIdCandidates = [];
     const files = this.scanDirectory(directoryPath);
     for (const filePath of files) {
       await this.indexFile(filePath);
     }
     this.seedLegacyPaths();
+    this.validateAllCrossReferences();
     this.lastIndexTime = (/* @__PURE__ */ new Date()).toISOString();
     this.logIndexStateChange("indexing_completed", {
       directoryPath,
@@ -14704,10 +14743,13 @@ var DocumentIndexer = class {
       this.pruneAddressingEntriesForKey(filePath);
       this.documentMap.delete(filePath);
       this.documentContent.delete(filePath);
+      this.crossRefsByKey.delete(filePath);
+      this.droppedIdCandidates = this.droppedIdCandidates.filter((d) => d.sourceKey !== filePath);
       this.lastIndexTime = (/* @__PURE__ */ new Date()).toISOString();
       return;
     }
     await this.indexFile(filePath);
+    this.validateCrossReferencesForKey(filePath);
     this.lastIndexTime = (/* @__PURE__ */ new Date()).toISOString();
   }
   /**
@@ -14745,10 +14787,11 @@ var DocumentIndexer = class {
    * @param filePath - Path to document
    */
   getDocumentSummary(filePath) {
-    const content = this.getDocumentContent(filePath);
+    const { indexedKey } = this.resolveRef(filePath);
+    const content = this.documentContent.get(indexedKey);
     const metadata = extractMetadata(content);
     const outline = extractHeadingStructure(content);
-    const crossReferences = extractCrossReferences(content, filePath);
+    const crossReferences = this.crossRefsByKey.get(indexedKey) ?? [];
     const crossReferenceInfo = crossReferences.map((ref) => ({
       target: ref.target,
       context: ref.context,
@@ -14858,12 +14901,65 @@ ${candidateLines}`
   /**
    * List cross-references in a document
    * Returns links without following them
-   * 
-   * @param filePath - Path to document
+   *
+   * Spec 119-B OB-1: the incoming ref routes through the SAME resolver chain
+   * as every other document-addressed tool (id → indexed key → legacy path,
+   * D5), and the result is the VALIDATED index-time set — `.md` path refs
+   * unchanged, bare-id refs enumerated with target = the doc id; dropped
+   * candidates never appear. Public shape unchanged (no kind tag).
+   *
+   * @param filePath - Document ref: id, indexed relative path, or legacy path
    */
   listCrossReferences(filePath) {
-    const content = this.getDocumentContent(filePath);
-    return extractCrossReferences(content, filePath);
+    const { indexedKey } = this.resolveRef(filePath);
+    return this.crossRefsByKey.get(indexedKey) ?? [];
+  }
+  /**
+   * Bare-id candidates dropped by validation (Spec 119-B OB-1) — the
+   * typo-suspicious class surfaced via index-health's aggregate warning and
+   * scan-cross-references.sh's individual listing.
+   */
+  getDroppedIdCandidates() {
+    return this.droppedIdCandidates;
+  }
+  /**
+   * Validate ALL stored cross-reference sets against the completed idIndex
+   * (the post-index hook — Spec 119-B OB-1, Decision 1's single validation
+   * point). Resets the dropped-candidate record.
+   */
+  validateAllCrossReferences() {
+    this.droppedIdCandidates = [];
+    for (const key of this.crossRefsByKey.keys()) {
+      this.validateCrossReferencesForKey(key);
+    }
+  }
+  /**
+   * Validate one document's stored cross-references against the CURRENT
+   * idIndex. `.md` path refs pass through untouched; bare-id candidates are
+   * kept iff their target is a known doc id (tag stripped — it never escapes
+   * the indexer) and dropped-with-record otherwise.
+   */
+  validateCrossReferencesForKey(key) {
+    const raw = this.crossRefsByKey.get(key);
+    if (!raw) return;
+    this.droppedIdCandidates = this.droppedIdCandidates.filter((d) => d.sourceKey !== key);
+    const validated = [];
+    for (const ref of raw) {
+      if (ref.kind !== "id-candidate") {
+        validated.push(ref);
+      } else if (this.idIndex.has(ref.target)) {
+        const { kind: _kind, ...publicRef } = ref;
+        validated.push(publicRef);
+      } else {
+        this.droppedIdCandidates.push({
+          sourceKey: key,
+          target: ref.target,
+          section: ref.section,
+          lineNumber: ref.lineNumber
+        });
+      }
+    }
+    this.crossRefsByKey.set(key, validated);
   }
   /**
    * Validate metadata for a document
@@ -14957,6 +15053,7 @@ ${candidateLines}`
       viability: frontmatter.viability
     };
     this.documentMap.set(filePath, documentMetadata);
+    this.crossRefsByKey.set(filePath, extractCrossReferences(content, filePath));
     for (const [existingId, existingKey] of this.idIndex) {
       if (existingKey === filePath && existingId !== id) this.idIndex.delete(existingId);
     }
@@ -15119,10 +15216,16 @@ ${candidateLines}`
       this.logIndexStateChange("validation_completed", { status: health2.status, errors: health2.errors });
       return health2;
     }
+    let validatedCount = 0;
+    for (const refs of this.crossRefsByKey.values()) validatedCount += refs.length;
     const health = determineIndexHealth({
       indexedDocuments: this.documentContent,
       directoryPath: this.directoryPath,
-      lastIndexTime: this.lastIndexTime
+      lastIndexTime: this.lastIndexTime,
+      crossRefTotals: {
+        validatedCount,
+        droppedBareIdCount: this.droppedIdCandidates.length
+      }
     });
     this.logIndexStateChange("validation_completed", {
       status: health.status,
@@ -16421,13 +16524,13 @@ function formatMcpResponse4(result) {
 // mcp-server/src/tools/list-cross-references.ts
 var listCrossReferencesTool = {
   name: "list_cross_references",
-  description: "List cross-references in a document. Returns all referenced documents with context, source section, and line number.",
+  description: "List cross-references in a document. Returns all referenced documents with context, source section, and line number. Enumerates both `.md`-path links (target = the linked path, verbatim) and bare-id links validated against the doc-id index (target = the doc id); unresolvable bare-id targets are excluded (surfaced via index-health). Addressing contract (D5): the `path` parameter resolves through the same strategy chain as the other document tools \u2014 doc id, then indexed relative path, then legacy `.kiro/steering/\u2026` path.",
   inputSchema: {
     type: "object",
     properties: {
       path: {
         type: "string",
-        description: 'Document path (e.g., ".kiro/steering/Component Development Guide.md")'
+        description: 'Document ref: doc id (e.g., "token-governance"), indexed relative path, or legacy `.kiro/steering/\u2026` path \u2014 same resolver chain as get_document_summary'
       }
     },
     required: ["path"]
@@ -16851,7 +16954,15 @@ var MCPDocumentationServer = class {
     this.isRunning = false;
   }
   /**
-   * Set up graceful shutdown handlers
+   * Set up graceful shutdown handlers.
+   *
+   * stdin EOF ('end'/'close') is a first-class shutdown trigger: a stdio MCP server
+   * whose parent client died (or gracefully closed the pipe) has no one to serve, but
+   * the file watcher keeps the event loop alive forever — found live at Spec 122 U3
+   * (~230 orphaned servers accumulated across harness runs, wedging later boots).
+   * Self-exiting on EOF also makes graceful client closes immediate: the MCP SDK's
+   * StdioClientTransport.close() ends stdin and waits up to 2s for exactly this exit
+   * before escalating to SIGTERM.
    */
   setupShutdownHandlers() {
     const shutdown = async () => {
@@ -16860,6 +16971,8 @@ var MCPDocumentationServer = class {
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
+    process.stdin.on("end", shutdown);
+    process.stdin.on("close", shutdown);
   }
 };
 async function main() {
@@ -16882,10 +16995,12 @@ async function main() {
   const server = new MCPDocumentationServer(steeringDir);
   await server.start();
 }
-main().catch((error2) => {
-  console.error("[MCP Server] Fatal error:", error2);
-  process.exit(1);
-});
+if (require.main === module) {
+  main().catch((error2) => {
+    console.error("[MCP Server] Fatal error:", error2);
+    process.exit(1);
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MCPDocumentationServer,

package/dist/mcp/product-mcp.js

@@ -24567,6 +24567,31 @@ var ProductMCPServer = class {
     const transport = new StdioServerTransport();
     await this.server.connect(transport);
     console.error(`[${SERVER_NAME4}] Server running on stdio`);
+    this.setupShutdownHandlers();
+  }
+  /**
+   * Self-exit on stdin EOF and fatal signals. A stdio MCP server whose parent client
+   * died (or gracefully closed the pipe) has no one to serve, but the file watcher
+   * keeps the event loop alive forever — found live at Spec 122 U3 (~230 orphaned
+   * servers accumulated across harness runs, this server the most-leaked of the
+   * three). Exiting on EOF also makes graceful client closes immediate: the MCP
+   * SDK's StdioClientTransport.close() ends stdin and waits up to 2s for exactly
+   * this exit before escalating to SIGTERM.
+   */
+  setupShutdownHandlers() {
+    let shuttingDown = false;
+    const shutdown = async () => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      console.error(`[${SERVER_NAME4}] Shutting down...`);
+      this.fileWatcher?.close();
+      await this.server.close();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.stdin.on("end", shutdown);
+    process.stdin.on("close", shutdown);
   }
   startFileWatcher() {
     if (!fs7.existsSync(this.productDir)) return;

package/dist/tokens/OpacityTokens.js

@@ -108,7 +108,7 @@ exports.opacityTokens = {
         category: PrimitiveToken_1.TokenCategory.OPACITY,
         baseValue: exports.OPACITY_BASE_VALUE * 6,
         familyBaseValue: exports.OPACITY_BASE_VALUE,
-        description: 'Disabled state - faded, very strong overlay',
+        description: 'Very strong transparency - background scrims and modal overlays (referenced by opacity.heavy)',
         mathematicalRelationship: 'base × 6 = 0.08 × 6 = 0.48',
         baselineGridAlignment: false,
         isStrategicFlexibility: false,

package/dist/tokens/component/progress.d.ts

@@ -19,16 +19,34 @@
  * @see .kiro/specs/048-progress-family/requirements.md (Requirements 5.7-5.15)
  * @see .kiro/specs/048-progress-family/design.md (Size Variant, Token Usage sections)
  */
+import type { RegisteredComponentToken } from '../../registries/ComponentTokenRegistry';
 /**
- * Progress Indicator component tokens defined using the hybrid authoring API.
+ * ONE CALL PER FAMILY.
+ *
+ * Every token registered by a single defineComponentTokens() call is stamped with that
+ * call's `family`, and the family drives platform output — notably the primitive class
+ * name emitted for reference-path tokens (TokenFileGenerator.getFamilyClassName) and the
+ * Android `.dp` suffix. These 10 tokens span THREE primitive families, so they require
+ * three calls. A single `family: 'spacing'` call previously produced
+ * `SpacingTokens.size150` / `SpacingTokens.borderWidth100` — members no generated platform
+ * file defines — the same defect fixed for Button-Icon in PR #126.
+ *
+ * The three branded results MUST NOT be spread/merged into one registration object: the
+ * rich metadata rides on a non-enumerable brand (src/build/tokens/defineComponentTokens.ts,
+ * TOKEN_CONTRACT_BRAND) that a spread silently drops. The harvest in loadComponentTokens
+ * collects each branded export separately. Use {@link progressTokenValues} for flat
+ * value lookups and {@link getProgressRegisteredTokens} for the rich metadata.
+ *
+ * All three calls declare `component: 'Progress'`, so platform output is still a single
+ * `ProgressTokens` Swift enum / Kotlin object.
+ */
+/**
+ * Node dimension tokens — reference sizing primitives (dimensions, not spacing).
  *
- * 13 tokens organized by concept:
  * - node.size.{sm|md|lg}         — base node dimensions
  * - node.size.{sm|md|lg}.current — emphasized node dimensions (+4px)
- * - node.gap.{sm|md|lg}          — spacing between nodes
- * - connector.thickness           — connector line width
  */
-export declare const ProgressTokens: import("../../build/tokens").ComponentTokenValues<{
+export declare const ProgressSizingTokens: import("../../build/tokens").ComponentTokenValues<{
     'node.size.sm': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
@@ -53,6 +71,13 @@ export declare const ProgressTokens: import("../../build/tokens").ComponentToken
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
+}>;
+/**
+ * Node gap tokens — reference spacing primitives (gaps are spacing, not sizing).
+ *
+ * - node.gap.{sm|md|lg} — spacing between nodes
+ */
+export declare const ProgressSpacingTokens: import("../../build/tokens").ComponentTokenValues<{
     'node.gap.sm': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
@@ -65,11 +90,46 @@ export declare const ProgressTokens: import("../../build/tokens").ComponentToken
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
+}>;
+/**
+ * Connector tokens — line connecting nodes in steppers. References a borderWidth primitive.
+ *
+ * - connector.thickness — connector line width
+ */
+export declare const ProgressBorderWidthTokens: import("../../build/tokens").ComponentTokenValues<{
     'connector.thickness': {
         reference: import("../../types").PrimitiveToken;
         reasoning: string;
     };
 }>;
+/**
+ * Flat value map across all three Progress token calls — a READ-ONLY convenience for
+ * value lookups (`progressTokenValues['node.size.md']`).
+ *
+ * NOT a registration surface: spreading drops the non-enumerable brand, so this object
+ * deliberately harvests to zero and cannot double-register. For the rich metadata use
+ * {@link getProgressRegisteredTokens}, never `getTokenContract(progressTokenValues)`.
+ */
+export declare const progressTokenValues: {
+    'connector.thickness': number;
+    'node.gap.sm': number;
+    'node.gap.md': number;
+    'node.gap.lg': number;
+    'node.size.sm': number;
+    'node.size.md': number;
+    'node.size.lg': number;
+    'node.size.sm.current': number;
+    'node.size.md.current': number;
+    'node.size.lg.current': number;
+};
+/**
+ * All Progress component tokens with their rich metadata, concatenated across the three
+ * family calls in declaration order (sizing → spacing → borderWidth).
+ *
+ * This is the brand-safe replacement for `getTokenContract(ProgressTokens)`, which is no
+ * longer meaningful now that Progress registers through three calls.
+ */
+export declare function getProgressRegisteredTokens(): RegisteredComponentToken[];
 /**
  * Expected token count for governance validation
  *

package/dist/tokens/component/progress.js

@@ -21,7 +21,8 @@
  * @see .kiro/specs/048-progress-family/design.md (Size Variant, Token Usage sections)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.progressComponentTokenNames = exports.PROGRESS_COMPONENT_TOKEN_COUNT = exports.ProgressTokens = void 0;
+exports.progressComponentTokenNames = exports.PROGRESS_COMPONENT_TOKEN_COUNT = exports.progressTokenValues = exports.ProgressBorderWidthTokens = exports.ProgressSpacingTokens = exports.ProgressSizingTokens = void 0;
+exports.getProgressRegisteredTokens = getProgressRegisteredTokens;
 exports.validateProgressComponentTokenCount = validateProgressComponentTokenCount;
 exports.getProgressComponentToken = getProgressComponentToken;
 exports.getAllProgressComponentTokens = getAllProgressComponentTokens;
@@ -30,20 +31,37 @@ const SpacingTokens_1 = require("../../tokens/SpacingTokens");
 const SizingTokens_1 = require("../../tokens/SizingTokens");
 const BorderWidthTokens_1 = require("../../tokens/BorderWidthTokens");
 /**
- * Progress Indicator component tokens defined using the hybrid authoring API.
+ * ONE CALL PER FAMILY.
+ *
+ * Every token registered by a single defineComponentTokens() call is stamped with that
+ * call's `family`, and the family drives platform output — notably the primitive class
+ * name emitted for reference-path tokens (TokenFileGenerator.getFamilyClassName) and the
+ * Android `.dp` suffix. These 10 tokens span THREE primitive families, so they require
+ * three calls. A single `family: 'spacing'` call previously produced
+ * `SpacingTokens.size150` / `SpacingTokens.borderWidth100` — members no generated platform
+ * file defines — the same defect fixed for Button-Icon in PR #126.
+ *
+ * The three branded results MUST NOT be spread/merged into one registration object: the
+ * rich metadata rides on a non-enumerable brand (src/build/tokens/defineComponentTokens.ts,
+ * TOKEN_CONTRACT_BRAND) that a spread silently drops. The harvest in loadComponentTokens
+ * collects each branded export separately. Use {@link progressTokenValues} for flat
+ * value lookups and {@link getProgressRegisteredTokens} for the rich metadata.
+ *
+ * All three calls declare `component: 'Progress'`, so platform output is still a single
+ * `ProgressTokens` Swift enum / Kotlin object.
+ */
+/**
+ * Node dimension tokens — reference sizing primitives (dimensions, not spacing).
  *
- * 13 tokens organized by concept:
  * - node.size.{sm|md|lg}         — base node dimensions
  * - node.size.{sm|md|lg}.current — emphasized node dimensions (+4px)
- * - node.gap.{sm|md|lg}          — spacing between nodes
- * - connector.thickness           — connector line width
  */
-exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
+exports.ProgressSizingTokens = (0, tokens_1.defineComponentTokens)({
     component: 'Progress',
-    family: 'spacing',
+    family: 'sizing',
     tokens: {
         // ========================================================================
-        // BASE NODE SIZES — reference sizing primitives (dimensions, not spacing)
+        // BASE NODE SIZES
         // ========================================================================
         'node.size.sm': {
             reference: SizingTokens_1.sizingTokens.size150,
@@ -58,7 +76,7 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reasoning: 'Large node base size (20px). Inactive dots in desktop contexts.',
         },
         // ========================================================================
-        // CURRENT NODE SIZES — reference sizing primitives directly (+4px emphasis)
+        // CURRENT NODE SIZES — +4px emphasis
         // Provides non-color visual differentiation of active position
         // ========================================================================
         'node.size.sm.current': {
@@ -73,9 +91,17 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reference: SizingTokens_1.sizingTokens.size300,
             reasoning: 'Current node emphasis for lg (24px). +4px over base 20px for non-color visual differentiation.',
         },
-        // ========================================================================
-        // GAP TOKENS — spacing between nodes (gaps are spacing, not sizing)
-        // ========================================================================
+    },
+});
+/**
+ * Node gap tokens — reference spacing primitives (gaps are spacing, not sizing).
+ *
+ * - node.gap.{sm|md|lg} — spacing between nodes
+ */
+exports.ProgressSpacingTokens = (0, tokens_1.defineComponentTokens)({
+    component: 'Progress',
+    family: 'spacing',
+    tokens: {
         'node.gap.sm': {
             reference: SpacingTokens_1.spacingTokens.space075,
             reasoning: 'Small gap between nodes (6px = 0.75× base). Tight spacing for compact pagination dots in mobile contexts.',
@@ -88,15 +114,50 @@ exports.ProgressTokens = (0, tokens_1.defineComponentTokens)({
             reference: SpacingTokens_1.spacingTokens.space150,
             reasoning: 'Large gap between nodes (12px = 1.5× base). Generous spacing for detailed steppers with labels in desktop contexts.',
         },
-        // ========================================================================
-        // CONNECTOR TOKENS — line connecting nodes in steppers
-        // ========================================================================
+    },
+});
+/**
+ * Connector tokens — line connecting nodes in steppers. References a borderWidth primitive.
+ *
+ * - connector.thickness — connector line width
+ */
+exports.ProgressBorderWidthTokens = (0, tokens_1.defineComponentTokens)({
+    component: 'Progress',
+    family: 'borderWidth',
+    tokens: {
         'connector.thickness': {
             reference: BorderWidthTokens_1.borderWidthTokens.borderWidth100,
             reasoning: 'Connector line thickness (1px). References borderDefault primitive for consistent border treatment across the design system.',
         },
     },
 });
+/**
+ * Flat value map across all three Progress token calls — a READ-ONLY convenience for
+ * value lookups (`progressTokenValues['node.size.md']`).
+ *
+ * NOT a registration surface: spreading drops the non-enumerable brand, so this object
+ * deliberately harvests to zero and cannot double-register. For the rich metadata use
+ * {@link getProgressRegisteredTokens}, never `getTokenContract(progressTokenValues)`.
+ */
+exports.progressTokenValues = {
+    ...exports.ProgressSizingTokens,
+    ...exports.ProgressSpacingTokens,
+    ...exports.ProgressBorderWidthTokens,
+};
+/**
+ * All Progress component tokens with their rich metadata, concatenated across the three
+ * family calls in declaration order (sizing → spacing → borderWidth).
+ *
+ * This is the brand-safe replacement for `getTokenContract(ProgressTokens)`, which is no
+ * longer meaningful now that Progress registers through three calls.
+ */
+function getProgressRegisteredTokens() {
+    return [
+        ...((0, tokens_1.getTokenContract)(exports.ProgressSizingTokens) ?? []),
+        ...((0, tokens_1.getTokenContract)(exports.ProgressSpacingTokens) ?? []),
+        ...((0, tokens_1.getTokenContract)(exports.ProgressBorderWidthTokens) ?? []),
+    ];
+}
 // ============================================================================
 // Constants and Utilities
 // ============================================================================
@@ -128,18 +189,18 @@ exports.progressComponentTokenNames = [
  * Validate that the progress component token count matches the expected count (13)
  */
 function validateProgressComponentTokenCount() {
-    return Object.keys(exports.ProgressTokens).length === exports.PROGRESS_COMPONENT_TOKEN_COUNT;
+    return Object.keys(exports.progressTokenValues).length === exports.PROGRESS_COMPONENT_TOKEN_COUNT;
 }
 /**
  * Get a single progress component token value by key
  */
 function getProgressComponentToken(key) {
-    return exports.ProgressTokens[key];
+    return exports.progressTokenValues[key];
 }
 /**
  * Get all progress component token entries as key-value pairs
  */
 function getAllProgressComponentTokens() {
-    return Object.entries(exports.ProgressTokens).map(([name, value]) => ({ name, value }));
+    return Object.entries(exports.progressTokenValues).map(([name, value]) => ({ name, value }));
 }
 //# sourceMappingURL=progress.js.map

package/dist/tokens/semantic/BlendTokens.d.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)
  *
@@ -42,6 +42,12 @@ export interface SemanticBlendToken {
     context: string;
     /** 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;
 }
 /**
  * Semantic blend tokens for common interaction states
@@ -87,8 +93,9 @@ export declare 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/dist/tokens/semantic/BlendTokens.js

@@ -17,7 +17,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)
  *
@@ -84,6 +84,14 @@ exports.blendTokens = {
         context: 'Focus state feedback - more vibrant, attention-drawing color',
         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: {
@@ -91,8 +99,11 @@ exports.blendTokens = {
         },
         direction: BlendTokens_1.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': {
         name: 'blend.containerHoverDarker',
@@ -166,8 +177,9 @@ function validateBlendTokenCount() {
  *    → 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)