@fjall/generator 22.0.0 → 24.0.0

package/dist/.build-source-hash

@@ -9,7 +9,7 @@
     "package.json",
     "tsconfig.json"
   ],
-  "hash": "072da3c52c9b559750731318bd00cee13ef1e254a1b6e8ece9e9f4378f958c06",
+  "hash": "f7719f98cd378ddbe28b4db7318ab783f99247be7b80208b9152ecacbdc9a9e1",
   "files": {
     "src/ast/astTestHelpers.ts": "026cac849eb88bdb",
     "src/ast/domain/astDomainParser.ts": "a88b990396db0a46",
@@ -111,7 +111,7 @@
     "src/codemod/validationGate/gates/schema.ts": "7ed5acaec0620a46",
     "src/codemod/validationGate/index.ts": "bbe1f460330a11cf",
     "src/codemod/validationGate/types.ts": "4a1cfa054e3383d5",
-    "src/detection/index.ts": "88a577f0173028d4",
+    "src/detection/index.ts": "cd321fd291b7388b",
     "src/dns/bindParser.ts": "2b463c4dd1395ae5",
     "src/dns/bindWriter.ts": "c296911ce5aef77c",
     "src/dns/domainFileGenerator.ts": "f2d0ba8cca5ab1c9",
@@ -143,7 +143,7 @@
     "src/planning/resourceAddition.ts": "7d0320620a74fdcd",
     "src/planning/resourceConnections.ts": "a6b7db8f733e560f",
     "src/planning/resourcePlanning.ts": "d6bb9fa8e1419908",
-    "src/planning/staticSitePlanning.ts": "242af1e9618821ab",
+    "src/planning/staticSitePlanning.ts": "ee0b100e081061be",
     "src/presets/clickhouseTierPreset.ts": "1758d991c81d769a",
     "src/presets/index.ts": "8332c0198b2a6fe9",
     "src/presets/patternTierPresets.ts": "f4fc368fc623aae4",
@@ -158,7 +158,7 @@
     "src/projection/types.ts": "68045bc02a36cee9",
     "src/projection/unresolved.ts": "885c8d3c1624b328",
     "src/schemas/alarmSchemas.ts": "beb19255d37ed43d",
-    "src/schemas/applicationSchemas.ts": "d85771a4607cf2da",
+    "src/schemas/applicationSchemas.ts": "12ee3bc2654717f0",
     "src/schemas/baseSchemas.ts": "93d9bd1c0adfcaa0",
     "src/schemas/buildkiteSchemas.ts": "a28ec3b40f7851ec",
     "src/schemas/cdnSchemas.ts": "16784f15894c62ba",
@@ -171,7 +171,7 @@
     "src/schemas/messagingSchemas.ts": "2c1975fac903fd1b",
     "src/schemas/networkSchemas.ts": "c3a5f30e440dd2f8",
     "src/schemas/organisationSchemas.ts": "50d793aa7ff7f749",
-    "src/schemas/patternSchemas.ts": "2ad2ed522c244ac1",
+    "src/schemas/patternSchemas.ts": "8b48dfb02852a7ba",
     "src/schemas/resourceSchemas.ts": "cd050813242ea213",
     "src/schemas/securityBoundary.ts": "54d216807103bab8",
     "src/schemas/sharedTypes.ts": "45210e600bea393e",
@@ -181,11 +181,11 @@
     "src/validation/patterns.ts": "f9629eafdad7ac3e",
     "src/validation/validationMessages.ts": "b03413b3953c3e79",
     "src/validation/validationPatterns.ts": "865f3d688975b7c8",
-    "src/version.ts": "b24668563e688655",
+    "src/version.ts": "628659b85d1e2c43",
     "../scripts/minify-dist.mjs": "6b2e4b0df8aec601",
-    "package.json": "68bbbd728e286eff",
+    "package.json": "097bea1fa43d11c5",
     "tsconfig.json": "1929cf3f99fe9b1e"
   },
-  "outputHash": "b14439370356dd742ad72b81c29bf80df1c5ce3ffbd9470bac6637e6d3d42843",
+  "outputHash": "b758bb39fed2cbf694ae9e1df71412a218866466be0c834122143536d0d13cf3",
   "outputFileCount": 343
 }

package/dist/.minified

@@ -1 +1 @@
-171 files minified at 2026-08-30T00:18:26.718Z
+171 files minified at 2026-08-30T07:28:36.308Z

package/dist/src/ast/astTestHelpers.d.ts

@@ -342,7 +342,7 @@ export declare function parseAndConvert(code: string): {
             command: string;
             outputDir: string;
         };
-        routing?: "multipage" | "spa" | undefined;
+        routing?: "multipage" | "directory" | "spa" | undefined;
         security?: {
             headers?: boolean | undefined;
             contentSecurityPolicy?: string | undefined;

package/dist/src/detection/index.d.ts

@@ -10,7 +10,7 @@
  * `apps detect --output json` frame and the MCP `detect_app_framework`
  * tool's `outputSchema`.
  */
-import { type Framework } from "@fjall/util";
+import { type Framework, type StaticSiteRouting } from "@fjall/util";
 import { z } from "zod";
 /**
  * The framework vocabulary now lives in `@fjall/util/patterns`, beside the
@@ -104,24 +104,132 @@ export declare const CreatePrefillSchema: z.ZodObject<{
     outputDir: z.ZodNullable<z.ZodString>;
     routing: z.ZodNullable<z.ZodEnum<{
         multipage: "multipage";
+        directory: "directory";
         spa: "spa";
     }>>;
 }, z.core.$strict>;
 export type CreatePrefill = z.infer<typeof CreatePrefillSchema>;
+export declare const PACKAGE_MANAGER_VALUES: readonly ["npm", "pnpm", "yarn", "bun"];
+export type PackageManager = (typeof PACKAGE_MANAGER_VALUES)[number];
+/**
+ * The lockfile that proves each manager.
+ *
+ * Keyed on the MANAGER, not on the file, so the vocabulary cannot grow a member
+ * that no evidence can ever reach — a manager without a lockfile here fails to
+ * compile rather than becoming silently undetectable. That is the shape of the
+ * bug this table exists to close: the manager vocabulary and the set of files
+ * actually probed drifted apart, so pnpm was only recognised through
+ * `pnpm-workspace.yaml` and never through its lockfile.
+ *
+ * The value is a NON-EMPTY tuple. A manager whose evidence list is empty would
+ * satisfy a plain `string[]` while being exactly as undetectable as one that is
+ * missing, so the type refuses to let detectability be claimed without naming a
+ * file that proves it.
+ */
+export declare const PACKAGE_MANAGER_LOCKFILES: {
+    readonly npm: readonly ["package-lock.json"];
+    readonly pnpm: readonly ["pnpm-lock.yaml"];
+    readonly yarn: readonly ["yarn.lock"];
+    readonly bun: readonly ["bun.lock", "bun.lockb"];
+};
+/**
+ * Which package manager runs this repo's scripts.
+ *
+ * Deliberately orthogonal to `MonorepoTool`. The two were conflated — the build
+ * command was chosen by asking `inferMonorepoTool`, whose ladder returns the
+ * ORCHESTRATOR in preference to the manager — so turbo-on-pnpm (a common pair,
+ * not an exotic one) reported `npm run build`, and so did every yarn repo, every
+ * bun repo, and every flat pnpm repo that has a lockfile but no
+ * `pnpm-workspace.yaml`. A repo has both a manager and, sometimes, an
+ * orchestrator; asking one question cannot answer the other.
+ *
+ * Absent evidence resolves to npm: it ships with Node, so a repo with no
+ * lockfile and no declared manager is npm's by default rather than by guess.
+ * Contradictory evidence (two lockfiles committed) is not a tie to break — the
+ * declared field decides, and npm is the fallback.
+ */
+export declare function inferPackageManager(rootPackageJson: ParsedPackageJson | null, markers: MarkerFiles): PackageManager;
+/**
+ * Astro's `build.format` vocabulary — the setting that decides which object
+ * each page becomes, and therefore which routing mode serves the site.
+ */
+export declare const ASTRO_BUILD_FORMAT_VALUES: readonly ["file", "directory", "preserve"];
+export type AstroBuildFormat = (typeof ASTRO_BUILD_FORMAT_VALUES)[number];
+/**
+ * Config filenames Astro will load, in the order the CLI probes them. Owned
+ * here beside the parser so the I/O wrapper cannot probe a spelling the
+ * parser was never taught about.
+ */
+export declare const ASTRO_CONFIG_FILENAMES: readonly ["astro.config.mjs", "astro.config.js", "astro.config.ts", "astro.config.cjs", "astro.config.mts", "astro.config.cts"];
+/**
+ * Read `build.format` out of an Astro config's text.
+ *
+ * A bounded regex over comment-stripped text, not an AST: this runs on the
+ * CLI and MCP detect paths, and pulling a TypeScript parser into those
+ * bundles for one key is weight no other detection signal pays. The match is
+ * bounded on both sides — the key must be `format` and the value must be one
+ * of Astro's three format literals — so `format:` keys with other values (an
+ * image config, a date format) cannot match. Returns null when the text
+ * states no format; callers resolve that to Astro's default ("directory").
+ */
+export declare function parseAstroBuildFormat(configText: string): AstroBuildFormat | null;
+/**
+ * The routing mode that serves each Astro build format, total over the format
+ * vocabulary so a format Astro adds cannot silently fall through to a wrong
+ * default.
+ *
+ * `preserve` maps to null deliberately: it keeps whichever shape each source
+ * file already had, so no single rewrite serves the whole site — the gap is
+ * left marked for the user rather than filled with a plausible mode.
+ */
+export declare const ASTRO_FORMAT_TO_ROUTING: {
+    readonly file: "multipage";
+    readonly directory: "directory";
+    readonly preserve: null;
+};
+/**
+ * Routing for an Astro workspace, from its config text (null when no config
+ * file exists). Absence of the file, and absence of `build.format` inside
+ * it, both mean Astro's default: "directory".
+ */
+export declare function inferAstroRouting(configText: string | null): StaticSiteRouting | null;
+/**
+ * Re-frame a repo-root-relative workspace path as the `source` value the
+ * static-site pattern is actually read in.
+ *
+ * `source` is not repo-root-relative, though it long claimed to be. deploy-core
+ * runs the build in `resolve(appPath, buildCommand.cwd)` and the CDK construct
+ * uploads `resolve(this.props.source, build.outputDir)` from a child process
+ * whose cwd is that same `appPath` — the app's config directory. Emitting the
+ * repo-root path put both one boundary too deep, and neither consumer errors:
+ * the value simply resolves somewhere else, which is why this shipped. Every
+ * hand-written example in `components/infrastructure` carries the climb
+ * (`source: "../.."`), and this makes the generated value agree with them.
+ *
+ * An absolute path is returned untouched. `relativise` yields one for a
+ * workspace that resolves outside the scanned root (a `workspaces` glob may
+ * escape it), and an absolute source already resolves correctly from any cwd —
+ * prefixing a climb would corrupt a value that was right.
+ */
+export declare function toConfigDirRelativeSource(relativePath: string): string;
 /**
  * Assemble the create prefill for one detected workspace. Pure: the caller
- * supplies the parsed `package.json` and the repo's monorepo tool.
+ * supplies the parsed `package.json`, the repo's package manager, and the
+ * framework's own routing verdict (`inferAstroRouting` for Astro; null when
+ * the framework states none — the gap rides through rather than being
+ * defaulted here).
  */
 export declare function inferCreatePrefill(input: {
     framework: Framework;
     relativePath: string;
     pkg: ParsedPackageJson | null;
-    monorepoTool: MonorepoTool | null;
+    packageManager: PackageManager;
+    routing: StaticSiteRouting | null;
 }): CreatePrefill | null;
 export declare const MONOREPO_TOOL_VALUES: readonly ["npm-workspaces", "pnpm", "lerna", "turbo", "nx"];
 export declare const MonorepoToolSchema: z.ZodEnum<{
-    "npm-workspaces": "npm-workspaces";
     pnpm: "pnpm";
+    "npm-workspaces": "npm-workspaces";
     lerna: "lerna";
     turbo: "turbo";
     nx: "nx";
@@ -181,6 +289,7 @@ export declare const AppDetectionSchema: z.ZodObject<{
         outputDir: z.ZodNullable<z.ZodString>;
         routing: z.ZodNullable<z.ZodEnum<{
             multipage: "multipage";
+            directory: "directory";
             spa: "spa";
         }>>;
     }, z.core.$strict>>;
@@ -189,8 +298,8 @@ export type AppDetection = z.infer<typeof AppDetectionSchema>;
 export declare const RepositoryDetectionSchema: z.ZodObject<{
     isMonorepo: z.ZodBoolean;
     monorepoTool: z.ZodNullable<z.ZodEnum<{
-        "npm-workspaces": "npm-workspaces";
         pnpm: "pnpm";
+        "npm-workspaces": "npm-workspaces";
         lerna: "lerna";
         turbo: "turbo";
         nx: "nx";
@@ -250,6 +359,7 @@ export declare const RepositoryDetectionSchema: z.ZodObject<{
             outputDir: z.ZodNullable<z.ZodString>;
             routing: z.ZodNullable<z.ZodEnum<{
                 multipage: "multipage";
+                directory: "directory";
                 spa: "spa";
             }>>;
         }, z.core.$strict>>;
@@ -265,12 +375,20 @@ export interface ParsedPackageJson {
     dependencies?: Record<string, string>;
     devDependencies?: Record<string, string>;
     scripts?: Record<string, string>;
+    /** Corepack's declared manager, e.g. `"pnpm@9.1.0"`. */
+    packageManager?: string;
 }
 export interface MarkerFiles {
     pnpmWorkspaceYaml: boolean;
     lernaJson: boolean;
     turboJson: boolean;
     nxJson: boolean;
+    /**
+     * Which manager's lockfile is present. Total over `PackageManager` so the
+     * probe cannot fall behind the vocabulary: adding a manager fails to compile
+     * here and at every collection site until its lockfile is actually stat'd.
+     */
+    lockfiles: Record<PackageManager, boolean>;
 }
 /**
  * Determine the monorepo tool from root package.json + marker files.

package/dist/src/detection/index.js

@@ -1 +1 @@
-var c=Object.defineProperty;var o=(e,t)=>c(e,"name",{value:t,configurable:!0});import{buildAppConfigPath as p,FRAMEWORK_VALUES as u,PATTERN_TYPE_VALUES as s,STATIC_SITE_ROUTING_VALUES as f,recommendPatternForFramework as d}from"@fjall/util";import{z as r}from"zod";import{FRAMEWORK_VALUES as q,FRAMEWORKS as V,isFramework as I,FRAMEWORK_PATTERN_RECOMMENDATIONS as B,recommendPatternForFramework as G,CREATABLE_FRAMEWORKS as J}from"@fjall/util";const m=r.enum(u),b=["application","library"],k=r.enum(b);function T(e,t){return e!=="unknown"||t?"application":"library"}o(T,"inferAppRole");const g=r.discriminatedUnion("kind",[r.object({kind:r.literal("recommended"),pattern:r.enum(s),rationale:r.string()}).strict(),r.object({kind:r.literal("blocked"),pattern:r.enum(s),reason:r.string()}).strict(),r.object({kind:r.literal("unsupported"),reason:r.string()}).strict()]),w={astro:"dist",nextjs:"out","nextjs+payload":null,payload:null,remix:null,express:null,unknown:null},x=r.object({pattern:r.enum(s),source:r.string().describe("Directory the build runs in, relative to the repo root."),buildCommand:r.string().nullable().describe("Build command, from the workspace's own build script. Null when it declares none."),outputDir:r.string().nullable().describe("Build output directory relative to `source`, by framework convention \u2014 NOT verified against disk. Confirm it exists after building before deploying."),routing:r.enum(f).nullable()}).strict();function h(e){return e==="pnpm"?"pnpm run build":"npm run build"}o(h,"buildCommandFor");function F(e){const t=d(e.framework);if(t.kind!=="recommended")return null;const n=typeof e.pkg?.scripts?.build=="string"&&e.pkg.scripts.build.trim().length>0;return{pattern:t.pattern,source:e.relativePath===""?".":e.relativePath,buildCommand:n?h(e.monorepoTool):null,outputDir:w[e.framework],routing:t.pattern==="staticsite"?"multipage":null}}o(F,"inferCreatePrefill");const A=["npm-workspaces","pnpm","lerna","turbo","nx"],E=r.enum(A),R=r.object({relativePath:r.string().describe("Path relative to repo root. '.' for flat repo, e.g. 'apps/website' for monorepo workspace."),framework:m,packageName:r.string().nullable(),hasDockerfile:r.boolean(),docker:r.object({path:r.string().describe("Path to chosen Dockerfile, relative to relativePath.")}).strict().nullable().describe("Docker build descriptor. Null if no Dockerfile present."),inferredPort:r.number().int().min(1).max(65535),suggestedAppName:r.string().describe("kebab-case app name suggestion derived from packageName or relativePath."),suggestedConfigPath:r.string().describe("Suggested fjall config path relative to repo root, e.g. 'fjall/website' or 'apps/website/fjall/website'."),role:k.describe("'application' if deployable evidence was found (a framework, or a Dockerfile); 'library' otherwise. Do not scaffold libraries."),recommendation:g.describe("What this workspace's framework means for `fjall apps create --pattern`. Pass `pattern` from here; never pass the framework name."),create:x.nullable().describe("Values to pass to `fjall apps create`, read from the repository. Null when no pattern applies.")}).strict(),O=r.object({isMonorepo:r.boolean(),monorepoTool:E.nullable(),rootPackageName:r.string().nullable(),apps:r.array(R).describe("Detected apps. Empty if nothing scaffoldable was found. Single-element for flat repos, multi-element for monorepos."),warnings:r.array(r.string()).describe("Non-fatal observations (e.g. 'apps/legacy has no package.json \u2014 skipped').")}).strict();function _(e,t){return t.turboJson?"turbo":t.nxJson?"nx":t.pnpmWorkspaceYaml?"pnpm":t.lernaJson?"lerna":e?.workspaces?"npm-workspaces":null}o(_,"inferMonorepoTool");function j(e){return e?.workspaces?Array.isArray(e.workspaces)?e.workspaces:e.workspaces.packages??[]:[]}o(j,"extractWorkspaceGlobs");const D=[{framework:"nextjs+payload",required:["next","payload"]},{framework:"nextjs",required:["next"]},{framework:"payload",required:["payload"]},{framework:"remix",required:["@remix-run/node"]},{framework:"astro",required:["astro"]},{framework:"express",required:["express"]}];function M(e){if(!e)return"unknown";const t={...e.dependencies??{},...e.devDependencies??{}};for(const n of D)if(n.required.every(a=>a in t))return n.framework;return"unknown"}o(M,"inferFrameworkFromDeps");const y={nextjs:3e3,"nextjs+payload":3e3,payload:3e3,remix:3e3,astro:4321,express:3e3,unknown:3e3};function C(e){return y[e]}o(C,"inferPortForFramework");function N(e){if(e.length===0)return null;const t=e.find(i=>i==="Dockerfile");if(t)return{name:t,isDev:!1};const n=e.find(i=>i.startsWith("Dockerfile")&&!/\.(dev|local|test)$/i.test(i));if(n)return{name:n,isDev:!1};const a=e.find(i=>/\.dev$/i.test(i));if(a)return{name:a,isDev:!0};const l=e[0];return l===void 0?null:{name:l,isDev:!1}}o(N,"pickPreferredDockerfile");function W(e,t){if(e){const a=e.replace(/^@[^/]+\//,"");if(a.length>0)return a}return t==="."||t===""?"app":t.split("/").pop()??"app"}o(W,"suggestAppName");function L(e,t){return t==="."||t===""?p(e):p(e,t)}o(L,"suggestConfigPath");export{b as APP_ROLE_VALUES,R as AppDetectionSchema,k as AppRoleSchema,J as CREATABLE_FRAMEWORKS,x as CreatePrefillSchema,V as FRAMEWORKS,w as FRAMEWORK_OUTPUT_DIRS,B as FRAMEWORK_PATTERN_RECOMMENDATIONS,q as FRAMEWORK_VALUES,m as FrameworkSchema,A as MONOREPO_TOOL_VALUES,E as MonorepoToolSchema,g as PatternRecommendationSchema,O as RepositoryDetectionSchema,j as extractWorkspaceGlobs,T as inferAppRole,F as inferCreatePrefill,M as inferFrameworkFromDeps,_ as inferMonorepoTool,C as inferPortForFramework,I as isFramework,N as pickPreferredDockerfile,G as recommendPatternForFramework,W as suggestAppName,L as suggestConfigPath};
+var d=Object.defineProperty;var o=(e,r)=>d(e,"name",{value:r,configurable:!0});import{buildAppConfigPath as l,FRAMEWORK_VALUES as b,PATTERN_TYPE_VALUES as p,STATIC_SITE_ROUTING_VALUES as g,recommendPatternForFramework as A}from"@fjall/util";import{z as t}from"zod";import{FRAMEWORK_VALUES as re,FRAMEWORKS as te,isFramework as ne,FRAMEWORK_PATTERN_RECOMMENDATIONS as oe,recommendPatternForFramework as ae,CREATABLE_FRAMEWORKS as se}from"@fjall/util";const k=t.enum(b),x=["application","library"],h=t.enum(x);function K(e,r){return e!=="unknown"||r?"application":"library"}o(K,"inferAppRole");const R=t.discriminatedUnion("kind",[t.object({kind:t.literal("recommended"),pattern:t.enum(p),rationale:t.string()}).strict(),t.object({kind:t.literal("blocked"),pattern:t.enum(p),reason:t.string()}).strict(),t.object({kind:t.literal("unsupported"),reason:t.string()}).strict()]),w={astro:"dist",nextjs:"out","nextjs+payload":null,payload:null,remix:null,express:null,unknown:null},y=t.object({pattern:t.enum(p),source:t.string().describe("Pass verbatim to `--source`. Relative to the app's `fjall/<name>` config directory, NOT the repo root \u2014 that is the frame every consumer resolves it in, so the leading `../..` is part of the value rather than a mistake. Assumes the app is scaffolded at `<repo root>/fjall/<name>`, which is where `apps create` puts it."),buildCommand:t.string().nullable().describe("Build command, from the workspace's own build script. Null when it declares none."),outputDir:t.string().nullable().describe("Build output directory relative to `source`, by framework convention \u2014 NOT verified against disk. Confirm it exists after building before deploying."),routing:t.enum(g).nullable().describe("Pass to `--routing`. Read from the framework's own build configuration (for Astro, `build.format`): 'multipage' when the build emits `about.html`, 'directory' when it emits `about/index.html`. Null when no single mode serves the layout (e.g. Astro's 'preserve') \u2014 ask rather than guess.")}).strict(),c=["npm","pnpm","yarn","bun"],E={npm:"npm run build",pnpm:"pnpm run build",yarn:"yarn run build",bun:"bun run build"},W={npm:["package-lock.json"],pnpm:["pnpm-lock.yaml"],yarn:["yarn.lock"],bun:["bun.lock","bun.lockb"]};function _(e){if(typeof e!="string")return null;const r=e.trim().split("@")[0];return c.find(n=>n===r)??null}o(_,"packageManagerFromField");function I(e,r){const n=_(e?.packageManager);if(n!==null)return n;const a=c.filter(i=>r.lockfiles[i]);return a.length===1?a[0]:"npm"}o(I,"inferPackageManager");function O(e){return E[e]}o(O,"buildCommandFor");const S=["file","directory","preserve"],G=["astro.config.mjs","astro.config.js","astro.config.ts","astro.config.cjs","astro.config.mts","astro.config.cts"];function D(e){const r=e.replace(/\/\*[\s\S]*?\*\//g,"").replace(/\/\/[^\n]*/g,""),n=new RegExp(`format\\s*:\\s*["'](${S.join("|")})["']`).exec(r);return n===null?null:n[1]}o(D,"parseAstroBuildFormat");const F={file:"multipage",directory:"directory",preserve:null};function V(e){const r=e===null?"directory":D(e)??"directory";return F[r]}o(V,"inferAstroRouting");const u=l("probe").split("/").map(()=>"..").join("/");function T(e){const r=e.trim().replace(/^\.\/+/,"").replace(/\/+$/,"");return r.startsWith("/")?r:r===""||r==="."?u:`${u}/${r}`}o(T,"toConfigDirRelativeSource");function B(e){const r=A(e.framework);if(r.kind!=="recommended")return null;const n=typeof e.pkg?.scripts?.build=="string"&&e.pkg.scripts.build.trim().length>0;return{pattern:r.pattern,source:T(e.relativePath),buildCommand:n?O(e.packageManager):null,outputDir:w[e.framework],routing:r.pattern==="staticsite"?e.routing:null}}o(B,"inferCreatePrefill");const j=["npm-workspaces","pnpm","lerna","turbo","nx"],v=t.enum(j),M=t.object({relativePath:t.string().describe("Path relative to repo root. '.' for flat repo, e.g. 'apps/website' for monorepo workspace."),framework:k,packageName:t.string().nullable(),hasDockerfile:t.boolean(),docker:t.object({path:t.string().describe("Path to chosen Dockerfile, relative to relativePath.")}).strict().nullable().describe("Docker build descriptor. Null if no Dockerfile present."),inferredPort:t.number().int().min(1).max(65535),suggestedAppName:t.string().describe("kebab-case app name suggestion derived from packageName or relativePath."),suggestedConfigPath:t.string().describe("Suggested fjall config path relative to repo root, e.g. 'fjall/website' or 'apps/website/fjall/website'."),role:h.describe("'application' if deployable evidence was found (a framework, or a Dockerfile); 'library' otherwise. Do not scaffold libraries."),recommendation:R.describe("What this workspace's framework means for `fjall apps create --pattern`. Pass `pattern` from here; never pass the framework name."),create:y.nullable().describe("Values to pass to `fjall apps create`, read from the repository. Null when no pattern applies.")}).strict(),$=t.object({isMonorepo:t.boolean(),monorepoTool:v.nullable(),rootPackageName:t.string().nullable(),apps:t.array(M).describe("Detected apps. Empty if nothing scaffoldable was found. Single-element for flat repos, multi-element for monorepos."),warnings:t.array(t.string()).describe("Non-fatal observations (e.g. 'apps/legacy has no package.json \u2014 skipped').")}).strict();function J(e,r){return r.turboJson?"turbo":r.nxJson?"nx":r.pnpmWorkspaceYaml?"pnpm":r.lernaJson?"lerna":e?.workspaces?"npm-workspaces":null}o(J,"inferMonorepoTool");function Y(e){return e?.workspaces?Array.isArray(e.workspaces)?e.workspaces:e.workspaces.packages??[]:[]}o(Y,"extractWorkspaceGlobs");const f={"nextjs+payload":["next","payload"],nextjs:["next"],payload:["payload"],remix:["@remix-run/node"],astro:["astro"],express:["express"]},m={"nextjs+payload":0,nextjs:1,payload:2,remix:3,astro:4,express:5},P=Object.keys(f).sort((e,r)=>m[e]-m[r]);function H(e){if(!e)return"unknown";const r={...e.dependencies??{},...e.devDependencies??{}};for(const n of P)if(f[n].every(a=>a in r))return n;return"unknown"}o(H,"inferFrameworkFromDeps");const C={nextjs:3e3,"nextjs+payload":3e3,payload:3e3,remix:3e3,astro:4321,express:3e3,unknown:3e3};function z(e){return C[e]}o(z,"inferPortForFramework");function q(e){if(e.length===0)return null;const r=e.find(s=>s==="Dockerfile");if(r)return{name:r,isDev:!1};const n=e.find(s=>s.startsWith("Dockerfile")&&!/\.(dev|local|test)$/i.test(s));if(n)return{name:n,isDev:!1};const a=e.find(s=>/\.dev$/i.test(s));if(a)return{name:a,isDev:!0};const i=e[0];return i===void 0?null:{name:i,isDev:!1}}o(q,"pickPreferredDockerfile");function Q(e,r){if(e){const a=e.replace(/^@[^/]+\//,"");if(a.length>0)return a}return r==="."||r===""?"app":r.split("/").pop()??"app"}o(Q,"suggestAppName");function X(e,r){return r==="."||r===""?l(e):l(e,r)}o(X,"suggestConfigPath");export{x as APP_ROLE_VALUES,S as ASTRO_BUILD_FORMAT_VALUES,G as ASTRO_CONFIG_FILENAMES,F as ASTRO_FORMAT_TO_ROUTING,M as AppDetectionSchema,h as AppRoleSchema,se as CREATABLE_FRAMEWORKS,y as CreatePrefillSchema,te as FRAMEWORKS,w as FRAMEWORK_OUTPUT_DIRS,oe as FRAMEWORK_PATTERN_RECOMMENDATIONS,re as FRAMEWORK_VALUES,k as FrameworkSchema,j as MONOREPO_TOOL_VALUES,v as MonorepoToolSchema,W as PACKAGE_MANAGER_LOCKFILES,c as PACKAGE_MANAGER_VALUES,R as PatternRecommendationSchema,$ as RepositoryDetectionSchema,Y as extractWorkspaceGlobs,K as inferAppRole,V as inferAstroRouting,B as inferCreatePrefill,H as inferFrameworkFromDeps,J as inferMonorepoTool,I as inferPackageManager,z as inferPortForFramework,ne as isFramework,D as parseAstroBuildFormat,q as pickPreferredDockerfile,ae as recommendPatternForFramework,Q as suggestAppName,X as suggestConfigPath,T as toConfigDirRelativeSource};

package/dist/src/planning/staticSitePlanning.d.ts

@@ -14,7 +14,8 @@ export interface StaticSiteResourceOptions {
     source: string;
     /** Build command + output directory (both required — deploy SSoT). */
     build: StaticSiteBuildConfig;
-    /** Clean-URL rewriting ("multipage") or SPA fallback ("spa"). */
+    /** "multipage" (/about → /about.html), "directory" (/about →
+     * /about/index.html) or "spa" (index.html fallback). */
     routing?: StaticSiteRouting;
     /** Custom domain (auto-creates certificate + DNS). Required for forms. */
     domain?: string;

package/dist/src/schemas/applicationSchemas.d.ts

@@ -271,6 +271,7 @@ export declare const ApplicationResourcePlanSchema: z.ZodObject<{
         }, z.core.$strict>;
         routing: z.ZodOptional<z.ZodEnum<{
             multipage: "multipage";
+            directory: "directory";
             spa: "spa";
         }>>;
         security: z.ZodOptional<z.ZodObject<{
@@ -939,6 +940,7 @@ export declare const ApplicationGeneratorSchema: z.ZodObject<{
     outputDir: z.ZodOptional<z.ZodString>;
     routing: z.ZodOptional<z.ZodEnum<{
         multipage: "multipage";
+        directory: "directory";
         spa: "spa";
     }>>;
     formsTo: z.ZodOptional<z.ZodString>;

package/dist/src/schemas/patternSchemas.d.ts

@@ -412,13 +412,15 @@ export declare const NextJSPatternConfigSchema: z.ZodObject<{
     environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
 /**
- * Routing mode for a static site: "multipage" (clean-URL `.html` rewriting)
- * or "spa" (single-page-app fallback to index.html). The accept-set is derived
- * from `@fjall/util` — the CDN construct reads the same tuple, so a third mode
- * cannot be added to one side alone.
+ * Routing mode for a static site: "multipage" (/about → /about.html),
+ * "directory" (/about → /about/index.html — Astro's default layout) or "spa"
+ * (unknown paths fall back to /index.html). The accept-set is derived from
+ * `@fjall/util` — the CDN construct reads the same tuple, so a mode cannot
+ * be added to one side alone.
  */
 export declare const StaticSiteRoutingSchema: z.ZodEnum<{
     multipage: "multipage";
+    directory: "directory";
     spa: "spa";
 }>;
 export type StaticSiteRouting = z.infer<typeof StaticSiteRoutingSchema>;
@@ -483,6 +485,7 @@ export declare const StaticSitePatternConfigSchema: z.ZodObject<{
     }, z.core.$strict>;
     routing: z.ZodOptional<z.ZodEnum<{
         multipage: "multipage";
+        directory: "directory";
         spa: "spa";
     }>>;
     security: z.ZodOptional<z.ZodObject<{
@@ -757,6 +760,7 @@ export declare const PatternConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>;
     routing: z.ZodOptional<z.ZodEnum<{
         multipage: "multipage";
+        directory: "directory";
         spa: "spa";
     }>>;
     security: z.ZodOptional<z.ZodObject<{

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const GENERATOR_VERSION = "22.0.0";
+export declare const GENERATOR_VERSION = "24.0.0";

package/dist/src/version.js

@@ -1 +1 @@
-const E="22.0.0";export{E as GENERATOR_VERSION};
+const E="24.0.0";export{E as GENERATOR_VERSION};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjall/generator",
-  "version": "22.0.0",
+  "version": "24.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fjall-tech/fjall.git",
@@ -58,7 +58,7 @@
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "@babel/parser": "^7.29.8",
-    "@fjall/util": "^22.0.0",
+    "@fjall/util": "^24.0.0",
     "ast-types": "^0.16.1",
     "recast": "^0.23.12",
     "ts-morph": "^28.0.0",