@usefragments/core 1.3.0 → 1.4.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-h_yWj15D.js';
-export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-h_yWj15D.js';
+import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-0lmh0Lbo.js';
+export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-0lmh0Lbo.js';
 import { Severity } from './severity.js';
 export { SEVERITIES, SEVERITY_RANK, SEVERITY_WEIGHTS, SeverityLevel, compareSeverity, maxSeverity, severityLevel, severitySchema, sortBySeverity } from './severity.js';
 export { BridgeViolationInput, CODES, CodeCategory, CodeLifecycle, EXPLAIN_URL_BASE, FuiCode, bridgeSourceViolation, bridgeSourceViolations, byCode, byRuleId, explainUrlForCode } from './codes/index.js';
-import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-DYSirwJu.js';
-export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-DYSirwJu.js';
+import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-DxdJV6lx.js';
+export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-DxdJV6lx.js';
 import { z } from 'zod';
 import { RegistryArtifact, RegistryDependency, RegistryInstallReceipt } from './registry.js';
 export { REGISTRY_ARTIFACT_SCHEMA_VERSION, REGISTRY_INSTALL_RECEIPT_SCHEMA_VERSION, REGISTRY_MANIFEST_SCHEMA_VERSION, RegistryArtifactInput, RegistryComponent, RegistryComponentExport, RegistryDependencyType, RegistryEntrypoint, RegistryFile, RegistryFileContent, RegistryFileInput, RegistryFileRole, RegistryInstallProfile, RegistryInstallReceiptComponent, RegistryInstallReceiptFile, RegistryManifest, RegistryManifestDraft, RegistrySource, assertValidRegistryArtifact, buildRegistryArtifact, buildRegistryFile, computeRegistryHash, finalizeRegistryManifest, hashRegistryFileContent, registryArtifactDigest, registryArtifactSchema, registryComponentExportSchema, registryComponentSchema, registryDependencySchema, registryDependencyTypeSchema, registryEntrypointSchema, registryFileContentSchema, registryFileRoleSchema, registryFileSchema, registryFileSize, registryInstallProfileSchema, registryInstallReceiptComponentSchema, registryInstallReceiptFileSchema, registryInstallReceiptSchema, registryManifestCanonicalPreimage, registryManifestDraftSchema, registryManifestSchema, registrySourceSchema } from './registry.js';
@@ -39,6 +39,8 @@ declare const BRAND: {
     readonly legacyConfigFile: "segments.config.ts";
     /** CLI command name (e.g., "fragments") */
     readonly cliCommand: "fragments";
+    /** Full user-facing CLI invocation for copy printed to end users (e.g., "npx @usefragments/cli") */
+    readonly cliInvocation: "npx @usefragments/cli";
     /** Directory for storing fragments, registry, and cache */
     readonly dataDir: ".fragments";
     /** Components subdirectory within .fragments/ */
@@ -824,7 +826,20 @@ interface UsageInlineStyleFact extends BaseFact {
     kind: "usage_inline_style";
     nodeId: FactId;
     property: string;
-    valueKind: "static" | "number" | "css-variable";
+    /**
+     * How the extractor resolved the value:
+     * - `static`       — a string literal (`"#f00"`, `"12px"`).
+     * - `number`       — a numeric literal (React treats it as `px`).
+     * - `css-variable` — a `var(--token)` reference; rules treat it as a token.
+     * - `dynamic-raw`  — a value constructed at runtime whose *static* fragments
+     *   unambiguously begin a raw color literal (`` `#${red}` ``,
+     *   `` `rgb(${r},${g},${b})` ``, `"#" + hex`). `value` carries a reconstructed
+     *   skeleton with each interpolation rendered as `‹expr›`. Detect-only: a rule
+     *   may flag it as a raw color but must NEVER attach a deterministic fix
+     *   (the value is partly runtime). Only color-shaped dynamic values ever
+     *   surface as facts — a non-color dynamic value stays opaque.
+     */
+    valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
     value: string;
 }
 interface UsageTextChildFact extends BaseFact {
@@ -1224,7 +1239,7 @@ declare function makeUsagePropResolvedFact(input: {
 declare function makeUsageInlineStyleFact(input: {
     nodeId: FactId;
     property: string;
-    valueKind: "static" | "number" | "css-variable";
+    valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
     value: string;
 }): UsageInlineStyleFact;
 declare function makeUsageTextChildFact(input: {
@@ -1774,7 +1789,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         name: string;
     }[];
     publicSlug: string | null;
-    tier: "core" | "composition";
+    tier: "composition" | "core";
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1795,7 +1810,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         name: string;
     }[];
     publicSlug: string | null;
-    tier: "core" | "composition";
+    tier: "composition" | "core";
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1904,7 +1919,7 @@ declare const bundleManifestSchema: z.ZodObject<{
             name: string;
         }[];
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1925,7 +1940,7 @@ declare const bundleManifestSchema: z.ZodObject<{
             name: string;
         }[];
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1948,7 +1963,7 @@ declare const bundleManifestSchema: z.ZodObject<{
             name: string;
         }[];
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1994,7 +2009,7 @@ declare const bundleManifestSchema: z.ZodObject<{
             name: string;
         }[];
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -2198,7 +2213,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
         }[];
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2224,7 +2239,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
         }[];
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2255,7 +2270,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
         }[];
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2288,7 +2303,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
         }[];
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
+        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -5510,6 +5525,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             path: string;
             format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
         }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
         themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5527,6 +5543,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             path: string;
             format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
         }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
         themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5544,6 +5561,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             path: string;
             format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
         }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
         themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5561,6 +5579,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             path: string;
             format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
         }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
         themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5578,6 +5597,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             path: string;
             format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
         }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
         themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -6726,6 +6746,33 @@ declare const fragmentsConfigSchema: z.ZodObject<{
     }>>;
     recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
+    components?: string[] | undefined;
+    screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    tokens?: z.objectOutputType<{
+        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        namespace: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    performance?: "strict" | "relaxed" | "standard" | {
+        preset?: "strict" | "relaxed" | "standard" | undefined;
+        budgets?: {
+            bundleSize?: number | undefined;
+        } | undefined;
+    } | undefined;
     govern?: {
         components?: Record<string, {
             rules: ({
@@ -6901,32 +6948,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             failOnWarnings: z.ZodOptional<z.ZodBoolean>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
-    components?: string[] | undefined;
-    screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
-    tokens?: z.objectOutputType<{
-        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodEffects<z.ZodString, string, string>;
-            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }>, "many">>;
-        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        namespace: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    performance?: "strict" | "relaxed" | "standard" | {
-        preset?: "strict" | "relaxed" | "standard" | undefined;
-        budgets?: {
-            bundleSize?: number | undefined;
-        } | undefined;
-    } | undefined;
     include?: string[] | undefined;
     exclude?: string[] | undefined;
     registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -6984,6 +7005,33 @@ declare const fragmentsConfigSchema: z.ZodObject<{
     } | undefined;
     recognizedClassHelpers?: string[] | undefined;
 }, {
+    components?: string[] | undefined;
+    screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    tokens?: z.objectInputType<{
+        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        namespace: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    performance?: "strict" | "relaxed" | "standard" | {
+        preset?: "strict" | "relaxed" | "standard" | undefined;
+        budgets?: {
+            bundleSize?: number | undefined;
+        } | undefined;
+    } | undefined;
     govern?: {
         components?: Record<string, {
             rules: ({
@@ -7159,32 +7207,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             failOnWarnings: z.ZodOptional<z.ZodBoolean>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
-    components?: string[] | undefined;
-    screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
-    tokens?: z.objectInputType<{
-        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodEffects<z.ZodString, string, string>;
-            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }>, "many">>;
-        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        namespace: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    performance?: "strict" | "relaxed" | "standard" | {
-        preset?: "strict" | "relaxed" | "standard" | undefined;
-        budgets?: {
-            bundleSize?: number | undefined;
-        } | undefined;
-    } | undefined;
     include?: string[] | undefined;
     exclude?: string[] | undefined;
     registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -8669,7 +8691,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         guidelines?: string[] | undefined;
         accessibility?: string[] | undefined;
     };
-    govern?: ((...args: unknown[]) => unknown) | undefined;
     composition?: {
         pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
         subComponents?: string[] | undefined;
@@ -8685,6 +8706,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
     }> | undefined;
+    govern?: ((...args: unknown[]) => unknown) | undefined;
     contract?: {
         composition?: {
             rule: {
@@ -8815,7 +8837,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         guidelines?: string[] | undefined;
         accessibility?: string[] | undefined;
     };
-    govern?: ((...args: unknown[]) => unknown) | undefined;
     composition?: {
         pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
         subComponents?: string[] | undefined;
@@ -8831,6 +8852,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
     }> | undefined;
+    govern?: ((...args: unknown[]) => unknown) | undefined;
     contract?: {
         composition?: {
             rule: {
@@ -9699,7 +9721,7 @@ interface ThemeParserResult {
 
 declare function inferTokenCategory(name: string, value?: string): TokenCategory;
 declare function inferTokenGroup(name: string): string;
-declare function normalizeTokenGroupComment(comment: string): string;
+declare function normalizeTokenGroupComment(comment: string): string | null;
 
 declare function parseScssVariables(content: string): Map<string, string>;
 declare function resolveTokenValue(rawValue: string, scssVars: Map<string, string>, cssVarValues: Map<string, string>, depth?: number): string;
@@ -10241,6 +10263,8 @@ declare const componentContractSchema: z.ZodObject<{
         accessibility?: string[] | undefined;
     };
     $schema: string;
+    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
+    tokens?: string[] | undefined;
     preview?: {
         css?: string[] | undefined;
         theme?: "light" | "dark" | undefined;
@@ -10248,8 +10272,6 @@ declare const componentContractSchema: z.ZodObject<{
         wrapperModule?: string | undefined;
         wrapperExport?: string | undefined;
     } | undefined;
-    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
-    tokens?: string[] | undefined;
     contract?: {
         compoundChildren?: Record<string, {
             description?: string | undefined;
@@ -10322,6 +10344,8 @@ declare const componentContractSchema: z.ZodObject<{
         accessibility?: string[] | undefined;
     };
     $schema: string;
+    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
+    tokens?: string[] | undefined;
     preview?: {
         css?: string[] | undefined;
         theme?: "light" | "dark" | undefined;
@@ -10329,8 +10353,6 @@ declare const componentContractSchema: z.ZodObject<{
         wrapperModule?: string | undefined;
         wrapperExport?: string | undefined;
     } | undefined;
-    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
-    tokens?: string[] | undefined;
     contract?: {
         compoundChildren?: Record<string, {
             description?: string | undefined;