@gjsify/cli 0.3.21 → 0.4.0

package/src/index.ts

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import yargs from 'yargs'
-import { hideBin } from 'yargs/helpers'
-
-import {
-    buildCommand as build,
-    runCommand as run,
-    infoCommand as info,
-    checkCommand as check,
-    showcaseCommand as showcase,
-    createCommand as create,
-    gresourceCommand as gresource,
-    gettextCommand as gettext,
-    gsettingsCommand as gsettings,
-    flatpakCommand as flatpak,
-    dlxCommand as dlx,
-    installCommand as install,
-} from './commands/index.js'
-import { APP_NAME } from './constants.js'
-
-void yargs(hideBin(process.argv))
-    .scriptName(APP_NAME)
-    .strict()
-    .command(create.command, create.description, create.builder, create.handler)
-    .command(install.command, install.description, install.builder, install.handler)
-    .command(build.command, build.description, build.builder, build.handler)
-    .command(run.command, run.description, run.builder, run.handler)
-    .command(dlx.command, dlx.description, dlx.builder, dlx.handler)
-    .command(info.command, info.description, info.builder, info.handler)
-    .command(check.command, check.description, check.builder, check.handler)
-    .command(showcase.command, showcase.description, showcase.builder, showcase.handler)
-    .command(gresource.command, gresource.description, gresource.builder, gresource.handler)
-    .command(gettext.command, gettext.description, gettext.builder, gettext.handler)
-    .command(gsettings.command, gsettings.description, gsettings.builder, gsettings.handler)
-    .command(flatpak.command, flatpak.description, flatpak.builder, flatpak.handler)
-    .demandCommand(1)
-    .help().argv

package/src/types/cli-build-options.ts

@@ -1,100 +0,0 @@
-import type { App } from '@gjsify/rolldown-plugin-gjsify';
-
-export interface CliBuildOptions {
-  /**
-   * This is an array of files that each serve as an input to the bundling algorithm.
-   * @see https://esbuild.github.io/api/#entry-points
-   */
-  entryPoints?: string[];
-  /** Switch on the verbose mode */
-  verbose?: boolean;
-  /**
-   * When enabled, the generated code will be minified instead of pretty-printed.
-   * @see https://esbuild.github.io/api/#minify
-   */
-  minify?: boolean;
-  /**
-   * Override the default output format.
-   * @see https://esbuild.github.io/api/#format
-   */
-  format?: 'iife' | 'esm' | 'cjs';
-  /** Use this if you want to build an application or test, the platform node is usually only used internally to build the tests for Gjsify */
-  app?: App;
-  /** Use this if you want to build a library for Gjsify */
-  library?: boolean;
-  /**
-   * This option sets the output file name for the build operation.
-   * This is only applicable if there is a single entry point.
-   * If there are multiple entry points, you must use the outdir option instead to specify an output directory.
-   * @see https://esbuild.github.io/api/#outfile
-   */
-  outfile?: string;
-  /**
-   * This option sets the output directory for the build operation.
-   * @see https://esbuild.github.io/api/#outdir
-   */
-  outdir?: string;
-  /** Enables TypeScript types on runtime using Deepkit's type compiler */
-  reflection?: boolean;
-  /**
-   * The log level can be changed to prevent esbuild from printing warning and/or error messages to the terminal
-   * @see https://esbuild.github.io/api/#log-level
-   */
-  logLevel: 'silent' | 'error' | 'warning' | 'info' | 'debug' | 'verbose';
-  /** An array of glob patterns to exclude matches and aliases */
-  exclude?: string[];
-  /**
-   * Inject a console shim into GJS builds for clean output (no GLib prefix, ANSI colors work).
-   * Use --no-console-shim to disable. Only applies to GJS app builds. Default: true.
-   */
-  consoleShim?: boolean;
-  /**
-   * Comma-separated list of global identifiers your code needs (e.g.
-   * `"fetch,Buffer,process,URL,crypto"`). Each identifier is mapped to the
-   * corresponding `@gjsify/<pkg>/register` module and injected into the
-   * bundle. Only applies to GJS app builds.
-   */
-  globals?: string;
-  /**
-   * Prepend a `#!/usr/bin/env -S gjs -m` shebang to the output file and mark
-   * it executable (chmod 755). Only applies to GJS app builds with a single
-   * `--outfile`. Default: false.
-   */
-  shebang?: boolean;
-  /**
-   * Module names that should NOT be bundled. Each name remains as a literal
-   * `import`/`require` in the output and is resolved by the runtime against
-   * its own `node_modules` (or equivalent) at execution time.
-   *
-   * Repeat the flag or pass a comma-separated value:
-   * `--external typedoc,prettier --external typescript`. Glob-style wildcards
-   * (`@inquirer/*`, `lodash-*`) are forwarded as-is to esbuild.
-   *
-   * @see https://esbuild.github.io/api/#external
-   */
-  external?: string[];
-  /**
-   * Substitute compile-time constants in the bundle. Each entry is a
-   * `KEY=VALUE` pair where `VALUE` is an arbitrary JS expression — string
-   * literals must be quoted (`--define VERSION='"1.2.3"'`). Useful for
-   * upstream packages that read a build-time constant via
-   * `typeof __FOO__ !== 'undefined'`.
-   *
-   * @see https://esbuild.github.io/api/#define
-   */
-  define?: string[];
-  /**
-   * Map module specifiers to alternative targets at bundle time. Each entry
-   * is `FROM=TO` where `FROM` is the imported package name and `TO` is the
-   * substitute (typically `@gjsify/empty` to drop a heavy dep that the test
-   * scenario never executes). Layered on top of the built-in alias map.
-   */
-  alias?: string[];
-  /**
-   * Comma-separated global identifiers to remove from the auto-detected set.
-   * Useful for false positives from dead browser-compat code in npm deps
-   * whose polyfills require unavailable native libraries.
-   * Example: `--exclude-globals fetch,XMLHttpRequest`
-   */
-  excludeGlobals?: string[];
-}

package/src/types/command.ts

@@ -1,10 +0,0 @@
-import type { ArgumentsCamelCase, MiddlewareFunction, BuilderCallback } from 'yargs';
-
-export interface Command <T = any, U = T> {
-    command: string | ReadonlyArray<string>,
-    description: string,
-    builder?: BuilderCallback<T, U>,
-    handler?: (args: ArgumentsCamelCase<U>) => void | Promise<void>,
-    middlewares?: MiddlewareFunction[],
-    deprecated?: boolean | string,
-}

package/src/types/config-data-library.ts

@@ -1,5 +0,0 @@
-import type { PackageJson } from 'pkg-types';
-
-export interface ConfigDataLibrary extends PackageJson {
-
-}

package/src/types/config-data-typescript.ts

@@ -1,6 +0,0 @@
-import type { TsConfigJsonResolved } from 'get-tsconfig';
-
-export interface ConfigDataTypescript extends TsConfigJsonResolved {
-    /** Enables TypeScript types on runtime using Deepkit's type compiler */
-    reflection?: boolean;
-}

package/src/types/config-data.ts

@@ -1,225 +0,0 @@
-import type { RolldownOptions, OutputOptions, RolldownPluginOption } from 'rolldown';
-import type { ConfigDataLibrary, ConfigDataTypescript } from './index.js';
-
-/**
- * Plugin entry resolvable by package name from the project's `node_modules`.
- * Lets users describe the plugin chain in `package.json#gjsify` without
- * dropping to a JS-form config file. The CLI imports the named module,
- * picks the chosen export (defaults to `default`), and calls it with
- * `options`.
- *
- * Example:
- * ```jsonc
- * { "name": "@gjsify/vite-plugin-blueprint", "options": { "minify": true } }
- * { "name": "@gjsify/vite-plugin-gettext", "export": "msgfmtPlugin", "options": { ... } }
- * ```
- */
-export interface BundlerPluginByName {
-    name: string;
-    export?: string;
-    options?: unknown;
-}
-
-/**
- * Subset of `RolldownOptions` accepted in `.gjsifyrc.js`. Mirrors the legacy
- * `esbuild?: BuildOptions` field — a thin pass-through. The orchestrator
- * applies platform defaults on top of these, so most projects only need
- * `output.file` / `output.dir` here.
- *
- * `output` is constrained to a single `OutputOptions` object (Rolldown also
- * accepts an array for multi-output builds, but the CLI surface targets the
- * single-output use case).
- *
- * `plugins` is widened to also accept `BundlerPluginByName` entries — these
- * are resolved by the CLI from the project's `node_modules` before the
- * Rolldown call.
- */
-export type BundlerOptions = Omit<RolldownOptions, 'output' | 'plugins'> & {
-    output?: OutputOptions;
-    plugins?: Array<RolldownPluginOption | BundlerPluginByName>;
-};
-
-/**
- * Legacy `esbuild?: BuildOptions` shape — kept as a compatibility shim for
- * one minor release. Setting it logs a deprecation warning; the supported
- * subset of fields is mapped into `bundler` at config-load time.
- *
- * Drop in 0.5.0.
- */
-export interface LegacyEsbuildOptions {
-    outfile?: string;
-    outdir?: string;
-    format?: 'esm' | 'cjs' | 'iife';
-    external?: string[];
-    define?: Record<string, string>;
-    inject?: string[];
-    banner?: { js?: string };
-    target?: string | string[];
-    minify?: boolean;
-    sourcemap?: boolean | 'inline' | 'external' | 'both';
-    mainFields?: string[];
-    conditions?: string[];
-    platform?: 'browser' | 'node' | 'neutral';
-    loader?: Record<string, string>;
-}
-
-export interface ConfigData {
-    /** Switch on the verbose mode */
-    verbose?: boolean;
-    /**
-     * Bundler-level options forwarded to Rolldown. Replaces the legacy
-     * `esbuild` field. The orchestrator applies platform-specific defaults
-     * on top — most projects only need to set `output.file` / `output.dir`.
-     */
-    bundler?: BundlerOptions;
-    /**
-     * @deprecated Use `bundler` instead. Will be removed in 0.5.0. The shim
-     * maps the supported subset of esbuild fields into the equivalent
-     * Rolldown shape and logs a deprecation warning.
-     */
-    esbuild?: LegacyEsbuildOptions;
-    library?: ConfigDataLibrary;
-    typescript?: ConfigDataTypescript;
-    /** An array of glob patterns to exclude matches and aliases */
-    exclude?: string[];
-    /**
-     * Inject a console shim into GJS builds for clean output (no GLib prefix, ANSI colors work).
-     * Only applies to GJS app builds. Default: true.
-     */
-    consoleShim?: boolean;
-    /**
-     * Comma-separated list of global identifiers to register in the bundle.
-     * See CliBuildOptions for format.
-     */
-    globals?: string;
-    /**
-     * Prepend a shebang to the output bundle and mark it executable.
-     *
-     *   `true`  → use the default `#!/usr/bin/env -S gjs -m` line
-     *   `false` → no shebang (default)
-     *   `"…"`   → custom line. Supports `${env:NAME}` and `${env:NAME:-default}`
-     *             placeholders against `process.env`. The leading `#!` is
-     *             added automatically if omitted. Useful when an outer
-     *             build tool (Meson, Flatpak) exports the GJS interpreter
-     *             path as `GJS_CONSOLE` (e.g. `/usr/bin/gjs-console`).
-     *
-     * Example: `"shebang": "${env:GJS_CONSOLE:-/usr/bin/env -S gjs} -m"`
-     *
-     * See also `CliBuildOptions.shebang`.
-     */
-    shebang?: boolean | string;
-    /**
-     * Extra module aliases layered on top of the built-in alias map.
-     * Comes from `gjsify build --alias FROM=TO`.
-     */
-    aliases?: Record<string, string>;
-    /**
-     * Global identifiers to remove from the auto-detected set before writing
-     * the inject stub. Useful for false positives from dead browser-compat
-     * code in npm dependencies whose polyfills require unavailable native libs.
-     * Example: `["fetch", "XMLHttpRequest"]` excludes the HTTP polyfill stack.
-     */
-    excludeGlobals?: string[];
-    /**
-     * Compile-time defines populated from `package.json` fields. Each entry
-     * maps a JS identifier (the define key) to a dotted package.json path.
-     * Values are JSON-stringified before merging into `bundler.transform.define`.
-     *
-     * Example:
-     * ```jsonc
-     * "defineFromPackageJson": {
-     *   "__PACKAGE_VERSION__": { "field": "version" },
-     *   "__PACKAGE_NAME__":    { "field": "name" }
-     * }
-     * ```
-     *
-     * Replaces the wrapper-script pattern (`spawnSync('gjsify', ['build',
-     * '--define', '__VERSION__=' + JSON.stringify(pkg.version)])`) used by
-     * `@ts-for-gir/cli` before this option existed.
-     */
-    defineFromPackageJson?: Record<string, { field: string }>;
-    /**
-     * Compile-time defines populated from `process.env` at config-load time.
-     * Each entry maps a JS identifier to an environment variable name with an
-     * optional default. Values are JSON-stringified before merging into
-     * `bundler.transform.define`. When the variable is unset and no default
-     * is provided, the identifier is replaced with the literal `undefined`
-     * so consumer code can safely guard with `typeof X === 'undefined'` or
-     * `X ?? fallback`.
-     *
-     * Example:
-     * ```jsonc
-     * "defineFromEnv": {
-     *   "__APPLICATION_ID__": { "env": "APPLICATION_ID", "default": "org.example.App" },
-     *   "__PREFIX__":         { "env": "PREFIX" }
-     * }
-     * ```
-     *
-     * Designed for projects whose build is driven by an outer tool (Meson,
-     * Make, CI) that exports environment variables — avoids a wrapper script
-     * just to thread them through to the bundler.
-     */
-    defineFromEnv?: Record<string, { env: string; default?: string }>;
-    /**
-     * Extension → loader-kind map for files Rolldown does not classify
-     * natively. Currently only `'text'` is implemented — the file's content
-     * becomes the JS string default export (`export default "<content>"`).
-     * Replaces the legacy esbuild `loader: { '.ui': 'text' }` pattern.
-     *
-     * Example:
-     * ```jsonc
-     * "loaders": { ".ui": "text", ".asm": "text" }
-     * ```
-     *
-     * Lives at the top level (not under `bundler`) so it doesn't leak into
-     * Rolldown's options on pass-through; the CLI converts it into a
-     * `text-loader` plugin prepended to the bundler's plugin chain.
-     */
-    loaders?: Record<string, 'text'>;
-    /**
-     * Flatpak-related configuration consumed by `gjsify flatpak <sub>`.
-     * Lives in its own top-level namespace so the bundler config doesn't
-     * accumulate concerns and `flatpak init` / `flatpak ci` can read defaults
-     * declaratively. CLI flags override these values.
-     */
-    flatpak?: ConfigDataFlatpak;
-}
-
-/**
- * Flatpak-toolchain config consumed by the `gjsify flatpak` subcommand
- * group. All fields optional — sensible defaults apply when missing.
- */
-export interface ConfigDataFlatpak {
-    /** Reverse-DNS app id, e.g. `eu.jumplink.Learn6502`. Defaults to `package.json#name` if it looks like a reverse-DNS id. */
-    appId?: string;
-    /**
-     * Runtime family. Default `'gnome'` — needed at runtime by GJS bundles
-     * for GLib/GObject/GIO. `'freedesktop'` is only suitable for non-gjsify
-     * CLI tools (no GJS interpreter ships in the Freedesktop runtime).
-     */
-    runtime?: 'gnome' | 'freedesktop';
-    /** Runtime/SDK version, e.g. `'50'` for GNOME or `'24.08'` for Freedesktop. */
-    runtimeVersion?: string;
-    /** Extra SDK extensions, e.g. `['org.freedesktop.Sdk.Extension.node24']` for build-time `yarn install`. */
-    sdkExtensions?: string[];
-    /** Path components prepended to PATH inside the build sandbox. */
-    appendPath?: string[];
-    /** The binary name to run (`/app/bin/<command>`). Defaults to `appId`. */
-    command?: string;
-    /** Finish-args (capabilities). Default depends on `runtime` + `--cli-only`. */
-    finishArgs?: string[];
-    /** Extra Flatpak modules prepended before the app's own meson/simple module (e.g. `blueprint-compiler` build). */
-    extraModules?: unknown[];
-    /** Cleanup glob patterns applied to the final manifest, e.g. `['/include', '/lib/pkgconfig']`. */
-    cleanup?: string[];
-    /** Source-of-truth lockfile for `gjsify flatpak deps` — `yarn.lock` or `package-lock.json`. */
-    lockfile?: string;
-    /**
-     * GitHub-Actions container image override for `gjsify flatpak ci`.
-     * Default derived from runtime + runtimeVersion:
-     *   gnome+50 → `ghcr.io/flathub-infra/flatpak-github-actions:gnome-50`
-     */
-    ciContainer?: string;
-    /** Branches the generated workflow triggers on. Default `['main']`. */
-    ciBranches?: string[];
-}

package/src/types/cosmiconfig-result.ts

@@ -1,5 +0,0 @@
-export type CosmiconfigResult<C = any> = {
-    config: C;
-    filepath: string;
-    isEmpty?: boolean;
-} | null;

package/src/types/index.ts

@@ -1,6 +0,0 @@
-export * from './cli-build-options.js';
-export * from './command.js';
-export * from './config-data-library.js';
-export * from './config-data-typescript.js';
-export * from './config-data.js';
-export * from './cosmiconfig-result.js';