@modularcore/registry 0.2.0 → 0.5.1

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG7F,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAgBhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/schema.d.ts

@@ -1,3 +1,5 @@
+import type { FrameworkDefinition } from './framework-catalog.js';
+import type { UiCoverage } from './ui-coverage.js';
 /**
  * Descriptor types for a ModularCore registry component (`modularcore.json`).
  * Runtime validation lives in `schema.zod.ts`; keep both in sync.
@@ -5,6 +7,15 @@
 /** Extensible component kind. New kinds (e.g. `agent-tool`) can be added without breaking existing descriptors. */
 export type ComponentType = 'frontend-component' | 'headless-core' | 'snippet' | (string & {});
 export type SupportedFramework = 'react' | 'svelte' | (string & {});
+export interface PreviewImage {
+    /**
+     * En el descriptor, la ruta dentro del paquete (`preview/media-picker.png`). En lo que sirve el
+     * registry, la URL ya servible: `buildRegistry` copia el fichero y reescribe este campo.
+     */
+    image: string;
+    /** Texto alternativo. Obligatorio: la captura es contenido, no decoración. */
+    alt: string;
+}
 /** `internal` components are built and locally resolvable but excluded from the public `index.json`. */
 export type Visibility = 'public' | 'internal';
 export type FileEncoding = 'utf8' | 'base64';
@@ -29,6 +40,26 @@ export interface RegistryDescriptor {
     type: ComponentType;
     category: string;
     frameworks: SupportedFramework[];
+    /**
+     * Cobertura de la UI de referencia por framework. `frameworks` dice dónde se puede instalar
+     * —núcleo y adaptador—; esto dice dónde hay además componentes de interfaz, y qué falta por
+     * adaptar. Ver `ui-coverage.ts`.
+     */
+    ui?: Record<string, UiCoverage>;
+    /**
+     * Frameworks que este componente aporta al catálogo, para los que el registry no trae
+     * definición de casa. Permite traer un componente en Solid o Qwik sin tocar código nuestro.
+     */
+    frameworkDefs?: Record<string, FrameworkDefinition>;
+    /**
+     * Una captura del componente en funcionamiento, para el catálogo y para quien revise la
+     * aportación: nadie puede ejecutar un componente de un framework que no tiene instalado, pero
+     * sí ver qué hace.
+     *
+     * No va en `files[]` a propósito: aquello es lo que la CLI copia al proyecto de quien instala,
+     * y una captura no pinta nada en su `src/`.
+     */
+    preview?: PreviewImage;
     visibility: Visibility;
     /** Semver ranges keyed by peer framework, e.g. `{ "react": ">=18" }`. Gates `add` (Phase 3) before writing runes/hooks. */
     peerDependencies: Record<string, string>;
@@ -53,6 +84,10 @@ export interface RegistryIndexEntry {
     category: string;
     version: string;
     frameworks: SupportedFramework[];
+    /** Cobertura de la UI de referencia, para que el catálogo distinga «instalable» de «con UI». */
+    ui?: Record<string, UiCoverage>;
+    /** Captura del componente, con la URL ya servible que produce `buildRegistry`. */
+    preview?: PreviewImage;
     description?: string;
 }
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mHAAmH;AACnH,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,eAAe,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpE,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,2HAA2H;IAC3H,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACtE,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AAEH,mHAAmH;AACnH,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,eAAe,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,2HAA2H;IAC3H,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACtE,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,kFAAkF;IAClF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/schema.js

@@ -1,6 +1,2 @@
-/**
- * Descriptor types for a ModularCore registry component (`modularcore.json`).
- * Runtime validation lives in `schema.zod.ts`; keep both in sync.
- */
 export {};
 //# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}

package/dist/schema.zod.d.ts

@@ -37,6 +37,34 @@ export declare const registryDescriptorSchema: z.ZodObject<{
     }>, z.ZodString]>;
     category: z.ZodString;
     frameworks: z.ZodArray<z.ZodString>;
+    preview: z.ZodOptional<z.ZodObject<{
+        image: z.ZodString;
+        alt: z.ZodString;
+    }, z.core.$strip>>;
+    frameworkDefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        title: z.ZodString;
+        uiExtension: z.ZodOptional<z.ZodString>;
+        detect: z.ZodOptional<z.ZodObject<{
+            npm: z.ZodOptional<z.ZodString>;
+            composer: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        peer: z.ZodOptional<z.ZodString>;
+        paths: z.ZodOptional<z.ZodObject<{
+            components: z.ZodString;
+            lib: z.ZodString;
+        }, z.core.$strip>>;
+        basedOn: z.ZodOptional<z.ZodString>;
+        snippetDirectory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        presentations: z.ZodArray<z.ZodEnum<{
+            vanilla: "vanilla";
+            headless: "headless";
+            tailwind: "tailwind";
+            shadcn: "shadcn";
+        }>>;
+        missing: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     visibility: z.ZodDefault<z.ZodEnum<{
         public: "public";
         internal: "internal";
@@ -73,21 +101,45 @@ export declare const registryFileWithContentSchema: z.ZodObject<{
     content: z.ZodString;
 }, z.core.$strip>;
 export declare const registryEntrySchema: z.ZodObject<{
+    name: z.ZodString;
     type: z.ZodUnion<readonly [z.ZodEnum<{
         "frontend-component": "frontend-component";
         "headless-core": "headless-core";
         snippet: "snippet";
     }>, z.ZodString]>;
     description: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
     visibility: z.ZodDefault<z.ZodEnum<{
         public: "public";
         internal: "internal";
     }>>;
-    name: z.ZodString;
     version: z.ZodString;
-    title: z.ZodString;
     category: z.ZodString;
     frameworks: z.ZodArray<z.ZodString>;
+    frameworkDefs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        title: z.ZodString;
+        uiExtension: z.ZodOptional<z.ZodString>;
+        detect: z.ZodOptional<z.ZodObject<{
+            npm: z.ZodOptional<z.ZodString>;
+            composer: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        peer: z.ZodOptional<z.ZodString>;
+        paths: z.ZodOptional<z.ZodObject<{
+            components: z.ZodString;
+            lib: z.ZodString;
+        }, z.core.$strip>>;
+        basedOn: z.ZodOptional<z.ZodString>;
+        snippetDirectory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        presentations: z.ZodArray<z.ZodEnum<{
+            vanilla: "vanilla";
+            headless: "headless";
+            tailwind: "tailwind";
+            shadcn: "shadcn";
+        }>>;
+        missing: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     peerDependencies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
     registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -106,6 +158,10 @@ export declare const registryEntrySchema: z.ZodObject<{
         }>;
         content: z.ZodString;
     }, z.core.$strip>>;
+    preview: z.ZodOptional<z.ZodObject<{
+        image: z.ZodString;
+        alt: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const registryIndexEntrySchema: z.ZodObject<{
     name: z.ZodString;
@@ -113,6 +169,35 @@ export declare const registryIndexEntrySchema: z.ZodObject<{
     category: z.ZodString;
     version: z.ZodString;
     frameworks: z.ZodArray<z.ZodString>;
+    preview: z.ZodOptional<z.ZodObject<{
+        image: z.ZodString;
+        alt: z.ZodString;
+    }, z.core.$strip>>;
+    ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        presentations: z.ZodArray<z.ZodEnum<{
+            vanilla: "vanilla";
+            headless: "headless";
+            tailwind: "tailwind";
+            shadcn: "shadcn";
+        }>>;
+        missing: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** Catálogo de frameworks servido en `frameworks.json`, con las mismas reglas que el descriptor. */
+export declare const frameworkCatalogSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    title: z.ZodString;
+    uiExtension: z.ZodOptional<z.ZodString>;
+    detect: z.ZodOptional<z.ZodObject<{
+        npm: z.ZodOptional<z.ZodString>;
+        composer: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    peer: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodObject<{
+        components: z.ZodString;
+        lib: z.ZodString;
+    }, z.core.$strip>>;
+    basedOn: z.ZodOptional<z.ZodString>;
+    snippetDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
 //# sourceMappingURL=schema.zod.d.ts.map

package/dist/schema.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.zod.d.ts","sourceRoot":"","sources":["../src/schema.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;EAA6B,CAAC;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;GAAmD,CAAC;AAEjF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,6BAA6B;;;;;;;;;iBAExC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEmC,CAAC;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;iBAOnC,CAAC"}
+{"version":3,"file":"schema.zod.d.ts","sourceRoot":"","sources":["../src/schema.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;EAA6B,CAAC;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;GAAmD,CAAC;AAgCjF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,6BAA6B;;;;;;;;;iBAExC,CAAC;AAkBH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK5B,CAAC;AAEL,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAiBnC,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;kBAAyD,CAAC"}

package/dist/schema.zod.js

@@ -35,6 +35,35 @@ export const componentTypeSchema = z.union([
     z.string().min(1),
 ]);
 export const visibilitySchema = z.enum(['public', 'internal']).default('public');
+/**
+ * Las reglas de una definición de framework, compartidas por el descriptor y por el catálogo que
+ * el registry sirve. Tenerlas por duplicado dejaba el segundo mucho más laxo: aceptaba rutas
+ * vacías, y `init` acababa escribiendo `paths.components: ""`, con lo que todo `add` posterior
+ * remapeaba los ficheros a la raíz del proyecto.
+ */
+const frameworkDefinitionSchema = z.object({
+    title: z.string().min(1),
+    // Una extensión de verdad: uno o más tramos `.algo`, admitiendo dígitos y guiones
+    // (`.component.ts`, `.vue`). El patrón anterior aceptaba `..` y rechazaba `.mjs2`.
+    uiExtension: z
+        .string()
+        .regex(/^(?:\.[a-z0-9-]+)+$/i, {
+        message: 'uiExtension debe ser como ".tsx" o ".component.ts"',
+    })
+        .optional(),
+    // Con al menos una forma de reconocerlo: un `detect` vacío, o con cadenas vacías, no
+    // detecta nada y deja al framework inservible para `init`.
+    detect: z
+        .object({ npm: z.string().min(1).optional(), composer: z.string().min(1).optional() })
+        .refine((value) => value.npm !== undefined || value.composer !== undefined, {
+        message: 'detect debe declarar npm o composer',
+    })
+        .optional(),
+    peer: z.string().min(1).optional(),
+    paths: z.object({ components: z.string().min(1), lib: z.string().min(1) }).optional(),
+    basedOn: z.string().min(1).optional(),
+    snippetDirectory: z.string().min(1).optional(),
+});
 export const registryDescriptorSchema = z.object({
     name: z
         .string()
@@ -45,6 +74,19 @@ export const registryDescriptorSchema = z.object({
     type: componentTypeSchema,
     category: z.string().min(1),
     frameworks: z.array(z.string().min(1)).min(1),
+    preview: z
+        .object({
+        image: safeRelativePathSchema,
+        alt: z.string().min(1),
+    })
+        .optional(),
+    frameworkDefs: z.record(z.string().min(1), frameworkDefinitionSchema).optional(),
+    ui: z
+        .record(z.string().min(1), z.object({
+        presentations: z.array(z.enum(['headless', 'tailwind', 'shadcn', 'vanilla'])),
+        missing: z.array(z.string().min(1)).optional(),
+    }))
+        .optional(),
     visibility: visibilitySchema,
     peerDependencies: z.record(z.string(), z.string()).default({}),
     dependencies: z.array(z.string()).default([]),
@@ -56,15 +98,42 @@ export const registryDescriptorSchema = z.object({
 export const registryFileWithContentSchema = registryFileSchema.extend({
     content: z.string(),
 });
+/**
+ * `preview.image` tiene dos formas según dónde se lea, y por eso hay dos esquemas.
+ *
+ * En el descriptor es una ruta dentro del paquete (`preview/rating.png`), validada como cualquier
+ * otra ruta. En lo que sirve el registry es ya la URL servible, porque `buildRegistry` copia el
+ * fichero y reescribe el campo. Validar la segunda con las reglas de la primera rechazaba la
+ * salida del propio build: en cuanto un componente declarase una captura, el cliente del registry
+ * habría dejado de poder leer el índice entero.
+ */
+const servedPreviewSchema = z.object({
+    image: z.string().regex(/^\/registry\/[a-z0-9-]+\.(?:png|jpg|jpeg|webp)$/i, {
+        message: 'Served preview must be a /registry/{name}-preview.{ext} URL',
+    }),
+    alt: z.string().min(1),
+});
 export const registryEntrySchema = registryDescriptorSchema
-    .omit({ files: true })
-    .extend({ files: z.array(registryFileWithContentSchema).min(1) });
+    .omit({ files: true, preview: true })
+    .extend({
+    files: z.array(registryFileWithContentSchema).min(1),
+    preview: servedPreviewSchema.optional(),
+});
 export const registryIndexEntrySchema = z.object({
     name: z.string(),
     title: z.string(),
     category: z.string(),
     version: z.string(),
     frameworks: z.array(z.string()),
+    preview: servedPreviewSchema.optional(),
+    ui: z
+        .record(z.string().min(1), z.object({
+        presentations: z.array(z.enum(['headless', 'tailwind', 'shadcn', 'vanilla'])),
+        missing: z.array(z.string().min(1)).optional(),
+    }))
+        .optional(),
     description: z.string().optional(),
 });
+/** Catálogo de frameworks servido en `frameworks.json`, con las mismas reglas que el descriptor. */
+export const frameworkCatalogSchema = z.record(z.string().min(1), frameworkDefinitionSchema);
 //# sourceMappingURL=schema.zod.js.map

package/dist/schema.zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.zod.js","sourceRoot":"","sources":["../src/schema.zod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.zod.js","sourceRoot":"","sources":["../src/schema.zod.ts"],"names":[],"mappings":"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"}

package/dist/ui-coverage.d.ts

@@ -0,0 +1,59 @@
+import type { FrameworkDefinition } from './framework-catalog.js';
+/**
+ * Cobertura de la UI de referencia por framework.
+ *
+ * Un componente puede instalarse en cualquier framework que declare en `frameworks` —eso sólo
+ * exige núcleo y adaptador—, pero la UI de referencia es otra cosa: se escribe una vez por
+ * framework y por presentación, y es justo donde el trabajo se queda a medias sin que nada lo
+ * note. Así se declaró `vue` durante meses sin un solo componente de interfaz.
+ *
+ * `ui` en el descriptor declara esa cobertura, y las brechas conocidas van escritas con nombre y
+ * apellido. La comprobación no exige paridad completa —un colaborador entrega los frameworks que
+ * puede y el mantenimiento completa el resto— sino que lo declarado sea exactamente lo que hay:
+ * una brecha nueva que nadie declare hace fallar la comprobación.
+ */
+/** Las cuatro presentaciones en las que se escribe cada componente de UI. */
+export declare const PRESENTATIONS: readonly ["headless", "tailwind", "shadcn", "vanilla"];
+export type Presentation = (typeof PRESENTATIONS)[number];
+export interface UiCoverage {
+    /** Presentaciones que este framework cubre. Vacío: el framework no trae UI de referencia. */
+    presentations: Presentation[];
+    /**
+     * Componentes que otros frameworks sí tienen y este todavía no, por nombre. Es deuda del
+     * mantenimiento, no un rechazo al colaborador que aportó el resto.
+     */
+    missing?: string[];
+}
+export interface DescribedFile {
+    path: string;
+}
+export interface ComponentLocation {
+    framework: string;
+    presentation: Presentation;
+    component: string;
+}
+/**
+ * Sitúa un fichero de UI en el eje framework × presentación × componente, o devuelve `null` si no
+ * es UI de referencia (el núcleo, una hoja de estilos suelta, un snippet).
+ *
+ * `ui/<framework>/<Componente>` es la presentación headless; `ui/<framework>/<presentación>/…` es
+ * cada una de las otras tres.
+ */
+export declare function locateUiFile(path: string, catalog?: Record<string, FrameworkDefinition>): ComponentLocation | null;
+export type ActualCoverage = Map<string, Map<Presentation, Set<string>>>;
+/** Cobertura real que se desprende de los ficheros que el descriptor enumera. */
+export declare function readActualCoverage(files: DescribedFile[], catalog?: Record<string, FrameworkDefinition>): ActualCoverage;
+export interface CoverageMismatch {
+    framework: string;
+    problem: string;
+}
+/**
+ * Compara lo declarado en `ui` con lo que hay, y describe cada discrepancia en una línea legible.
+ *
+ * Un componente presente sólo en la presentación headless de *todos* los frameworks —los de
+ * apoyo, como `ModernSelect`— no cuenta como brecha: la comparación se hace presentación a
+ * presentación, así que sólo salta cuando un framework se queda atrás respecto de otro en la
+ * misma presentación.
+ */
+export declare function findCoverageMismatches(declared: Record<string, UiCoverage>, files: DescribedFile[], frameworks: string[], catalog?: Record<string, FrameworkDefinition>): CoverageMismatch[];
+//# sourceMappingURL=ui-coverage.d.ts.map

package/dist/ui-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-coverage.d.ts","sourceRoot":"","sources":["../src/ui-coverage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,aAAa,wDAAyD,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,6FAA6F;IAC7F,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAWD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAsB,GAChE,iBAAiB,GAAG,IAAI,CAoB1B;AAED,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEzE,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAsB,GAChE,cAAc,CAehB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAsB,GAChE,gBAAgB,EAAE,CAuEpB"}

package/dist/ui-coverage.js

@@ -0,0 +1,143 @@
+import { BUILTIN_FRAMEWORKS } from './framework-catalog.js';
+/**
+ * Cobertura de la UI de referencia por framework.
+ *
+ * Un componente puede instalarse en cualquier framework que declare en `frameworks` —eso sólo
+ * exige núcleo y adaptador—, pero la UI de referencia es otra cosa: se escribe una vez por
+ * framework y por presentación, y es justo donde el trabajo se queda a medias sin que nada lo
+ * note. Así se declaró `vue` durante meses sin un solo componente de interfaz.
+ *
+ * `ui` en el descriptor declara esa cobertura, y las brechas conocidas van escritas con nombre y
+ * apellido. La comprobación no exige paridad completa —un colaborador entrega los frameworks que
+ * puede y el mantenimiento completa el resto— sino que lo declarado sea exactamente lo que hay:
+ * una brecha nueva que nadie declare hace fallar la comprobación.
+ */
+/** Las cuatro presentaciones en las que se escribe cada componente de UI. */
+export const PRESENTATIONS = ['headless', 'tailwind', 'shadcn', 'vanilla'];
+/** Extensiones de la UI de referencia, tomadas del catálogo: un framework aportado trae la suya. */
+function uiExtensionsOf(catalog) {
+    const extensions = {};
+    for (const [name, definition] of Object.entries(catalog)) {
+        if (definition.uiExtension)
+            extensions[name] = definition.uiExtension;
+    }
+    return extensions;
+}
+/**
+ * Sitúa un fichero de UI en el eje framework × presentación × componente, o devuelve `null` si no
+ * es UI de referencia (el núcleo, una hoja de estilos suelta, un snippet).
+ *
+ * `ui/<framework>/<Componente>` es la presentación headless; `ui/<framework>/<presentación>/…` es
+ * cada una de las otras tres.
+ */
+export function locateUiFile(path, catalog = BUILTIN_FRAMEWORKS) {
+    const segments = path.split('/');
+    if (segments[0] !== 'ui' || segments.length < 3)
+        return null;
+    const framework = segments[1];
+    const extensions = uiExtensionsOf(catalog);
+    if (!framework || !(framework in extensions))
+        return null;
+    const extension = extensions[framework];
+    const last = segments[segments.length - 1];
+    if (!last.endsWith(extension))
+        return null;
+    const component = last.slice(0, -extension.length);
+    if (segments.length === 3)
+        return { framework, presentation: 'headless', component };
+    const presentation = segments[2];
+    if (!PRESENTATIONS.includes(presentation))
+        return null;
+    return { framework, presentation: presentation, component };
+}
+/** Cobertura real que se desprende de los ficheros que el descriptor enumera. */
+export function readActualCoverage(files, catalog = BUILTIN_FRAMEWORKS) {
+    const coverage = new Map();
+    for (const file of files) {
+        const located = locateUiFile(file.path, catalog);
+        if (!located)
+            continue;
+        const byPresentation = coverage.get(located.framework) ?? new Map();
+        const components = byPresentation.get(located.presentation) ?? new Set();
+        components.add(located.component);
+        byPresentation.set(located.presentation, components);
+        coverage.set(located.framework, byPresentation);
+    }
+    return coverage;
+}
+/**
+ * Compara lo declarado en `ui` con lo que hay, y describe cada discrepancia en una línea legible.
+ *
+ * Un componente presente sólo en la presentación headless de *todos* los frameworks —los de
+ * apoyo, como `ModernSelect`— no cuenta como brecha: la comparación se hace presentación a
+ * presentación, así que sólo salta cuando un framework se queda atrás respecto de otro en la
+ * misma presentación.
+ */
+export function findCoverageMismatches(declared, files, frameworks, catalog = BUILTIN_FRAMEWORKS) {
+    const actual = readActualCoverage(files, catalog);
+    const extensions = uiExtensionsOf(catalog);
+    const mismatches = [];
+    for (const framework of frameworks) {
+        if (!extensions[framework])
+            continue; // blade y vanilla se sirven con snippets, no con UI.
+        if (!declared[framework]) {
+            mismatches.push({
+                framework,
+                problem: `declarado en "frameworks" pero ausente de "ui": di qué cobertura tiene, aunque sea ninguna`,
+            });
+        }
+    }
+    // Un framework con ficheros de UI y sin entrada en `ui` no lo veía ninguna de las
+    // comprobaciones siguientes, que recorren lo declarado: la brecha se colaba justo por donde este
+    // módulo promete no dejar pasar ninguna. Y esos ficheros no se instalan en ningún sitio, porque
+    // ningún proyecto puede declarar un framework que el componente no soporta.
+    for (const framework of actual.keys()) {
+        if (declared[framework])
+            continue;
+        mismatches.push({
+            framework,
+            problem: `hay ficheros en ui/${framework}/ y el descriptor no lo declara ni en "frameworks" ni en "ui": nadie los instalaría`,
+        });
+    }
+    for (const [framework, coverage] of Object.entries(declared)) {
+        const byPresentation = actual.get(framework) ?? new Map();
+        const present = PRESENTATIONS.filter((p) => (byPresentation.get(p)?.size ?? 0) > 0);
+        const declaredPresentations = [...coverage.presentations].sort();
+        if (JSON.stringify(present.slice().sort()) !== JSON.stringify(declaredPresentations)) {
+            mismatches.push({
+                framework,
+                problem: `declara las presentaciones [${declaredPresentations.join(', ')}] y en el paquete hay [${present.join(', ')}]`,
+            });
+        }
+    }
+    // Una brecha es un componente que otro framework sí tiene en esa misma presentación.
+    for (const [framework, coverage] of Object.entries(declared)) {
+        if (coverage.presentations.length === 0)
+            continue;
+        const byPresentation = actual.get(framework) ?? new Map();
+        const gaps = new Set();
+        for (const presentation of coverage.presentations) {
+            const mine = byPresentation.get(presentation) ?? new Set();
+            for (const [other, otherCoverage] of actual) {
+                if (other === framework)
+                    continue;
+                if (!declared[other]?.presentations.includes(presentation))
+                    continue;
+                for (const component of otherCoverage.get(presentation) ?? []) {
+                    if (!mine.has(component))
+                        gaps.add(component);
+                }
+            }
+        }
+        const declaredMissing = [...(coverage.missing ?? [])].sort();
+        const actualMissing = [...gaps].sort();
+        if (JSON.stringify(declaredMissing) !== JSON.stringify(actualMissing)) {
+            mismatches.push({
+                framework,
+                problem: `declara que le faltan [${declaredMissing.join(', ') || '—'}] y en realidad le faltan [${actualMissing.join(', ') || '—'}]`,
+            });
+        }
+    }
+    return mismatches;
+}
+//# sourceMappingURL=ui-coverage.js.map

package/dist/ui-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-coverage.js","sourceRoot":"","sources":["../src/ui-coverage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modularcore/registry",
-  "version": "0.2.0",
+  "version": "0.5.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -12,11 +12,20 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
     }
   },
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
   "dependencies": {
     "tar-stream": "^3.2.0",
     "zod": "^4.4.3"
@@ -24,10 +33,5 @@
   "devDependencies": {
     "@types/node": "^22.13.0",
     "@types/tar-stream": "^3.1.4"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run"
   }
-}
+}