create-specglass 0.0.2

package/dist/app.d.ts

@@ -0,0 +1,6 @@
+interface CreateAppProps {
+    initialProjectName?: string;
+}
+export declare function CreateApp({ initialProjectName }: CreateAppProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAUA,UAAU,cAAc;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,cAAc,2CAgG/D"}

package/dist/app.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { Box, Text } from "ink";
+import { TextInput, Spinner, StatusMessage } from "@inkjs/ui";
+import { scaffoldProject, ScaffoldError } from "./scaffold.js";
+import { resolve } from "node:path";
+const DEFAULT_PROJECT_NAME = "my-docs";
+export function CreateApp({ initialProjectName }) {
+    const [phase, setPhase] = useState(initialProjectName ? "scaffolding" : "prompting");
+    const [projectName, setProjectName] = useState(initialProjectName ?? "");
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (initialProjectName) {
+            runScaffold(initialProjectName);
+        }
+    }, [initialProjectName]);
+    async function runScaffold(name) {
+        setPhase("scaffolding");
+        try {
+            const targetDir = resolve(process.cwd(), name);
+            await scaffoldProject(name, targetDir);
+            setPhase("done");
+            setTimeout(() => process.exit(0), 100);
+        }
+        catch (err) {
+            if (err instanceof ScaffoldError) {
+                setError(err);
+            }
+            else {
+                setError(new ScaffoldError(err instanceof Error ? err.message : String(err), "SCAFFOLD_FAILED", "Check filesystem permissions and try again."));
+            }
+            setPhase("error");
+            setTimeout(() => process.exit(1), 100);
+        }
+    }
+    function handleSubmit(value) {
+        const name = value.trim() || DEFAULT_PROJECT_NAME;
+        setProjectName(name);
+        runScaffold(name);
+    }
+    if (phase === "prompting") {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "create-specglass" }) }), _jsxs(Box, { children: [_jsx(Text, { children: "Project name: " }), _jsx(TextInput, { placeholder: DEFAULT_PROJECT_NAME, onSubmit: handleSubmit })] })] }));
+    }
+    if (phase === "scaffolding") {
+        return (_jsx(Box, { paddingX: 1, children: _jsx(Spinner, { label: `Scaffolding ${projectName || initialProjectName}...` }) }));
+    }
+    if (phase === "error" && error) {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(StatusMessage, { variant: "error", children: error.message }), error.hint && (_jsxs(Text, { dimColor: true, children: ["Hint: ", error.hint] }))] }));
+    }
+    // done
+    const displayName = projectName || initialProjectName || DEFAULT_PROJECT_NAME;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(StatusMessage, { variant: "success", children: ["Project created in ", displayName, "/"] }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { children: "Next steps:" }), _jsxs(Text, { dimColor: true, children: [" cd ", displayName] }), _jsx(Text, { dimColor: true, children: " npm install" }), _jsx(Text, { dimColor: true, children: " npx specglass dev" })] })] }));
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import meow from "meow";
+import { render } from "ink";
+import { CreateApp } from "./app.js";
+process.on("SIGINT", () => process.exit(130));
+const cli = meow(`
+  Usage
+    $ create-specglass [project-name]
+
+  Options
+    --help       Show this help message
+    --version    Show version number
+
+  Examples
+    $ npx create-specglass
+    $ npx create-specglass my-docs
+`, {
+    importMeta: import.meta,
+});
+const projectName = cli.input[0];
+render(_jsx(CreateApp, { initialProjectName: projectName }));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";;AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9C,MAAM,GAAG,GAAG,IAAI,CACd;;;;;;;;;;;CAWD,EACC;IACE,UAAU,EAAE,MAAM,CAAC,IAAI;CACxB,CACF,CAAC;AAEF,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEjC,MAAM,CAAC,KAAC,SAAS,IAAC,kBAAkB,EAAE,WAAW,GAAI,CAAC,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,8 @@
+export declare class ScaffoldError extends Error {
+    readonly code: string;
+    readonly hint?: string | undefined;
+    constructor(message: string, code: string, hint?: string | undefined);
+}
+export declare function scaffoldProject(projectName: string, targetDir: string): Promise<void>;
+export declare function resolveTemplateDir(): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAIA,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAUD,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAiCD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/scaffold.js

@@ -0,0 +1,67 @@
+import { mkdir, readdir, readFile, writeFile, access, cp } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export class ScaffoldError extends Error {
+    code;
+    hint;
+    constructor(message, code, hint) {
+        super(message);
+        this.code = code;
+        this.hint = hint;
+        this.name = "ScaffoldError";
+    }
+}
+const TEMPLATE_DIR = resolve(fileURLToPath(new URL(".", import.meta.url)), "..", "src", "templates", "default");
+export async function scaffoldProject(projectName, targetDir) {
+    // Check if target directory already exists
+    try {
+        await access(targetDir);
+        throw new ScaffoldError(`Directory "${projectName}" already exists`, "PROJECT_EXISTS", `Choose a different project name or remove the existing directory.`);
+    }
+    catch (err) {
+        if (err instanceof ScaffoldError)
+            throw err;
+        // Directory doesn't exist — good, continue
+    }
+    // Create target directory
+    await mkdir(targetDir, { recursive: true });
+    // Copy and process all template files
+    try {
+        await copyTemplateDir(TEMPLATE_DIR, targetDir, { projectName });
+    }
+    catch (err) {
+        if (err instanceof ScaffoldError)
+            throw err;
+        throw new ScaffoldError(`Failed to scaffold project: ${err instanceof Error ? err.message : String(err)}`, "SCAFFOLD_FAILED", "Check filesystem permissions and try again.");
+    }
+}
+async function copyTemplateDir(srcDir, destDir, vars) {
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(srcDir, entry.name);
+        const destName = entry.name.endsWith(".tmpl")
+            ? entry.name.slice(0, -5)
+            : entry.name;
+        const destPath = join(destDir, destName);
+        if (entry.isDirectory()) {
+            await mkdir(destPath, { recursive: true });
+            await copyTemplateDir(srcPath, destPath, vars);
+        }
+        else if (entry.name.endsWith(".tmpl")) {
+            // Template file — read, substitute, write
+            let content = await readFile(srcPath, "utf-8");
+            for (const [key, value] of Object.entries(vars)) {
+                content = content.replaceAll(`{{${key}}}`, value);
+            }
+            await writeFile(destPath, content, "utf-8");
+        }
+        else {
+            // Static file — copy as-is
+            await cp(srcPath, destPath);
+        }
+    }
+}
+export function resolveTemplateDir() {
+    return TEMPLATE_DIR;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,YAAY,GAAG,OAAO,CAC1B,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAC5C,IAAI,EACJ,KAAK,EACL,WAAW,EACX,SAAS,CACV,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,SAAiB;IAEjB,2CAA2C;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACxB,MAAM,IAAI,aAAa,CACrB,cAAc,WAAW,kBAAkB,EAC3C,gBAAgB,EAChB,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa;YAAE,MAAM,GAAG,CAAC;QAC5C,2CAA2C;IAC7C,CAAC;IAED,0BAA0B;IAC1B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,sCAAsC;IACtC,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa;YAAE,MAAM,GAAG,CAAC;QAC5C,MAAM,IAAI,aAAa,CACrB,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACjF,iBAAiB,EACjB,6CAA6C,CAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAc,EACd,OAAe,EACf,IAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC3C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEzC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,0CAA0C;YAC1C,IAAI,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "create-specglass",
+  "version": "0.0.2",
+  "description": "Scaffolding tool to create a new Specglass documentation project",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Not-Diamond/ndocs.git",
+    "directory": "packages/create-specglass"
+  },
+  "homepage": "https://github.com/Not-Diamond/ndocs#readme",
+  "bin": {
+    "create-specglass": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.5",
+    "vitest": "^3.0"
+  },
+  "dependencies": {
+    "@inkjs/ui": "^2.0.0",
+    "ink": "^6.7.0",
+    "meow": "^13.2.0",
+    "react": "^19.2.4"
+  }
+}

package/src/templates/default/content/docs/_meta.json

@@ -0,0 +1,4 @@
+{
+  "index": "Welcome",
+  "getting-started": "Getting Started"
+}

package/src/templates/default/content/docs/getting-started.mdx

@@ -0,0 +1,87 @@
+---
+title: Getting Started
+description: Learn how to add content, configure your site, and deploy
+---
+
+# Getting Started
+
+This guide walks you through the basics of working with your specglass site.
+
+## Adding a page
+
+Create a new `.mdx` file in the `content/docs/` directory:
+
+```mdx
+---
+title: My New Page
+description: A brief description for search and metadata
+---
+
+# My New Page
+
+Write your content here using Markdown.
+```
+
+Every page needs **frontmatter** — the `title` and `description` between the `---` fences. These are used for the page title, navigation labels, and metadata.
+
+## Organizing navigation
+
+The `_meta.json` file in each directory controls the order and labels of pages in the sidebar:
+
+```json
+{
+  "index": "Welcome",
+  "getting-started": "Getting Started",
+  "my-new-page": "My New Page"
+}
+```
+
+Keys match filenames (without `.mdx`), and values are the display labels.
+
+## Using components
+
+specglass includes built-in components you can use in any MDX page:
+
+<Callout type="tip">
+  Components like this `Callout` are available globally — no imports needed.
+</Callout>
+
+<Callout type="warning">
+  Callout types include `info`, `tip`, `warning`, and `error`.
+</Callout>
+
+## Configuring your site
+
+Edit `specglass.config.ts` to change your site's title, description, and other settings:
+
+```ts
+import { defineConfig } from "@specglass/core";
+
+export default defineConfig({
+  site: {
+    title: "My Project Docs",
+    description: "Documentation for my project",
+  },
+});
+```
+
+## Development workflow
+
+```bash
+# Start dev server with hot reload
+npm run dev
+
+# Build static site for production
+npm run build
+```
+
+The dev server runs at `http://localhost:4321` by default. Changes to MDX files are reflected immediately.
+
+## Deploying
+
+Running `npm run build` generates a static site in the `dist/` directory. Deploy it to any static hosting provider:
+
+- **Vercel** — drop the `dist/` folder or connect your repository
+- **Netlify** — set build command to `npm run build` and publish directory to `dist`
+- **GitHub Pages** — use a CI workflow to build and deploy the `dist/` folder
+- **Any web server** — upload the contents of `dist/`

package/src/templates/default/content/docs/index.mdx

@@ -0,0 +1,36 @@
+---
+title: Welcome
+description: Get started with your new documentation site
+---
+
+# Welcome to your docs
+
+You're looking at your brand-new documentation site, powered by **specglass**. This page — and everything in the `content/docs/` directory — is written in [MDX](https://mdxjs.com/), a format that combines Markdown with JSX components.
+
+<Callout type="info">
+  This starter content is your documentation _about_ documentation. Edit these files to replace them with your own content, or use them as a reference while you get started.
+</Callout>
+
+## What you can do
+
+- **Write pages** in MDX with full Markdown support plus components
+- **Organize navigation** using `_meta.json` files in each directory
+- **Use built-in components** like `<Callout>` to add visual emphasis
+- **Preview changes** instantly with `npm run dev`
+- **Build for production** with `npm run build` to generate static HTML
+
+## Project structure
+
+```
+content/
+  docs/
+    index.mdx          ← You are here
+    getting-started.mdx ← Next steps
+    _meta.json          ← Navigation order
+specglass.config.ts         ← Site configuration
+package.json
+```
+
+## Next steps
+
+Head to the [Getting Started](/docs/getting-started) guide to learn how to add pages, configure your site, and deploy.

package/src/templates/default/package.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "specglass dev",
+    "build": "specglass build"
+  },
+  "dependencies": {
+    "@specglass/cli": "^0.0.1",
+    "@specglass/core": "^0.0.1",
+    "@specglass/theme-default": "^0.0.1"
+  }
+}

package/src/templates/default/specglass.config.ts.tmpl

@@ -0,0 +1,8 @@
+import { defineConfig } from "@specglass/core";
+
+export default defineConfig({
+  site: {
+    title: "{{projectName}}",
+    description: "Documentation powered by specglass",
+  },
+});

package/src/templates/default/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["specglass.config.ts"]
+}