create-gtkx 0.21.0 → 1.0.0-rc.1

package/README.md

@@ -0,0 +1,173 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
+</p>
+
+<h1 align="center">GTKX</h1>
+
+<p align="center">
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
+</p>
+
+---
+
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
+
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
+
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+
+```tsx
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
+import { useState } from "react";
+
+const Counter = () => {
+  const [count, setCount] = useState(0);
+
+  return (
+    <GtkApplicationWindow
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
+    >
+      <GtkBox
+        orientation={Gtk.Orientation.VERTICAL}
+        spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
+        valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
+      >
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
+      </GtkBox>
+    </GtkApplicationWindow>
+  );
+};
+
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
+```
+
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
+
+## Why GTKX
+
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
+
+## Quick start
+
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
+cd my-app
+npm run dev
+```
+
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
+
+## Documentation
+
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
+
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
+
+## Requirements
+
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+
+## License
+
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/bin/create-gtkx.js

@@ -1,5 +1,2 @@
 #!/usr/bin/env node
-import { runMain } from "citty";
-import { main } from "../dist/cli.js";
-
-runMain(main);
+import "../dist/cli.js";

package/dist/cli.d.ts

@@ -1,24 +1,2 @@
-export declare const main: import("citty").CommandDef<{
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
-    };
-}>;
+export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;EAQf,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,19 +1,14 @@
-import { createRequire } from "node:module";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { packageVersion } from "@gtkx/utils";
 import { defineCommand, runMain } from "citty";
-import { createCommandArgs, runCreate } from "./command.js";
-const { version } = createRequire(import.meta.url)("../package.json");
-export const main = defineCommand({
+import { createCommand } from "./command.js";
+const version = packageVersion(import.meta.url);
+const main = defineCommand({
+    ...createCommand,
     meta: {
         name: "create-gtkx",
         version,
         description: "Scaffold a new GTKX application",
     },
-    args: createCommandArgs,
-    run: ({ args }) => runCreate(args),
 });
-if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
-    void runMain(main);
-}
+runMain(main);
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;IAC9B,IAAI,EAAE;QACF,IAAI,EAAE,aAAa;QACnB,OAAO;QACP,WAAW,EAAE,iCAAiC;KACjD;IACD,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC;AAEH,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,IAAI,GAAG,aAAa,CAAC;IACvB,GAAG,aAAa;IAChB,IAAI,EAAE;QACF,IAAI,EAAE,aAAa;QACnB,OAAO;QACP,WAAW,EAAE,iCAAiC;KACjD;CACJ,CAAC,CAAC;AAEH,OAAO,CAAC,IAAI,CAAC,CAAC","sourcesContent":["import { packageVersion } from \"@gtkx/utils\";\nimport { defineCommand, runMain } from \"citty\";\nimport { createCommand } from \"./command.js\";\n\nconst version = packageVersion(import.meta.url);\n\nconst main = defineCommand({\n    ...createCommand,\n    meta: {\n        name: \"create-gtkx\",\n        version,\n        description: \"Scaffold a new GTKX application\",\n    },\n});\n\nrunMain(main);\n"]}

package/dist/command.d.ts

@@ -1,65 +1,57 @@
-/** Raw, unparsed command-line arguments accepted by the create command. */
 export type CreateCommandArgs = {
     name?: string | undefined;
     "application-id"?: string | undefined;
-    pm?: string | undefined;
-    testing?: string | undefined;
-    "claude-skills"?: boolean | undefined;
-};
-/**
- * Shared citty argument schema for both the standalone `create-gtkx` binary and
- * the `gtkx create` subcommand.
- */
-export declare const createCommandArgs: {
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
-    };
+    "package-manager"?: string | undefined;
+    typescript?: boolean | undefined;
+    vitest?: boolean | undefined;
+    yes?: boolean | undefined;
+    "no-interactive"?: boolean | undefined;
+    overwrite?: boolean | undefined;
 };
+export declare const runCreate: (args: CreateCommandArgs) => Promise<void>;
 /**
- * Normalize raw create arguments and scaffold the application. Throws on an
- * unknown package manager or testing option before any files are written.
+ * Citty command definition for the CLI `create` subcommand. It declares the
+ * scaffolder's arguments (target name, application ID, package manager,
+ * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the
+ * scaffolder to generate a new GTKX application.
  */
-export declare const runCreate: (args: CreateCommandArgs) => Promise<void>;
-/** The `gtkx create` subcommand: scaffold a new gtkx application. */
 export declare const createCommand: import("citty").CommandDef<{
-    name: {
-        type: "positional";
-        description: string;
-        required: false;
-    };
-    "application-id": {
-        type: "string";
-        description: string;
-    };
-    pm: {
-        type: "string";
-        description: string;
-    };
-    testing: {
-        type: "string";
-        description: string;
-    };
-    "claude-skills": {
-        type: "boolean";
-        description: string;
+    readonly name: {
+        readonly type: "positional";
+        readonly description: "Target directory or project name (e.g. my-app, ., apps/my-app)";
+        readonly required: false;
+    };
+    readonly "application-id": {
+        readonly type: "string";
+        readonly description: "Application ID (e.g., com.example.myapp)";
+    };
+    readonly "package-manager": {
+        readonly type: "string";
+        readonly alias: "pm";
+        readonly description: string;
+    };
+    readonly typescript: {
+        readonly type: "boolean";
+        readonly negativeDescription: "Scaffold the application in JavaScript instead of TypeScript";
+        readonly description: "Scaffold the application in TypeScript";
+    };
+    readonly vitest: {
+        readonly type: "boolean";
+        readonly description: "Include a Vitest testing setup";
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly alias: "y";
+        readonly description: "Skip prompts and accept defaults for unspecified options";
+    };
+    readonly "no-interactive": {
+        readonly type: "boolean";
+        readonly description: "Run without prompts, using the default for every option not passed on the command line (same as --yes)";
+    };
+    readonly overwrite: {
+        readonly type: "boolean";
+        readonly alias: "force";
+        readonly description: "Overwrite the contents of a non-empty target directory when running without prompts";
     };
 }>;
 //# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAWA,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAsBX,CAAC;AAkBpB;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAQrE,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,CAAC;AAUF,eAAO,MAAM,SAAS,SAAgB,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAWrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CxB,CAAC"}

package/dist/command.js

@@ -1,33 +1,6 @@
 import { defineCommand } from "citty";
-import { createApp } from "./create.js";
-import { isKnownPackageManager, isTestingOption, PACKAGE_MANAGER_FLAG_DESCRIPTION, TESTING_FLAG_DESCRIPTION, } from "./options.js";
-/**
- * Shared citty argument schema for both the standalone `create-gtkx` binary and
- * the `gtkx create` subcommand.
- */
-export const createCommandArgs = {
-    name: {
-        type: "positional",
-        description: "Project name",
-        required: false,
-    },
-    "application-id": {
-        type: "string",
-        description: "Application ID (e.g., com.example.myapp)",
-    },
-    pm: {
-        type: "string",
-        description: PACKAGE_MANAGER_FLAG_DESCRIPTION,
-    },
-    testing: {
-        type: "string",
-        description: TESTING_FLAG_DESCRIPTION,
-    },
-    "claude-skills": {
-        type: "boolean",
-        description: "Include Claude Code skills for AI assistance",
-    },
-};
+import { isKnownPackageManager, PACKAGE_MANAGER_FLAG_DESCRIPTION } from "./package-managers.js";
+import { scaffold } from "./scaffolder.js";
 const parsePackageManager = (value) => {
     if (value === undefined)
         return undefined;
@@ -36,34 +9,68 @@ const parsePackageManager = (value) => {
     }
     return value;
 };
-const parseTestingOption = (value) => {
-    if (value === undefined)
-        return undefined;
-    if (!isTestingOption(value)) {
-        throw new Error(`Unknown testing setup "${value}". Expected one of: ${TESTING_FLAG_DESCRIPTION}.`);
-    }
-    return value;
-};
-/**
- * Normalize raw create arguments and scaffold the application. Throws on an
- * unknown package manager or testing option before any files are written.
- */
 export const runCreate = async (args) => {
-    await createApp({
+    const interactive = args["no-interactive"] ? false : args.yes ? false : process.stdin.isTTY === true;
+    await scaffold({
         name: args.name,
         applicationId: args["application-id"],
-        packageManager: parsePackageManager(args.pm),
-        testing: parseTestingOption(args.testing),
-        claudeSkills: args["claude-skills"],
+        packageManager: parsePackageManager(args["package-manager"]),
+        typescript: args.typescript,
+        includeTesting: args.vitest,
+        interactive,
+        overwrite: args.overwrite,
     });
 };
-/** The `gtkx create` subcommand: scaffold a new gtkx application. */
+/**
+ * Citty command definition for the CLI `create` subcommand. It declares the
+ * scaffolder's arguments (target name, application ID, package manager,
+ * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the
+ * scaffolder to generate a new GTKX application.
+ */
 export const createCommand = defineCommand({
     meta: {
         name: "create",
         description: "Create a new GTKX application",
     },
-    args: createCommandArgs,
+    args: {
+        name: {
+            type: "positional",
+            description: "Target directory or project name (e.g. my-app, ., apps/my-app)",
+            required: false,
+        },
+        "application-id": {
+            type: "string",
+            description: "Application ID (e.g., com.example.myapp)",
+        },
+        "package-manager": {
+            type: "string",
+            alias: "pm",
+            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,
+        },
+        typescript: {
+            type: "boolean",
+            negativeDescription: "Scaffold the application in JavaScript instead of TypeScript",
+            description: "Scaffold the application in TypeScript",
+        },
+        vitest: {
+            type: "boolean",
+            description: "Include a Vitest testing setup",
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip prompts and accept defaults for unspecified options",
+        },
+        "no-interactive": {
+            type: "boolean",
+            description: "Run without prompts, using the default for every option not passed on the command line (same as --yes)",
+        },
+        overwrite: {
+            type: "boolean",
+            alias: "force",
+            description: "Overwrite the contents of a non-empty target directory when running without prompts",
+        },
+    },
     run: ({ args }) => runCreate(args),
 });
 //# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,aAAa,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACH,qBAAqB,EACrB,eAAe,EACf,gCAAgC,EAEhC,wBAAwB,GAE3B,MAAM,cAAc,CAAC;AAWtB;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,IAAI,EAAE;QACF,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,KAAK;KAClB;IACD,gBAAgB,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;KAC1D;IACD,EAAE,EAAE;QACA,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gCAAgC;KAChD;IACD,OAAO,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wBAAwB;KACxC;IACD,eAAe,EAAE;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;KAC9D;CACc,CAAC;AAEpB,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAA8B,EAAE;IAClF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,uBAAuB,gCAAgC,GAAG,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAyB,EAA6B,EAAE;IAChF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,uBAAuB,wBAAwB,GAAG,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IACtE,MAAM,SAAS,CAAC;QACZ,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACrC,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;KACtC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC/C;IACD,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAuB,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAa3C,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAA8B,EAAE;IAClF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,uBAAuB,gCAAgC,GAAG,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAuB,EAAiB,EAAE;IACtE,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IACrG,MAAM,QAAQ,CAAC;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACrC,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5D,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,MAAM;QAC3B,WAAW;QACX,SAAS,EAAE,IAAI,CAAC,SAAS;KAC5B,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC/C;IACD,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,KAAK;SAClB;QACD,gBAAgB,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SAC1D;QACD,iBAAiB,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,gCAAgC;SAChD;QACD,UAAU,EAAE;YACR,IAAI,EAAE,SAAS;YACf,mBAAmB,EAAE,8DAA8D;YACnF,WAAW,EAAE,wCAAwC;SACxD;QACD,MAAM,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gCAAgC;SAChD;QACD,GAAG,EAAE;YACD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,0DAA0D;SAC1E;QACD,gBAAgB,EAAE;YACd,IAAI,EAAE,SAAS;YACf,WAAW,EACP,wGAAwG;SAC/G;QACD,SAAS,EAAE;YACP,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,qFAAqF;SACrG;KACJ;IACD,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC","sourcesContent":["import { defineCommand } from \"citty\";\nimport { isKnownPackageManager, PACKAGE_MANAGER_FLAG_DESCRIPTION, type PackageManager } from \"./package-managers.js\";\nimport { scaffold } from \"./scaffolder.js\";\n\nexport type CreateCommandArgs = {\n    name?: string | undefined;\n    \"application-id\"?: string | undefined;\n    \"package-manager\"?: string | undefined;\n    typescript?: boolean | undefined;\n    vitest?: boolean | undefined;\n    yes?: boolean | undefined;\n    \"no-interactive\"?: boolean | undefined;\n    overwrite?: boolean | undefined;\n};\n\nconst parsePackageManager = (value: string | undefined): PackageManager | undefined => {\n    if (value === undefined) return undefined;\n    if (!isKnownPackageManager(value)) {\n        throw new Error(`Unknown package manager \"${value}\". Expected one of: ${PACKAGE_MANAGER_FLAG_DESCRIPTION}.`);\n    }\n    return value;\n};\n\nexport const runCreate = async (args: CreateCommandArgs): Promise<void> => {\n    const interactive = args[\"no-interactive\"] ? false : args.yes ? false : process.stdin.isTTY === true;\n    await scaffold({\n        name: args.name,\n        applicationId: args[\"application-id\"],\n        packageManager: parsePackageManager(args[\"package-manager\"]),\n        typescript: args.typescript,\n        includeTesting: args.vitest,\n        interactive,\n        overwrite: args.overwrite,\n    });\n};\n\n/**\n * Citty command definition for the CLI `create` subcommand. It declares the\n * scaffolder's arguments (target name, application ID, package manager,\n * TypeScript and Vitest toggles, prompt behavior, and overwrite) and runs the\n * scaffolder to generate a new GTKX application.\n */\nexport const createCommand = defineCommand({\n    meta: {\n        name: \"create\",\n        description: \"Create a new GTKX application\",\n    },\n    args: {\n        name: {\n            type: \"positional\",\n            description: \"Target directory or project name (e.g. my-app, ., apps/my-app)\",\n            required: false,\n        },\n        \"application-id\": {\n            type: \"string\",\n            description: \"Application ID (e.g., com.example.myapp)\",\n        },\n        \"package-manager\": {\n            type: \"string\",\n            alias: \"pm\",\n            description: PACKAGE_MANAGER_FLAG_DESCRIPTION,\n        },\n        typescript: {\n            type: \"boolean\",\n            negativeDescription: \"Scaffold the application in JavaScript instead of TypeScript\",\n            description: \"Scaffold the application in TypeScript\",\n        },\n        vitest: {\n            type: \"boolean\",\n            description: \"Include a Vitest testing setup\",\n        },\n        yes: {\n            type: \"boolean\",\n            alias: \"y\",\n            description: \"Skip prompts and accept defaults for unspecified options\",\n        },\n        \"no-interactive\": {\n            type: \"boolean\",\n            description:\n                \"Run without prompts, using the default for every option not passed on the command line (same as --yes)\",\n        },\n        overwrite: {\n            type: \"boolean\",\n            alias: \"force\",\n            description: \"Overwrite the contents of a non-empty target directory when running without prompts\",\n        },\n    },\n    run: ({ args }) => runCreate(args),\n});\n"]}

package/dist/index.d.ts

@@ -1,5 +1,2 @@
-export { createCommand, createCommandArgs, type CreateCommandArgs, runCreate } from "./command.js";
-export { createApp } from "./create.js";
-export { isKnownPackageManager, isTestingOption, type PackageManager, type TestingOption } from "./options.js";
-export type { CreateOptions } from "./scaffolder.js";
+export { createCommand } from "./command.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/G,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,4 +1,2 @@
-export { createCommand, createCommandArgs, runCreate } from "./command.js";
-export { createApp } from "./create.js";
-export { isKnownPackageManager, isTestingOption } from "./options.js";
+export { createCommand } from "./command.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,SAAS,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAA2C,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { createCommand } from \"./command.js\";\n"]}

package/dist/{options.d.ts → package-managers.d.ts}

@@ -1,25 +1,23 @@
-export type TestingOption = "vitest" | "none";
 export declare const PACKAGE_MANAGERS: readonly [{
     readonly value: "pnpm";
     readonly label: "pnpm";
-    readonly runDev: "pnpm dev";
+    readonly devCommand: "pnpm dev";
+    readonly installCommand: "pnpm install";
     readonly recommended: true;
 }, {
     readonly value: "npm";
     readonly label: "npm";
-    readonly runDev: "npm run dev";
+    readonly devCommand: "npm run dev";
+    readonly installCommand: "npm install";
     readonly recommended: false;
 }, {
     readonly value: "yarn";
     readonly label: "yarn";
-    readonly runDev: "yarn dev";
+    readonly devCommand: "yarn dev";
+    readonly installCommand: "yarn install";
     readonly recommended: false;
 }];
 export type PackageManager = (typeof PACKAGE_MANAGERS)[number]["value"];
-export declare const PACKAGE_MANAGER_VALUES: PackageManager[];
 export declare const isKnownPackageManager: (name: string) => name is PackageManager;
-export declare const isTestingOption: (value: string) => value is TestingOption;
 export declare const PACKAGE_MANAGER_FLAG_DESCRIPTION: string;
-export declare const TESTING_FLAG_DESCRIPTION: string;
-export declare const isValidProjectName: (name: string) => boolean;
-//# sourceMappingURL=options.d.ts.map
+//# sourceMappingURL=package-managers.d.ts.map

package/dist/package-managers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-managers.d.ts","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;aACvB,KAAK,EAAE,MAAM;aAAE,KAAK,EAAE,MAAM;aAAE,UAAU,EAAE,UAAU;aAAE,cAAc,EAAE,cAAc;aAAE,WAAW;;aACjG,KAAK,EAAE,KAAK;aAAE,KAAK,EAAE,KAAK;aAAE,UAAU,EAAE,aAAa;aAAE,cAAc,EAAE,aAAa;aAAE,WAAW;;aACjG,KAAK,EAAE,MAAM;aAAE,KAAK,EAAE,MAAM;aAAE,UAAU,EAAE,UAAU;aAAE,cAAc,EAAE,cAAc;aAAE,WAAW;EAC7F,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAIxE,eAAO,MAAM,qBAAqB,SAAU,MAAM,KAAG,IAAI,IAAI,cACN,CAAC;AAExD,eAAO,MAAM,gCAAgC,QAA2D,CAAC"}

package/dist/package-managers.js

@@ -0,0 +1,9 @@
+export const PACKAGE_MANAGERS = [
+    { value: "pnpm", label: "pnpm", devCommand: "pnpm dev", installCommand: "pnpm install", recommended: true },
+    { value: "npm", label: "npm", devCommand: "npm run dev", installCommand: "npm install", recommended: false },
+    { value: "yarn", label: "yarn", devCommand: "yarn dev", installCommand: "yarn install", recommended: false },
+];
+const PACKAGE_MANAGER_VALUES = PACKAGE_MANAGERS.map((manager) => manager.value);
+export const isKnownPackageManager = (name) => PACKAGE_MANAGER_VALUES.includes(name);
+export const PACKAGE_MANAGER_FLAG_DESCRIPTION = `Package manager (${PACKAGE_MANAGER_VALUES.join(", ")})`;
+//# sourceMappingURL=package-managers.js.map

package/dist/package-managers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-managers.js","sourceRoot":"","sources":["../src/package-managers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE;IAC3G,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE;IAC5G,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE;CACtG,CAAC;AAIX,MAAM,sBAAsB,GAAqB,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAA0B,EAAE,CACzE,sBAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAAoB,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC","sourcesContent":["export const PACKAGE_MANAGERS = [\n    { value: \"pnpm\", label: \"pnpm\", devCommand: \"pnpm dev\", installCommand: \"pnpm install\", recommended: true },\n    { value: \"npm\", label: \"npm\", devCommand: \"npm run dev\", installCommand: \"npm install\", recommended: false },\n    { value: \"yarn\", label: \"yarn\", devCommand: \"yarn dev\", installCommand: \"yarn install\", recommended: false },\n] as const;\n\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number][\"value\"];\n\nconst PACKAGE_MANAGER_VALUES: PackageManager[] = PACKAGE_MANAGERS.map((manager) => manager.value);\n\nexport const isKnownPackageManager = (name: string): name is PackageManager =>\n    (PACKAGE_MANAGER_VALUES as string[]).includes(name);\n\nexport const PACKAGE_MANAGER_FLAG_DESCRIPTION = `Package manager (${PACKAGE_MANAGER_VALUES.join(\", \")})`;\n"]}

package/dist/project-name.d.ts

@@ -0,0 +1,2 @@
+export declare const isValidProjectName: (name: string) => boolean;
+//# sourceMappingURL=project-name.d.ts.map

package/dist/project-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.d.ts","sourceRoot":"","sources":["../src/project-name.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,OAAoC,CAAC"}

package/dist/project-name.js

@@ -0,0 +1,2 @@
+export const isValidProjectName = (name) => /^[a-z0-9-]+$/.test(name);
+//# sourceMappingURL=project-name.js.map

package/dist/project-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.js","sourceRoot":"","sources":["../src/project-name.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["export const isValidProjectName = (name: string): boolean => /^[a-z0-9-]+$/.test(name);\n"]}