@getcoherent/core 0.6.13 → 0.6.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sergei Kovtun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -2733,8 +2733,8 @@ interface ComponentProvider {
  * See docs/epic-2-shared-components.md.
  */
 
-/** Shared component type: layout (layout.tsx), section (reusable block), widget (small element) */
-declare const SharedComponentTypeSchema: z.ZodEnum<["layout", "section", "widget"]>;
+/** Shared component type classification */
+declare const SharedComponentTypeSchema: z.ZodEnum<["layout", "navigation", "data-display", "form", "feedback", "section", "widget"]>;
 type SharedComponentType = z.infer<typeof SharedComponentTypeSchema>;
 /** Single entry in the shared components registry */
 declare const SharedComponentEntrySchema: z.ZodObject<{
@@ -2743,7 +2743,7 @@ declare const SharedComponentEntrySchema: z.ZodObject<{
     /** Display name (e.g. "Header", "PricingCard") */
     name: z.ZodString;
     /** layout | section | widget */
-    type: z.ZodEnum<["layout", "section", "widget"]>;
+    type: z.ZodEnum<["layout", "navigation", "data-display", "form", "feedback", "section", "widget"]>;
     /** Path to component file relative to project root */
     file: z.ZodString;
     /** List of file paths that import this component (e.g. ["app/layout.tsx", "app/dashboard/page.tsx"]) */
@@ -2753,24 +2753,36 @@ declare const SharedComponentEntrySchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     /** TypeScript props interface body, e.g. "{ icon: React.ReactNode; title: string }" */
     propsInterface: z.ZodOptional<z.ZodString>;
+    /** Example JSX usage, e.g. '<StatsCard icon={Users} value="1,234" />' */
+    usageExample: z.ZodOptional<z.ZodString>;
+    /** Package and component dependencies, e.g. ['lucide-react', 'components/ui/card'] */
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** How this component was created */
+    source: z.ZodOptional<z.ZodEnum<["extracted", "generated", "manual"]>>;
 }, "strip", z.ZodTypeAny, {
-    type: "layout" | "section" | "widget";
+    type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
     name: string;
     id: string;
     file: string;
     usedIn: string[];
+    dependencies: string[];
     description?: string | undefined;
+    source?: "extracted" | "generated" | "manual" | undefined;
     createdAt?: string | undefined;
     propsInterface?: string | undefined;
+    usageExample?: string | undefined;
 }, {
-    type: "layout" | "section" | "widget";
+    type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
     name: string;
     id: string;
     file: string;
     description?: string | undefined;
+    source?: "extracted" | "generated" | "manual" | undefined;
     createdAt?: string | undefined;
     usedIn?: string[] | undefined;
     propsInterface?: string | undefined;
+    usageExample?: string | undefined;
+    dependencies?: string[] | undefined;
 }>;
 type SharedComponentEntry = z.infer<typeof SharedComponentEntrySchema>;
 /** Root schema for coherent.components.json */
@@ -2781,7 +2793,7 @@ declare const SharedComponentsManifestSchema: z.ZodObject<{
         /** Display name (e.g. "Header", "PricingCard") */
         name: z.ZodString;
         /** layout | section | widget */
-        type: z.ZodEnum<["layout", "section", "widget"]>;
+        type: z.ZodEnum<["layout", "navigation", "data-display", "form", "feedback", "section", "widget"]>;
         /** Path to component file relative to project root */
         file: z.ZodString;
         /** List of file paths that import this component (e.g. ["app/layout.tsx", "app/dashboard/page.tsx"]) */
@@ -2791,49 +2803,67 @@ declare const SharedComponentsManifestSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         /** TypeScript props interface body, e.g. "{ icon: React.ReactNode; title: string }" */
         propsInterface: z.ZodOptional<z.ZodString>;
+        /** Example JSX usage, e.g. '<StatsCard icon={Users} value="1,234" />' */
+        usageExample: z.ZodOptional<z.ZodString>;
+        /** Package and component dependencies, e.g. ['lucide-react', 'components/ui/card'] */
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** How this component was created */
+        source: z.ZodOptional<z.ZodEnum<["extracted", "generated", "manual"]>>;
     }, "strip", z.ZodTypeAny, {
-        type: "layout" | "section" | "widget";
+        type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
         name: string;
         id: string;
         file: string;
         usedIn: string[];
+        dependencies: string[];
         description?: string | undefined;
+        source?: "extracted" | "generated" | "manual" | undefined;
         createdAt?: string | undefined;
         propsInterface?: string | undefined;
+        usageExample?: string | undefined;
     }, {
-        type: "layout" | "section" | "widget";
+        type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
         name: string;
         id: string;
         file: string;
         description?: string | undefined;
+        source?: "extracted" | "generated" | "manual" | undefined;
         createdAt?: string | undefined;
         usedIn?: string[] | undefined;
         propsInterface?: string | undefined;
+        usageExample?: string | undefined;
+        dependencies?: string[] | undefined;
     }>, "many">>;
     /** Next numeric id for new entries (CID-XXX → nextId = 4 for CID-004) */
     nextId: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     shared: {
-        type: "layout" | "section" | "widget";
+        type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
         name: string;
         id: string;
         file: string;
         usedIn: string[];
+        dependencies: string[];
         description?: string | undefined;
+        source?: "extracted" | "generated" | "manual" | undefined;
         createdAt?: string | undefined;
         propsInterface?: string | undefined;
+        usageExample?: string | undefined;
     }[];
     nextId: number;
 }, {
     shared?: {
-        type: "layout" | "section" | "widget";
+        type: "form" | "layout" | "navigation" | "feedback" | "data-display" | "section" | "widget";
         name: string;
         id: string;
         file: string;
         description?: string | undefined;
+        source?: "extracted" | "generated" | "manual" | undefined;
         createdAt?: string | undefined;
         usedIn?: string[] | undefined;
         propsInterface?: string | undefined;
+        usageExample?: string | undefined;
+        dependencies?: string[] | undefined;
     }[] | undefined;
     nextId?: number | undefined;
 }>;
@@ -3146,6 +3176,9 @@ interface CreateSharedComponentInput {
     usedIn?: string[];
     description?: string;
     propsInterface?: string;
+    usageExample?: string;
+    dependencies?: string[];
+    source?: 'extracted' | 'generated' | 'manual';
 }
 /**
  * Add a new shared component: allocate CID, set createdAt, append to shared, increment nextId.
@@ -3557,6 +3590,9 @@ interface GenerateSharedComponentInput {
     overwrite?: boolean;
     /** TypeScript props interface body, e.g. "{ title: string; icon: React.ReactNode }". */
     propsInterface?: string;
+    usageExample?: string;
+    dependencies?: string[];
+    source?: 'extracted' | 'generated' | 'manual';
 }
 interface GenerateSharedComponentResult {
     id: string;

package/dist/index.js

@@ -454,7 +454,15 @@ var EXAMPLE_SPA_CONFIG = {
 
 // src/types/shared-components-manifest.ts
 import { z as z2 } from "zod";
-var SharedComponentTypeSchema = z2.enum(["layout", "section", "widget"]);
+var SharedComponentTypeSchema = z2.enum([
+  "layout",
+  "navigation",
+  "data-display",
+  "form",
+  "feedback",
+  "section",
+  "widget"
+]);
 var SharedComponentEntrySchema = z2.object({
   /** Unique ID: CID-001, CID-002, ... */
   id: z2.string().regex(/^CID-\d{3,}$/, "Must be CID-XXX with zero-padded number"),
@@ -470,7 +478,13 @@ var SharedComponentEntrySchema = z2.object({
   /** Human-readable description */
   description: z2.string().optional(),
   /** TypeScript props interface body, e.g. "{ icon: React.ReactNode; title: string }" */
-  propsInterface: z2.string().optional()
+  propsInterface: z2.string().optional(),
+  /** Example JSX usage, e.g. '<StatsCard icon={Users} value="1,234" />' */
+  usageExample: z2.string().optional(),
+  /** Package and component dependencies, e.g. ['lucide-react', 'components/ui/card'] */
+  dependencies: z2.array(z2.string()).default([]),
+  /** How this component was created */
+  source: z2.enum(["extracted", "generated", "manual"]).optional()
 });
 var SharedComponentsManifestSchema = z2.object({
   shared: z2.array(SharedComponentEntrySchema).default([]),
@@ -1977,6 +1991,9 @@ function createEntry(manifest, input) {
     usedIn: input.usedIn ?? [],
     description: input.description,
     propsInterface: input.propsInterface,
+    usageExample: input.usageExample,
+    dependencies: input.dependencies ?? [],
+    source: input.source,
     createdAt: now
   };
   const nextManifest = {
@@ -6826,7 +6843,10 @@ async function generateSharedComponent(projectRoot, input) {
     file: filePath,
     usedIn: input.usedIn ?? [],
     description: input.description,
-    propsInterface: input.propsInterface
+    propsInterface: input.propsInterface,
+    usageExample: input.usageExample,
+    dependencies: input.dependencies,
+    source: input.source
   });
   await saveManifest(projectRoot, nextManifest);
   return { id: entry.id, name: entry.name, file: entry.file };

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.6.13",
+  "version": "0.6.14",
   "description": "Core design system engine for Coherent",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,12 +32,6 @@
   ],
   "author": "Coherent Design Method",
   "license": "MIT",
-  "scripts": {
-    "dev": "tsup --watch",
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest"
-  },
   "dependencies": {
     "handlebars": "^4.7.8",
     "zod": "^3.22.4"
@@ -47,5 +41,11 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.2.1"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest"
   }
-}
+}