create-gitcms 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# create-gitcms
+
+Bootstrap [`gitcms.md`](https://gitcms.dev/docs/getting-started/configuration) for a GitCMS project.
+
+`create-gitcms` helps you detect site roots, infer Markdown collections, and generate the initial config for single-site repos and monorepos.
+
+GitCMS is a Git-powered CMS with a Notion-like editor. Every save becomes a real Git commit. Learn more at [gitcms.dev](https://gitcms.dev).
+
+## Usage
+
+The intended entrypoint is:
+
+```bash
+npm init gitcms
+```
+
+You can also run it directly:
+
+```bash
+npx create-gitcms@latest
+```
+
+Examples:
+
+```bash
+npm init gitcms
+npm init gitcms -- --yes
+npm init gitcms -- --website-url https://example.com
+npm init gitcms -- --mode monorepo --site-root apps/docs --site-root apps/blog
+```
+
+## What it does
+
+- Detects whether the repo looks like a single-site setup or a monorepo
+- Finds likely Markdown or MDX collections
+- Infers frontmatter shape from sample content
+- Suggests framework-aware defaults for media and content paths
+- Writes `gitcms.md` in the correct location
+
+## Product Links
+
+- App: [gitcms.dev](https://gitcms.dev)
+- Docs: [gitcms.dev/docs](https://gitcms.dev/docs)
+- Quick Start: [gitcms.dev/docs/getting-started/quick-start](https://gitcms.dev/docs/getting-started/quick-start)
+
+## Notes
+
+- `gitcms.md` is meant to be generated by GitCMS tooling, not hand-written.
+- For product setup after config generation, continue in the GitCMS web app.

package/dist/args.d.ts

@@ -0,0 +1,14 @@
+import type { InitMode } from './types.js';
+export interface CliFlags {
+    repoPath: string;
+    mode: InitMode;
+    siteRoots: Array<string>;
+    websiteUrls: Array<string>;
+    yes: boolean;
+    dryRun: boolean;
+    force: boolean;
+    help: boolean;
+}
+export declare function parseCliFlags(argv: Array<string>): CliFlags;
+export declare function usageText(): string;
+//# 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":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACxB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1B,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;CACd;AA8BD,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,YAqFhD;AAED,wBAAgB,SAAS,WAqBxB"}

package/dist/args.js

@@ -0,0 +1,119 @@
+function takeValue(arg, argv, index) {
+    const eqIndex = arg.indexOf('=');
+    if (eqIndex !== -1) {
+        return {
+            value: arg.slice(eqIndex + 1),
+            nextIndex: index,
+        };
+    }
+    const next = argv[index + 1];
+    if (!next || next.startsWith('-')) {
+        throw new Error(`Missing value for ${arg}`);
+    }
+    return {
+        value: next,
+        nextIndex: index + 1,
+    };
+}
+function parseMode(raw) {
+    if (raw === 'auto' || raw === 'single' || raw === 'monorepo') {
+        return raw;
+    }
+    throw new Error(`Invalid mode: ${raw}. Expected auto, single, or monorepo.`);
+}
+export function parseCliFlags(argv) {
+    const flags = {
+        repoPath: '.',
+        mode: 'auto',
+        siteRoots: [],
+        websiteUrls: [],
+        yes: false,
+        dryRun: false,
+        force: false,
+        help: false,
+    };
+    let repoPathWasSet = false;
+    let index = 0;
+    while (index < argv.length) {
+        const arg = argv[index];
+        if (!arg) {
+            index += 1;
+            continue;
+        }
+        if (arg === 'init') {
+            index += 1;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            flags.help = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--yes') {
+            flags.yes = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            flags.dryRun = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--force') {
+            flags.force = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--mode' || arg.startsWith('--mode=')) {
+            const parsed = takeValue(arg, argv, index);
+            flags.mode = parseMode(parsed.value);
+            index = parsed.nextIndex + 1;
+            continue;
+        }
+        if (arg === '--site-root' || arg.startsWith('--site-root=')) {
+            const parsed = takeValue(arg, argv, index);
+            flags.siteRoots.push(parsed.value);
+            index = parsed.nextIndex + 1;
+            continue;
+        }
+        if (arg === '--website-url' || arg.startsWith('--website-url=')) {
+            const parsed = takeValue(arg, argv, index);
+            flags.websiteUrls.push(parsed.value);
+            index = parsed.nextIndex + 1;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown flag: ${arg}`);
+        }
+        if (flags.repoPath !== '.' || repoPathWasSet) {
+            throw new Error('Only one repository path argument is supported');
+        }
+        repoPathWasSet = true;
+        flags.repoPath = arg;
+        index += 1;
+    }
+    return flags;
+}
+export function usageText() {
+    return [
+        'Usage: create-gitcms [repoPath] [options]',
+        '',
+        'Options:',
+        '  --mode <auto|single|monorepo>   Initialization mode (default: auto)',
+        '  --site-root <path>               Site root path (repeatable for monorepo)',
+        '  --website-url <value>            Repeatable: <url> global, multi-url by order, or <siteRoot>=<url>',
+        '  --yes                            Non-interactive mode, accept inferred defaults',
+        '  --dry-run                        Preview inferred config paths without writing files',
+        '  --force                          Overwrite existing gitcms.md files',
+        '  --help, -h                       Show help',
+        '',
+        'Examples:',
+        '  npm init gitcms',
+        '  npm init gitcms -- --yes',
+        '  npm init gitcms -- --website-url https://example.com',
+        '  npm init gitcms -- --mode monorepo --site-root apps/v4 --site-root deprecated/www --website-url https://v4.example.com --website-url https://legacy.example.com',
+        '  npm init gitcms -- --mode monorepo --website-url apps/v4=https://v4.example.com --website-url deprecated/www=https://legacy.example.com',
+        '  npm init gitcms -- --mode monorepo --site-root apps/docs --site-root apps/blog',
+    ].join('\n');
+}
+//# 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/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function run(): Promise<void>;
+export { run };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA8dA,iBAAe,GAAG,kBA6PjB;AAaD,OAAO,EAAE,GAAG,EAAE,CAAA"}