sparkling-app-cli 2.0.0-rc.2

package/dist/config.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAppConfig = loadAppConfig;
+/// <reference types="node" />
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const url_1 = require("url");
+const module_1 = require("module");
+let registeredTsNode = false;
+const pkgRequire = (0, module_1.createRequire)(__filename);
+function isEsmProject(cwd) {
+    try {
+        let dir = cwd;
+        while (true) {
+            const pkg = path_1.default.join(dir, 'package.json');
+            if (fs_1.default.existsSync(pkg)) {
+                const json = JSON.parse(fs_1.default.readFileSync(pkg, 'utf8'));
+                return json?.type === 'module';
+            }
+            const parent = path_1.default.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // ignore, assume CJS
+    }
+    return false;
+}
+function ensureTsNodeRegistered() {
+    if (registeredTsNode) {
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const tsNode = pkgRequire('ts-node');
+    tsNode.register({
+        transpileOnly: true,
+        compilerOptions: {
+            module: 'commonjs',
+            moduleResolution: 'node',
+            esModuleInterop: true,
+            jsx: 'react-jsx',
+        },
+    });
+    registeredTsNode = true;
+}
+async function loadAppConfig(cwd, configFile = 'app.config.ts') {
+    const configPath = path_1.default.resolve(cwd, configFile);
+    if (!fs_1.default.existsSync(configPath)) {
+        throw new Error(`App config not found at ${configPath}`);
+    }
+    // If the project is ESM, jump straight to the ESM loader path.
+    if (isEsmProject(cwd)) {
+        return loadAppConfigViaEsm(cwd, configPath);
+    }
+    let loaderPath = configPath;
+    if (path_1.default.extname(configPath) === '.ts') {
+        // Create a temporary CommonJS wrapper to load the TS config reliably even in ESM packages
+        const tempDir = path_1.default.resolve(cwd, '.sparkling');
+        fs_1.default.mkdirSync(tempDir, { recursive: true });
+        loaderPath = path_1.default.join(tempDir, 'app.config.cjs');
+        const escaped = path_1.default.resolve(configPath);
+        const content = [
+            'const { register } = require("ts-node");',
+            'register({',
+            '  transpileOnly: true,',
+            '  compilerOptions: {',
+            "    module: 'commonjs',",
+            "    moduleResolution: 'node',",
+            '    esModuleInterop: true,',
+            "    jsx: 'react-jsx',",
+            '  },',
+            '});',
+            `const mod = require(${JSON.stringify(escaped)});`,
+            'module.exports = mod.default ?? mod;',
+        ].join('\n');
+        fs_1.default.writeFileSync(loaderPath, content);
+    }
+    // Try CommonJS require first; if the project is ESM, fall back to an ESM loader
+    try {
+        ensureTsNodeRegistered();
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require(loaderPath);
+        const config = (mod.default ?? mod);
+        if (!config || !config.lynxConfig) {
+            throw new Error(`Invalid AppConfig in ${configPath}: missing lynxConfig`);
+        }
+        return { config, configPath };
+    }
+    catch (err) {
+        // Fallback to ESM loader
+        return loadAppConfigViaEsm(cwd, configPath, err);
+    }
+}
+function loadAppConfigViaEsm(cwd, configPath, originalError) {
+    const tempDir = path_1.default.resolve(cwd, '.sparkling');
+    fs_1.default.mkdirSync(tempDir, { recursive: true });
+    const readerScript = path_1.default.join(tempDir, 'read-app-config.mjs');
+    const fileUrl = (0, url_1.pathToFileURL)(configPath).href;
+    const script = [
+        `const url = ${JSON.stringify(fileUrl)};`,
+        'const mod = await import(url);',
+        'const cfg = (mod.default ?? mod);',
+        'const out = { lynxConfig: cfg.lynxConfig ?? {}, platform: cfg.platform ?? {}, paths: cfg.paths ?? {}, appName: cfg.appName };',
+        'process.stdout.write(JSON.stringify(out));',
+    ].join('\n');
+    fs_1.default.writeFileSync(readerScript, script);
+    // Resolve ts-node/esm loader relative to this package to avoid relying on the app's node_modules
+    const esmReq = pkgRequire;
+    let esmLoader = 'ts-node/esm';
+    try {
+        esmLoader = esmReq.resolve('ts-node/esm');
+    }
+    catch { }
+    const res = (0, child_process_1.spawnSync)('node', ['--loader', esmLoader, readerScript], {
+        cwd,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: process.env,
+    });
+    if (res.status !== 0) {
+        const stderr = res.stderr?.toString('utf8') ?? '';
+        const stdout = res.stdout?.toString('utf8') ?? '';
+        const message = [stderr.trim(), stdout.trim(), originalError ? String(originalError) : '']
+            .filter(Boolean)
+            .join('\n');
+        throw new Error(`Failed to load app config via ESM: ${message}`);
+    }
+    const raw = res.stdout?.toString('utf8') || '{}';
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (jsonErr) {
+        throw new Error(`Failed to parse app config JSON: ${String(jsonErr)}\nRaw: ${raw}`);
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Invalid app config structure: expected an object');
+    }
+    const config = {
+        ...parsed,
+    };
+    if (!config.lynxConfig || typeof config.lynxConfig !== 'object') {
+        config.lynxConfig = {};
+    }
+    return { config: config, configPath };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import type { AppConfig } from './types';
+export type { AppConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAmHzC,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const commander_1 = require("commander");
+const autolink_1 = require("./commands/autolink");
+const build_1 = require("./commands/build");
+const copy_assets_1 = require("./commands/copy-assets");
+const doctor_1 = require("./commands/doctor");
+const run_android_1 = require("./commands/run-android");
+const run_ios_1 = require("./commands/run-ios");
+const ui_1 = require("./utils/ui");
+const verbose_1 = require("./utils/verbose");
+const program = new commander_1.Command();
+program.name('sparkling-cli').description('Sparkling workspace helper CLI');
+program.option('-v, --verbose', 'Enable verbose logging for debugging');
+program.hook('preAction', (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    (0, verbose_1.enableVerboseLogging)(opts.verbose);
+    if ((0, verbose_1.isVerboseEnabled)()) {
+        (0, verbose_1.verboseLog)('Verbose logging enabled');
+    }
+});
+/**
+ * Resolve skipCopy option from --copy and --skip-copy flags
+ * @param opts Command options
+ * @returns Whether to skip copying
+ */
+function resolveSkipCopy(opts) {
+    // If --copy is explicitly set, don't skip
+    if (opts.copy)
+        return false;
+    // If --skip-copy is explicitly set, skip
+    if (opts.skipCopy)
+        return true;
+    // Default: skip copy (recommended for development)
+    return true;
+}
+program
+    .command('build')
+    .description('Build Lynx bundle using app.config.ts (no-copy by default)')
+    .option('--config <path>', 'Path to app.config.ts', 'app.config.ts')
+    .option('--copy', 'Copy assets to native shells')
+    .option('--skip-copy', 'Skip copying assets to native shells')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    const skipCopy = resolveSkipCopy(opts);
+    await (0, build_1.buildProject)({ cwd, configFile: opts.config, skipCopy });
+});
+program
+    .command('copy-assets')
+    .description('Copy dist assets into Android/iOS resource locations')
+    .option('--source <path>', 'Path to compiled assets', 'dist')
+    .option('--android-dest <path>', 'Android asset destination', 'android/app/src/main/assets')
+    .option('--ios-dest <path>', 'iOS asset destination', 'ios/SparklingGo/SparklingGo/Resources/Assets')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    await (0, copy_assets_1.copyAssets)({
+        cwd,
+        source: opts.source,
+        androidDest: opts.androidDest,
+        iosDest: opts.iosDest,
+    });
+});
+program
+    .command('autolink')
+    .description('Autolink Sparkling method modules for Android and iOS')
+    .option('--platform <platform>', 'Platform to autolink: android|ios|all', 'all')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    const raw = String(opts.platform ?? 'all').toLowerCase();
+    const allowed = ['android', 'ios', 'all'];
+    const platform = (allowed.includes(raw) ? raw : 'all');
+    if (!allowed.includes(raw)) {
+        console.warn(ui_1.ui.warn(`Unknown platform "${opts.platform}", defaulting to 'all'.`));
+    }
+    await (0, autolink_1.autolink)({ cwd, platform });
+});
+program
+    .command('run:android')
+    .description('Build Lynx bundle, copy assets, and install Android debug build')
+    .option('--copy', 'Copy assets to native shells')
+    .option('--skip-copy', 'Skip copying assets to native shells')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    const skipCopy = resolveSkipCopy(opts);
+    await (0, run_android_1.runAndroid)({ cwd, skipCopy });
+});
+program
+    .command('run:ios')
+    .description('Build Lynx bundle, copy assets, and launch iOS simulator build')
+    .option('--copy', 'Copy assets to native shells')
+    .option('--skip-copy', 'Skip copying assets to native shells')
+    .option('--device <nameOrId>', 'Simulator name or UDID to run')
+    .option('--skip-pod-install', 'Skip running pod install before building iOS')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    const skipCopy = resolveSkipCopy(opts);
+    await (0, run_ios_1.runIos)({
+        cwd,
+        skipCopy,
+        device: opts.device,
+        skipPodInstall: opts.skipPodInstall,
+    });
+});
+program
+    .command('doctor')
+    .description('Check if your environment is ready to build a Sparkling app')
+    .option('--platform <platform>', 'Platform to check: android|ios|all', 'all')
+    .action(async (opts) => {
+    const raw = String(opts.platform ?? 'all').toLowerCase();
+    const allowed = ['android', 'ios', 'all'];
+    const platform = (allowed.includes(raw) ? raw : 'all');
+    if (!allowed.includes(raw)) {
+        console.warn(ui_1.ui.warn(`Unknown platform "${opts.platform}", defaulting to 'all'.`));
+    }
+    await (0, doctor_1.doctor)({ platform });
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export interface PlatformConfig {
+    android?: {
+        packageName?: string;
+    };
+    ios?: {
+        bundleIdentifier?: string;
+        simulator?: string;
+    };
+}
+export type LynxConfig = unknown;
+export interface RouterEntry {
+    path: string;
+}
+export interface RouterConfig {
+    main?: RouterEntry;
+    [name: string]: RouterEntry | undefined;
+}
+export interface SplashScreenPluginConfig {
+    backgroundColor?: string;
+    image?: string;
+    imageWidth?: number;
+    dark?: {
+        image?: string;
+        backgroundColor?: string;
+    };
+}
+export type PluginConfig = ['splash-screen', SplashScreenPluginConfig] | [string, Record<string, unknown>?];
+export interface AppConfig {
+    lynxConfig: LynxConfig;
+    appName?: string;
+    platform?: PlatformConfig;
+    paths?: {
+        androidAssets?: string;
+        iosAssets?: string;
+    };
+    appIcon?: string;
+    router?: RouterConfig;
+    plugin?: PluginConfig[];
+}
+export interface MethodModuleConfig {
+    name: string;
+    root: string;
+    android?: {
+        packageName?: string;
+        className?: string;
+        projectDir?: string;
+        buildGradle?: string;
+    };
+    ios?: {
+        moduleName?: string;
+        className?: string;
+        podspecPath?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GACpB,CAAC,eAAe,EAAE,wBAAwB,CAAC,GAC3C,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH"}

package/dist/types.js

@@ -0,0 +1,8 @@
+"use strict";
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+// Avoid hard dependency on external type packages in library types; 
+// use a minimal alias for Lynx config shape.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,yEAAyE;AACzE,0DAA0D;AAC1D,qEAAqE;AACrE,6CAA6C"}

package/dist/utils/exec.d.ts

@@ -0,0 +1,7 @@
+export interface RunCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    ignoreFailure?: boolean;
+}
+export declare function runCommand(command: string, args: string[], options?: RunCommandOptions): Promise<void>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/utils/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/utils/exec.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommand = runCommand;
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const node_child_process_1 = require("node:child_process");
+const verbose_1 = require("./verbose");
+async function runCommand(command, args, options = {}) {
+    if ((0, verbose_1.isVerboseEnabled)()) {
+        const envKeys = Object.keys(options.env ?? {});
+        const cwd = options.cwd ?? process.cwd();
+        const envLabel = envKeys.length ? ` env:${envKeys.join(',')}` : '';
+        (0, verbose_1.verboseLog)(`Running "${command} ${args.join(' ')}" (cwd: ${cwd})${envLabel}`);
+    }
+    const child = (0, node_child_process_1.spawn)(command, args, {
+        cwd: options.cwd,
+        env: { ...process.env, ...options.env },
+        stdio: 'inherit',
+        shell: false,
+    });
+    await new Promise((resolve, reject) => {
+        child.on('error', reject);
+        child.on('close', code => {
+            if ((0, verbose_1.isVerboseEnabled)()) {
+                (0, verbose_1.verboseLog)(`${command} exited with code ${code ?? 0}`);
+            }
+            if (code && !options.ignoreFailure) {
+                reject(new Error(`${command} exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":";;AAYA,gCAgCC;AA5CD,sCAAsC;AACtC,yEAAyE;AACzE,0DAA0D;AAC1D,2DAA2C;AAC3C,uCAAyD;AAQlD,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,IAAc,EACd,UAA6B,EAAE;IAE/B,IAAI,IAAA,0BAAgB,GAAE,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,IAAA,oBAAU,EAAC,YAAY,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;QACjC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;YACvB,IAAI,IAAA,0BAAgB,GAAE,EAAE,CAAC;gBACvB,IAAA,oBAAU,EAAC,GAAG,OAAO,qBAAqB,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzD,OAAO;YACT,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Resolve a project path from the current working directory
+ * @param cwd - Current working directory
+ * @param segments - Path segments to join
+ * @returns Resolved absolute path
+ * @throws Error if cwd is empty
+ */
+export declare function resolveProjectPath(cwd: string, ...segments: string[]): string;
+/**
+ * Convert a path to POSIX format (forward slashes)
+ * @param p - Path to convert
+ * @returns POSIX-style path
+ */
+export declare function toPosixPath(p: string): string;
+/**
+ * Get relative path from one location to another in POSIX format
+ * @param from - Source path
+ * @param to - Target path
+ * @returns Relative path in POSIX format
+ */
+export declare function relativeTo(from: string, to: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/dist/utils/paths.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProjectPath = resolveProjectPath;
+exports.toPosixPath = toPosixPath;
+exports.relativeTo = relativeTo;
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Resolve a project path from the current working directory
+ * @param cwd - Current working directory
+ * @param segments - Path segments to join
+ * @returns Resolved absolute path
+ * @throws Error if cwd is empty
+ */
+function resolveProjectPath(cwd, ...segments) {
+    if (!cwd || typeof cwd !== 'string') {
+        throw new Error('cwd must be a non-empty string');
+    }
+    // Filter out empty segments
+    const validSegments = segments.filter(s => s && typeof s === 'string');
+    return node_path_1.default.resolve(cwd, ...validSegments);
+}
+/**
+ * Convert a path to POSIX format (forward slashes)
+ * @param p - Path to convert
+ * @returns POSIX-style path
+ */
+function toPosixPath(p) {
+    if (!p || typeof p !== 'string') {
+        return '';
+    }
+    return p.split(node_path_1.default.sep).join('/');
+}
+/**
+ * Get relative path from one location to another in POSIX format
+ * @param from - Source path
+ * @param to - Target path
+ * @returns Relative path in POSIX format
+ */
+function relativeTo(from, to) {
+    if (!from || typeof from !== 'string') {
+        return toPosixPath(to || '');
+    }
+    if (!to || typeof to !== 'string') {
+        return '';
+    }
+    return toPosixPath(node_path_1.default.relative(from, to));
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":";;;;;AAYA,gDAOC;AAOD,kCAKC;AAQD,gCAQC;AA/CD,sCAAsC;AACtC,yEAAyE;AACzE,0DAA0D;AAC1D,0DAA6B;AAE7B;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,GAAW,EAAE,GAAG,QAAkB;IACnE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,4BAA4B;IAC5B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACvE,OAAO,mBAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC,mBAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,EAAU;IACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,WAAW,CAAC,mBAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/utils/ui.d.ts

@@ -0,0 +1,12 @@
+export declare const ui: {
+    headline: (msg: string) => string;
+    success: (msg: string) => string;
+    warn: (msg: string) => string;
+    error: (msg: string) => string;
+    info: (msg: string) => string;
+    muted: (msg: string) => string;
+    tipLabel: string;
+    tip: (msg: string) => string;
+    prompt: (msg: string) => string;
+};
+//# sourceMappingURL=ui.d.ts.map

package/dist/utils/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AA0EA,eAAO,MAAM,EAAE;oBACG,MAAM;mBACP,MAAM;gBACT,MAAM;iBACL,MAAM;gBACP,MAAM;iBACL,MAAM;;eAER,MAAM;kBACH,MAAM;CACrB,CAAC"}

package/dist/utils/ui.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ui = void 0;
+// Copyright (c) 2025 TikTok Pte. Ltd.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+const DEFAULT_CONFIG = {
+    labels: { tip: 'Tip' },
+    colors: {
+        headline: 'cyan',
+        success: 'green',
+        warn: 'yellow',
+        error: 'red',
+        // Use blue for info to improve contrast on light themes
+        info: 'blue',
+        // Use dim for muted text to avoid low-contrast gray on light themes
+        muted: 'dim',
+        tipLabel: 'cyan',
+        tipText: 'blue',
+        promptLabel: 'blue',
+        promptText: 'blue',
+    },
+};
+const colorFns = {
+    cyan: chalk_1.default.cyan,
+    green: chalk_1.default.green,
+    yellow: chalk_1.default.yellow,
+    red: chalk_1.default.red,
+    white: chalk_1.default.white,
+    gray: chalk_1.default.gray,
+    grey: chalk_1.default.grey,
+    magenta: chalk_1.default.magenta,
+    blue: chalk_1.default.blue,
+};
+function loadUiConfig() {
+    const candidate = node_path_1.default.join(process.cwd(), 'packages', 'common', 'cli-style.config.json');
+    if (node_fs_1.default.existsSync(candidate)) {
+        try {
+            const parsed = JSON.parse(node_fs_1.default.readFileSync(candidate, 'utf8'));
+            return parsed;
+        }
+        catch {
+            // ignore parse errors, fall back to defaults
+        }
+    }
+    return {};
+}
+const cfg = loadUiConfig();
+const palette = { ...DEFAULT_CONFIG.colors, ...(cfg.colors ?? {}) };
+const labels = { ...DEFAULT_CONFIG.labels, ...(cfg.labels ?? {}) };
+function paint(msg, colorName, bold = false) {
+    const key = colorName?.toLowerCase();
+    if (key === 'none' || key === 'default' || key === 'reset') {
+        return bold ? chalk_1.default.bold(msg) : msg;
+    }
+    if (key === 'dim') {
+        const styled = chalk_1.default.dim(msg);
+        return bold ? chalk_1.default.bold(styled) : styled;
+    }
+    const fn = key ? colorFns[key] : undefined;
+    const colored = fn ? fn(msg) : msg;
+    return bold ? chalk_1.default.bold(colored) : colored;
+}
+exports.ui = {
+    headline: (msg) => paint(msg, palette.headline, true),
+    success: (msg) => paint(msg, palette.success, true),
+    warn: (msg) => paint(msg, palette.warn, true),
+    error: (msg) => paint(msg, palette.error, true),
+    info: (msg) => paint(msg, palette.info, false),
+    muted: (msg) => paint(msg, palette.muted, false),
+    tipLabel: paint(labels.tip ?? 'TIP', palette.tipLabel, true),
+    tip: (msg) => `${paint(labels.tip ?? 'TIP', palette.tipLabel, true)} ${paint(msg, palette.tipText, true)}`,
+    prompt: (msg) => paint(msg, palette.promptText ?? palette.promptLabel ?? palette.info, true),
+};
+//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

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

package/dist/utils/verbose.d.ts

@@ -0,0 +1,4 @@
+export declare function isVerboseEnabled(): boolean;
+export declare function enableVerboseLogging(enabled?: boolean): void;
+export declare function verboseLog(message: string): void;
+//# sourceMappingURL=verbose.d.ts.map

package/dist/utils/verbose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose.d.ts","sourceRoot":"","sources":["../../src/utils/verbose.ts"],"names":[],"mappings":"AAMA,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAK5D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIhD"}