create-parlor 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cychien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# create-parlor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Create a [Parlor](https://cychien.github.io/parlor) app: actions, a page, and an agent sidebar that drives your own coding agent.
+
+```sh
+pnpm create parlor my-app
+npm create parlor@latest my-app
+yarn create parlor my-app
+bun create parlor my-app
+```
+
+It asks only for the name. `--yes` never prompts; `--no-install`, `--no-git`, `--package-manager <npm|pnpm|yarn|bun>`, `--add auth` and `--dry-run` change the defaults. The first action in the app it creates:
+
+```ts
+import { defineAction } from "@parlor/core";
+import { z } from "zod";
+
+export const addTodo = defineAction({
+  description: "Add a todo.",
+  input: z.object({ title: z.string().trim().min(1) }),
+  writes: ["todos"],
+  run: ({ title }) => ({ title, done: false }),
+});
+```
+
+Docs: https://cychien.github.io/parlor/getting-started/

package/dist/args.d.ts

@@ -0,0 +1,22 @@
+import { type AddonName, type PackageManagerName } from "@parlor/scaffold";
+export declare const DEFAULT_DIRECTORY = "my-parlor-app";
+export interface CreateRequest {
+    readonly directory: string | undefined;
+    readonly yes: boolean;
+    readonly install: boolean;
+    readonly git: boolean;
+    readonly packageManager: PackageManagerName | undefined;
+    readonly addons: readonly AddonName[];
+    readonly dryRun: boolean;
+    readonly help: boolean;
+    readonly version: boolean;
+}
+export declare const USAGE: string;
+/** npm 7+ passes a lone `--` through to the initializer; it is dropped like create-astro does. */
+export declare function parseCreateArgs(argv: readonly string[]): CreateRequest;
+export declare function canPrompt(stdin: {
+    readonly isTTY?: boolean;
+}, stdout: {
+    readonly isTTY?: boolean;
+}, env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAId,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,KAAK,QAS8B,CAAC;AAEjD,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CA8CtE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EACnC,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EACpC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAET"}

package/dist/args.js

@@ -0,0 +1,59 @@
+import { parseArgs } from "node:util";
+import { ADDON_NAMES, CreateError, isAddonName, PACKAGE_MANAGERS, } from "@parlor/scaffold";
+export const DEFAULT_DIRECTORY = "my-parlor-app";
+export const USAGE = `Usage: create-parlor [directory] [options]
+
+  -y, --yes                    Use every default and never prompt
+      --package-manager <pm>   npm, pnpm, yarn or bun (default: the one running this)
+      --add <addon>            Run \`parlor add <addon>\` after install; repeatable (${ADDON_NAMES.join(", ")})
+      --no-install             Skip installing dependencies
+      --no-git                 Skip the initial git commit
+      --dry-run                List the files that would be written and stop
+  -h, --help                   Show this help
+  -v, --version                Show the version`;
+/** npm 7+ passes a lone `--` through to the initializer; it is dropped like create-astro does. */
+export function parseCreateArgs(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv.filter((arg) => arg !== "--"),
+        allowPositionals: true,
+        allowNegative: true,
+        strict: true,
+        options: {
+            yes: { type: "boolean", short: "y", default: false },
+            install: { type: "boolean", default: true },
+            git: { type: "boolean", default: true },
+            "package-manager": { type: "string" },
+            add: { type: "string", multiple: true, default: [] },
+            "dry-run": { type: "boolean", default: false },
+            help: { type: "boolean", short: "h", default: false },
+            version: { type: "boolean", short: "v", default: false },
+        },
+    });
+    if (positionals.length > 1) {
+        throw new CreateError(`Expected one directory, got: ${positionals.join(" ")}`);
+    }
+    const manager = values["package-manager"];
+    if (manager !== undefined &&
+        !PACKAGE_MANAGERS.includes(manager)) {
+        throw new CreateError(`Unknown package manager "${manager}". Expected one of: ${PACKAGE_MANAGERS.join(", ")}`);
+    }
+    const unknownAddons = values.add.filter((name) => !isAddonName(name));
+    if (unknownAddons.length > 0) {
+        throw new CreateError(`Unknown add-on ${unknownAddons.map((name) => `"${name}"`).join(", ")}. Expected one of: ${ADDON_NAMES.join(", ")}`);
+    }
+    return {
+        directory: positionals[0],
+        yes: values.yes,
+        install: values.install,
+        git: values.git,
+        packageManager: manager,
+        addons: [...new Set(values.add.filter(isAddonName))],
+        dryRun: values["dry-run"],
+        help: values.help,
+        version: values.version,
+    };
+}
+export function canPrompt(stdin, stdout, env) {
+    return Boolean(stdin.isTTY && stdout.isTTY && !env.CI);
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { cancel, isCancel, text } from "@clack/prompts";
+import { CreateError, createProject, FRAMEWORK_VERSION, fromUserAgent, } from "@parlor/scaffold";
+import { canPrompt, DEFAULT_DIRECTORY, parseCreateArgs, USAGE } from "./args.js";
+import { dryRunReport, nextSteps } from "./next-steps.js";
+async function askDirectory() {
+    const answer = await text({
+        message: "Project name",
+        placeholder: DEFAULT_DIRECTORY,
+        defaultValue: DEFAULT_DIRECTORY,
+    });
+    if (isCancel(answer)) {
+        cancel("Cancelled");
+        return undefined;
+    }
+    return answer.trim() || DEFAULT_DIRECTORY;
+}
+async function main(argv) {
+    const request = parseCreateArgs(argv);
+    if (request.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (request.version) {
+        console.log(FRAMEWORK_VERSION);
+        return 0;
+    }
+    const detected = fromUserAgent(process.env.npm_config_user_agent);
+    const packageManager = request.packageManager
+        ? {
+            name: request.packageManager,
+            version: detected?.name === request.packageManager ? detected.version : undefined,
+        }
+        : (detected ?? { name: "npm", version: undefined });
+    const directory = request.directory ??
+        (request.yes
+            ? DEFAULT_DIRECTORY
+            : canPrompt(process.stdin, process.stdout, process.env)
+                ? await askDirectory()
+                : undefined);
+    if (directory === undefined) {
+        if (canPrompt(process.stdin, process.stdout, process.env))
+            return 0;
+        throw new CreateError(`create-parlor needs a project name when it cannot ask for one. Run, for example:\n  ${packageManager.name} create parlor my-app --yes`);
+    }
+    const project = await createProject({
+        directory: resolve(directory),
+        packageManager,
+        mode: request.dryRun ? "dry-run" : "apply",
+        install: request.install,
+        git: request.git,
+        addons: request.addons,
+        log: (line) => console.log(line),
+    });
+    const lines = request.dryRun
+        ? dryRunReport(project)
+        : nextSteps(project, process.cwd());
+    console.log(lines.join("\n"));
+    return project.install.kind === "failed" ? 1 : 0;
+}
+try {
+    process.exitCode = await main(process.argv.slice(2));
+}
+catch (error) {
+    if (error instanceof CreateError ||
+        (error instanceof TypeError &&
+            "code" in error &&
+            error.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION")) {
+        console.error(error.message);
+        process.exitCode = 1;
+    }
+    else {
+        throw error;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/next-steps.d.ts

@@ -0,0 +1,4 @@
+import { type CreatedProject } from "@parlor/scaffold";
+export declare function nextSteps(project: CreatedProject, cwd: string): readonly string[];
+export declare function dryRunReport(project: CreatedProject): readonly string[];
+//# sourceMappingURL=next-steps.d.ts.map

package/dist/next-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-steps.d.ts","sourceRoot":"","sources":["../src/next-steps.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAC;AAQ1B,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAgCjF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAOvE"}

package/dist/next-steps.js

@@ -0,0 +1,43 @@
+import { relative } from "node:path";
+import { commandsFor, DOCS_URL, formatCommand, } from "@parlor/scaffold";
+const COLUMN = 31;
+function step(command, note) {
+    return note ? `  ${command.padEnd(COLUMN)}${note}` : `  ${command}`;
+}
+export function nextSteps(project, cwd) {
+    const pm = commandsFor(project.packageManager);
+    const where = relative(cwd, project.directory) || ".";
+    return [
+        `Created ${where} with ${project.packageManager.name}.`,
+        "",
+        ...(where === "." ? [] : [step(`cd ${where}`)]),
+        ...(project.install.kind === "installed" || project.install.kind === "ignored-builds"
+            ? []
+            : [step(formatCommand(pm.install))]),
+        step(pm.run("dev"), "web app on http://localhost:5173, API on :3000"),
+        ...project.addons.deferred.map((addon) => step(pm.exec("parlor", ["add", addon]), `finish adding ${addon}`)),
+        ...(project.addons.applied.includes("auth") ||
+            project.addons.deferred.includes("auth")
+            ? []
+            : [step(pm.exec("parlor", ["add", "auth"]), "sign-in with Better Auth")]),
+        step(pm.exec("parlor", ["dev", "--target", "mac"]), "the same app as a desktop window"),
+        "",
+        "Open http://localhost:5173 and press Agent to chat with your coding agent.",
+        `AGENTS.md tells coding agents how this project works. Docs: ${DOCS_URL}/llms.txt`,
+        ...(project.git.kind === "failed"
+            ? [
+                "",
+                `No initial commit: ${project.git.message.split("\n").find((line) => line.trim()) ?? "git failed"}. Commit the files once git works.`,
+            ]
+            : []),
+    ];
+}
+export function dryRunReport(project) {
+    const name = project.identity.directoryName;
+    return [
+        ...project.files.map((path) => `${name}/${path}`),
+        "",
+        `${project.files.length} files would be written to ${name}. Nothing was.`,
+    ];
+}
+//# sourceMappingURL=next-steps.js.map

package/dist/next-steps.js.map

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

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "create-parlor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Create a Parlor app: pnpm create parlor, npm create parlor, yarn create parlor, bun create parlor",
+  "homepage": "https://cychien.github.io/parlor",
+  "bugs": "https://github.com/cychien/parlor/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cychien/parlor.git",
+    "directory": "packages/create-parlor"
+  },
+  "bin": {
+    "create-parlor": "./dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "@parlor/scaffold": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.14.0",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.spec.json --noEmit",
+    "test": "vitest run"
+  }
 }