@idealyst/cli 1.2.0 → 1.2.1

package/dist/types/templates/copier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Template file copying utilities
+ */
+import { TemplateData } from '../types';
+/**
+ * Copy a template directory with variable replacement
+ */
+export declare function copyTemplateDirectory(sourceDir: string, destDir: string, data: TemplateData): Promise<void>;
+/**
+ * Copy a single template file with variable replacement
+ */
+export declare function copyTemplateFile(sourceFile: string, destFile: string, data: TemplateData): Promise<void>;
+/**
+ * Get the path to a template directory
+ */
+export declare function getTemplatePath(...segments: string[]): string;
+/**
+ * Check if a template exists and has content
+ */
+export declare function templateExists(...segments: string[]): Promise<boolean>;
+/**
+ * Check if a template has content (non-empty directory)
+ */
+export declare function templateHasContent(templatePath: string): Promise<boolean>;

package/dist/types/templates/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Template utilities exports
+ */
+export * from './processor';
+export * from './copier';
+export * from './merger';

package/dist/types/templates/merger.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Package.json merging utilities
+ */
+/**
+ * Deep merge two objects, with source taking precedence
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/**
+ * Package.json structure
+ */
+export interface PackageJson {
+    name?: string;
+    version?: string;
+    description?: string;
+    main?: string;
+    types?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    workspaces?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Merge additional configuration into a package.json file
+ */
+export declare function mergePackageJson(filePath: string, additions: Partial<PackageJson>): Promise<void>;
+/**
+ * Add dependencies to a package.json file
+ */
+export declare function addDependencies(filePath: string, dependencies: Record<string, string>, type?: 'dependencies' | 'devDependencies' | 'peerDependencies'): Promise<void>;
+/**
+ * Remove dependencies from a package.json file
+ */
+export declare function removeDependencies(filePath: string, dependencyNames: string[], type?: 'dependencies' | 'devDependencies' | 'peerDependencies'): Promise<void>;
+/**
+ * Add scripts to a package.json file
+ */
+export declare function addScripts(filePath: string, scripts: Record<string, string>): Promise<void>;
+/**
+ * Update workspace configuration in root package.json
+ */
+export declare function addToWorkspaces(filePath: string, packagePath: string): Promise<void>;

package/dist/types/templates/processor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Template variable processor
+ */
+import { TemplateData } from '../types';
+/**
+ * Process template content and replace all variables
+ */
+export declare function processTemplate(content: string, data: TemplateData): string;
+/**
+ * Process conditional blocks in templates
+ * Supports: {{#if hasApi}}...{{/if}} and {{#unless hasApi}}...{{/unless}}
+ */
+export declare function processConditionals(content: string, data: TemplateData): string;
+/**
+ * Full template processing (variables + conditionals)
+ */
+export declare function processTemplateContent(content: string, data: TemplateData): string;
+/**
+ * Check if a file should be processed for template variables
+ */
+export declare function shouldProcessFile(filename: string): boolean;
+/**
+ * Build TemplateData from ProjectConfig and additional info
+ */
+export declare function buildTemplateData(config: {
+    projectName: string;
+    appDisplayName: string;
+    iosBundleId: string;
+    androidPackageName: string;
+    extensions: {
+        api: boolean;
+        prisma: boolean;
+        trpc: boolean;
+        graphql: boolean;
+        devcontainer: boolean | {
+            enabled: boolean;
+        };
+    };
+}, idealystVersion: string): TemplateData;

package/dist/types/types.d.ts

@@ -1,15 +1,163 @@
-export interface GenerateProjectOptions {
-    name: string;
+/**
+ * Core type definitions for the CLI-Beta package
+ */
+/**
+ * Complete project configuration collected from wizard or CLI args
+ */
+export interface ProjectConfig {
+    projectName: string;
+    orgDomain: string;
+    appDisplayName: string;
+    iosBundleId: string;
+    androidPackageName: string;
+    extensions: ExtensionConfig;
     directory: string;
     skipInstall: boolean;
-    figmaToken?: string;
+    isInteractive: boolean;
+}
+/**
+ * Extension configuration - which optional features are enabled
+ */
+export interface ExtensionConfig {
+    api: boolean;
+    prisma: boolean;
+    trpc: boolean;
+    graphql: boolean;
+    devcontainer: boolean | DevcontainerConfig;
+}
+/**
+ * Devcontainer configuration options
+ */
+export interface DevcontainerConfig {
+    enabled: boolean;
+    postgres: boolean;
+    redis: boolean;
+    chrome: boolean;
+    claudeCode: boolean;
+}
+/**
+ * CLI arguments before processing
+ */
+export interface CLIArgs {
+    projectName?: string;
+    orgDomain?: string;
+    appDisplayName?: string;
+    withApi?: boolean;
+    withPrisma?: boolean;
+    withTrpc?: boolean;
+    withGraphql?: boolean;
+    withDevcontainer?: boolean;
+    noInteractive?: boolean;
+    skipInstall?: boolean;
+    directory?: string;
+}
+/**
+ * A single wizard step definition
+ */
+export interface WizardStep<T = unknown> {
+    id: string;
+    prompt: (currentConfig: Partial<ProjectConfig>) => Promise<T>;
+    validate: (value: T) => ValidationResult;
+    shouldShow?: (config: Partial<ProjectConfig>) => boolean;
 }
+/**
+ * Result of validation
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    suggestions?: string[];
+}
+/**
+ * Wizard state during collection
+ */
+export interface WizardState {
+    currentStep: number;
+    totalSteps: number;
+    config: Partial<ProjectConfig>;
+    completed: boolean;
+}
+/**
+ * Template data passed to template processor
+ */
 export interface TemplateData {
     projectName: string;
     packageName: string;
+    workspaceScope: string;
     version: string;
     description: string;
-    appName?: string;
-    workspaceScope?: string;
+    appDisplayName: string;
+    iosBundleId: string;
+    androidPackageName: string;
     idealystVersion: string;
+    hasApi: boolean;
+    hasPrisma: boolean;
+    hasTrpc: boolean;
+    hasGraphql: boolean;
+    hasDevcontainer: boolean;
+}
+/**
+ * Generator result with metadata
+ */
+export interface GeneratorResult {
+    success: boolean;
+    projectPath: string;
+    packagesCreated: string[];
+    extensionsEnabled: string[];
+    warnings: string[];
+    nextSteps: string[];
+}
+/**
+ * Result from generating a single package
+ */
+export interface PackageGeneratorResult {
+    success: boolean;
+    warning?: string;
+}
+/**
+ * Options for React Native initialization
+ */
+export interface ReactNativeInitOptions {
+    projectName: string;
+    displayName: string;
+    bundleId: string;
+    packageName: string;
+    directory: string;
+    skipInstall: boolean;
+}
+/**
+ * Types of projects that can be added to workspace
+ */
+export type AddableProjectType = 'web' | 'mobile' | 'api' | 'shared';
+/**
+ * Options for add command
+ */
+export interface AddProjectOptions {
+    name: string;
+    type: AddableProjectType;
+    directory: string;
+    appDisplayName?: string;
+    withTrpc?: boolean;
+    withGraphql?: boolean;
+    skipInstall?: boolean;
+}
+/**
+ * Custom error for missing required arguments in non-interactive mode
+ */
+export declare class MissingArgumentsError extends Error {
+    missingArgs: string[];
+    providedArgs: Record<string, unknown>;
+    constructor(missingArgs: string[], providedArgs: Record<string, unknown>);
+}
+/**
+ * Error when trying to run outside workspace for certain operations
+ */
+export declare class NotInWorkspaceError extends Error {
+    constructor(operation: string);
+}
+/**
+ * Error for invalid extension combinations
+ */
+export declare class InvalidExtensionError extends Error {
+    constructor(extension: string, requirement: string);
 }

package/dist/types/utils/filesystem.d.ts

@@ -0,0 +1,56 @@
+/**
+ * File system utilities for template copying and file operations
+ */
+import { TemplateData } from '../types';
+/**
+ * Check if a path matches any ignore patterns
+ */
+export declare function shouldIgnore(filePath: string): boolean;
+/**
+ * Check if a file should have template variables processed
+ */
+export declare function shouldProcessTemplate(filePath: string): boolean;
+/**
+ * Replace template variables in content
+ */
+export declare function processTemplateContent(content: string, data: TemplateData): string;
+/**
+ * Copy a template directory with variable replacement
+ */
+export declare function copyTemplate(sourceDir: string, destDir: string, data: TemplateData): Promise<void>;
+/**
+ * Ensure a directory exists
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Read a JSON file
+ */
+export declare function readJson<T = unknown>(filePath: string): Promise<T>;
+/**
+ * Write a JSON file
+ */
+export declare function writeJson(filePath: string, data: unknown): Promise<void>;
+/**
+ * Read a text file
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Write a text file
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Copy a file
+ */
+export declare function copyFile(source: string, dest: string): Promise<void>;
+/**
+ * Remove a file or directory
+ */
+export declare function remove(filePath: string): Promise<void>;
+/**
+ * Get the template path for cli-beta
+ */
+export declare function getTemplatePath(templateName: string): string;

package/dist/types/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility exports
+ */
+export * from './logger';
+export * from './filesystem';
+export * from './shell';
+export * from './validation';

package/dist/types/utils/logger.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Logger utility for consistent CLI output
+ */
+export declare const logger: {
+    /**
+     * Log an info message
+     */
+    info(message: string): void;
+    /**
+     * Log a success message
+     */
+    success(message: string): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string): void;
+    /**
+     * Log an error message
+     */
+    error(message: string): void;
+    /**
+     * Log a step in the process
+     */
+    step(message: string): void;
+    /**
+     * Log a bullet point item
+     */
+    bullet(message: string, color?: "green" | "yellow" | "blue" | "white"): void;
+    /**
+     * Log a code snippet or command
+     */
+    code(message: string): void;
+    /**
+     * Log a dimmed/subtle message
+     */
+    dim(message: string): void;
+    /**
+     * Log a bold message
+     */
+    bold(message: string): void;
+    /**
+     * Log a newline
+     */
+    newline(): void;
+    /**
+     * Log a horizontal separator
+     */
+    separator(): void;
+    /**
+     * Log a header with separator
+     */
+    header(message: string): void;
+    /**
+     * Log a key-value pair
+     */
+    keyValue(key: string, value: string): void;
+};
+export default logger;

package/dist/types/utils/shell.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shell command execution utilities
+ */
+export interface CommandOptions {
+    cwd?: string;
+    timeout?: number;
+    silent?: boolean;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Run a shell command and return the result
+ */
+export declare function runCommand(command: string, args: string[], options?: CommandOptions): Promise<CommandResult>;
+/**
+ * Run yarn install in a directory
+ */
+export declare function installDependencies(directory: string, options?: {
+    silent?: boolean;
+}): Promise<void>;
+/**
+ * Check if a command exists
+ */
+export declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Get the current yarn version
+ */
+export declare function getYarnVersion(): Promise<string | null>;
+/**
+ * Get the current node version
+ */
+export declare function getNodeVersion(): Promise<string | null>;

package/dist/types/utils/validation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Input validation utilities
+ */
+import { ValidationResult } from '../types';
+/**
+ * Validate a project name
+ */
+export declare function validateProjectName(name: string): ValidationResult;
+/**
+ * Validate an organization domain
+ */
+export declare function validateOrgDomain(domain: string): ValidationResult;
+/**
+ * Validate an app display name
+ */
+export declare function validateAppDisplayName(name: string): ValidationResult;
+/**
+ * Validate an iOS bundle ID
+ */
+export declare function validateBundleId(bundleId: string): ValidationResult;
+/**
+ * Validate an Android package name
+ */
+export declare function validateAndroidPackageName(packageName: string): ValidationResult;
+/**
+ * Validate that extension dependencies are met
+ */
+export declare function validateExtensions(options: {
+    withApi?: boolean;
+    withTrpc?: boolean;
+    withGraphql?: boolean;
+}): ValidationResult;

package/dist/types/wizard/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Wizard orchestrator - manages the step-by-step configuration flow
+ */
+import { ProjectConfig, CLIArgs } from '../types';
+/**
+ * Run the interactive wizard to collect all configuration
+ */
+export declare function runWizard(prefilledArgs?: Partial<CLIArgs>): Promise<ProjectConfig | null>;
+/**
+ * Validate CLI args for non-interactive mode
+ */
+export declare function validateNonInteractiveArgs(args: CLIArgs): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * Build a ProjectConfig from CLI arguments (for non-interactive mode)
+ */
+export declare function buildConfigFromArgs(args: CLIArgs): ProjectConfig;
+export * from './validators';

package/dist/types/wizard/steps/apiExtension.d.ts

@@ -0,0 +1,5 @@
+/**
+ * API extension wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const apiExtensionStep: WizardStep<boolean>;

package/dist/types/wizard/steps/appDisplayName.d.ts

@@ -0,0 +1,5 @@
+/**
+ * App display name wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const appDisplayNameStep: WizardStep<string>;

package/dist/types/wizard/steps/devcontainerExtension.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Wizard step for devcontainer extension
+ */
+import { WizardStep, DevcontainerConfig } from '../../types';
+export declare const devcontainerExtensionStep: WizardStep<DevcontainerConfig | false>;

package/dist/types/wizard/steps/graphqlExtension.d.ts

@@ -0,0 +1,5 @@
+/**
+ * GraphQL extension wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const graphqlExtensionStep: WizardStep<boolean>;

package/dist/types/wizard/steps/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wizard steps exports
+ */
+export { projectNameStep } from './projectName';
+export { orgDomainStep } from './orgDomain';
+export { appDisplayNameStep } from './appDisplayName';
+export { apiExtensionStep } from './apiExtension';
+export { trpcExtensionStep } from './trpcExtension';
+export { graphqlExtensionStep } from './graphqlExtension';
+export { prismaExtensionStep } from './prismaExtension';
+export { devcontainerExtensionStep } from './devcontainerExtension';
+export { summaryStep } from './summary';

package/dist/types/wizard/steps/orgDomain.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Organization domain wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const orgDomainStep: WizardStep<string>;

package/dist/types/wizard/steps/prismaExtension.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Prisma extension wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const prismaExtensionStep: WizardStep<boolean>;

package/dist/types/wizard/steps/projectName.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Project name wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const projectNameStep: WizardStep<string>;

package/dist/types/wizard/steps/summary.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Summary wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const summaryStep: WizardStep<boolean>;

package/dist/types/wizard/steps/trpcExtension.d.ts

@@ -0,0 +1,5 @@
+/**
+ * tRPC extension wizard step
+ */
+import { WizardStep } from '../../types';
+export declare const trpcExtensionStep: WizardStep<boolean>;

package/dist/types/wizard/validators.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Wizard input validators
+ */
+import { ValidationResult } from '../types';
+import { validateProjectName, validateOrgDomain, validateAppDisplayName } from '../utils/validation';
+/**
+ * Re-export validators for use in wizard steps
+ */
+export { validateProjectName, validateOrgDomain, validateAppDisplayName, };
+/**
+ * Validate a boolean input
+ */
+export declare function validateBoolean(value: unknown): ValidationResult;
+/**
+ * Display validation error to user
+ */
+export declare function formatValidationError(result: ValidationResult): string;

package/dist/types.js

@@ -1,3 +1,44 @@
 "use strict";
+/**
+ * Core type definitions for the CLI-Beta package
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidExtensionError = exports.NotInWorkspaceError = exports.MissingArgumentsError = void 0;
+// ============================================
+// ERROR TYPES
+// ============================================
+/**
+ * Custom error for missing required arguments in non-interactive mode
+ */
+class MissingArgumentsError extends Error {
+    constructor(missingArgs, providedArgs) {
+        const message = `Missing required arguments: ${missingArgs.join(', ')}\n` +
+            `Run with interactive mode (remove --no-interactive) or provide all required arguments.`;
+        super(message);
+        this.name = 'MissingArgumentsError';
+        this.missingArgs = missingArgs;
+        this.providedArgs = providedArgs;
+    }
+}
+exports.MissingArgumentsError = MissingArgumentsError;
+/**
+ * Error when trying to run outside workspace for certain operations
+ */
+class NotInWorkspaceError extends Error {
+    constructor(operation) {
+        super(`The '${operation}' command must be run from within an Idealyst workspace.`);
+        this.name = 'NotInWorkspaceError';
+    }
+}
+exports.NotInWorkspaceError = NotInWorkspaceError;
+/**
+ * Error for invalid extension combinations
+ */
+class InvalidExtensionError extends Error {
+    constructor(extension, requirement) {
+        super(`Extension '${extension}' requires '${requirement}' to be enabled.`);
+        this.name = 'InvalidExtensionError';
+    }
+}
+exports.InvalidExtensionError = InvalidExtensionError;
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqLH,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;GAEG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAI9C,YACE,WAAqB,EACrB,YAAqC;QAErC,MAAM,OAAO,GAAG,+BAA+B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACvE,wFAAwF,CAAC;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAfD,sDAeC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,SAAiB;QAC3B,KAAK,CAAC,QAAQ,SAAS,0DAA0D,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,SAAiB,EAAE,WAAmB;QAChD,KAAK,CAAC,cAAc,SAAS,eAAe,WAAW,kBAAkB,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC"}