@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Prism CLI - Add Command
+ *
+ * Add components or blocks to your project.
+ *
+ * @module cli/commands/add
+ */
+import { Command } from 'commander';
+import type { ComponentDefinition } from '../../types/registry.js';
+/**
+ * Create the add command.
+ */
+export declare function addCommand(): Command;
+/**
+ * Convert kebab-case to PascalCase.
+ */
+export declare function toPascalCase(name: string): string;
+/**
+ * Generate file content based on type.
+ */
+export declare function generateFileContent(name: string, fileName: string, fileType: string, definition: ComponentDefinition, isBlock: boolean): string;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAkBnE;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAiBpC;AA6ND;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAUD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,OAAO,GACf,MAAM,CA2BR"}

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - Diff Command
+ *
+ * Show differences between local and registry versions.
+ *
+ * @module cli/commands/diff
+ */
+import { Command } from 'commander';
+/**
+ * Create the diff command.
+ */
+export declare function diffCommand(): Command;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAYrC"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - Doctor Command
+ *
+ * Diagnose project configuration and environment.
+ *
+ * @module cli/commands/doctor
+ */
+import { Command } from 'commander';
+/**
+ * Create the doctor command.
+ */
+export declare function doctorCommand(): Command;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAWvC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - Init Command
+ *
+ * Initialize a new Prism project with configuration.
+ *
+ * @module cli/commands/init
+ */
+import { Command } from 'commander';
+/**
+ * Create the init command.
+ */
+export declare function initCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsDpC;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAarC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - List Command
+ *
+ * List available components and blocks from the registry.
+ *
+ * @module cli/commands/list
+ */
+import { Command } from 'commander';
+/**
+ * Create the list command.
+ */
+export declare function listCommand(): Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAcrC"}

package/dist/cli/commands/remove.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - Remove Command
+ *
+ * Remove components or blocks from your project.
+ *
+ * @module cli/commands/remove
+ */
+import { Command } from 'commander';
+/**
+ * Create the remove command.
+ */
+export declare function removeCommand(): Command;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cli/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAcvC"}

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Prism CLI - Update Command
+ *
+ * Update installed components and blocks to latest versions.
+ *
+ * @module cli/commands/update
+ */
+import { Command } from 'commander';
+/**
+ * Create the update command.
+ */
+export declare function updateCommand(): Command;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAevC"}

package/dist/cli/config.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Prism CLI Configuration
+ *
+ * Handles loading, validating, and saving Prism configuration.
+ *
+ * @module cli/config
+ */
+/**
+ * Prism configuration schema.
+ */
+export interface PrismConfigSchema {
+    $schema?: string;
+    style: 'default' | 'new-york';
+    tailwind?: {
+        config: string;
+        css: string;
+        baseColor: string;
+        cssVariables: boolean;
+    };
+    aliases: {
+        components: string;
+        blocks: string;
+        hooks: string;
+        utils: string;
+    };
+    registries: string[];
+}
+/**
+ * Runtime Prism configuration with resolved paths.
+ */
+export interface PrismConfig extends PrismConfigSchema {
+    /** Resolved root directory */
+    rootDir: string;
+    /** Resolved config file path */
+    configPath: string;
+}
+/**
+ * Find the prism.config.json file by walking up the directory tree.
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Load Prism configuration from file.
+ */
+export declare function loadConfig(cwd?: string): Promise<PrismConfig | null>;
+/**
+ * Save Prism configuration to file.
+ */
+export declare function saveConfig(config: PrismConfigSchema, outputPath?: string): Promise<void>;
+/**
+ * Validate Prism configuration.
+ */
+export declare function validateConfig(config: unknown): config is PrismConfigSchema;
+/**
+ * Resolve an alias to an actual file path.
+ */
+export declare function resolveAlias(alias: string, config: PrismConfig): string;
+/**
+ * Get the output path for a component.
+ */
+export declare function getComponentPath(componentName: string, config: PrismConfig): string;
+/**
+ * Get the output path for a block.
+ */
+export declare function getBlockPath(blockName: string, config: PrismConfig): string;
+/**
+ * Get the output path for a hook.
+ */
+export declare function getHookPath(hookName: string, config: PrismConfig): string;
+/**
+ * Get the output path for a utility.
+ */
+export declare function getUtilPath(utilName: string, config: PrismConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAa9E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBzF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,UAAU,GAAE,MAAmD,GAC9D,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,iBAAiB,CA+B3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAkBvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGnF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGzE"}

package/dist/cli/constants.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Prism CLI Constants
+ *
+ * @module cli/constants
+ */
+/** Current Prism version */
+export declare const PRISM_VERSION: string;
+/** Default configuration file name */
+export declare const CONFIG_FILE_NAME = "prism.config.json";
+/** Default component output directory */
+export declare const DEFAULT_COMPONENTS_DIR = "src/components/ui";
+/** Default blocks output directory */
+export declare const DEFAULT_BLOCKS_DIR = "src/blocks";
+/** Default hooks output directory */
+export declare const DEFAULT_HOOKS_DIR = "src/hooks";
+/** Default utils output directory */
+export declare const DEFAULT_UTILS_DIR = "src/utils";
+/** Default registry URL */
+export declare const DEFAULT_REGISTRY_URL = "https://registry.prism.omnitron.dev";
+/** Default configuration */
+export declare const DEFAULT_CONFIG: {
+    $schema: string;
+    style: 'default';
+    tailwind: {
+        config: string;
+        css: string;
+        baseColor: string;
+        cssVariables: boolean;
+    };
+    aliases: {
+        components: string;
+        blocks: string;
+        hooks: string;
+        utils: string;
+    };
+    registries: string[];
+};
+/** CLI colors - disabled when NO_COLOR is set or output is not a TTY */
+export declare const COLORS: {
+    primary: string;
+    success: string;
+    warning: string;
+    error: string;
+    muted: string;
+    bold: string;
+    reset: string;
+};
+/** Log utilities */
+export declare const log: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warning: (msg: string) => void;
+    error: (msg: string) => void;
+    muted: (msg: string) => void;
+};
+/** Component categories */
+export declare const COMPONENT_CATEGORIES: readonly ['inputs', 'data-display', 'feedback', 'surfaces', 'navigation', 'layout', 'data'];
+/** Block categories */
+export declare const BLOCK_CATEGORIES: readonly ['layouts', 'auth', 'settings', 'data', 'dashboard', 'marketing'];
+//# sourceMappingURL=constants.d.ts.map

package/dist/cli/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,4BAA4B;AAC5B,eAAO,MAAM,aAAa,QAAc,CAAC;AAEzC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,2BAA2B;AAC3B,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAE1E,4BAA4B;AAC5B,eAAO,MAAM,cAAc;IACzB,OAAO;IACP,KAAK,EAAE,SAAS;IAChB,QAAQ;QACN,MAAM;QACN,GAAG;QACH,SAAS;QACT,YAAY;;IAEd,OAAO;QACL,UAAU;QACV,MAAM;QACN,KAAK;QACL,KAAK;;IAEP,UAAU;CACX,CAAC;AAKF,wEAAwE;AACxE,eAAO,MAAM,MAAM;;;;;;;;CAkBd,CAAC;AAEN,oBAAoB;AACpB,eAAO,MAAM,GAAG;IACd,IAAI,QAAQ,MAAM;IAClB,OAAO,QAAQ,MAAM;IACrB,OAAO,QAAQ,MAAM;IACrB,KAAK,QAAQ,MAAM;IACnB,KAAK,QAAQ,MAAM;CACpB,CAAC;AAEF,2BAA2B;AAC3B,eAAO,MAAM,oBAAoB,YAC/B,QAAQ,EACR,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,CACE,CAAC;AAEX,uBAAuB;AACvB,eAAO,MAAM,gBAAgB,YAAI,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Prism CLI
+ *
+ * Command-line interface for the Prism design system.
+ * Provides shadcn/ui-style component installation and management.
+ *
+ * @module @omnitron-dev/prism/cli
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure the Prism CLI.
+ */
+export declare function createCli(): Command;
+/**
+ * Run the CLI with process arguments.
+ */
+export declare function cli(): Promise<void>;
+export { addCommand } from './commands/add.js';
+export { removeCommand } from './commands/remove.js';
+export { initCommand } from './commands/init.js';
+export { listCommand } from './commands/list.js';
+export { diffCommand } from './commands/diff.js';
+export { updateCommand } from './commands/update.js';
+export { doctorCommand } from './commands/doctor.js';
+export { PRISM_VERSION, DEFAULT_CONFIG } from './constants.js';
+export type { PrismConfig, PrismConfigSchema } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAkBnC;AAED;;GAEG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAGzC;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/index.js

@@ -1304,7 +1304,7 @@ function generateBarrelExport(definition, pascalName) {
  *
  * ${definition.description || ""}
  *
- * @module @omnitron-dev/prism/components/${definition.name}
+ * @module components/${definition.name}
  */
 
 ${exports.join("\n")}
@@ -1315,7 +1315,7 @@ function generateTypeDefinitions(name, pascalName, definition) {
   return `/**
  * ${pascalName} Type Definitions
  *
- * @module @omnitron-dev/prism/components/${name}
+ * @module components/${name}
  */
 
 import type { ${muiComponent}Props as Mui${muiComponent}Props } from '@mui/material/${muiComponent}';
@@ -1347,7 +1347,7 @@ function generateHook(hookName, pascalName, definition, isBlock) {
  *
  * Custom hook for ${definition.displayName || pascalName} component logic.
  *
- * @module @omnitron-dev/prism/components/${definition.name}
+ * @module components/${definition.name}
  */
 
 import { useState, useCallback, useMemo } from 'react';
@@ -1426,7 +1426,7 @@ function generateBlockHook(hookName, pascalName, definition) {
  *
  * State management hook for ${definition.displayName || pascalName} block.
  *
- * @module @omnitron-dev/prism/blocks/${definition.name}
+ * @module blocks/${definition.name}
  */
 
 import { useState, useCallback, useMemo, useContext, createContext } from 'react';
@@ -1607,7 +1607,7 @@ function generateSchema(name, pascalName, definition) {
  *
  * Zod validation schemas for ${definition.displayName || pascalName} forms.
  *
- * @module @omnitron-dev/prism/blocks/${definition.name}
+ * @module blocks/${definition.name}
  */
 
 import { z } from 'zod';
@@ -1707,11 +1707,10 @@ function generateComponent(name, pascalName, camelName, fileName, definition, is
  *
  * ${definition.description || ""}
  *
- * @module @omnitron-dev/prism/components/${definition.name}
+ * @module components/${definition.name}
  * @see https://mui.com/material-ui/react-${name}/
  */
 
-import { forwardRef } from 'react';
 import Mui${muiComponent} from '@mui/material/${muiComponent}';
 import type { ${muiComponent}Props as Mui${muiComponent}Props } from '@mui/material/${muiComponent}';
 import { clsx } from 'clsx';
@@ -1738,19 +1737,17 @@ export interface ${componentPascal}Props extends Mui${muiComponent}Props {
  * </${componentPascal}>
  * \`\`\`
  */
-export const ${componentPascal} = forwardRef<HTMLButtonElement, ${componentPascal}Props>(
-  function ${componentPascal}({ className, ...props }, ref) {
-    return (
-      <Mui${muiComponent}
-        ref={ref}
-        className={clsx('prism-${name}', className)}
-        {...props}
-      />
-    );
-  }
-);
-
-${componentPascal}.displayName = '${componentPascal}';
+// React 19 passes ref through props directly \u2014 a plain function
+// component is sufficient and keeps the call site free of the
+// extra displayName line that forwardRef demanded for DevTools.
+export function ${componentPascal}({ className, ...props }: ${componentPascal}Props) {
+  return (
+    <Mui${muiComponent}
+      className={clsx('prism-${name}', className)}
+      {...props}
+    />
+  );
+}
 `;
 }
 function generateBlockComponent(name, componentName, componentPascal, definition) {
@@ -1761,10 +1758,9 @@ function generateBlockComponent(name, componentName, componentPascal, definition
  *
  * ${definition.description || ""}
  *
- * @module @omnitron-dev/prism/blocks/${definition.name}
+ * @module blocks/${definition.name}
  */
 
-import { forwardRef } from 'react';
 import type { ReactNode } from 'react';
 import Box from '@mui/material/Box';
 import type { BoxProps } from '@mui/material/Box';
@@ -1807,21 +1803,19 @@ const ${componentPascal}Root = styled(Box)(({ theme }) => ({
  * </${componentPascal}>
  * \`\`\`
  */
-export const ${componentPascal} = forwardRef<HTMLDivElement, ${componentPascal}Props>(
-  function ${componentPascal}({ className, children, ...props }, ref) {
-    return (
-      <${componentPascal}Root
-        ref={ref}
-        className={clsx('prism-${name}', className)}
-        {...props}
-      >
-        {children}
-      </${componentPascal}Root>
-    );
-  }
-);
-
-${componentPascal}.displayName = '${componentPascal}';
+// React 19 passes ref through props directly. No forwardRef
+// wrapper, no displayName follow-up needed \u2014 the function name
+// is what DevTools reads.
+export function ${componentPascal}({ className, children, ...props }: ${componentPascal}Props) {
+  return (
+    <${componentPascal}Root
+      className={clsx('prism-${name}', className)}
+      {...props}
+    >
+      {children}
+    </${componentPascal}Root>
+  );
+}
 `;
 }
 function getMuiComponent(name) {