@podosoft/podokit 0.11.1 → 0.12.0

package/dist/index.js

@@ -12,6 +12,8 @@ const remove_1 = require("./remove");
 const inspect_1 = require("./inspect");
 const update_1 = require("./update");
 const eject_1 = require("./eject");
+const dev_1 = require("./dev");
+const locale_1 = require("./locale");
 const HELP = `podo — PodoKit project generator
 
 Usage:
@@ -21,6 +23,8 @@ Usage:
   podo status              Show version, modules, file tiers, and local edits
   podo diff                List PodoKit-managed files you have edited
   podo doctor              Check framework versions against supported ranges
+  podo dev <action> [...]  Run the shared, portless container development gateway
+  podo locale <command>    Add, validate, activate, or list JSON locales
   podo update [--apply]    Preview (or apply) what a version update would change
   podo eject <path...>     Take ownership of managed files (update skips them)
 
@@ -28,6 +32,8 @@ Options:
   --template <t> Template to scaffold (see below)
   --dir <path>   Target directory (default: ./<name>)
   --pm <name>    Package manager: npm | pnpm | yarn (default: npm)
+  --name <label> Display name for a locale
+  --direction <direction>  Text direction: ltr | rtl (default: ltr)
   --adopt        Adopt colliding paths explicitly declared managed by a module
   --no-ai        Skip AI agent guidance (AGENTS.md, CLAUDE.md, editor rules)
   -y, --yes      Skip prompts and accept defaults
@@ -42,7 +48,14 @@ Example:
   cd my-app && npx @podosoft/podokit add auth
 `;
 function parseArgs(argv) {
-    const parsed = { help: false, yes: false, apply: false, adopt: false, ai: true };
+    const parsed = {
+        help: false,
+        yes: false,
+        apply: false,
+        adopt: false,
+        ai: true,
+        positionals: [],
+    };
     const positionals = [];
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -73,12 +86,23 @@ function parseArgs(argv) {
         else if (arg === "--pm") {
             parsed.pm = argv[++i];
         }
+        else if (arg === "--name") {
+            parsed.localeName = argv[++i];
+        }
+        else if (arg === "--direction") {
+            const direction = argv[++i];
+            if (direction !== "ltr" && direction !== "rtl") {
+                throw new Error('--direction must be either "ltr" or "rtl".');
+            }
+            parsed.localeDirection = direction;
+        }
         else if (arg !== undefined && !arg.startsWith("-")) {
             positionals.push(arg);
         }
     }
     parsed.command = positionals[0];
     parsed.name = positionals[1];
+    parsed.positionals = positionals;
     return parsed;
 }
 function fail(message) {
@@ -203,6 +227,62 @@ async function main(argv) {
         }
         return;
     }
+    if (args.command === "dev") {
+        try {
+            (0, dev_1.runDevCommand)(process.cwd(), args.name, argv.slice(2));
+        }
+        catch (err) {
+            fail(err.message);
+        }
+        return;
+    }
+    if (args.command === "locale") {
+        const action = args.positionals[1] ?? "list";
+        const code = args.positionals[2];
+        try {
+            if (action === "add") {
+                if (!code)
+                    fail("Usage: podo locale add <code> [--name <label>] [--direction ltr|rtl]");
+                const definition = (0, locale_1.addLocale)(process.cwd(), code, {
+                    name: args.localeName,
+                    direction: args.localeDirection,
+                });
+                process.stdout.write(`Added ${definition.code} (${definition.name}) as inactive. Translate catalogs, run ` +
+                    `"podo locale validate ${definition.code}", then activate it.\n`);
+                return;
+            }
+            if (action === "validate") {
+                const locales = code ? [code] : (0, locale_1.listLocales)(process.cwd()).map((locale) => locale.code);
+                for (const locale of locales) {
+                    const coverage = (0, locale_1.validateLocale)(process.cwd(), locale);
+                    process.stdout.write(`${coverage.definition.code.padEnd(10)} ${String(coverage.percent).padStart(3)}% ` +
+                        `(${coverage.translated}/${coverage.total})` +
+                        `${coverage.missing.length ? `  missing ${coverage.missing.length}` : ""}\n`);
+                }
+                return;
+            }
+            if (action === "activate" || action === "deactivate") {
+                if (!code)
+                    fail(`Usage: podo locale ${action} <code>`);
+                const coverage = (0, locale_1.setLocaleEnabled)(process.cwd(), code, action === "activate");
+                process.stdout.write(`${action === "activate" ? "Activated" : "Deactivated"} ${coverage.definition.code} ` +
+                    `(${coverage.percent}% translated; missing keys use the configured fallback).\n`);
+                return;
+            }
+            if (action === "list") {
+                for (const locale of (0, locale_1.listLocales)(process.cwd())) {
+                    const coverage = (0, locale_1.validateLocale)(process.cwd(), locale.code);
+                    process.stdout.write(`${locale.enabled ? "active  " : "inactive"} ${locale.code.padEnd(10)} ` +
+                        `${locale.name}  ${coverage.percent}%\n`);
+                }
+                return;
+            }
+            fail(`Unknown locale command "${action}". Use add, validate, activate, deactivate, or list.`);
+        }
+        catch (err) {
+            fail(err.message);
+        }
+    }
     if (args.command === "update") {
         const templatesDir = (0, node_path_1.join)(__dirname, "templates");
         try {
@@ -238,7 +318,7 @@ async function main(argv) {
         return;
     }
     if (args.command === "eject") {
-        const targets = argv.filter((a) => !a.startsWith("-")).slice(1);
+        const targets = args.positionals.slice(1);
         if (!targets.length) {
             fail("Usage: podo eject <path...>");
         }

package/dist/lib.d.ts

@@ -8,6 +8,8 @@ export { status, diff, doctor, SUPPORTED_FRAMEWORKS } from "./inspect";
 export type { StatusReport, DoctorFinding } from "./inspect";
 export { planUpdate, summarize } from "./update";
 export type { UpdatePlan, FileChange } from "./update";
+export { readDevConfig, renderRoute, renderRuntimeCompose, resolveDevRuntime, runDevCommand } from "./dev";
+export type { CommandRunner, DevConfig, DevRuntime } from "./dev";
 /** Absolute path to the templates bundled in this installed package. */
 export declare function builtinTemplatesDir(): string;
 /** Absolute path to the modules bundled in this installed package. */

package/dist/lib.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarize = exports.planUpdate = exports.SUPPORTED_FRAMEWORKS = exports.doctor = exports.diff = exports.status = exports.addModule = exports.listModules = exports.isKnownTemplate = exports.TEMPLATE_NAMES = exports.DEFAULT_TEMPLATE = exports.TEMPLATES = exports.create = void 0;
+exports.runDevCommand = exports.resolveDevRuntime = exports.renderRuntimeCompose = exports.renderRoute = exports.readDevConfig = exports.summarize = exports.planUpdate = exports.SUPPORTED_FRAMEWORKS = exports.doctor = exports.diff = exports.status = exports.addModule = exports.listModules = exports.isKnownTemplate = exports.TEMPLATE_NAMES = exports.DEFAULT_TEMPLATE = exports.TEMPLATES = exports.create = void 0;
 exports.builtinTemplatesDir = builtinTemplatesDir;
 exports.builtinModulesDir = builtinModulesDir;
 // Library entry point: the reusable functions behind the `podo` CLI, for other
@@ -24,6 +24,12 @@ Object.defineProperty(exports, "SUPPORTED_FRAMEWORKS", { enumerable: true, get:
 var update_1 = require("./update");
 Object.defineProperty(exports, "planUpdate", { enumerable: true, get: function () { return update_1.planUpdate; } });
 Object.defineProperty(exports, "summarize", { enumerable: true, get: function () { return update_1.summarize; } });
+var dev_1 = require("./dev");
+Object.defineProperty(exports, "readDevConfig", { enumerable: true, get: function () { return dev_1.readDevConfig; } });
+Object.defineProperty(exports, "renderRoute", { enumerable: true, get: function () { return dev_1.renderRoute; } });
+Object.defineProperty(exports, "renderRuntimeCompose", { enumerable: true, get: function () { return dev_1.renderRuntimeCompose; } });
+Object.defineProperty(exports, "resolveDevRuntime", { enumerable: true, get: function () { return dev_1.resolveDevRuntime; } });
+Object.defineProperty(exports, "runDevCommand", { enumerable: true, get: function () { return dev_1.runDevCommand; } });
 /** Absolute path to the templates bundled in this installed package. */
 function builtinTemplatesDir() {
     return (0, node_path_1.join)(__dirname, "templates");

package/dist/locale.d.ts

@@ -0,0 +1,22 @@
+export type LocaleDirection = "ltr" | "rtl";
+export interface LocaleDefinition {
+    code: string;
+    name: string;
+    direction: LocaleDirection;
+    enabled: boolean;
+}
+export interface LocaleCoverage {
+    definition: LocaleDefinition;
+    translated: number;
+    total: number;
+    percent: number;
+    missing: string[];
+}
+export declare function normalizeLocaleCode(value: string): string;
+export declare function listLocales(projectRoot: string): LocaleDefinition[];
+export declare function validateLocale(projectRoot: string, rawCode: string): LocaleCoverage;
+export declare function addLocale(projectRoot: string, rawCode: string, options?: {
+    name?: string;
+    direction?: LocaleDirection;
+}): LocaleDefinition;
+export declare function setLocaleEnabled(projectRoot: string, rawCode: string, enabled: boolean): LocaleCoverage;

package/dist/locale.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeLocaleCode = normalizeLocaleCode;
+exports.listLocales = listLocales;
+exports.validateLocale = validateLocale;
+exports.addLocale = addLocale;
+exports.setLocaleEnabled = setLocaleEnabled;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const WEB_I18N = (0, node_path_1.join)("apps", "web", "src", "lib", "i18n");
+function definitionsDir(projectRoot) {
+    return (0, node_path_1.join)(projectRoot, WEB_I18N, "locales");
+}
+function catalogsDir(projectRoot) {
+    return (0, node_path_1.join)(projectRoot, WEB_I18N, "catalogs");
+}
+function appCatalogDir(projectRoot) {
+    return (0, node_path_1.join)(catalogsDir(projectRoot), "app");
+}
+function normalizeLocaleCode(value) {
+    try {
+        const normalized = Intl.getCanonicalLocales(value)[0];
+        if (!normalized)
+            throw new Error("missing locale");
+        return normalized;
+    }
+    catch {
+        throw new Error(`Invalid locale code "${value}". Use a BCP 47 language tag such as en, ko, or pt-BR.`);
+    }
+}
+function readJson(path) {
+    const value = JSON.parse((0, node_fs_1.readFileSync)(path, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`Expected a JSON object: ${path}`);
+    }
+    return value;
+}
+function readDefinition(path) {
+    const value = readJson(path);
+    const code = typeof value.code === "string" ? normalizeLocaleCode(value.code) : "";
+    const name = typeof value.name === "string" ? value.name.trim() : "";
+    const direction = value.direction;
+    const enabled = value.enabled;
+    if (!code || !name || (direction !== "ltr" && direction !== "rtl") || typeof enabled !== "boolean") {
+        throw new Error(`Invalid locale definition: ${path}`);
+    }
+    if (`${code}.json` !== (0, node_path_1.basename)(path)) {
+        throw new Error(`Locale definition filename must match its canonical code: ${code}.json`);
+    }
+    return { code, name, direction, enabled };
+}
+function listLocales(projectRoot) {
+    const dir = definitionsDir(projectRoot);
+    if (!(0, node_fs_1.existsSync)(dir))
+        throw new Error("This project does not contain PodoKit JSON locale definitions.");
+    return (0, node_fs_1.readdirSync)(dir)
+        .filter((name) => name.endsWith(".json"))
+        .map((name) => readDefinition((0, node_path_1.join)(dir, name)))
+        .sort((left, right) => left.code.localeCompare(right.code));
+}
+function merge(target, source) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        const previous = result[key];
+        if (previous && typeof previous === "object" && !Array.isArray(previous) &&
+            value && typeof value === "object" && !Array.isArray(value)) {
+            result[key] = merge(previous, value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function composedCatalog(projectRoot, code) {
+    const root = catalogsDir(projectRoot);
+    if (!(0, node_fs_1.existsSync)(root))
+        return {};
+    const sources = (0, node_fs_1.readdirSync)(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort((left, right) => {
+        const leftApp = left === "app" ? 1 : 0;
+        const rightApp = right === "app" ? 1 : 0;
+        return leftApp - rightApp || left.localeCompare(right);
+    });
+    let catalog = {};
+    for (const source of sources) {
+        const path = (0, node_path_1.join)(root, source, `${code}.json`);
+        if ((0, node_fs_1.existsSync)(path))
+            catalog = merge(catalog, readJson(path));
+    }
+    return catalog;
+}
+function flatten(value, prefix = "", out = new Map()) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            out.set(prefix, value);
+        for (const [index, child] of value.entries()) {
+            flatten(child, `${prefix}[${index}]`, out);
+        }
+    }
+    else if (value && typeof value === "object") {
+        for (const [key, child] of Object.entries(value)) {
+            flatten(child, prefix ? `${prefix}.${key}` : key, out);
+        }
+    }
+    else {
+        out.set(prefix, value);
+    }
+    return out;
+}
+function placeholders(value) {
+    if (typeof value !== "string")
+        return [];
+    return [...value.matchAll(/\{(\w+)\}/g)].map((match) => match[1] ?? "").sort();
+}
+function validateLocale(projectRoot, rawCode) {
+    const code = normalizeLocaleCode(rawCode);
+    const definitionPath = (0, node_path_1.join)(definitionsDir(projectRoot), `${code}.json`);
+    if (!(0, node_fs_1.existsSync)(definitionPath))
+        throw new Error(`Locale ${code} has not been added.`);
+    const definition = readDefinition(definitionPath);
+    const base = new Map([...flatten(composedCatalog(projectRoot, "en"))].filter(([, value]) => value !== ""));
+    const selected = flatten(composedCatalog(projectRoot, code));
+    const missing = [];
+    for (const [key, baseValue] of base) {
+        if (!selected.has(key) || selected.get(key) === "") {
+            missing.push(key);
+            continue;
+        }
+        const selectedValue = selected.get(key);
+        const baseKind = Array.isArray(baseValue) ? "array" : typeof baseValue;
+        const selectedKind = Array.isArray(selectedValue) ? "array" : typeof selectedValue;
+        if (baseKind !== selectedKind)
+            throw new Error(`${code}:${key} must be ${baseKind}, received ${selectedKind}`);
+        if (placeholders(baseValue).join(",") !== placeholders(selectedValue).join(",")) {
+            throw new Error(`${code}:${key} must preserve placeholders ${placeholders(baseValue).join(", ")}`);
+        }
+    }
+    const total = base.size;
+    const translated = total - missing.length;
+    return {
+        definition,
+        translated,
+        total,
+        percent: total === 0 ? 100 : Math.round((translated / total) * 100),
+        missing,
+    };
+}
+function defaultLocaleName(code) {
+    try {
+        return new Intl.DisplayNames([code], { type: "language" }).of(code) ?? code;
+    }
+    catch {
+        return code;
+    }
+}
+function addLocale(projectRoot, rawCode, options = {}) {
+    const code = normalizeLocaleCode(rawCode);
+    const definitionPath = (0, node_path_1.join)(definitionsDir(projectRoot), `${code}.json`);
+    const catalogPath = (0, node_path_1.join)(appCatalogDir(projectRoot), `${code}.json`);
+    if ((0, node_fs_1.existsSync)(definitionPath) || (0, node_fs_1.existsSync)(catalogPath))
+        throw new Error(`Locale ${code} already exists.`);
+    const definition = {
+        code,
+        name: options.name?.trim() || defaultLocaleName(code),
+        direction: options.direction ?? "ltr",
+        enabled: false,
+    };
+    (0, node_fs_1.mkdirSync)(definitionsDir(projectRoot), { recursive: true });
+    (0, node_fs_1.mkdirSync)(appCatalogDir(projectRoot), { recursive: true });
+    (0, node_fs_1.writeFileSync)(definitionPath, `${JSON.stringify(definition, null, 2)}\n`);
+    (0, node_fs_1.writeFileSync)(catalogPath, "{}\n");
+    return definition;
+}
+function setLocaleEnabled(projectRoot, rawCode, enabled) {
+    const coverage = validateLocale(projectRoot, rawCode);
+    if (!enabled && coverage.definition.code === "en")
+        throw new Error("The PodoKit English fallback cannot be deactivated.");
+    const definition = { ...coverage.definition, enabled };
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(definitionsDir(projectRoot), `${definition.code}.json`), `${JSON.stringify(definition, null, 2)}\n`);
+    return { ...coverage, definition };
+}

package/dist/lockfile.d.ts

@@ -32,6 +32,8 @@ export interface PodokitManifest {
     modules: ManifestModule[];
     /** Globs whose files are user-owned and never touched by update. */
     ownedGlobs: string[];
+    /** Module-supplied globs that stay managed even inside a broad owned glob. */
+    managedOverrides?: string[];
 }
 export interface FileEntry {
     tier: Tier;
@@ -64,11 +66,11 @@ export declare function podokitVersion(): string;
 /** Match a POSIX relative path against a simple glob supporting `*` and `**`. */
 export declare function matchGlob(path: string, glob: string): boolean;
 /** Classify a file's ownership tier. See ADR-0010 priority order. */
-export declare function classifyTier(relPath: string, content: string | Buffer, ownedGlobs: string[]): Tier;
+export declare function classifyTier(relPath: string, content: string | Buffer, ownedGlobs: string[], managedOverrides?: string[]): Tier;
 /** List project files as POSIX-relative paths, skipping generated/vendored dirs. */
 export declare function walkFiles(projectRoot: string, prefix?: string): string[];
 /** Recompute the files.lock by hashing and classifying every project file. */
-export declare function computeFilesLock(projectRoot: string, ownedGlobs: string[]): FilesLock;
+export declare function computeFilesLock(projectRoot: string, ownedGlobs: string[], managedOverrides?: string[]): FilesLock;
 export declare function readFilesLock(projectRoot: string): FilesLock | null;
 export interface Drift {
     /** Managed/assembled files whose content differs from what PodoKit wrote. */
@@ -101,4 +103,4 @@ export declare function mergeOwnedGlobs(existing: string[], add: string[]): stri
  * `ownedGlobs` a module declares are merged into the manifest so its owned paths
  * survive every future recompute. No-op on projects without a manifest.
  */
-export declare function recordModules(projectRoot: string, moduleInputs: (string | ManifestModuleInput)[], version?: string, ownedGlobs?: string[], lockSnapshot?: RecordModulesLockSnapshot): void;
+export declare function recordModules(projectRoot: string, moduleInputs: (string | ManifestModuleInput)[], version?: string, ownedGlobs?: string[], lockSnapshot?: RecordModulesLockSnapshot, managedOverrides?: string[]): void;

package/dist/lockfile.js

@@ -45,6 +45,9 @@ const WALK_IGNORE = new Set([
 exports.DEFAULT_OWNED_GLOBS = [
     "apps/web/src/routes/**",
     "apps/web/src/lib/components/ui/**",
+    // Locale definitions and app messages are application-owned extension points.
+    "apps/web/src/lib/i18n/locales/**",
+    "apps/web/src/lib/i18n/catalogs/app/**",
     // Owned Nest DI extension slot — override providers here; update never touches it.
     "apps/api/src/app.extensions.ts",
     // AI agent guidance — yours to customize; update never touches it.
@@ -62,6 +65,7 @@ exports.DEFAULT_OWNED_GLOBS = [
     ".devcontainer/**",
     ".env.docker",
     "infra/traefik/**",
+    ".podokit/dev.json",
 ];
 const TEXT_EXT = /\.(json|md|ts|tsx|js|mjs|cjs|css|html|yml|yaml|txt|env|svelte|gitignore|example)$/i;
 function podokitDir(projectRoot) {
@@ -114,7 +118,12 @@ function isTextPath(relPath) {
     return relPath.startsWith("dot-") || TEXT_EXT.test(relPath);
 }
 /** Classify a file's ownership tier. See ADR-0010 priority order. */
-function classifyTier(relPath, content, ownedGlobs) {
+function classifyTier(relPath, content, ownedGlobs, managedOverrides = []) {
+    const explicitlyOwned = ownedGlobs.some((glob) => !glob.includes("*") && matchGlob(relPath, glob));
+    if (explicitlyOwned)
+        return "owned";
+    if (managedOverrides.some((glob) => matchGlob(relPath, glob)))
+        return "managed";
     if (ownedGlobs.some((glob) => matchGlob(relPath, glob)))
         return "owned";
     if (isTextPath(relPath) && content.toString("utf8").includes(INJECTION_MARKER))
@@ -138,11 +147,14 @@ function walkFiles(projectRoot, prefix = "") {
     return out;
 }
 /** Recompute the files.lock by hashing and classifying every project file. */
-function computeFilesLock(projectRoot, ownedGlobs) {
+function computeFilesLock(projectRoot, ownedGlobs, managedOverrides = []) {
     const files = {};
     for (const rel of walkFiles(projectRoot).sort()) {
         const content = (0, node_fs_1.readFileSync)((0, node_path_1.join)(projectRoot, rel));
-        files[rel] = { tier: classifyTier(rel, content, ownedGlobs), outHash: (0, podokit_template_engine_1.hashContent)(content) };
+        files[rel] = {
+            tier: classifyTier(rel, content, ownedGlobs, managedOverrides),
+            outHash: (0, podokit_template_engine_1.hashContent)(content),
+        };
     }
     return { schemaVersion: exports.LOCK_SCHEMA_VERSION, files };
 }
@@ -185,6 +197,7 @@ function initLockfile(projectRoot, options) {
         answers: options.answers,
         modules: [],
         ownedGlobs,
+        managedOverrides: [],
     };
     writeManifest(projectRoot, manifest);
     writeFilesLock(projectRoot, computeFilesLock(projectRoot, ownedGlobs));
@@ -209,7 +222,7 @@ function mergeOwnedGlobs(existing, add) {
  * `ownedGlobs` a module declares are merged into the manifest so its owned paths
  * survive every future recompute. No-op on projects without a manifest.
  */
-function recordModules(projectRoot, moduleInputs, version, ownedGlobs, lockSnapshot) {
+function recordModules(projectRoot, moduleInputs, version, ownedGlobs, lockSnapshot, managedOverrides) {
     const manifest = readManifest(projectRoot);
     if (!manifest)
         return;
@@ -234,8 +247,11 @@ function recordModules(projectRoot, moduleInputs, version, ownedGlobs, lockSnaps
     }
     if (ownedGlobs?.length)
         manifest.ownedGlobs = mergeOwnedGlobs(manifest.ownedGlobs, ownedGlobs);
+    if (managedOverrides?.length) {
+        manifest.managedOverrides = mergeOwnedGlobs(manifest.managedOverrides ?? [], managedOverrides);
+    }
     writeManifest(projectRoot, manifest);
-    const computed = computeFilesLock(projectRoot, manifest.ownedGlobs);
+    const computed = computeFilesLock(projectRoot, manifest.ownedGlobs, manifest.managedOverrides ?? []);
     if (!lockSnapshot) {
         writeFilesLock(projectRoot, computed);
         return;

package/dist/remove.js

@@ -107,8 +107,11 @@ function removeModule(options) {
     manifest.modules = manifest.modules
         .filter((m) => m.name !== module)
         .map((m, i) => ({ ...m, order: i }));
+    const sharedManagedOverrides = new Set(others.flatMap((other) => other.manifest.managedOverrides ?? []));
+    const targetManagedOverrides = new Set(targetManifest.managedOverrides ?? []);
+    manifest.managedOverrides = (manifest.managedOverrides ?? []).filter((glob) => !targetManagedOverrides.has(glob) || sharedManagedOverrides.has(glob));
     (0, lockfile_1.writeManifest)(projectRoot, manifest);
-    (0, lockfile_1.writeFilesLock)(projectRoot, (0, lockfile_1.computeFilesLock)(projectRoot, manifest.ownedGlobs));
+    (0, lockfile_1.writeFilesLock)(projectRoot, (0, lockfile_1.computeFilesLock)(projectRoot, manifest.ownedGlobs, manifest.managedOverrides));
     return { module, removed, keptEdited, keptShared, unwired };
 }
 /** Remove now-empty directories left behind by a deleted file, up to the root. */
@@ -126,33 +129,33 @@ function pruneEmptyDirs(projectRoot, relDir) {
     }
 }
 function pruneAppPackage(projectRoot, target, others) {
-    if (!(target.dependencies || target.devDependencies || target.scripts))
-        return;
-    const appPkgPath = (0, node_path_1.join)(projectRoot, "apps", target.targetApp, "package.json");
-    if (!(0, node_fs_1.existsSync)(appPkgPath))
-        return;
-    const keep = (section) => new Set(others.flatMap((o) => Object.keys(o.manifest[section] ?? {})));
-    const pkg = readJson(appPkgPath);
-    let changed = false;
-    for (const section of ["dependencies", "devDependencies", "scripts"]) {
-        const declared = target[section];
-        const current = pkg[section];
-        if (!declared || !current)
+    for (const [app, declaration] of (0, add_1.modulePackageOverlays)(target)) {
+        const appPkgPath = (0, node_path_1.join)(projectRoot, "apps", app, "package.json");
+        if (!(0, node_fs_1.existsSync)(appPkgPath))
             continue;
-        const shared = keep(section);
-        for (const name of Object.keys(declared)) {
-            if (shared.has(name))
+        const keep = (section) => new Set(others.flatMap((other) => Object.keys((0, add_1.modulePackageOverlays)(other.manifest).get(app)?.[section] ?? {})));
+        const pkg = readJson(appPkgPath);
+        let changed = false;
+        for (const section of ["dependencies", "devDependencies", "scripts"]) {
+            const declared = declaration[section];
+            const current = pkg[section];
+            if (!declared || !current)
                 continue;
-            if (name in current) {
-                delete current[name];
-                changed = true;
+            const shared = keep(section);
+            for (const name of Object.keys(declared)) {
+                if (shared.has(name))
+                    continue;
+                if (name in current) {
+                    delete current[name];
+                    changed = true;
+                }
             }
+            if (current && Object.keys(current).length === 0)
+                delete pkg[section];
         }
-        if (current && Object.keys(current).length === 0)
-            delete pkg[section];
+        if (changed)
+            (0, node_fs_1.writeFileSync)(appPkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
     }
-    if (changed)
-        (0, node_fs_1.writeFileSync)(appPkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
 }
 function pruneEnvExample(projectRoot, target, others) {
     if (!target.env?.length)

package/dist/templates/fullstack-nest-svelte/README.md

@@ -8,10 +8,49 @@ Full-stack TypeScript starter generated with [PodoKit](https://github.com/podoso
 
 ## Getting started
 
+### Recommended: containerized development
+
 ```bash
 {{packageManager}} install
 cp .env.example .env
+npx @podosoft/podokit dev watch
+```
+
+Open the URL printed by the command; a new project defaults to
+**http://{{projectName}}.localhost**. The committed `.podokit/dev.json` is the
+source of truth if you change the hostname. The first running PodoKit project starts
+one user-level Traefik gateway on `127.0.0.1:80`; additional projects reuse it and
+route by that hostname. Even a single app uses
+the same topology, with one route and no project-specific host port.
+
+Run lifecycle and container commands from a second terminal:
+
+```bash
+npx @podosoft/podokit dev url
+npx @podosoft/podokit dev ps
+npx @podosoft/podokit dev logs
+npx @podosoft/podokit dev exec api npm run migration:run -w {{projectName}}-api
+npx @podosoft/podokit dev down
+```
+
+If installed modules require extra services, use their profiles on the initial
+watch command instead:
 
+```bash
+npx @podosoft/podokit dev watch \
+  --profile cache --profile storage --profile queue
+```
+
+Pass the same profile flags to other lifecycle commands when applicable. `dev down`
+removes this project's stack and route. If it is the final registered
+project, it also removes the shared gateway and network. Source changes are synced
+through Compose Watch, including Vite HMR on the same portless browser origin.
+
+### Alternative: host processes
+
+Use this loop when you want only the web and API processes on the host:
+
+```bash
 # start local PostgreSQL + Redis
 docker compose -f infra/docker/docker-compose.yml up -d
 
@@ -35,6 +74,9 @@ generate and run a migration:
 Want a worked example? Generate the `todo` template instead:
 `npx @podosoft/podokit create my-app --template todo`.
 
+For multi-project routing, container profiles, migrations, and OAuth over a
+stable HTTPS tunnel, see the PodoKit [development guide](https://github.com/podosoft-dev/podokit/blob/main/docs/development.md).
+
 ## Deploy
 
 Docker Compose in `infra/docker`; example k3s manifests in `infra/k3s`

package/dist/templates/fullstack-nest-svelte/apps/api/Dockerfile

@@ -20,6 +20,7 @@ RUN addgroup -S app && adduser -S app -G app
 COPY --from=build /app/node_modules ./node_modules
 COPY --from=deps /app/apps/api ./apps/api
 COPY --from=build /app/apps/api/dist ./apps/api/dist
+COPY --from=build /app/apps/api/scripts ./apps/api/scripts
 WORKDIR /app/apps/api
 USER app
 EXPOSE 3000

package/dist/templates/fullstack-nest-svelte/apps/api/scripts/.keep

@@ -0,0 +1 @@
+

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/README.md

@@ -1,7 +1,9 @@
-# i18n
+# Localization
 
-Locales use [typesafe-i18n](https://github.com/ivanhofer/typesafe-i18n).
+Locale definitions live in `locales/<code>.json`. Product copy and intentional
+module overrides live in the app-owned `catalogs/app/<code>.json` files.
 
-- `en.ts` is the base locale; `ko.ts` mirrors its shape.
-- Run `npx typesafe-i18n` to generate the typed runtime and Svelte store,
-  then use `$LL.appTitle()` in components. Add keys to every locale.
+The admin-dashboard module installs the composed JSON message runtime and its
+complete English and Korean catalogs. Use `podo locale add`, `validate`, and
+`activate` to extend it. See the generated `$podokit-add-locale` skill for the
+complete workflow.

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/catalogs/app/en.json

@@ -0,0 +1 @@
+{}

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/catalogs/app/ko.json

@@ -0,0 +1 @@
+{}

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/locales/en.json

@@ -0,0 +1,6 @@
+{
+  "code": "en",
+  "name": "English",
+  "direction": "ltr",
+  "enabled": true
+}

package/dist/templates/fullstack-nest-svelte/apps/web/src/lib/i18n/locales/ko.json

@@ -0,0 +1,6 @@
+{
+  "code": "ko",
+  "name": "한국어",
+  "direction": "ltr",
+  "enabled": true
+}