anhedral 0.4.1 → 0.6.0

package/dist/cli.js

@@ -1,235 +0,0 @@
-import path from 'node:path';
-import { env } from 'node:process';
-import { TOOLCHAIN_CHANNELS, resolveToolchainChannel } from './toolchain.js';
-import { resolveModules } from './architecture/modules.js';
-import { packageNameFromText } from './render.js';
-import { isNativeStylingLibrary, isUiTarget, parseUiComponentList, } from './ui.js';
-export const USAGE = `
-anhedral new <directory> [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral doctor [--json] [--verbose]
-anhedral --version
-
-Commands:
-  anhedral new my-app
-    Generate the complete TypeScript stack in a new directory. With no module flags, every module is included.
-  anhedral new my-app --web --api --db --auth
-    Generate a web app, Fastify API, shared database package, and auth wiring.
-  anhedral init --web --api --db --auth
-    Generate the same readable workspace in the current empty directory.
-  anhedral add mobile extension
-    Add missing modules to an existing Anhedral project.
-  anhedral ui add button dialog --target mobile
-    Add React Native Reusables components to Expo. DOM clients use shadcn/ui.
-  anhedral upgrade
-    Transactionally upgrade a supported older Anhedral project before adding modules.
-`;
-export function parseNewProjectRequest(args) {
-    const [directory, ...moduleArgs] = args;
-    if (!directory || directory.startsWith('--'))
-        throw new Error('anhedral new requires a destination directory before module flags');
-    return Object.freeze({ directory, moduleArgs: Object.freeze(moduleArgs) });
-}
-export const APP_MODULES = ['web', 'mobile', 'api', 'desktop', 'extension'];
-export const FEATURE_MODULES = ['db', 'auth', 'billing', 'storage', 'native-subscriptions', 'electron-updater'];
-export function parseCli(args) {
-    const flags = { modules: new Set(), uiComponents: [] };
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (!token.startsWith('--')) {
-            const moduleName = normalizeModuleName(token);
-            if (moduleName) {
-                flags.modules.add(moduleName);
-                continue;
-            }
-            throw new Error(`Unexpected argument: ${token}. Use module names, module flags, --toolchain, or --skip-install`);
-        }
-        if (token === '--skip-install') {
-            flags.skipInstall = true;
-            continue;
-        }
-        if (token === '--dry-run') {
-            flags.dryRun = true;
-            continue;
-        }
-        if (token === '--json') {
-            flags.json = true;
-            continue;
-        }
-        if (token === '--verbose') {
-            flags.verbose = true;
-            continue;
-        }
-        if (token === '--ui') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('--'))
-                throw new Error('Missing value for --ui');
-            flags.uiComponents.push(...parseUiComponentList(value));
-            index += 1;
-            continue;
-        }
-        if (token.startsWith('--ui=')) {
-            flags.uiComponents.push(...parseUiComponentList(token.slice('--ui='.length)));
-            continue;
-        }
-        if (token === '--native-styling') {
-            const value = args[index + 1];
-            if (!isNativeStylingLibrary(value))
-                throw new Error('--native-styling must be nativewind or uniwind');
-            flags.nativeStyling = value;
-            index += 1;
-            continue;
-        }
-        if (token.startsWith('--native-styling=')) {
-            const value = token.slice('--native-styling='.length);
-            if (!isNativeStylingLibrary(value))
-                throw new Error('--native-styling must be nativewind or uniwind');
-            flags.nativeStyling = value;
-            continue;
-        }
-        if (token === '--toolchain') {
-            const value = args[index + 1];
-            if (!value || value.startsWith('--')) {
-                throw new Error('Missing value for --toolchain');
-            }
-            flags.toolchain = value;
-            index += 1;
-            continue;
-        }
-        if (token.startsWith('--toolchain=')) {
-            const value = token.slice('--toolchain='.length);
-            if (!value) {
-                throw new Error('Missing value for --toolchain');
-            }
-            flags.toolchain = value;
-            continue;
-        }
-        const moduleName = normalizeModuleName(token.slice(2));
-        if (moduleName) {
-            flags.modules.add(moduleName);
-            continue;
-        }
-        throw new Error(`Unknown flag: ${token}`);
-    }
-    return flags;
-}
-export function normalizeModuleName(raw) {
-    if (APP_MODULES.includes(raw))
-        return raw;
-    if (FEATURE_MODULES.includes(raw))
-        return raw;
-    return null;
-}
-export function deriveProjectName(cwd) {
-    return packageNameFromText(path.basename(cwd));
-}
-export function deriveDisplayName(cwd) {
-    const base = path.basename(cwd).trim();
-    return base || 'Anhedral App';
-}
-export function buildOptions(flags) {
-    return buildOptionsForRoot(flags, process.cwd());
-}
-export function buildOptionsForRoot(flags, root) {
-    const resolvedRoot = path.resolve(root);
-    const projectName = deriveProjectName(resolvedRoot);
-    const displayName = deriveDisplayName(resolvedRoot);
-    if (flags.toolchain != null && !TOOLCHAIN_CHANNELS.includes(flags.toolchain)) {
-        throw new Error(`--toolchain must be one of: ${TOOLCHAIN_CHANNELS.join(', ')}`);
-    }
-    const requestedModules = flags.modules.size === 0
-        ? [...APP_MODULES, ...FEATURE_MODULES]
-        : [...flags.modules];
-    const resolution = resolveModules(requestedModules);
-    return {
-        projectName,
-        displayName,
-        modules: [...resolution.requestedModules],
-        uiComponents: Array.from(new Set(flags.uiComponents)),
-        nativeStyling: flags.nativeStyling ?? 'nativewind',
-        skipInstall: flags.skipInstall === true || env.ANHEDRAL_SKIP_INSTALL === '1',
-        dryRun: flags.dryRun === true,
-        json: flags.json === true,
-        toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
-        rootDirectory: resolvedRoot,
-    };
-}
-export function parseUiAddOptions(args) {
-    const components = [];
-    const targets = [];
-    let skipInstall = env.ANHEDRAL_SKIP_INSTALL === '1';
-    let dryRun = false;
-    let json = false;
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (!token.startsWith('--')) {
-            components.push(...parseUiComponentList(token));
-            continue;
-        }
-        if (token === '--target') {
-            const value = args[index + 1];
-            if (!isUiTarget(value))
-                throw new Error(`--target must be one of: web, mobile, desktop, extension`);
-            targets.push(value);
-            index += 1;
-            continue;
-        }
-        if (token.startsWith('--target=')) {
-            const value = token.slice('--target='.length);
-            if (!isUiTarget(value))
-                throw new Error(`--target must be one of: web, mobile, desktop, extension`);
-            targets.push(value);
-            continue;
-        }
-        if (token === '--skip-install') {
-            skipInstall = true;
-            continue;
-        }
-        if (token === '--dry-run') {
-            dryRun = true;
-            continue;
-        }
-        if (token === '--json') {
-            json = true;
-            continue;
-        }
-        if (token === '--verbose') {
-            continue;
-        }
-        throw new Error(`Unknown UI option: ${token}`);
-    }
-    if (components.length === 0)
-        throw new Error('anhedral ui add requires at least one component');
-    return {
-        components: Array.from(new Set(components)),
-        targets: Array.from(new Set(targets)),
-        skipInstall,
-        dryRun,
-        json,
-    };
-}
-export function buildAddOptions(modules, flags) {
-    const requestedModules = [...modules, ...flags.modules];
-    if (requestedModules.length === 0) {
-        throw new Error('anhedral add requires at least one module');
-    }
-    const normalizedModules = requestedModules.map((moduleName) => {
-        const normalized = normalizeModuleName(moduleName);
-        if (!normalized) {
-            throw new Error(`Unknown module: ${moduleName}`);
-        }
-        return normalized;
-    });
-    return {
-        modules: Array.from(new Set(normalizedModules)),
-        skipInstall: flags.skipInstall === true || env.ANHEDRAL_SKIP_INSTALL === '1',
-        dryRun: flags.dryRun === true,
-        json: flags.json === true,
-        ...((flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN) != null
-            ? { toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN) }
-            : {}),
-    };
-}

package/dist/composers/root.d.ts

@@ -1,6 +0,0 @@
-import type { CompositionModel } from '../architecture/contributions.js';
-export type RootEnvironmentContext = {
-    readonly corsOrigins: readonly string[];
-};
-export declare function composeRootEnvironment(model: CompositionModel, context: RootEnvironmentContext): readonly string[];
-export declare function composeVercelCrons(model: CompositionModel): readonly Record<string, string>[];

package/dist/composers/root.js

@@ -1,35 +0,0 @@
-const ROOT_ENVIRONMENT_ORDER = [
-    'ANHEDRAL_DEMO',
-    'PORT',
-    'TRUST_PROXY_HOPS',
-    'CORS_ORIGINS',
-    'BASE_URL',
-    'DATABASE_URL',
-    'CLERK_PUBLISHABLE_KEY',
-    'CLERK_SECRET_KEY',
-    'RC_WEBHOOK_SECRET',
-    'RC_SECRET_API_KEY',
-    'RC_ENTITLEMENT_ID',
-    'ABLY_API_KEY',
-    'R2_ACCOUNT_ID',
-    'R2_ACCESS_KEY_ID',
-    'R2_SECRET_ACCESS_KEY',
-    'R2_BUCKET_NAME',
-    'R2_PREFIX',
-    'R2_PROXY_READ_URL_TTL_SECONDS',
-    'DESKTOP_UPDATE_BASE_URL',
-    'CLOUDFLARE_API_TOKEN',
-    'CRON_SECRET',
-];
-export function composeRootEnvironment(model, context) {
-    const environment = new Map(model.environment.map((entry) => [entry.name, entry.defaultValue]));
-    return Object.freeze(ROOT_ENVIRONMENT_ORDER.flatMap((name) => {
-        if (!environment.has(name))
-            return [];
-        const value = name === 'CORS_ORIGINS' ? context.corsOrigins.join(',') : environment.get(name);
-        return [`${name}=${value}`];
-    }));
-}
-export function composeVercelCrons(model) {
-    return Object.freeze(model.crons.map(({ path, schedule }) => Object.freeze({ path, schedule })));
-}

package/dist/print.d.ts

@@ -1,8 +0,0 @@
-export declare const anhedralPrint: {
-    banner(message: string): void;
-    section(message: string): void;
-    step(message: string): void;
-    done(message: string): void;
-    info(message: string): void;
-    fail(message: string): void;
-};

package/dist/print.js

@@ -1,48 +0,0 @@
-import { stdout } from 'node:process';
-const USE_COLOR = Boolean(stdout.isTTY) && process.env.NO_COLOR == null;
-function isQuiet() {
-    return process.env.ANHEDRAL_QUIET === '1';
-}
-function paint(code, message) {
-    if (!USE_COLOR)
-        return message;
-    return `\x1b[${code}m${message}\x1b[0m`;
-}
-const dim = (value) => paint('2', value);
-const bold = (value) => paint('1', value);
-const cyan = (value) => paint('36', value);
-const green = (value) => paint('32', value);
-const red = (value) => paint('31', value);
-const magenta = (value) => paint('35', value);
-export const anhedralPrint = {
-    banner(message) {
-        if (isQuiet())
-            return;
-        console.log(`${bold(magenta('>'))} ${bold(message)}\n`);
-    },
-    section(message) {
-        if (isQuiet())
-            return;
-        console.log(`\n${cyan('==')} ${bold(message)}`);
-    },
-    step(message) {
-        if (isQuiet())
-            return;
-        console.log(`  ${cyan('>')} ${message}`);
-    },
-    done(message) {
-        if (isQuiet())
-            return;
-        console.log(`  ${green('ok')} ${message}`);
-    },
-    info(message) {
-        if (isQuiet())
-            return;
-        console.log(`  ${dim(message)}`);
-    },
-    fail(message) {
-        if (isQuiet())
-            return;
-        console.log(`  ${red('x')} ${message}`);
-    },
-};

package/dist/prompts.d.ts

@@ -1,5 +0,0 @@
-export declare function shouldPromptForInitModules(args: readonly string[], isTTY: boolean): boolean;
-export declare function hasUiSelection(args: readonly string[]): boolean;
-export declare function parsePromptModules(input: string, fallback: readonly string[]): string[];
-export declare const DEFAULT_PROMPT_APP_MODULES: readonly ["web", "mobile", "api", "desktop", "extension"];
-export declare const DEFAULT_PROMPT_FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];

package/dist/prompts.js

@@ -1,19 +0,0 @@
-import { APP_MODULES, FEATURE_MODULES, normalizeModuleName } from './cli.js';
-function hasModuleSelection(args) {
-    return args.some((arg) => normalizeModuleName(arg.startsWith('--') ? arg.slice(2) : arg) != null);
-}
-export function shouldPromptForInitModules(args, isTTY) {
-    return isTTY && !args.includes('--json') && !hasModuleSelection(args);
-}
-export function hasUiSelection(args) {
-    return args.some((arg) => arg === '--ui' || arg.startsWith('--ui='));
-}
-export function parsePromptModules(input, fallback) {
-    const tokens = input
-        .split(/[\s,]+/)
-        .map((entry) => entry.trim())
-        .filter(Boolean);
-    return tokens.length > 0 ? tokens : [...fallback];
-}
-export const DEFAULT_PROMPT_APP_MODULES = APP_MODULES;
-export const DEFAULT_PROMPT_FEATURE_MODULES = FEATURE_MODULES;

package/dist/scaffold.d.ts

@@ -1,76 +0,0 @@
-import { type ToolchainChannel } from './toolchain.js';
-import { type ModuleId } from './architecture/index.js';
-import { type NativeStylingLibrary, type UiTarget } from './ui.js';
-export type AppSelections = {
-    web: boolean;
-    mobile: boolean;
-    api: boolean;
-    desktop: boolean;
-    extension: boolean;
-};
-export type FeatureSelections = {
-    database: boolean;
-    auth: boolean;
-    billing: boolean;
-    storage: boolean;
-    nativeSubscriptions: boolean;
-    electronUpdater: boolean;
-};
-export interface InitOptions {
-    projectName: string;
-    displayName: string;
-    modules: ModuleId[];
-    skipInstall: boolean;
-    dryRun: boolean;
-    json: boolean;
-    toolchainChannel: ToolchainChannel;
-    uiComponents?: string[];
-    nativeStyling?: NativeStylingLibrary;
-    /** Destination root. Omit to scaffold the current working directory. */
-    rootDirectory?: string;
-}
-export interface AddOptions {
-    modules: ModuleId[];
-    skipInstall: boolean;
-    dryRun: boolean;
-    json: boolean;
-    toolchainChannel?: ToolchainChannel;
-}
-export interface UiAddOptions {
-    components: string[];
-    targets: UiTarget[];
-    skipInstall: boolean;
-    dryRun: boolean;
-    json: boolean;
-}
-export interface UpgradeOptions {
-    skipInstall: boolean;
-    dryRun: boolean;
-    json: boolean;
-}
-export interface ProjectOptions {
-    projectName: string;
-    displayName: string;
-    apps: AppSelections;
-    features: FeatureSelections;
-    skipInstall?: boolean;
-    nativeStyling?: NativeStylingLibrary;
-}
-export declare function supportsMobileInstallNode(version: string): boolean;
-export type DoctorIssue = {
-    path: string;
-    severity: 'error' | 'warning';
-    message: string;
-};
-export type DoctorReport = {
-    ok: boolean;
-    schemaVersion: number;
-    generatorVersion: string;
-    issues: DoctorIssue[];
-};
-export declare function isSupportedProjectUpgrade(fromVersion: string, toVersion: string): boolean;
-export declare function scaffoldProject(inputOptions: InitOptions): Promise<void>;
-export declare function scaffoldUiComponents(uiOptions: UiAddOptions): Promise<void>;
-export declare function scaffoldUpgradeProject(upgradeOptions: UpgradeOptions): Promise<void>;
-export declare function scaffoldAddModules(addOptions: AddOptions): Promise<void>;
-export declare function doctorProject(): DoctorReport;