@usefragments/core 1.10.2 → 2.0.0

package/dist/registry.d.ts

@@ -31,14 +31,14 @@ declare const registryFileSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     path: string;
     size: number;
-    role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+    role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
     contentType: string;
     sha256: string;
     contentRef: string;
 }, {
     path: string;
     size: number;
-    role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+    role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
     contentType: string;
     sha256: string;
     contentRef: string;
@@ -122,13 +122,13 @@ declare const registryComponentExportSchema: z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
     path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
 }, "strip", z.ZodTypeAny, {
-    kind: "hook" | "type" | "style" | "component" | "utility";
+    kind: "hook" | "type" | "component" | "style" | "utility";
     name: string;
     path?: string | undefined;
 }, {
     name: string;
     path?: string | undefined;
-    kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+    kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
 }>;
 declare const registryComponentSchema: z.ZodObject<{
     componentId: z.ZodString;
@@ -147,14 +147,14 @@ declare const registryComponentSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
     }, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -199,29 +199,29 @@ declare const registryComponentSchema: z.ZodObject<{
         kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
         path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "hook" | "type" | "style" | "component" | "utility";
+        kind: "hook" | "type" | "component" | "style" | "utility";
         name: string;
         path?: string | undefined;
     }, {
         name: string;
         path?: string | undefined;
-        kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+        kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
     }>, "many">>;
     contract: z.ZodOptional<z.ZodUnknown>;
     examples: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
     provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     status: string;
-    componentId: string;
     name: string;
+    componentId: string;
     publicRef: string;
-    tier: "composition" | "core" | "custom" | "utility";
     provenance: Record<string, unknown>;
+    tier: "composition" | "core" | "custom" | "utility";
     examples: unknown[];
     files: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -242,20 +242,20 @@ declare const registryComponentSchema: z.ZodObject<{
     }[];
     internalDependencies: string[];
     exports: {
-        kind: "hook" | "type" | "style" | "component" | "utility";
+        kind: "hook" | "type" | "component" | "style" | "utility";
         name: string;
         path?: string | undefined;
     }[];
     category?: string | undefined;
     contract?: unknown;
 }, {
-    componentId: string;
     name: string;
+    componentId: string;
     publicRef: string;
     files: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -263,8 +263,8 @@ declare const registryComponentSchema: z.ZodObject<{
     status?: string | undefined;
     category?: string | undefined;
     contract?: unknown;
-    tier?: "composition" | "core" | "custom" | "utility" | undefined;
     provenance?: Record<string, unknown> | undefined;
+    tier?: "composition" | "core" | "custom" | "utility" | undefined;
     examples?: unknown[] | undefined;
     styleFiles?: string[] | undefined;
     tokenDependencies?: string[] | undefined;
@@ -284,7 +284,7 @@ declare const registryComponentSchema: z.ZodObject<{
     exports?: {
         name: string;
         path?: string | undefined;
-        kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+        kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
     }[] | undefined;
 }>;
 declare const registryEntrypointSchema: z.ZodObject<{
@@ -304,14 +304,14 @@ declare const registryInstallProfileSchema: z.ZodObject<{
     stylePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     includeTests: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    importPath: string;
     name: string;
+    importPath: string;
     targetPath: string;
     includeTests: boolean;
     stylePath?: string | undefined;
 }, {
-    importPath: string;
     name: string;
+    importPath: string;
     targetPath: string;
     stylePath?: string | undefined;
     includeTests?: boolean | undefined;
@@ -390,14 +390,37 @@ declare const registryManifestDraftSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }, {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }>, "many">>;
+    /** Files every install writes, whatever the selection: the stylesheet entry and its closure. */
+    baseFiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+        contentType: z.ZodString;
+        contentRef: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
     }, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -429,14 +452,14 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
         }, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -481,29 +504,29 @@ declare const registryManifestDraftSchema: z.ZodObject<{
             kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
             path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
         }, "strip", z.ZodTypeAny, {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }, {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }>, "many">>;
         contract: z.ZodOptional<z.ZodUnknown>;
         examples: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
         provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         status: string;
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
-        tier: "composition" | "core" | "custom" | "utility";
         provenance: Record<string, unknown>;
+        tier: "composition" | "core" | "custom" | "utility";
         examples: unknown[];
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -524,20 +547,20 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         }[];
         internalDependencies: string[];
         exports: {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }[];
         category?: string | undefined;
         contract?: unknown;
     }, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -545,8 +568,8 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         status?: string | undefined;
         category?: string | undefined;
         contract?: unknown;
-        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         provenance?: Record<string, unknown> | undefined;
+        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         examples?: unknown[] | undefined;
         styleFiles?: string[] | undefined;
         tokenDependencies?: string[] | undefined;
@@ -566,7 +589,7 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         exports?: {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }[] | undefined;
     }>>;
     dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -592,14 +615,14 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         stylePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         includeTests: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         includeTests: boolean;
         stylePath?: string | undefined;
     }, {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         stylePath?: string | undefined;
         includeTests?: boolean | undefined;
@@ -607,16 +630,16 @@ declare const registryManifestDraftSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     components: Record<string, {
         status: string;
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
-        tier: "composition" | "core" | "custom" | "utility";
         provenance: Record<string, unknown>;
+        tier: "composition" | "core" | "custom" | "utility";
         examples: unknown[];
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -637,7 +660,7 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         }[];
         internalDependencies: string[];
         exports: {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }[];
@@ -668,11 +691,25 @@ declare const registryManifestDraftSchema: z.ZodObject<{
     name: string;
     registryId: string;
     version: string;
+    dependencies: {
+        type: "runtime" | "peer" | "dev" | "optional";
+        name: string;
+        versionRange: string;
+        optional?: boolean | undefined;
+    }[];
     channel: string;
     packageFiles: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }[];
+    baseFiles: {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -681,15 +718,9 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         specifier: string;
         sourcePath: string;
     }[];
-    dependencies: {
-        type: "runtime" | "peer" | "dev" | "optional";
-        name: string;
-        versionRange: string;
-        optional?: boolean | undefined;
-    }[];
     installProfiles: {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         includeTests: boolean;
         stylePath?: string | undefined;
@@ -698,13 +729,13 @@ declare const registryManifestDraftSchema: z.ZodObject<{
     contractVersionId?: string | undefined;
 }, {
     components: Record<string, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -712,8 +743,8 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         status?: string | undefined;
         category?: string | undefined;
         contract?: unknown;
-        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         provenance?: Record<string, unknown> | undefined;
+        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         examples?: unknown[] | undefined;
         styleFiles?: string[] | undefined;
         tokenDependencies?: string[] | undefined;
@@ -733,7 +764,7 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         exports?: {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }[] | undefined;
     }>;
     schemaVersion: "fragments.registry.v1";
@@ -762,11 +793,25 @@ declare const registryManifestDraftSchema: z.ZodObject<{
     version: string;
     channel: string;
     fcid?: string | undefined;
+    dependencies?: {
+        type: "runtime" | "peer" | "dev" | "optional";
+        name: string;
+        versionRange: string;
+        optional?: boolean | undefined;
+    }[] | undefined;
     contractVersionId?: string | undefined;
     packageFiles?: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }[] | undefined;
+    baseFiles?: {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -775,15 +820,9 @@ declare const registryManifestDraftSchema: z.ZodObject<{
         specifier: string;
         sourcePath: string;
     }[] | undefined;
-    dependencies?: {
-        type: "runtime" | "peer" | "dev" | "optional";
-        name: string;
-        versionRange: string;
-        optional?: boolean | undefined;
-    }[] | undefined;
     installProfiles?: {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         stylePath?: string | undefined;
         includeTests?: boolean | undefined;
@@ -863,14 +902,37 @@ declare const registryManifestSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }, {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }>, "many">>;
+    /** Files every install writes, whatever the selection: the stylesheet entry and its closure. */
+    baseFiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+        contentType: z.ZodString;
+        contentRef: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
     }, {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -902,14 +964,14 @@ declare const registryManifestSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
         }, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -954,29 +1016,29 @@ declare const registryManifestSchema: z.ZodObject<{
             kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
             path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
         }, "strip", z.ZodTypeAny, {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }, {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }>, "many">>;
         contract: z.ZodOptional<z.ZodUnknown>;
         examples: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
         provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         status: string;
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
-        tier: "composition" | "core" | "custom" | "utility";
         provenance: Record<string, unknown>;
+        tier: "composition" | "core" | "custom" | "utility";
         examples: unknown[];
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -997,20 +1059,20 @@ declare const registryManifestSchema: z.ZodObject<{
         }[];
         internalDependencies: string[];
         exports: {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }[];
         category?: string | undefined;
         contract?: unknown;
     }, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1018,8 +1080,8 @@ declare const registryManifestSchema: z.ZodObject<{
         status?: string | undefined;
         category?: string | undefined;
         contract?: unknown;
-        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         provenance?: Record<string, unknown> | undefined;
+        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         examples?: unknown[] | undefined;
         styleFiles?: string[] | undefined;
         tokenDependencies?: string[] | undefined;
@@ -1039,7 +1101,7 @@ declare const registryManifestSchema: z.ZodObject<{
         exports?: {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }[] | undefined;
     }>>;
     dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1065,14 +1127,14 @@ declare const registryManifestSchema: z.ZodObject<{
         stylePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         includeTests: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         includeTests: boolean;
         stylePath?: string | undefined;
     }, {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         stylePath?: string | undefined;
         includeTests?: boolean | undefined;
@@ -1082,16 +1144,16 @@ declare const registryManifestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     components: Record<string, {
         status: string;
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
-        tier: "composition" | "core" | "custom" | "utility";
         provenance: Record<string, unknown>;
+        tier: "composition" | "core" | "custom" | "utility";
         examples: unknown[];
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1112,7 +1174,7 @@ declare const registryManifestSchema: z.ZodObject<{
         }[];
         internalDependencies: string[];
         exports: {
-            kind: "hook" | "type" | "style" | "component" | "utility";
+            kind: "hook" | "type" | "component" | "style" | "utility";
             name: string;
             path?: string | undefined;
         }[];
@@ -1144,11 +1206,25 @@ declare const registryManifestSchema: z.ZodObject<{
     registryId: string;
     registryHash: string;
     version: string;
+    dependencies: {
+        type: "runtime" | "peer" | "dev" | "optional";
+        name: string;
+        versionRange: string;
+        optional?: boolean | undefined;
+    }[];
     channel: string;
     packageFiles: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }[];
+    baseFiles: {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -1157,15 +1233,9 @@ declare const registryManifestSchema: z.ZodObject<{
         specifier: string;
         sourcePath: string;
     }[];
-    dependencies: {
-        type: "runtime" | "peer" | "dev" | "optional";
-        name: string;
-        versionRange: string;
-        optional?: boolean | undefined;
-    }[];
     installProfiles: {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         includeTests: boolean;
         stylePath?: string | undefined;
@@ -1174,13 +1244,13 @@ declare const registryManifestSchema: z.ZodObject<{
     contractVersionId?: string | undefined;
 }, {
     components: Record<string, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1188,8 +1258,8 @@ declare const registryManifestSchema: z.ZodObject<{
         status?: string | undefined;
         category?: string | undefined;
         contract?: unknown;
-        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         provenance?: Record<string, unknown> | undefined;
+        tier?: "composition" | "core" | "custom" | "utility" | undefined;
         examples?: unknown[] | undefined;
         styleFiles?: string[] | undefined;
         tokenDependencies?: string[] | undefined;
@@ -1209,7 +1279,7 @@ declare const registryManifestSchema: z.ZodObject<{
         exports?: {
             name: string;
             path?: string | undefined;
-            kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+            kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
         }[] | undefined;
     }>;
     schemaVersion: "fragments.registry.v1";
@@ -1239,11 +1309,25 @@ declare const registryManifestSchema: z.ZodObject<{
     version: string;
     channel: string;
     fcid?: string | undefined;
+    dependencies?: {
+        type: "runtime" | "peer" | "dev" | "optional";
+        name: string;
+        versionRange: string;
+        optional?: boolean | undefined;
+    }[] | undefined;
     contractVersionId?: string | undefined;
     packageFiles?: {
         path: string;
         size: number;
-        role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+        contentType: string;
+        sha256: string;
+        contentRef: string;
+    }[] | undefined;
+    baseFiles?: {
+        path: string;
+        size: number;
+        role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
         contentType: string;
         sha256: string;
         contentRef: string;
@@ -1252,15 +1336,9 @@ declare const registryManifestSchema: z.ZodObject<{
         specifier: string;
         sourcePath: string;
     }[] | undefined;
-    dependencies?: {
-        type: "runtime" | "peer" | "dev" | "optional";
-        name: string;
-        versionRange: string;
-        optional?: boolean | undefined;
-    }[] | undefined;
     installProfiles?: {
-        importPath: string;
         name: string;
+        importPath: string;
         targetPath: string;
         stylePath?: string | undefined;
         includeTests?: boolean | undefined;
@@ -1342,14 +1420,37 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }>, "many">>;
+        /** Files every install writes, whatever the selection: the stylesheet entry and its closure. */
+        baseFiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+            role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            contentRef: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
         }, {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1381,14 +1482,14 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             }, "strip", z.ZodTypeAny, {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
             }, {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1433,29 +1534,29 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
                 kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
                 path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
             }, "strip", z.ZodTypeAny, {
-                kind: "hook" | "type" | "style" | "component" | "utility";
+                kind: "hook" | "type" | "component" | "style" | "utility";
                 name: string;
                 path?: string | undefined;
             }, {
                 name: string;
                 path?: string | undefined;
-                kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
             }>, "many">>;
             contract: z.ZodOptional<z.ZodUnknown>;
             examples: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
             provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             status: string;
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
-            tier: "composition" | "core" | "custom" | "utility";
             provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
             examples: unknown[];
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1476,20 +1577,20 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             }[];
             internalDependencies: string[];
             exports: {
-                kind: "hook" | "type" | "style" | "component" | "utility";
+                kind: "hook" | "type" | "component" | "style" | "utility";
                 name: string;
                 path?: string | undefined;
             }[];
             category?: string | undefined;
             contract?: unknown;
         }, {
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1497,8 +1598,8 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             status?: string | undefined;
             category?: string | undefined;
             contract?: unknown;
-            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             examples?: unknown[] | undefined;
             styleFiles?: string[] | undefined;
             tokenDependencies?: string[] | undefined;
@@ -1518,7 +1619,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             exports?: {
                 name: string;
                 path?: string | undefined;
-                kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
             }[] | undefined;
         }>>;
         dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1544,14 +1645,14 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             stylePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
             includeTests: z.ZodDefault<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             includeTests: boolean;
             stylePath?: string | undefined;
         }, {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             stylePath?: string | undefined;
             includeTests?: boolean | undefined;
@@ -1561,16 +1662,16 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         components: Record<string, {
             status: string;
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
-            tier: "composition" | "core" | "custom" | "utility";
             provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
             examples: unknown[];
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1591,7 +1692,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             }[];
             internalDependencies: string[];
             exports: {
-                kind: "hook" | "type" | "style" | "component" | "utility";
+                kind: "hook" | "type" | "component" | "style" | "utility";
                 name: string;
                 path?: string | undefined;
             }[];
@@ -1623,11 +1724,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         registryId: string;
         registryHash: string;
         version: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
         channel: string;
         packageFiles: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1636,15 +1751,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[];
-        dependencies: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[];
         installProfiles: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             includeTests: boolean;
             stylePath?: string | undefined;
@@ -1653,13 +1762,13 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         contractVersionId?: string | undefined;
     }, {
         components: Record<string, {
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1667,8 +1776,8 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             status?: string | undefined;
             category?: string | undefined;
             contract?: unknown;
-            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             examples?: unknown[] | undefined;
             styleFiles?: string[] | undefined;
             tokenDependencies?: string[] | undefined;
@@ -1688,7 +1797,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             exports?: {
                 name: string;
                 path?: string | undefined;
-                kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
             }[] | undefined;
         }>;
         schemaVersion: "fragments.registry.v1";
@@ -1718,11 +1827,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         version: string;
         channel: string;
         fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
         contractVersionId?: string | undefined;
         packageFiles?: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1731,15 +1854,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[] | undefined;
-        dependencies?: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[] | undefined;
         installProfiles?: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             stylePath?: string | undefined;
             includeTests?: boolean | undefined;
@@ -1769,16 +1886,16 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
     manifest: {
         components: Record<string, {
             status: string;
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
-            tier: "composition" | "core" | "custom" | "utility";
             provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
             examples: unknown[];
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1799,7 +1916,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             }[];
             internalDependencies: string[];
             exports: {
-                kind: "hook" | "type" | "style" | "component" | "utility";
+                kind: "hook" | "type" | "component" | "style" | "utility";
                 name: string;
                 path?: string | undefined;
             }[];
@@ -1831,11 +1948,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         registryId: string;
         registryHash: string;
         version: string;
-        channel: string;
-        packageFiles: {
-            path: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
+        channel: string;
+        packageFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1844,15 +1975,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[];
-        dependencies: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[];
         installProfiles: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             includeTests: boolean;
             stylePath?: string | undefined;
@@ -1871,13 +1996,13 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
     schemaVersion: "fragments.registry-artifact.v1";
     manifest: {
         components: Record<string, {
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -1885,8 +2010,8 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             status?: string | undefined;
             category?: string | undefined;
             contract?: unknown;
-            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             examples?: unknown[] | undefined;
             styleFiles?: string[] | undefined;
             tokenDependencies?: string[] | undefined;
@@ -1906,7 +2031,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             exports?: {
                 name: string;
                 path?: string | undefined;
-                kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
             }[] | undefined;
         }>;
         schemaVersion: "fragments.registry.v1";
@@ -1936,11 +2061,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         version: string;
         channel: string;
         fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
         contractVersionId?: string | undefined;
         packageFiles?: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -1949,15 +2088,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[] | undefined;
-        dependencies?: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[] | undefined;
         installProfiles?: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             stylePath?: string | undefined;
             includeTests?: boolean | undefined;
@@ -1975,16 +2108,16 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
     manifest: {
         components: Record<string, {
             status: string;
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
-            tier: "composition" | "core" | "custom" | "utility";
             provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
             examples: unknown[];
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -2005,7 +2138,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             }[];
             internalDependencies: string[];
             exports: {
-                kind: "hook" | "type" | "style" | "component" | "utility";
+                kind: "hook" | "type" | "component" | "style" | "utility";
                 name: string;
                 path?: string | undefined;
             }[];
@@ -2037,11 +2170,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         registryId: string;
         registryHash: string;
         version: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
         channel: string;
         packageFiles: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -2050,15 +2197,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[];
-        dependencies: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[];
         installProfiles: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             includeTests: boolean;
             stylePath?: string | undefined;
@@ -2077,13 +2218,13 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
     schemaVersion: "fragments.registry-artifact.v1";
     manifest: {
         components: Record<string, {
-            componentId: string;
             name: string;
+            componentId: string;
             publicRef: string;
             files: {
                 path: string;
                 size: number;
-                role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
                 contentType: string;
                 sha256: string;
                 contentRef: string;
@@ -2091,8 +2232,8 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             status?: string | undefined;
             category?: string | undefined;
             contract?: unknown;
-            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
             examples?: unknown[] | undefined;
             styleFiles?: string[] | undefined;
             tokenDependencies?: string[] | undefined;
@@ -2112,7 +2253,7 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             exports?: {
                 name: string;
                 path?: string | undefined;
-                kind?: "hook" | "type" | "style" | "component" | "utility" | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
             }[] | undefined;
         }>;
         schemaVersion: "fragments.registry.v1";
@@ -2142,11 +2283,25 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
         version: string;
         channel: string;
         fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
         contractVersionId?: string | undefined;
         packageFiles?: {
             path: string;
             size: number;
-            role: "source" | "metadata" | "token" | "style" | "contract" | "example" | "test" | "story" | "asset" | "barrel";
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
             contentType: string;
             sha256: string;
             contentRef: string;
@@ -2155,15 +2310,9 @@ declare const registryArtifactSchema: z.ZodEffects<z.ZodObject<{
             specifier: string;
             sourcePath: string;
         }[] | undefined;
-        dependencies?: {
-            type: "runtime" | "peer" | "dev" | "optional";
-            name: string;
-            versionRange: string;
-            optional?: boolean | undefined;
-        }[] | undefined;
         installProfiles?: {
-            importPath: string;
             name: string;
+            importPath: string;
             targetPath: string;
             stylePath?: string | undefined;
             includeTests?: boolean | undefined;
@@ -2199,13 +2348,13 @@ declare const registryInstallReceiptComponentSchema: z.ZodObject<{
     name: z.ZodString;
     files: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
 }, "strip", z.ZodTypeAny, {
-    componentId: string;
     name: string;
+    componentId: string;
     publicRef: string;
     files: string[];
 }, {
-    componentId: string;
     name: string;
+    componentId: string;
     publicRef: string;
     files: string[];
 }>;
@@ -2224,13 +2373,13 @@ declare const registryInstallReceiptSchema: z.ZodObject<{
         name: z.ZodString;
         files: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
     }, "strip", z.ZodTypeAny, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: string[];
     }, {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: string[];
     }>, "many">;
@@ -2272,6 +2421,12 @@ declare const registryInstallReceiptSchema: z.ZodObject<{
     importPath: string;
     registryId: string;
     registryHash: string;
+    dependencies: {
+        type: "runtime" | "peer" | "dev" | "optional";
+        name: string;
+        versionRange: string;
+        optional?: boolean | undefined;
+    }[];
     files: {
         path: string;
         sourcePath: string;
@@ -2279,16 +2434,10 @@ declare const registryInstallReceiptSchema: z.ZodObject<{
         componentId?: string | undefined;
     }[];
     targetPath: string;
-    dependencies: {
-        type: "runtime" | "peer" | "dev" | "optional";
-        name: string;
-        versionRange: string;
-        optional?: boolean | undefined;
-    }[];
     registryVersion: string;
     installedComponents: {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: string[];
     }[];
@@ -2309,20 +2458,20 @@ declare const registryInstallReceiptSchema: z.ZodObject<{
     targetPath: string;
     registryVersion: string;
     installedComponents: {
-        componentId: string;
         name: string;
+        componentId: string;
         publicRef: string;
         files: string[];
     }[];
     installedAt: string;
     fcid?: string | undefined;
-    channel?: string | undefined;
     dependencies?: {
         type: "runtime" | "peer" | "dev" | "optional";
         name: string;
         versionRange: string;
         optional?: boolean | undefined;
     }[] | undefined;
+    channel?: string | undefined;
 }>;
 type RegistryDependencyType = z.infer<typeof registryDependencyTypeSchema>;
 type RegistryDependency = z.infer<typeof registryDependencySchema>;
@@ -2363,5 +2512,1065 @@ declare function buildRegistryArtifact(input: RegistryArtifactInput): RegistryAr
 declare function assertValidRegistryArtifact(artifact: unknown): RegistryArtifact;
 declare function registryArtifactDigest(artifact: RegistryArtifact): string;
 declare function registryManifestCanonicalPreimage(manifest: RegistryManifestDraft | RegistryManifest): string;
+declare const REGISTRY_INDEX_SCHEMA_VERSION = "fragments.registry-index.v2";
+declare const REGISTRY_SHARD_SCHEMA_VERSION = "fragments.registry-shard.v2";
+declare const registryShardSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"fragments.registry-shard.v2">;
+    files: z.ZodRecord<z.ZodString, z.ZodObject<{
+        path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        content: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+        contentType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "fragments.registry-shard.v2";
+    files: Record<string, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }>;
+}, {
+    schemaVersion: "fragments.registry-shard.v2";
+    files: Record<string, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }>;
+}>, {
+    schemaVersion: "fragments.registry-shard.v2";
+    files: Record<string, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }>;
+}, {
+    schemaVersion: "fragments.registry-shard.v2";
+    files: Record<string, {
+        path: string;
+        size: number;
+        content: string;
+        contentType: string;
+        sha256: string;
+    }>;
+}>;
+declare const registryIndexSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"fragments.registry-index.v2">;
+    manifest: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"fragments.registry.v1">;
+        registryId: z.ZodString;
+        name: z.ZodString;
+        channel: z.ZodString;
+        version: z.ZodString;
+        contractVersionId: z.ZodOptional<z.ZodString>;
+        fcid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodString;
+        source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"package">;
+            packageName: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            rootPath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            commitSha: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        }, {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"github">;
+            repoFullName: z.ZodString;
+            commitSha: z.ZodString;
+            path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        }, {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"local">;
+            rootPath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            commitSha: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        }, {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"manual">;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "manual";
+            label: string;
+        }, {
+            kind: "manual";
+            label: string;
+        }>]>;
+        packageFiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+            role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            contentRef: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }>, "many">>;
+        /** Files every install writes, whatever the selection: the stylesheet entry and its closure. */
+        baseFiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+            role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+            sha256: z.ZodString;
+            size: z.ZodNumber;
+            contentType: z.ZodString;
+            contentRef: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }, {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }>, "many">>;
+        entrypoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            specifier: z.ZodString;
+            sourcePath: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        }, "strip", z.ZodTypeAny, {
+            specifier: string;
+            sourcePath: string;
+        }, {
+            specifier: string;
+            sourcePath: string;
+        }>, "many">>;
+        components: z.ZodRecord<z.ZodString, z.ZodObject<{
+            componentId: z.ZodString;
+            publicRef: z.ZodString;
+            name: z.ZodString;
+            status: z.ZodDefault<z.ZodString>;
+            tier: z.ZodDefault<z.ZodEnum<["core", "composition", "utility", "custom"]>>;
+            category: z.ZodOptional<z.ZodString>;
+            files: z.ZodArray<z.ZodObject<{
+                path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+                role: z.ZodEnum<["source", "style", "token", "contract", "test", "story", "example", "asset", "barrel", "metadata"]>;
+                sha256: z.ZodString;
+                size: z.ZodNumber;
+                contentType: z.ZodString;
+                contentRef: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }, {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }>, "many">;
+            styleFiles: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">>;
+            tokenDependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            runtimeDependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                versionRange: z.ZodString;
+                type: z.ZodEnum<["runtime", "peer", "dev", "optional"]>;
+                optional: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }, {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }>, "many">>;
+            peerDependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                versionRange: z.ZodString;
+                type: z.ZodEnum<["runtime", "peer", "dev", "optional"]>;
+                optional: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }, {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }>, "many">>;
+            internalDependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            exports: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                kind: z.ZodDefault<z.ZodEnum<["component", "hook", "utility", "type", "style"]>>;
+                path: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "hook" | "type" | "component" | "style" | "utility";
+                name: string;
+                path?: string | undefined;
+            }, {
+                name: string;
+                path?: string | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
+            }>, "many">>;
+            contract: z.ZodOptional<z.ZodUnknown>;
+            examples: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+            provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            name: string;
+            componentId: string;
+            publicRef: string;
+            provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
+            examples: unknown[];
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            styleFiles: string[];
+            tokenDependencies: string[];
+            runtimeDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            peerDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            internalDependencies: string[];
+            exports: {
+                kind: "hook" | "type" | "component" | "style" | "utility";
+                name: string;
+                path?: string | undefined;
+            }[];
+            category?: string | undefined;
+            contract?: unknown;
+        }, {
+            name: string;
+            componentId: string;
+            publicRef: string;
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            status?: string | undefined;
+            category?: string | undefined;
+            contract?: unknown;
+            provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
+            examples?: unknown[] | undefined;
+            styleFiles?: string[] | undefined;
+            tokenDependencies?: string[] | undefined;
+            runtimeDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            peerDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            internalDependencies?: string[] | undefined;
+            exports?: {
+                name: string;
+                path?: string | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
+            }[] | undefined;
+        }>>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            versionRange: z.ZodString;
+            type: z.ZodEnum<["runtime", "peer", "dev", "optional"]>;
+            optional: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }, {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }>, "many">>;
+        installProfiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            targetPath: z.ZodEffects<z.ZodString, string, string>;
+            importPath: z.ZodString;
+            stylePath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            includeTests: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            includeTests: boolean;
+            stylePath?: string | undefined;
+        }, {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            stylePath?: string | undefined;
+            includeTests?: boolean | undefined;
+        }>, "many">>;
+    } & {
+        registryHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        components: Record<string, {
+            status: string;
+            name: string;
+            componentId: string;
+            publicRef: string;
+            provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
+            examples: unknown[];
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            styleFiles: string[];
+            tokenDependencies: string[];
+            runtimeDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            peerDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            internalDependencies: string[];
+            exports: {
+                kind: "hook" | "type" | "component" | "style" | "utility";
+                name: string;
+                path?: string | undefined;
+            }[];
+            category?: string | undefined;
+            contract?: unknown;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
+        channel: string;
+        packageFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        entrypoints: {
+            specifier: string;
+            sourcePath: string;
+        }[];
+        installProfiles: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            includeTests: boolean;
+            stylePath?: string | undefined;
+        }[];
+        fcid?: string | undefined;
+        contractVersionId?: string | undefined;
+    }, {
+        components: Record<string, {
+            name: string;
+            componentId: string;
+            publicRef: string;
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            status?: string | undefined;
+            category?: string | undefined;
+            contract?: unknown;
+            provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
+            examples?: unknown[] | undefined;
+            styleFiles?: string[] | undefined;
+            tokenDependencies?: string[] | undefined;
+            runtimeDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            peerDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            internalDependencies?: string[] | undefined;
+            exports?: {
+                name: string;
+                path?: string | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
+            }[] | undefined;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        channel: string;
+        fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
+        contractVersionId?: string | undefined;
+        packageFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        entrypoints?: {
+            specifier: string;
+            sourcePath: string;
+        }[] | undefined;
+        installProfiles?: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            stylePath?: string | undefined;
+            includeTests?: boolean | undefined;
+        }[] | undefined;
+    }>;
+    /** Shard path (relative to the index) → registry file paths whose bodies it carries. */
+    shards: z.ZodRecord<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "fragments.registry-index.v2";
+    manifest: {
+        components: Record<string, {
+            status: string;
+            name: string;
+            componentId: string;
+            publicRef: string;
+            provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
+            examples: unknown[];
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            styleFiles: string[];
+            tokenDependencies: string[];
+            runtimeDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            peerDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            internalDependencies: string[];
+            exports: {
+                kind: "hook" | "type" | "component" | "style" | "utility";
+                name: string;
+                path?: string | undefined;
+            }[];
+            category?: string | undefined;
+            contract?: unknown;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
+        channel: string;
+        packageFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        entrypoints: {
+            specifier: string;
+            sourcePath: string;
+        }[];
+        installProfiles: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            includeTests: boolean;
+            stylePath?: string | undefined;
+        }[];
+        fcid?: string | undefined;
+        contractVersionId?: string | undefined;
+    };
+    shards: Record<string, string[]>;
+}, {
+    schemaVersion: "fragments.registry-index.v2";
+    manifest: {
+        components: Record<string, {
+            name: string;
+            componentId: string;
+            publicRef: string;
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            status?: string | undefined;
+            category?: string | undefined;
+            contract?: unknown;
+            provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
+            examples?: unknown[] | undefined;
+            styleFiles?: string[] | undefined;
+            tokenDependencies?: string[] | undefined;
+            runtimeDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            peerDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            internalDependencies?: string[] | undefined;
+            exports?: {
+                name: string;
+                path?: string | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
+            }[] | undefined;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        channel: string;
+        fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
+        contractVersionId?: string | undefined;
+        packageFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        entrypoints?: {
+            specifier: string;
+            sourcePath: string;
+        }[] | undefined;
+        installProfiles?: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            stylePath?: string | undefined;
+            includeTests?: boolean | undefined;
+        }[] | undefined;
+    };
+    shards: Record<string, string[]>;
+}>, {
+    schemaVersion: "fragments.registry-index.v2";
+    manifest: {
+        components: Record<string, {
+            status: string;
+            name: string;
+            componentId: string;
+            publicRef: string;
+            provenance: Record<string, unknown>;
+            tier: "composition" | "core" | "custom" | "utility";
+            examples: unknown[];
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            styleFiles: string[];
+            tokenDependencies: string[];
+            runtimeDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            peerDependencies: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[];
+            internalDependencies: string[];
+            exports: {
+                kind: "hook" | "type" | "component" | "style" | "utility";
+                name: string;
+                path?: string | undefined;
+            }[];
+            category?: string | undefined;
+            contract?: unknown;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        dependencies: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[];
+        channel: string;
+        packageFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        baseFiles: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[];
+        entrypoints: {
+            specifier: string;
+            sourcePath: string;
+        }[];
+        installProfiles: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            includeTests: boolean;
+            stylePath?: string | undefined;
+        }[];
+        fcid?: string | undefined;
+        contractVersionId?: string | undefined;
+    };
+    shards: Record<string, string[]>;
+}, {
+    schemaVersion: "fragments.registry-index.v2";
+    manifest: {
+        components: Record<string, {
+            name: string;
+            componentId: string;
+            publicRef: string;
+            files: {
+                path: string;
+                size: number;
+                role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+                contentType: string;
+                sha256: string;
+                contentRef: string;
+            }[];
+            status?: string | undefined;
+            category?: string | undefined;
+            contract?: unknown;
+            provenance?: Record<string, unknown> | undefined;
+            tier?: "composition" | "core" | "custom" | "utility" | undefined;
+            examples?: unknown[] | undefined;
+            styleFiles?: string[] | undefined;
+            tokenDependencies?: string[] | undefined;
+            runtimeDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            peerDependencies?: {
+                type: "runtime" | "peer" | "dev" | "optional";
+                name: string;
+                versionRange: string;
+                optional?: boolean | undefined;
+            }[] | undefined;
+            internalDependencies?: string[] | undefined;
+            exports?: {
+                name: string;
+                path?: string | undefined;
+                kind?: "hook" | "type" | "component" | "style" | "utility" | undefined;
+            }[] | undefined;
+        }>;
+        schemaVersion: "fragments.registry.v1";
+        generatedAt: string;
+        source: {
+            kind: "package";
+            packageName: string;
+            version?: string | undefined;
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "github";
+            repoFullName: string;
+            commitSha: string;
+            path?: string | undefined;
+        } | {
+            kind: "local";
+            rootPath?: string | undefined;
+            commitSha?: string | undefined;
+        } | {
+            kind: "manual";
+            label: string;
+        };
+        name: string;
+        registryId: string;
+        registryHash: string;
+        version: string;
+        channel: string;
+        fcid?: string | undefined;
+        dependencies?: {
+            type: "runtime" | "peer" | "dev" | "optional";
+            name: string;
+            versionRange: string;
+            optional?: boolean | undefined;
+        }[] | undefined;
+        contractVersionId?: string | undefined;
+        packageFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        baseFiles?: {
+            path: string;
+            size: number;
+            role: "source" | "metadata" | "contract" | "token" | "style" | "example" | "test" | "story" | "asset" | "barrel";
+            contentType: string;
+            sha256: string;
+            contentRef: string;
+        }[] | undefined;
+        entrypoints?: {
+            specifier: string;
+            sourcePath: string;
+        }[] | undefined;
+        installProfiles?: {
+            name: string;
+            importPath: string;
+            targetPath: string;
+            stylePath?: string | undefined;
+            includeTests?: boolean | undefined;
+        }[] | undefined;
+    };
+    shards: Record<string, string[]>;
+}>;
+/**
+ * A short-lived pointer (`latest.json`) to an immutable versioned index. One hop only;
+ * `index` is a relative path so the hop cannot leave the pointer's origin.
+ */
+declare const REGISTRY_POINTER_SCHEMA_VERSION = "fragments.registry-pointer.v1";
+declare const registryPointerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"fragments.registry-pointer.v1">;
+    registryId: z.ZodString;
+    version: z.ZodString;
+    registryHash: z.ZodString;
+    index: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "fragments.registry-pointer.v1";
+    generatedAt: string;
+    index: string;
+    registryId: string;
+    registryHash: string;
+    version: string;
+}, {
+    schemaVersion: "fragments.registry-pointer.v1";
+    generatedAt: string;
+    index: string;
+    registryId: string;
+    registryHash: string;
+    version: string;
+}>;
+type RegistryShard = z.infer<typeof registryShardSchema>;
+type RegistryIndex = z.infer<typeof registryIndexSchema>;
+type RegistryPointer = z.infer<typeof registryPointerSchema>;
+declare function buildRegistryPointer(index: RegistryIndex, indexPath: string): RegistryPointer;
+/** Every file path the manifest references, sorted and unique. */
+declare function registryManifestFilePaths(manifest: RegistryManifest): string[];
+/** Path → metadata for every manifest file; entrypoint-only paths map to `null`. */
+declare function registryManifestFileMetadata(manifest: RegistryManifest): Map<string, RegistryFile | null>;
+/**
+ * Default shard layout: one shard per component directory, one shard per shared
+ * top-level directory under `src/` (`shared/tokens.json`, `shared/utils.json`, …),
+ * `shared/src.json` for files directly under `src/`, and `shared/package.json` for
+ * package-root files (`package.json`, `fragments.json`) that only complete installs need.
+ */
+declare function defaultRegistryShardPath(path: string): string;
+interface ShardedRegistryArtifact {
+    index: RegistryIndex;
+    shards: Map<string, RegistryShard>;
+}
+declare function shardRegistryArtifact(artifact: RegistryArtifact, shardPathFor?: (path: string) => string): ShardedRegistryArtifact;
+/** The shards (sorted, unique) that carry the given registry file paths. */
+declare function registryShardsForPaths(index: RegistryIndex, paths: readonly string[]): string[];
+/**
+ * Rebuild a v1-shaped artifact from an index plus the shards that cover `paths`.
+ * Only the requested paths are materialised; every body is checked against the
+ * manifest's hash and size before it is accepted.
+ */
+declare function assembleRegistryArtifact(args: {
+    index: RegistryIndex;
+    shards: ReadonlyMap<string, RegistryShard>;
+    paths: readonly string[];
+}): RegistryArtifact;
 
-export { REGISTRY_ARTIFACT_SCHEMA_VERSION, REGISTRY_INSTALL_RECEIPT_SCHEMA_VERSION, REGISTRY_MANIFEST_SCHEMA_VERSION, type RegistryArtifact, type RegistryArtifactInput, type RegistryComponent, type RegistryComponentExport, type RegistryDependency, type RegistryDependencyType, type RegistryEntrypoint, type RegistryFile, type RegistryFileContent, type RegistryFileInput, type RegistryFileRole, type RegistryInstallProfile, type RegistryInstallReceipt, type RegistryInstallReceiptComponent, type RegistryInstallReceiptFile, type RegistryManifest, type RegistryManifestDraft, type 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 };
+export { REGISTRY_ARTIFACT_SCHEMA_VERSION, REGISTRY_INDEX_SCHEMA_VERSION, REGISTRY_INSTALL_RECEIPT_SCHEMA_VERSION, REGISTRY_MANIFEST_SCHEMA_VERSION, REGISTRY_POINTER_SCHEMA_VERSION, REGISTRY_SHARD_SCHEMA_VERSION, type RegistryArtifact, type RegistryArtifactInput, type RegistryComponent, type RegistryComponentExport, type RegistryDependency, type RegistryDependencyType, type RegistryEntrypoint, type RegistryFile, type RegistryFileContent, type RegistryFileInput, type RegistryFileRole, type RegistryIndex, type RegistryInstallProfile, type RegistryInstallReceipt, type RegistryInstallReceiptComponent, type RegistryInstallReceiptFile, type RegistryManifest, type RegistryManifestDraft, type RegistryPointer, type RegistryShard, type RegistrySource, type ShardedRegistryArtifact, assembleRegistryArtifact, assertValidRegistryArtifact, buildRegistryArtifact, buildRegistryFile, buildRegistryPointer, computeRegistryHash, defaultRegistryShardPath, finalizeRegistryManifest, hashRegistryFileContent, registryArtifactDigest, registryArtifactSchema, registryComponentExportSchema, registryComponentSchema, registryDependencySchema, registryDependencyTypeSchema, registryEntrypointSchema, registryFileContentSchema, registryFileRoleSchema, registryFileSchema, registryFileSize, registryIndexSchema, registryInstallProfileSchema, registryInstallReceiptComponentSchema, registryInstallReceiptFileSchema, registryInstallReceiptSchema, registryManifestCanonicalPreimage, registryManifestDraftSchema, registryManifestFileMetadata, registryManifestFilePaths, registryManifestSchema, registryPointerSchema, registryShardSchema, registryShardsForPaths, registrySourceSchema, shardRegistryArtifact };