@nakedev/nextjs-fsd 0.1.0

package/dist/index.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const picocolors_1 = __importDefault(require("picocolors"));
+const prompts_1 = require("./prompts");
+const init_1 = require("./commands/init");
+const generate_1 = require("./commands/generate");
+const add_1 = require("./commands/add");
+const config_1 = require("./commands/config");
+const config_2 = require("./utils/config");
+const copy_1 = require("./utils/copy");
+const version_1 = require("./utils/version");
+// fail is every command's catch, in one place so the two non-obvious cases stay
+// consistent. @inquirer/prompts throws ExitPromptError on Ctrl-C and its raw
+// message ("User force closed the prompt with 0 null") tells a user nothing.
+// The no-TTY case normally never reaches here — prompts.ts rejects before a
+// prompt starts — but stdin can also close mid-prompt, which arrives as the
+// same error and deserves the same advice rather than "aborted".
+function fail(err) {
+    const message = err.message ?? String(err);
+    if (err.name === "ExitPromptError") {
+        console.error(picocolors_1.default.red(process.stdin.isTTY ? "aborted" : prompts_1.NO_TTY_MESSAGE));
+    }
+    else {
+        console.error(picocolors_1.default.red(message));
+    }
+    process.exitCode = 1;
+}
+const program = new commander_1.Command();
+program
+    .name("nextjs-fsd")
+    .description("Keep a Next.js App Router project on Feature-Sliced Design.\n\n" +
+    "Next.js creates the app (`create-next-app`); this only shapes what is inside it: `init` once, " +
+    "then `generate` for slices and `add` for the API error handling and auth wiring.\n\n" +
+    "Run `nextjs-fsd` with no arguments to pick what to do from a menu. Commands ask for whatever you omit; " +
+    "`--defaults` answers every question for CI.")
+    .version((0, version_1.cliVersion)());
+program
+    .command("init")
+    .description("shape an existing Next.js App Router project into FSD layers (run this once, after create-next-app)")
+    .option("--locale <locale>", 'language for the generated user-facing copy: "th" (default) or "en"')
+    .option("--no-install", "write the files but do not run the package manager")
+    .option("--defaults", "skip every question; Thai copy, and no confirmation")
+    .option("-y, --yes", "skip only the confirmation summary")
+    .action(async (opts) => {
+    try {
+        await (0, init_1.initProject)(process.cwd(), {
+            locale: (0, copy_1.parseLocale)(opts.locale),
+            install: opts.install,
+            defaults: opts.defaults,
+            yes: opts.yes || opts.defaults,
+        });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+async function runGenerateWizard() {
+    const target = await (0, prompts_1.select)({
+        message: "What do you want to generate?",
+        choices: [
+            { name: "Page (a _pages slice plus its route file)", value: "page" },
+            { name: "Slice (features / entities / widgets)", value: "slice" },
+            { name: "Layout (shared chrome for a group of routes)", value: "layout" },
+        ],
+    });
+    if (target === "page")
+        await (0, generate_1.generatePage)(undefined, {});
+    else if (target === "slice")
+        await (0, generate_1.generateSlice)(undefined, undefined, {});
+    else
+        await (0, generate_1.generateLayout)(undefined, {});
+}
+const generate = program
+    .command("generate")
+    .alias("g")
+    .description("add a page or slice; bare `generate` opens a target wizard")
+    .action(async () => {
+    try {
+        await runGenerateWizard();
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+generate
+    .command("page [name]")
+    .alias("p")
+    .description("scaffold a _pages slice and the thin route file that re-exports it")
+    .option("--title <title>", "heading and browser title; defaults to the Title Case of the page name")
+    .option("--route <path>", 'App Router path; defaults to the page name. Route groups and dynamic segments work: "(admin)/dashboard", "loans/[id]"')
+    .option("--no-route", "write the slice only, no route file")
+    .option("--client", 'also create a "use client" leaf component')
+    .option("--auth", "the client leaf sits behind useRequireSession (needs `add auth`)")
+    .option("--errors", "add model/<name>-errors.ts, this page's own error catalog (needs `add error-handling`)")
+    .option("--defaults", "skip every question; server component only, route = the page name")
+    .action(async (name, opts) => {
+    try {
+        // commander folds --no-route into the same `route` key: false when it
+        // was passed, a string when --route was, undefined when neither.
+        const noRoute = opts.route === false;
+        await (0, generate_1.generatePage)(name, {
+            title: opts.title,
+            route: noRoute ? undefined : opts.route,
+            routeFile: noRoute ? false : undefined,
+            client: opts.client,
+            auth: opts.auth,
+            errors: opts.errors,
+            defaults: opts.defaults,
+        });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+generate
+    .command("slice [layer] [name]")
+    .alias("s")
+    .description("scaffold a features/entities/widgets slice with only the segments it needs")
+    .option("--segments <list>", "comma-separated: ui,model,api,lib (default ui)")
+    .option("--errors", "add model/<name>-errors.ts, this slice's own error catalog (needs `add error-handling`)")
+    .option("--defaults", "skip every question; ui segment only")
+    .action(async (layer, name, opts) => {
+    try {
+        await (0, generate_1.generateSlice)(layer, name, {
+            segments: opts.segments,
+            errors: opts.errors,
+            defaults: opts.defaults,
+        });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+generate
+    .command("layout [name]")
+    .alias("l")
+    .description("scaffold a shared route shell in _app/layouts plus the layout.tsx that re-exports it")
+    .option("--route <path>", 'where it applies; defaults to the route group "(<name>)". A real segment works too: "admin"')
+    .option("--no-route", "write the component only, no layout.tsx")
+    .option("--defaults", "skip every question; route = the (<name>) group")
+    .action(async (name, opts) => {
+    try {
+        const noRoute = opts.route === false;
+        await (0, generate_1.generateLayout)(name, {
+            route: noRoute ? undefined : opts.route,
+            routeFile: noRoute ? false : undefined,
+            defaults: opts.defaults,
+        });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+async function runAddWizard() {
+    // Read once, up front: the menu should say what is already installed rather
+    // than letting someone walk a confirmation to reach "already installed".
+    const config = (0, config_2.readConfig)(process.cwd());
+    const target = await (0, prompts_1.select)({
+        message: "What do you want to add?",
+        choices: [
+            {
+                name: "Error handling (ApiError, per-domain catalogs, axios client with a 401 refresh, QueryClient)",
+                value: "errors",
+                disabled: config.features.errorHandling ? "— already installed" : false,
+            },
+            {
+                name: "Auth (access token in memory, session hooks, route guard, login page)",
+                value: "auth",
+                disabled: config.features.auth ? "— already installed" : false,
+            },
+        ],
+    });
+    if (target === "errors")
+        await (0, add_1.addErrorHandling)({});
+    else
+        await (0, add_1.addAuth)({});
+}
+const add = program
+    .command("add")
+    .description("add shared infrastructure; bare `add` opens an error-handling/auth wizard")
+    .action(async () => {
+    try {
+        await runAddWizard();
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+add
+    .command("error-handling")
+    .alias("errors")
+    .description("add shared/api: ApiError, per-domain error catalogs, a resolver, an axios client with a single-flight 401 refresh, and a QueryClient")
+    .option("--no-install", "write the files but do not run the package manager")
+    .option("-y, --yes", "skip the confirmation summary")
+    .action(async (opts) => {
+    try {
+        await (0, add_1.addErrorHandling)({ install: opts.install, yes: opts.yes });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+add
+    .command("auth")
+    .description("add shared/auth and a login page: access token in memory, session hooks, useRequireSession (installs error handling first if missing)")
+    .option("--no-install", "write the files but do not run the package manager")
+    .option("-y, --yes", "skip the confirmation summary")
+    .action(async (opts) => {
+    try {
+        await (0, add_1.addAuth)({ install: opts.install, yes: opts.yes });
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+const config = program
+    .command("config")
+    .description("inspect the project config")
+    .action(() => {
+    try {
+        (0, config_1.showProjectConfig)();
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+config
+    .command("set <key> <value>")
+    .description('change a project setting; only `locale` (th|en) is settable, and it affects future generation only')
+    .action((key, value) => {
+    try {
+        if (key !== "locale") {
+            throw new Error(`unknown setting "${key}" — only \`locale\` can be set (th or en)`);
+        }
+        (0, config_1.setProjectLocale)(value);
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+config
+    .command("show")
+    .description("print the resolved project config and which features are installed")
+    .action(() => {
+    try {
+        (0, config_1.showProjectConfig)();
+    }
+    catch (err) {
+        fail(err);
+    }
+});
+// runTopMenu is bare `nextjs-fsd` — the command name is the one thing people
+// remember, so give the same "ask, then delegate" menu the subcommands give
+// when run bare, instead of Commander's static help (which lists commands but
+// never lets you act on one).
+//
+// Deliberately NOT a .action() on the root: giving the root an action makes it
+// callable, which turns a mistyped subcommand into "too many arguments"
+// instead of Commander's "unknown command 'ad' (Did you mean add?)".
+async function runTopMenu() {
+    if (!(0, config_2.isProjectDir)(process.cwd())) {
+        console.log(picocolors_1.default.dim(`${process.cwd()} isn't a nextjs-fsd project yet — only "init" can run here.\n`));
+        await (0, init_1.initProject)(process.cwd(), {});
+        return;
+    }
+    const target = await (0, prompts_1.select)({
+        message: "What do you want to do?",
+        choices: [
+            { name: "Generate (a page or a features/entities slice)", value: "generate" },
+            { name: "Add (error handling / auth)", value: "add" },
+            { name: "Show the project config", value: "config" },
+        ],
+    });
+    if (target === "generate")
+        await runGenerateWizard();
+    else if (target === "add")
+        await runAddWizard();
+    else
+        (0, config_1.showProjectConfig)();
+}
+if (process.argv.length <= 2) {
+    runTopMenu().catch(fail);
+}
+else {
+    program.parseAsync(process.argv);
+}

package/dist/prompts.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkbox = exports.select = exports.input = exports.confirm = exports.NO_TTY_MESSAGE = void 0;
+exports.assertInteractive = assertInteractive;
+const prompts_1 = require("@inquirer/prompts");
+exports.NO_TTY_MESSAGE = "no interactive terminal to prompt on — pass every value as an argument/flag (see --help), or add --defaults";
+// @inquirer/prompts does reject on a non-TTY stdin, but only after writing the
+// question and its cursor escapes, so a CI log ends with an unanswerable
+// question followed by raw ANSI followed by the real error. Answering the
+// no-TTY case before the prompt starts leaves only the line that says what to
+// do instead.
+//
+// Every prompt in this CLI comes from here rather than @inquirer/prompts
+// directly, so a prompt added later gets this for free.
+function assertInteractive() {
+    if (!process.stdin.isTTY)
+        throw new Error(exports.NO_TTY_MESSAGE);
+}
+const confirm = (...args) => {
+    assertInteractive();
+    return (0, prompts_1.confirm)(...args);
+};
+exports.confirm = confirm;
+const input = (...args) => {
+    assertInteractive();
+    return (0, prompts_1.input)(...args);
+};
+exports.input = input;
+const select = (...args) => {
+    assertInteractive();
+    return (0, prompts_1.select)(...args);
+};
+exports.select = select;
+const checkbox = (...args) => {
+    assertInteractive();
+    return (0, prompts_1.checkbox)(...args);
+};
+exports.checkbox = checkbox;

package/dist/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEGMENTS = exports.SLICE_LAYERS = void 0;
+exports.SLICE_LAYERS = ["features", "entities", "widgets"];
+exports.SEGMENTS = ["ui", "model", "api", "lib"];

package/dist/utils/config.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_SCHEMA_VERSION = void 0;
+exports.configPath = configPath;
+exports.isProjectDir = isProjectDir;
+exports.writeConfig = writeConfig;
+exports.detectFeatures = detectFeatures;
+exports.readConfig = readConfig;
+exports.setFeature = setFeature;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const project_1 = require("./project");
+const CONFIG_FILE = "nextjs-fsd.config.json";
+exports.CONFIG_SCHEMA_VERSION = 1;
+function configPath(projectDir) {
+    return path_1.default.join(projectDir, CONFIG_FILE);
+}
+function isProjectDir(projectDir) {
+    return fs_extra_1.default.existsSync(configPath(projectDir));
+}
+function writeConfig(projectDir, config) {
+    fs_extra_1.default.writeJsonSync(configPath(projectDir), config, { spaces: 2 });
+}
+/**
+ * Detects which features are actually on disk.
+ *
+ * Every command reads the config file, but a key the file does not define used
+ * to mean "false" to every caller — so `add auth` would re-install a
+ * shared/api that was already there and clobber the catalog someone had
+ * filled in. The tree always knew the answer; this stops the guessing. The
+ * file still wins wherever it has a value: an explicit `false` is an answer,
+ * not a hole.
+ */
+function detectFeatures(projectDir, srcDir = "src") {
+    const has = (relative) => fs_extra_1.default.existsSync(path_1.default.join(projectDir, srcDir, relative));
+    return {
+        errorHandling: has("shared/api/client.ts"),
+        auth: has("shared/auth/session.ts"),
+    };
+}
+function readConfig(projectDir) {
+    const file = configPath(projectDir);
+    if (!fs_extra_1.default.existsSync(file)) {
+        throw new Error(`${projectDir} isn't a nextjs-fsd project — no ${CONFIG_FILE}.\n` +
+            "Run `nextjs-fsd init` in a Next.js App Router project first.");
+    }
+    const raw = fs_extra_1.default.readJsonSync(file);
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        throw new Error(`${CONFIG_FILE} must contain a JSON object`);
+    }
+    const schemaVersion = raw.schemaVersion ?? exports.CONFIG_SCHEMA_VERSION;
+    if (!Number.isInteger(schemaVersion) || schemaVersion < 1) {
+        throw new Error(`${CONFIG_FILE} has invalid schemaVersion "${String(schemaVersion)}" — expected a positive integer`);
+    }
+    if (schemaVersion > exports.CONFIG_SCHEMA_VERSION) {
+        throw new Error(`${CONFIG_FILE} uses schemaVersion ${schemaVersion}, but this CLI supports up to ${exports.CONFIG_SCHEMA_VERSION} — upgrade nextjs-fsd first`);
+    }
+    const srcDir = raw.srcDir ?? "src";
+    const appDir = raw.appDir ?? "app";
+    if (!fs_extra_1.default.existsSync(path_1.default.join(projectDir, appDir))) {
+        throw new Error(`${CONFIG_FILE} points appDir at "${appDir}", which doesn't exist — fix the path, or re-run \`nextjs-fsd init\``);
+    }
+    const detected = detectFeatures(projectDir, srcDir);
+    const features = { ...(raw.features ?? {}) };
+    for (const key of Object.keys(detected)) {
+        if (typeof features[key] !== "boolean")
+            features[key] = detected[key];
+    }
+    return {
+        schemaVersion,
+        locale: raw.locale ?? "th",
+        srcDir,
+        appDir,
+        alias: raw.alias ?? "@",
+        packageManager: raw.packageManager ?? (0, project_1.detectPackageManager)(projectDir),
+        features: features,
+        ...(raw.scaffoldVersion ? { scaffoldVersion: raw.scaffoldVersion } : {}),
+    };
+}
+function setFeature(projectDir, feature, value) {
+    const config = readConfig(projectDir);
+    writeConfig(projectDir, { ...config, features: { ...config.features, [feature]: value } });
+}

package/dist/utils/copy.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyFor = copyFor;
+exports.parseLocale = parseLocale;
+exports.asCatalogEntries = asCatalogEntries;
+const th = {
+    loading: "กำลังโหลด…",
+    todo: "TODO: ยังไม่มีเนื้อหา",
+    genericError: "เกิดข้อผิดพลาด กรุณาลองอีกครั้ง",
+    saveFailed: "บันทึกไม่สำเร็จ",
+    signIn: "เข้าสู่ระบบ",
+    signInSubtitle: "กรอกอีเมลและรหัสผ่านเพื่อเข้าใช้งาน",
+    signingIn: "กำลังเข้าสู่ระบบ…",
+    signInFailed: "เข้าสู่ระบบไม่สำเร็จ",
+    signOut: "ออกจากระบบ",
+    email: "อีเมล",
+    password: "รหัสผ่าน",
+    common: {
+        VALIDATION_ERROR: "ข้อมูลที่กรอกไม่ถูกต้อง กรุณาตรวจสอบอีกครั้ง",
+        UNAUTHORIZED: "กรุณาเข้าสู่ระบบก่อนใช้งาน",
+        FORBIDDEN: "บัญชีนี้ไม่มีสิทธิ์ใช้งานส่วนนี้",
+        NOT_FOUND: "ไม่พบข้อมูลที่ต้องการ",
+        CONFLICT: "ข้อมูลขัดแย้งกับข้อมูลปัจจุบัน กรุณาโหลดใหม่",
+        RATE_LIMITED: "ส่งคำขอถี่เกินไป กรุณารอสักครู่",
+        INTERNAL: "ระบบขัดข้อง กรุณาลองใหม่อีกครั้ง",
+        NETWORK: "เชื่อมต่อเซิร์ฟเวอร์ไม่ได้ กรุณาตรวจสอบอินเทอร์เน็ตแล้วลองใหม่",
+        UNKNOWN: "เกิดข้อผิดพลาดที่ไม่รู้จัก กรุณาลองใหม่",
+    },
+    auth: {
+        AUTH_INVALID_CREDENTIALS: "อีเมลหรือรหัสผ่านไม่ถูกต้อง",
+        AUTH_INVALID_TOKEN: "เซสชันหมดอายุ กรุณาเข้าสู่ระบบอีกครั้ง",
+        AUTH_INVALID_PASSWORD: "รหัสผ่านต้องยาว 8–72 ตัวอักษร",
+        AUTH_TOO_MANY_ATTEMPTS: "ลองเข้าสู่ระบบผิดหลายครั้งเกินไป กรุณารอสักครู่แล้วลองใหม่",
+        USER_EMAIL_TAKEN: "อีเมลนี้ถูกใช้ไปแล้ว",
+        USER_NOT_FOUND: "ไม่พบผู้ใช้",
+    },
+};
+const en = {
+    loading: "Loading…",
+    todo: "TODO: nothing here yet",
+    genericError: "Something went wrong. Please try again.",
+    saveFailed: "Could not save.",
+    signIn: "Sign in",
+    signInSubtitle: "Enter your email and password to continue.",
+    signingIn: "Signing in…",
+    signInFailed: "Could not sign in.",
+    signOut: "Sign out",
+    email: "Email",
+    password: "Password",
+    common: {
+        VALIDATION_ERROR: "Some fields are invalid. Please check and try again.",
+        UNAUTHORIZED: "Please sign in to continue.",
+        FORBIDDEN: "This account may not use that.",
+        NOT_FOUND: "Not found.",
+        CONFLICT: "This conflicts with the current data. Please reload.",
+        RATE_LIMITED: "Too many requests. Please wait a moment.",
+        INTERNAL: "The server had a problem. Please try again.",
+        NETWORK: "Cannot reach the server. Check your connection and try again.",
+        UNKNOWN: "An unknown error occurred. Please try again.",
+    },
+    auth: {
+        AUTH_INVALID_CREDENTIALS: "Wrong email or password.",
+        AUTH_INVALID_TOKEN: "Your session expired. Please sign in again.",
+        AUTH_INVALID_PASSWORD: "The password must be 8–72 characters.",
+        AUTH_TOO_MANY_ATTEMPTS: "Too many failed attempts. Please wait and try again.",
+        USER_EMAIL_TAKEN: "That email is already in use.",
+        USER_NOT_FOUND: "User not found.",
+    },
+};
+function copyFor(locale) {
+    return locale === "en" ? en : th;
+}
+function parseLocale(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (normalized !== "th" && normalized !== "en") {
+        throw new Error(`unknown --locale ${value} — use "th" or "en"`);
+    }
+    return normalized;
+}
+/** Renders a `Record<string, string>` as the body of a TS object literal. */
+function asCatalogEntries(entries, indent = "  ") {
+    return Object.entries(entries)
+        .map(([code, message]) => `${indent}${code}: ${JSON.stringify(message)},`)
+        .join("\n");
+}

package/dist/utils/naming.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+exports.validateSliceName = validateSliceName;
+exports.resolveNaming = resolveNaming;
+exports.normalizeRoute = normalizeRoute;
+exports.validateRoute = validateRoute;
+function toKebabCase(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+}
+function toPascalCase(value) {
+    return toKebabCase(value)
+        .split("-")
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+function toCamelCase(value) {
+    const pascal = toPascalCase(value);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+// A slice name becomes three things at once: a directory, a file prefix, and a
+// PascalCase component identifier. Only the identifier can be illegal, and it
+// fails at type-check time in a file nobody wrote by hand — so reject it here,
+// where the message can still name the input.
+function validateSliceName(raw) {
+    const kebab = toKebabCase(raw);
+    if (!kebab)
+        return `invalid name "${raw}" — use letters and numbers, e.g. "reset-password"`;
+    if (/^[0-9]/.test(kebab)) {
+        return `"${kebab}" starts with a digit — the component would be \`export function ${toPascalCase(raw)}Page\`, which is not a valid identifier; pick another name`;
+    }
+    return true;
+}
+function resolveNaming(raw) {
+    const check = validateSliceName(raw);
+    if (check !== true)
+        throw new Error(check);
+    const name = toKebabCase(raw);
+    return {
+        name,
+        pascal: toPascalCase(name),
+        camel: toCamelCase(name),
+        screaming: name.replace(/-/g, "_").toUpperCase(),
+    };
+}
+// App Router path for a page slice. Route groups stay verbatim — "(admin)"
+// is a real directory Next.js reads and strips from the URL, so a caller
+// passing `--route "(admin)/dashboard"` means exactly that.
+function normalizeRoute(raw) {
+    const trimmed = raw.trim().replace(/^\/+|\/+$/g, "");
+    return trimmed;
+}
+const ROUTE_SEGMENT = /^(\([^()/]+\)|\[\[?\.{3}[A-Za-z][A-Za-z0-9_]*\]?\]|\[[A-Za-z][A-Za-z0-9_]*\]|@[a-z0-9-]+|[a-z0-9][a-z0-9._-]*)$/;
+// Every segment either is a literal path piece or one of the App Router's own
+// bracket forms. Validated because the segments become real directories: a
+// stray "/" or space produces a route that never matches and a directory
+// nobody expected.
+function validateRoute(raw) {
+    const route = normalizeRoute(raw);
+    if (route === "")
+        return true; // "" means the root route, app/page.tsx
+    const bad = route.split("/").find((segment) => !ROUTE_SEGMENT.test(segment));
+    if (bad !== undefined) {
+        return `invalid route segment "${bad}" in "${route}" — use lowercase path segments, a route group "(admin)", a dynamic "[id]", or a catch-all "[...slug]"`;
+    }
+    return true;
+}