@stratal/inertia 0.0.27 → 0.1.1

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":[],"sources":["../src/augment/test-response.ts","../src/testing.ts"],"sourcesContent":["import type { Page } from '@inertiajs/core'\nimport { getValueAtPath, hasValueAtPath, TestResponse } from '@stratal/testing'\nimport { expect } from 'vitest'\n\ndeclare module '@stratal/testing' {\n  interface TestResponse {\n    /** Assert the response is an Inertia response. Optionally run a callback with the page object for custom assertions. */\n    assertInertia(callback?: (page: Page) => void): Promise<this>\n    /** Assert the Inertia page component matches the expected name. */\n    assertInertiaComponent(component: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path equals the expected value. */\n    assertInertiaProp(path: string, expected: unknown): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path exists. */\n    assertInertiaPropExists(path: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path does not exist. */\n    assertInertiaPropMissing(path: string): Promise<this>\n    /** Assert the Inertia page URL matches the expected value. */\n    assertInertiaUrl(url: string): Promise<this>\n    /** Assert the Inertia page version matches the expected value. */\n    assertInertiaVersion(version: string | null): Promise<this>\n    /** Assert the Inertia page flash data contains the given key with the expected value. */\n    assertInertiaFlash(key: string, value: unknown): Promise<this>\n    /** Assert a prop is listed as deferred in the given group. */\n    assertInertiaDeferredProp(prop: string, group: string): Promise<this>\n    /** Assert a prop is listed as a merge prop. */\n    assertInertiaMergeProp(prop: string): Promise<this>\n    /** Assert a prop is listed as a shared prop. */\n    assertInertiaSharedProp(prop: string): Promise<this>\n    /** Assert the response is a successful precognition response (204 with precognition headers). */\n    assertSuccessfulPrecognition(): this\n    /** Assert the response is a precognition validation error (422 with precognition headers). Optionally assert specific errors. */\n    assertPrecognitionValidationErrors(errors?: Record<string, string>): Promise<this>\n  }\n}\n\nexport function augmentTestResponse(): void {\n  TestResponse.macro('assertInertia', async function (this: TestResponse, callback?: (page: Page) => void) {\n    this.assertHeader('x-inertia', 'true')\n    this.assertOk()\n\n    if (callback) {\n      const page = await this.json<Page>()\n      callback(page)\n    }\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaComponent', async function (this: TestResponse, component: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.component,\n      `Expected Inertia component \"${component}\", got \"${page.component}\"`,\n    ).toBe(component)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaProp', async function (this: TestResponse, path: string, expected: unknown) {\n    const page = await this.json<Page>()\n    const actual = getValueAtPath(page.props, path)\n\n    expect(\n      actual,\n      `Expected Inertia prop \"${path}\" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(expected)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropExists', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to exist`,\n    ).toBe(true)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropMissing', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to not exist`,\n    ).toBe(false)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaUrl', async function (this: TestResponse, url: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.url,\n      `Expected Inertia URL \"${url}\", got \"${page.url}\"`,\n    ).toBe(url)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaVersion', async function (this: TestResponse, version: string | null) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.version,\n      `Expected Inertia version \"${version}\", got \"${page.version}\"`,\n    ).toBe(version)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaFlash', async function (this: TestResponse, key: string, value: unknown) {\n    const page = await this.json<Page>()\n    const actual = page.flash?.[key]\n\n    expect(\n      actual,\n      `Expected Inertia flash \"${key}\" to be ${JSON.stringify(value)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(value)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaDeferredProp', async function (this: TestResponse, prop: string, group: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.deferredProps?.[group],\n      `Expected Inertia deferred group \"${group}\" to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaMergeProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.mergeProps,\n      `Expected Inertia mergeProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaSharedProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.sharedProps,\n      `Expected Inertia sharedProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertSuccessfulPrecognition', function (this: TestResponse) {\n    this.assertNoContent()\n    this.assertHeader('Precognition', 'true')\n    this.assertHeader('Precognition-Success', 'true')\n\n    return this\n  })\n\n  TestResponse.macro('assertPrecognitionValidationErrors', async function (this: TestResponse, errors?: Record<string, string>) {\n    this.assertUnprocessable()\n    this.assertHeader('Precognition', 'true')\n\n    if (errors) {\n      const body = await this.json<{ errors: Record<string, string> }>()\n\n      expect(\n        body.errors,\n        `Expected precognition errors to match ${JSON.stringify(errors)}, got ${JSON.stringify(body.errors)}`,\n      ).toStrictEqual(errors)\n    }\n\n    return this\n  })\n}\n","import { augmentTestResponse } from './augment/test-response'\n\n// Augmentation (side-effect import: augments TestResponse types)\nimport './augment/test-response'\n\n// Patch TestResponse.prototype with Inertia assertion methods\naugmentTestResponse()\n\n// Re-export useful types for test authors\nexport type { Page as InertiaPage } from '@inertiajs/core'\n"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","names":[],"sources":["../src/augment/test-response.ts","../src/testing.ts"],"sourcesContent":["import type { Page, ScrollProp } from '@inertiajs/core'\nimport { getValueAtPath, hasValueAtPath, TestResponse } from '@stratal/testing'\nimport { expect } from 'vitest'\n\ndeclare module '@stratal/testing' {\n  interface TestResponse {\n    /** Assert the response is an Inertia response. Optionally run a callback with the page object for custom assertions. */\n    assertInertia(callback?: (page: Page) => void): Promise<this>\n    /** Assert the Inertia page component matches the expected name. */\n    assertInertiaComponent(component: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path equals the expected value. */\n    assertInertiaProp(path: string, expected: unknown): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path exists. */\n    assertInertiaPropExists(path: string): Promise<this>\n    /** Assert the Inertia page prop at the given dot-path does not exist. */\n    assertInertiaPropMissing(path: string): Promise<this>\n    /** Assert the Inertia page URL matches the expected value. */\n    assertInertiaUrl(url: string): Promise<this>\n    /** Assert the Inertia page version matches the expected value. */\n    assertInertiaVersion(version: string | null): Promise<this>\n    /** Assert the Inertia page flash data contains the given key with the expected value. */\n    assertInertiaFlash(key: string, value: unknown): Promise<this>\n    /** Assert a prop is listed as deferred in the given group. */\n    assertInertiaDeferredProp(prop: string, group: string): Promise<this>\n    /** Assert a prop is listed as a merge prop. */\n    assertInertiaMergeProp(prop: string): Promise<this>\n    /** Assert a prop carries infinite-scroll metadata, optionally matching some of its fields. */\n    assertInertiaScrollProp(prop: string, expected?: Partial<ScrollProp>): Promise<this>\n    /** Assert a prop is listed as a shared prop. */\n    assertInertiaSharedProp(prop: string): Promise<this>\n    /** Assert the response is a successful precognition response (204 with precognition headers). */\n    assertSuccessfulPrecognition(): this\n    /** Assert the response is a precognition validation error (422 with precognition headers). Optionally assert specific errors. */\n    assertPrecognitionValidationErrors(errors?: Record<string, string>): Promise<this>\n  }\n}\n\nexport function augmentTestResponse(): void {\n  TestResponse.macro('assertInertia', async function (this: TestResponse, callback?: (page: Page) => void) {\n    this.assertHeader('x-inertia', 'true')\n    this.assertOk()\n\n    if (callback) {\n      const page = await this.json<Page>()\n      callback(page)\n    }\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaComponent', async function (this: TestResponse, component: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.component,\n      `Expected Inertia component \"${component}\", got \"${page.component}\"`,\n    ).toBe(component)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaProp', async function (this: TestResponse, path: string, expected: unknown) {\n    const page = await this.json<Page>()\n    const actual = getValueAtPath(page.props, path)\n\n    expect(\n      actual,\n      `Expected Inertia prop \"${path}\" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(expected)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropExists', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to exist`,\n    ).toBe(true)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaPropMissing', async function (this: TestResponse, path: string) {\n    const page = await this.json<Page>()\n    const exists = hasValueAtPath(page.props, path)\n\n    expect(\n      exists,\n      `Expected Inertia prop \"${path}\" to not exist`,\n    ).toBe(false)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaUrl', async function (this: TestResponse, url: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.url,\n      `Expected Inertia URL \"${url}\", got \"${page.url}\"`,\n    ).toBe(url)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaVersion', async function (this: TestResponse, version: string | null) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.version,\n      `Expected Inertia version \"${version}\", got \"${page.version}\"`,\n    ).toBe(version)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaFlash', async function (this: TestResponse, key: string, value: unknown) {\n    const page = await this.json<Page>()\n    const actual = page.flash?.[key]\n\n    expect(\n      actual,\n      `Expected Inertia flash \"${key}\" to be ${JSON.stringify(value)}, got ${JSON.stringify(actual)}`,\n    ).toStrictEqual(value)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaDeferredProp', async function (this: TestResponse, prop: string, group: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.deferredProps?.[group],\n      `Expected Inertia deferred group \"${group}\" to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaMergeProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.mergeProps,\n      `Expected Inertia mergeProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaScrollProp', async function (this: TestResponse, prop: string, expected?: Partial<ScrollProp>) {\n    const page = await this.json<Page>()\n    const actual = page.scrollProps?.[prop]\n\n    expect(\n      actual,\n      `Expected Inertia scrollProps to contain \"${prop}\"`,\n    ).toBeDefined()\n\n    if (expected) {\n      expect(\n        actual,\n        `Expected Inertia scroll prop \"${prop}\" to match ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,\n      ).toMatchObject(expected)\n    }\n\n    return this\n  })\n\n  TestResponse.macro('assertInertiaSharedProp', async function (this: TestResponse, prop: string) {\n    const page = await this.json<Page>()\n\n    expect(\n      page.sharedProps,\n      `Expected Inertia sharedProps to contain \"${prop}\"`,\n    ).toContain(prop)\n\n    return this\n  })\n\n  TestResponse.macro('assertSuccessfulPrecognition', function (this: TestResponse) {\n    this.assertNoContent()\n    this.assertHeader('Precognition', 'true')\n    this.assertHeader('Precognition-Success', 'true')\n\n    return this\n  })\n\n  TestResponse.macro('assertPrecognitionValidationErrors', async function (this: TestResponse, errors?: Record<string, string>) {\n    this.assertUnprocessable()\n    this.assertHeader('Precognition', 'true')\n\n    if (errors) {\n      const body = await this.json<{ errors: Record<string, string> }>()\n\n      expect(\n        body.errors,\n        `Expected precognition errors to match ${JSON.stringify(errors)}, got ${JSON.stringify(body.errors)}`,\n      ).toStrictEqual(errors)\n    }\n\n    return this\n  })\n}\n","import { augmentTestResponse } from './augment/test-response'\n\n// Augmentation (side-effect import: augments TestResponse types)\nimport './augment/test-response'\n\n// Patch TestResponse.prototype with Inertia assertion methods\naugmentTestResponse()\n\n// Re-export useful types for test authors\nexport type { Page as InertiaPage } from '@inertiajs/core'\n"],"mappings":"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"}

package/dist/{type-generator-DFpha_Fp.mjs → type-generator-BVw8mj1y.mjs}

@@ -22,15 +22,18 @@ async function createProject(tsConfigPath) {
 		ts
 	};
 }
+const INERTIA_CALL_NAMES = ["inertia", "modal"];
 const WRAPPER_TYPE_NAMES = [
 	"InertiaDeferredProp",
 	"InertiaMergeProp",
+	"InertiaScrollProp",
 	"InertiaOptionalProp",
 	"InertiaOnceProp",
 	"InertiaAlwaysProp"
 ];
 function extractControllerPageTypes(project, SK, tsObj, srcDir, pagesDir) {
 	project.addSourceFilesAtPaths(join(srcDir, "**/*.ts"));
+	primeTranslationKeys(project);
 	const pages = /* @__PURE__ */ new Map();
 	for (const sourceFile of project.getSourceFiles()) {
 		const filePath = sourceFile.getFilePath();
@@ -40,7 +43,7 @@ function extractControllerPageTypes(project, SK, tsObj, srcDir, pagesDir) {
 		for (const call of callExpressions) {
 			const expr = call.getExpression();
 			if (!expr.isKind(SK.PropertyAccessExpression)) continue;
-			if (expr.getName() !== "inertia") continue;
+			if (!INERTIA_CALL_NAMES.includes(expr.getName())) continue;
 			const args = call.getArguments();
 			if (args.length === 0) continue;
 			const firstArg = args[0];
@@ -78,6 +81,8 @@ function extractControllerPageTypes(project, SK, tsObj, srcDir, pagesDir) {
 	}).sort((a, b) => a.componentName.localeCompare(b.componentName));
 }
 function unwrapWrapperType(type, tsObj, fallbackLocation) {
+	const keyMatch = matchTranslationKeyReference(type, fallbackLocation);
+	if (keyMatch) return emitTranslationKeyMatch(keyMatch, false);
 	if (type.isUnion()) {
 		const unwrapped = type.getUnionTypes().filter((t) => {
 			const text = t.getText(void 0, tsObj.TypeFormatFlags.NoTruncation);
@@ -111,7 +116,21 @@ function stripReadonly(type, tsObj, fallbackLocation) {
 	}
 	return typeToString(type, tsObj, fallbackLocation);
 }
+/**
+* Types whose `.share()` contributes a shared page prop. Matched on the
+* receiver's resolved type rather than its source text, so `ctx.share()`,
+* `this.inertia.share()`, and any aliasing are all recognised while an
+* unrelated `.share()` that merely happens to sit on a variable named
+* something inertia-ish is not.
+*/
+const SHARE_RECEIVER_TYPE_NAMES = /* @__PURE__ */ new Set(["RouterContext", "InertiaService"]);
+function isShareReceiver(node) {
+	const type = node.getType().getNonNullableType();
+	const name = type.getSymbol()?.getName() ?? type.getAliasSymbol()?.getName();
+	return name !== void 0 && SHARE_RECEIVER_TYPE_NAMES.has(name);
+}
 function extractShareCallTypes(project, SK, tsObj, srcDir) {
+	primeTranslationKeys(project);
 	const shareTypes = /* @__PURE__ */ new Map();
 	for (const sourceFile of project.getSourceFiles()) {
 		const filePath = sourceFile.getFilePath();
@@ -122,14 +141,14 @@ function extractShareCallTypes(project, SK, tsObj, srcDir) {
 			const expr = call.getExpression();
 			if (!expr.isKind(SK.PropertyAccessExpression)) continue;
 			if (expr.getName() !== "share") continue;
-			if (!expr.getExpression().getText().includes("inertia")) continue;
+			if (!isShareReceiver(expr.getExpression())) continue;
 			const args = call.getArguments();
 			if (args.length < 2) continue;
 			const keyArg = args[0];
 			if (!keyArg.isKind(SK.StringLiteral)) continue;
 			const key = keyArg.getLiteralValue();
 			if (shareTypes.has(key)) continue;
-			const valueType = widenLiteralType(args[1].getType(), tsObj);
+			const valueType = unwrapWrapperType(args[1].getType(), tsObj, args[1]);
 			shareTypes.set(key, valueType);
 		}
 	}
@@ -162,7 +181,7 @@ function resolveModuleOptionsLiteral(optionsArg, SK) {
 			const unwrapped = unwrapAs(body, SK);
 			if (unwrapped?.isKind(SK.ObjectLiteralExpression)) return unwrapped;
 			if (body.isKind(SK.Block)) {
-				const returnStatements = body.getDescendantsOfKind(SK.ReturnStatement);
+				const returnStatements = ownReturnStatements(initializer, body, SK);
 				for (let i = returnStatements.length - 1; i >= 0; i--) {
 					const expr = returnStatements[i].getExpression();
 					if (!expr) continue;
@@ -262,6 +281,19 @@ function resolveToVariableDeclaration(identifier, SK) {
 	}
 	return null;
 }
+/**
+* The `return` statements the given function owns, skipping any that belong to a
+* function nested inside it.
+*
+* A config factory's body is full of nested resolvers, and several of them
+* return object literals of their own. Reading every descendant `return` picks
+* one of those over the factory's, and the options literal is then whatever the
+* last resolver happened to answer with.
+*/
+function ownReturnStatements(fn, body, SK) {
+	const isFunctionLike = (node) => node.isKind(SK.ArrowFunction) || node.isKind(SK.FunctionExpression) || node.isKind(SK.FunctionDeclaration) || node.isKind(SK.MethodDeclaration);
+	return body.getDescendantsOfKind(SK.ReturnStatement).filter((ret) => ret.getFirstAncestor(isFunctionLike) === fn);
+}
 function extractLiteralFromRegisterAs(varDecl, SK) {
 	if (!varDecl.isKind(SK.VariableDeclaration)) return null;
 	const init = varDecl.getInitializer();
@@ -278,7 +310,7 @@ function extractLiteralFromRegisterAs(varDecl, SK) {
 	const unwrapped = unwrapAs(body, SK);
 	if (unwrapped?.isKind(SK.ObjectLiteralExpression)) return unwrapped;
 	if (body.isKind(SK.Block)) {
-		const returnStatements = body.getDescendantsOfKind(SK.ReturnStatement);
+		const returnStatements = ownReturnStatements(factory, body, SK);
 		for (let i = returnStatements.length - 1; i >= 0; i--) {
 			const retExpr = returnStatements[i].getExpression();
 			if (!retExpr) continue;
@@ -375,40 +407,104 @@ function extractFlashTypes(project, SK, tsObj, srcDir) {
 		type
 	})) };
 }
-function extractSharedDataType(project, SK, tsObj, moduleFilePath) {
-	const callExpressions = (project.getSourceFile(moduleFilePath) ?? project.addSourceFileAtPath(moduleFilePath)).getDescendantsOfKind(SK.CallExpression);
-	for (const call of callExpressions) {
-		const expr = call.getExpression();
-		if (!expr.isKind(SK.PropertyAccessExpression)) continue;
-		const propName = expr.getName();
-		if (propName !== "forRoot" && propName !== "forRootAsync") continue;
-		const objExpr = expr.getExpression();
-		if (!objExpr.isKind(SK.Identifier) || objExpr.getText() !== "InertiaModule") continue;
-		const args = call.getArguments();
-		if (args.length === 0) continue;
-		const optionsLiteral = resolveModuleOptionsLiteral(args[0], SK);
-		if (!optionsLiteral || !optionsLiteral.isKind(SK.ObjectLiteralExpression)) continue;
-		const sharedDataProp = optionsLiteral.getProperty("sharedData");
-		if (!sharedDataProp) continue;
-		if (!sharedDataProp.isKind(SK.PropertyAssignment)) continue;
-		const initializer = sharedDataProp.getInitializer();
-		if (!initializer?.isKind(SK.ObjectLiteralExpression)) continue;
-		const members = [];
-		for (const prop of initializer.getProperties()) {
-			if (!prop.isKind(SK.PropertyAssignment)) continue;
-			const name = prop.getName();
-			const value = prop.getInitializer();
-			if (!value) continue;
-			let valueType;
-			if (value.isKind(SK.ArrowFunction) || value.isKind(SK.FunctionExpression)) valueType = typeToString(value.getReturnType(), tsObj);
-			else valueType = typeToString(value.getType(), tsObj);
-			members.push({
-				name,
-				type: valueType,
-				optional: false
-			});
+/**
+* Resolves the app's access control definition into permission strings and role
+* names, for the generated `AccessControlRegistry`.
+*
+* Reads the `accessControl:` property of the `AuthModule.forRootAsync(...)` call
+* in the app module. That is single-valued by construction — no ambiguity about
+* which of several `createAccessControl` calls is in effect — and it targets the
+* definition that is actually wired up.
+*
+* Everything goes through the type checker rather than static evaluation of
+* object literals, so an inline definition, a separate-file const, a workspace
+* package, and an `extendRole()`-composed role all resolve identically.
+*
+* @throws when `accessControl` is present but its resources don't resolve to
+* string literals — emitting a `string`-shaped union would type-check every
+* permission and quietly defeat the point.
+*/
+function extractAccessControlType(project, SK, srcDir) {
+	const normalizedSrcDir = srcDir.replace(/\\/g, "/");
+	for (const sourceFile of project.getSourceFiles()) {
+		const filePath = sourceFile.getFilePath();
+		if (!filePath.startsWith(normalizedSrcDir)) continue;
+		if (filePath.includes("__tests__") || filePath.includes(".spec.") || filePath.includes(".test.")) continue;
+		if (!sourceFile.getFullText().includes("accessControl")) continue;
+		for (const call of sourceFile.getDescendantsOfKind(SK.CallExpression)) {
+			const expr = call.getExpression();
+			if (!expr.isKind(SK.PropertyAccessExpression)) continue;
+			if (expr.getName() !== "forRootAsync") continue;
+			const optionsArg = call.getArguments()[0];
+			if (!optionsArg) continue;
+			const optionsLiteral = optionsArg.isKind(SK.ObjectLiteralExpression) ? optionsArg : resolveConfigLiteralFromAsProvider(optionsArg, SK);
+			if (!optionsLiteral?.isKind(SK.ObjectLiteralExpression)) continue;
+			const property = optionsLiteral.getProperty("accessControl");
+			if (!property?.isKind(SK.PropertyAssignment)) continue;
+			const initializer = property.getInitializer();
+			if (!initializer) continue;
+			const acType = initializer.getType();
+			const statementsType = acType.getProperty("ac")?.getTypeAtLocation(initializer).getProperty("statements")?.getTypeAtLocation(initializer);
+			if (!statementsType) continue;
+			const permissions = [];
+			for (const resourceSymbol of statementsType.getProperties()) {
+				const resource = resourceSymbol.getName();
+				const actions = resourceSymbol.getTypeAtLocation(initializer).getTupleElements().map((element) => element.getLiteralValue()).filter((value) => typeof value === "string");
+				if (actions.length === 0) throw new Error(`@stratal/inertia: the \`accessControl\` resource "${resource}" in ${filePath} has an action list that could not be resolved to string literals. Declare its actions as a literal array of strings (e.g. \`${resource}: ['read', 'update']\`) so the generated AccessControlRegistry can check permission strings.`);
+				permissions.push(resource, `${resource}:*`, ...actions.map((action) => `${resource}:${action}`));
+			}
+			if (permissions.length === 0) throw new Error(`@stratal/inertia: the \`accessControl\` option in ${filePath} has no resources that could be resolved to literal names. Declare \`resources\` as an object literal (e.g. \`resources: { posts: ['read'] }\`) so the generated AccessControlRegistry can check permission strings.`);
+			const roles = acType.getProperty("roles")?.getTypeAtLocation(initializer).getProperties().map((symbol) => symbol.getName()) ?? [];
+			if (roles.length === 0) throw new Error(`@stratal/inertia: the \`accessControl\` option in ${filePath} has no roles that could be resolved to literal names. Declare \`roles\` as an object literal (e.g. \`roles: { admin: {...} }\`) so the generated AccessControlRegistry can check role names.`);
+			return {
+				permissions: permissions.sort((a, b) => a.localeCompare(b)),
+				roles: roles.sort((a, b) => a.localeCompare(b))
+			};
+		}
+	}
+	return null;
+}
+function extractSharedDataType(project, SK, tsObj, srcDir) {
+	primeTranslationKeys(project);
+	const normalizedSrcDir = srcDir.replace(/\\/g, "/");
+	for (const sourceFile of project.getSourceFiles()) {
+		const filePath = sourceFile.getFilePath();
+		if (!filePath.startsWith(normalizedSrcDir)) continue;
+		if (filePath.includes("__tests__") || filePath.includes(".spec.") || filePath.includes(".test.")) continue;
+		if (!sourceFile.getFullText().includes("InertiaModule")) continue;
+		for (const call of sourceFile.getDescendantsOfKind(SK.CallExpression)) {
+			const expr = call.getExpression();
+			if (!expr.isKind(SK.PropertyAccessExpression)) continue;
+			const propName = expr.getName();
+			if (propName !== "forRoot" && propName !== "forRootAsync") continue;
+			const objExpr = expr.getExpression();
+			if (!objExpr.isKind(SK.Identifier) || objExpr.getText() !== "InertiaModule") continue;
+			const args = call.getArguments();
+			if (args.length === 0) continue;
+			const optionsLiteral = resolveModuleOptionsLiteral(args[0], SK) ?? resolveConfigLiteralFromAsProvider(args[0], SK);
+			if (!optionsLiteral || !optionsLiteral.isKind(SK.ObjectLiteralExpression)) continue;
+			const sharedDataProp = optionsLiteral.getProperty("sharedData");
+			if (!sharedDataProp) continue;
+			if (!sharedDataProp.isKind(SK.PropertyAssignment)) continue;
+			const initializer = sharedDataProp.getInitializer();
+			if (!initializer?.isKind(SK.ObjectLiteralExpression)) continue;
+			const members = [];
+			for (const prop of initializer.getProperties()) {
+				if (!prop.isKind(SK.PropertyAssignment)) continue;
+				const name = prop.getName();
+				const value = prop.getInitializer();
+				if (!value) continue;
+				let valueType;
+				if (value.isKind(SK.ArrowFunction) || value.isKind(SK.FunctionExpression)) valueType = unwrapPromise(value.getReturnType(), tsObj, value);
+				else valueType = typeToString(value.getType(), tsObj);
+				members.push({
+					name,
+					type: valueType,
+					optional: false
+				});
+			}
+			if (members.length > 0) return { members };
 		}
-		if (members.length > 0) return { members };
 	}
 	return null;
 }
@@ -434,8 +530,38 @@ function resolvePagePropsTypeNames(pages) {
 	}
 	return result;
 }
+/**
+* The `InertiaI18nConfig` narrowing this run emits — shared by the emitter and the
+* in-program seed so both are byte-for-byte the same shape.
+*/
+function inertiaI18nAugmentationLines(only) {
+	return [
+		"  interface InertiaI18nConfig {",
+		`    translationKeys: import('stratal/i18n').FilterByPrefix<import('stratal/i18n').MessageKeys, ${only.map((p) => `'${p}'`).join(" | ")}>`,
+		"  }"
+	];
+}
+/**
+* Register the `InertiaI18nConfig` narrowing this run is about to emit into the
+* ts-morph program, so `InertiaTranslationKeys` resolves to the prefix-filtered
+* union while page props are serialized — deterministically, whether or not a
+* prior inertia.d.ts exists on disk. Written at `outputPath`, overwriting any stale
+* augmentation the source glob loaded, so a clean regen and a seeded regen resolve
+* identically. When i18n is off or no prefixes are configured, the file is emptied
+* so a stale narrowing can't linger.
+*/
+function seedInertiaI18nAugmentation(project, outputPath, i18n) {
+	const body = i18n.enabled && i18n.only.length > 0 ? [
+		"declare module '@stratal/inertia' {",
+		...inertiaI18nAugmentationLines(i18n.only),
+		"}",
+		"export {}",
+		""
+	].join("\n") : "export {}\n";
+	project.createSourceFile(outputPath, body, { overwrite: true });
+}
 function generateInertiaTypes(input) {
-	const { pages, sharedData, shareCallTypes, i18n, flashTypes } = input;
+	const { pages, sharedData, shareCallTypes, i18n, flashTypes, accessControl } = input;
 	const typeNames = resolvePagePropsTypeNames(pages);
 	const lines = ["// Auto-generated by @stratal/inertia. Do not edit."];
 	if (pages.length > 0) {
@@ -454,10 +580,13 @@ function generateInertiaTypes(input) {
 		lines.push(`    '${page.componentName}': ${typeName}`);
 	}
 	lines.push("  }");
-	if (i18n.enabled && i18n.only.length > 0) {
-		const prefixUnion = i18n.only.map((p) => `'${p}'`).join(" | ");
-		lines.push("  interface InertiaI18nConfig {");
-		lines.push(`    translationKeys: import('stratal/i18n').FilterByPrefix<import('stratal/i18n').MessageKeys, ${prefixUnion}>`);
+	if (i18n.enabled && i18n.only.length > 0) lines.push(...inertiaI18nAugmentationLines(i18n.only));
+	if (accessControl) {
+		const permissionsUnion = accessControl.permissions.length > 0 ? accessControl.permissions.map((p) => `'${p}'`).join(" | ") : "never";
+		const rolesUnion = accessControl.roles.length > 0 ? accessControl.roles.map((r) => `'${r}'`).join(" | ") : "never";
+		lines.push("  interface AccessControlRegistry {");
+		lines.push(`    permissions: ${permissionsUnion}`);
+		lines.push(`    roles: ${rolesUnion}`);
 		lines.push("  }");
 	}
 	lines.push("}");
@@ -467,15 +596,19 @@ function generateInertiaTypes(input) {
 		configMembers.push(`    flashDataType: { ${flashProps} }`);
 	}
 	const sharedMembers = [];
-	if (sharedData) for (const member of sharedData.members) sharedMembers.push(`      ${member.name}${member.optional ? "?" : ""}: ${member.type}`);
+	const declared = /* @__PURE__ */ new Set();
+	const declare = (name, member) => {
+		if (declared.has(name)) return;
+		declared.add(name);
+		sharedMembers.push(member);
+	};
+	if (sharedData) for (const member of sharedData.members) declare(member.name, `      ${member.name}${member.optional ? "?" : ""}: ${member.type}`);
 	if (i18n.enabled) {
-		sharedMembers.push("      locale: string");
-		sharedMembers.push("      translations: Record<string, string>");
-	}
-	for (const [key, type] of shareCallTypes) {
-		if (sharedData?.members.some((m) => m.name === key)) continue;
-		sharedMembers.push(`      ${key}?: ${type}`);
+		declare("locale", "      locale: string");
+		declare("translations", "      translations: Record<string, string>");
 	}
+	if (accessControl) declare("access", "      access: import('@stratal/inertia').SharedAccess");
+	for (const [key, type] of shareCallTypes) declare(key, `      ${key}?: ${type}`);
 	if (sharedMembers.length > 0) configMembers.push(`    sharedPageProps: {\n${sharedMembers.join("\n")}\n    }`);
 	if (configMembers.length > 0) {
 		lines.push("");
@@ -494,14 +627,192 @@ function widenLiteralType(type, tsObj, fallbackLocation) {
 	if (type.isBooleanLiteral()) return "boolean";
 	return typeToString(type, tsObj, fallbackLocation);
 }
+const TRANSLATION_KEYS_REFERENCE = "import('@stratal/inertia').InertiaTranslationKeys";
+const MESSAGE_KEYS_REFERENCE_MODULE = "import('stratal/i18n')";
+const MESSAGE_KEYS_REFERENCE = `${MESSAGE_KEYS_REFERENCE_MODULE}.MessageKeys`;
+/**
+* Per-project cache of the resolved key sets, populated by
+* {@link primeTranslationKeys} before a walk so {@link matchTranslationKeyReference}
+* can match structurally.
+*/
+const translationKeysByProject = /* @__PURE__ */ new WeakMap();
+function stringLiteralUnionMembers(type) {
+	const parts = type.isUnion() ? type.getUnionTypes() : [type];
+	const members = /* @__PURE__ */ new Set();
+	for (const part of parts) {
+		if (!part.isStringLiteral()) return null;
+		members.add(part.getLiteralValue());
+	}
+	return members.size > 0 ? members : null;
+}
+/**
+* Resolve the project's key sets once, before walking any prop types. Resolving
+* throwaway probe aliases forces each union to concrete string literals, so they
+* match what prop types resolve to during the walk. Done up front — never mid-walk
+* — so the probe file's add/remove can't invalidate the `Type` objects the
+* recursion is holding.
+*
+* The probe file MUST live inside the source tree (`probeDir`): app message
+* namespaces are registered via `declare module 'stratal/i18n'` augmentations in
+* app source, which are only in scope for files under that tree. A probe at the
+* project root sees only the framework's base `MessageKeys` (a few dozen keys), so
+* every app key fails to match. Placed under `srcDir`, `MessageKeys` resolves to
+* the app's full key set.
+*
+* The filtered probe is built from the detected `only` prefixes
+* (`FilterByPrefix<MessageKeys, ...>`) rather than `InertiaTranslationKeys`: it does
+* not depend on the consumer's `InertiaI18nConfig` augmentation being applied inside
+* the probe, and matches what prefix-filtered props (the common case) resolve to
+* during the walk. When no prefixes are configured the filtered set equals the full
+* set, so fall back to `InertiaTranslationKeys` (which resolves to `MessageKeys`).
+*/
+function primeTranslationKeys(project, only, probeDir = "") {
+	if (translationKeysByProject.has(project)) return;
+	const filteredRef = only && only.length > 0 ? `${MESSAGE_KEYS_REFERENCE_MODULE}.FilterByPrefix<${MESSAGE_KEYS_REFERENCE}, ${only.map((p) => `'${p}'`).join(" | ")}>` : TRANSLATION_KEYS_REFERENCE;
+	const probe = project.createSourceFile(join(probeDir, "__stratal_translation_keys_probe__.ts"), `export type __ProbeFiltered = ${filteredRef}\nexport type __ProbeFull = ${MESSAGE_KEYS_REFERENCE}\n`, { overwrite: true });
+	try {
+		const filtered = stringLiteralUnionMembers(probe.getTypeAliasOrThrow("__ProbeFiltered").getType());
+		const full = stringLiteralUnionMembers(probe.getTypeAliasOrThrow("__ProbeFull").getType());
+		translationKeysByProject.set(project, {
+			filtered,
+			full
+		});
+	} finally {
+		project.removeSourceFile(probe);
+	}
+}
+function setsEqual(a, b) {
+	if (!b || a.size !== b.size) return false;
+	for (const value of a) if (!b.has(value)) return false;
+	return true;
+}
+function isSubset(a, b) {
+	if (!b) return false;
+	for (const value of a) if (!b.has(value)) return false;
+	return true;
+}
+/**
+* A string-literal union is treated as the translation-key type resolved with an
+* incomplete set of message-namespace augmentations in scope (see
+* {@link matchTranslationKeyReference}) rather than a hand-picked subset only when
+* it is BOTH:
+* - a large fraction ({@link TRANSLATION_KEY_COVERAGE}) of the full key set, and
+* - large in absolute terms ({@link TRANSLATION_KEY_MIN_MEMBERS}).
+*
+* The fraction alone is not enough: in a project with only a handful of keys, a
+* deliberate two-value enum can already be half the set. The absolute floor keeps
+* such narrow enums inlined regardless of how small the key set is — an
+* under-resolved translation-key union spans dozens to thousands of keys, while a
+* hand-picked enum spans a few.
+*/
+const TRANSLATION_KEY_COVERAGE = .5;
+const TRANSLATION_KEY_MIN_MEMBERS = 24;
+/**
+* Detect whether `type` is (a nullable wrapper around) one of the message-key
+* unions, and if so which reference to emit instead of inlining it. Inlining leaks
+* the entire key union (hundreds of literals) into every prop that uses it.
+*
+* The alias survives on a directly-referenced type, but is dropped once the union
+* is reached through nested object/array expansion — ts-morph then yields a bare
+* string-literal union (optionally joined with `null`/`undefined`). So match the
+* alias name when present (never gate on `isUnion()` — the `InertiaTranslationKeys`
+* conditional alias can report `isUnion() === false`), and otherwise fall back to
+* structural identity against the project's resolved key sets, ignoring `null` /
+* `undefined` members (which the caller re-attaches). The filtered set is checked
+* first so a prefix-filtered union stays `InertiaTranslationKeys`; a union equal to
+* the full set references `MessageKeys` (widening it to the filtered alias would
+* silently drop the unshared namespaces).
+*
+* Exact identity is not always reachable: app message namespaces are registered via
+* `declare module 'stratal/i18n'` augmentations, and a prop declared in a file that
+* doesn't transitively import every namespace resolves `InertiaTranslationKeys` to a
+* strict *subset* of the primed set — with no alias to recover (the value flows in
+* through an inferred property access). So collapse any union that is a subset of a
+* key set and clears the {@link TRANSLATION_KEY_COVERAGE} /
+* {@link TRANSLATION_KEY_MIN_MEMBERS} thresholds *measured against that same set* —
+* the filtered set for an `InertiaTranslationKeys` union, the full set for a
+* `MessageKeys` union — to the type the source actually declares. Measuring each
+* against its own set keeps a narrow prefix filter from shrinking the fraction below
+* the threshold, and stops a non-frontend subset from being widened through the
+* small filtered denominator. Small hand-picked key enums fall below the thresholds
+* and stay inlined.
+*/
+function matchTranslationKeyReference(type, fallbackLocation) {
+	const alias = type.getAliasSymbol?.()?.getName();
+	if (alias === "InertiaTranslationKeys") return {
+		ref: TRANSLATION_KEYS_REFERENCE,
+		hasNull: false,
+		hasUndefined: false
+	};
+	if (alias === "MessageKeys") return {
+		ref: MESSAGE_KEYS_REFERENCE,
+		hasNull: false,
+		hasUndefined: false
+	};
+	if (!fallbackLocation) return null;
+	const sets = translationKeysByProject.get(fallbackLocation.getProject());
+	if (!sets) return null;
+	const parts = type.isUnion() ? type.getUnionTypes() : [type];
+	let hasNull = false;
+	let hasUndefined = false;
+	const members = /* @__PURE__ */ new Set();
+	for (const part of parts) {
+		if (part.isNull()) {
+			hasNull = true;
+			continue;
+		}
+		if (part.isUndefined()) {
+			hasUndefined = true;
+			continue;
+		}
+		if (!part.isStringLiteral()) return null;
+		members.add(part.getLiteralValue());
+	}
+	if (members.size === 0) return null;
+	if (setsEqual(members, sets.filtered)) return {
+		ref: TRANSLATION_KEYS_REFERENCE,
+		hasNull,
+		hasUndefined
+	};
+	if (setsEqual(members, sets.full)) return {
+		ref: MESSAGE_KEYS_REFERENCE,
+		hasNull,
+		hasUndefined
+	};
+	if (sets.filtered && isSubset(members, sets.filtered) && members.size >= TRANSLATION_KEY_MIN_MEMBERS && members.size >= TRANSLATION_KEY_COVERAGE * sets.filtered.size) return {
+		ref: TRANSLATION_KEYS_REFERENCE,
+		hasNull,
+		hasUndefined
+	};
+	if (sets.full && isSubset(members, sets.full) && members.size >= TRANSLATION_KEY_MIN_MEMBERS && members.size >= TRANSLATION_KEY_COVERAGE * sets.full.size) return {
+		ref: MESSAGE_KEYS_REFERENCE,
+		hasNull,
+		hasUndefined
+	};
+	return null;
+}
+/**
+* Render a key-union match, re-attaching `null` (and `undefined`, unless the `?`
+* property marker already implies it) that {@link matchTranslationKeyReference}
+* stripped for comparison.
+*/
+function emitTranslationKeyMatch(match, undefinedImplied) {
+	const prefixes = [];
+	if (match.hasNull) prefixes.push("null");
+	if (match.hasUndefined && !undefinedImplied) prefixes.push("undefined");
+	return prefixes.length > 0 ? `${prefixes.join(" | ")} | ${match.ref}` : match.ref;
+}
 function typeToString(type, tsObj, fallbackLocation) {
-	if (type.isUnion() && type.getAliasSymbol?.()?.getName() === "MessageKeys") return "import('@stratal/inertia').InertiaTranslationKeys";
+	const keyMatch = matchTranslationKeyReference(type, fallbackLocation);
+	if (keyMatch) return emitTranslationKeyMatch(keyMatch, false);
 	if (type.isObject() || type.isUnion() || type.isIntersection()) return expandTypeToInline(type, tsObj, fallbackLocation);
 	const text = type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation | tsObj.TypeFormatFlags.UseFullyQualifiedType);
 	if (text.includes("import(")) return expandTypeToInline(type, tsObj, fallbackLocation);
 	return text;
 }
 function expandPropertyType(type, tsObj, fallbackLocation, visiting, isOptional) {
+	const keyMatch = matchTranslationKeyReference(type, fallbackLocation);
+	if (keyMatch) return emitTranslationKeyMatch(keyMatch, isOptional);
 	if (isOptional && type.isUnion()) {
 		const parts = type.getUnionTypes().filter((t) => !t.isUndefined());
 		if (parts.length === 0) return "undefined";
@@ -515,6 +826,8 @@ function expandTypeToInline(type, tsObj, fallbackLocation, visiting = /* @__PURE
 	if (type.isBoolean()) return "boolean";
 	visiting.add(type);
 	try {
+		const keyMatch = matchTranslationKeyReference(type, fallbackLocation);
+		if (keyMatch) return emitTranslationKeyMatch(keyMatch, false);
 		if (type.isObject() && !type.isArray() && !type.isReadonlyArray()) {
 			const symbolName = type.getSymbol()?.getName();
 			const text = type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation | tsObj.TypeFormatFlags.UseFullyQualifiedType);
@@ -540,10 +853,7 @@ function expandTypeToInline(type, tsObj, fallbackLocation, visiting = /* @__PURE
 				return type.isReadonlyArray() ? `ReadonlyArray<${inner}>` : `Array<${inner}>`;
 			}
 		}
-		if (type.isUnion()) {
-			if (type.getAliasSymbol?.()?.getName() === "MessageKeys") return "import('@stratal/inertia').InertiaTranslationKeys";
-			return type.getUnionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" | ");
-		}
+		if (type.isUnion()) return type.getUnionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" | ");
 		if (type.isIntersection()) return type.getIntersectionTypes().map((t) => expandTypeToInline(t, tsObj, fallbackLocation, visiting)).join(" & ");
 		const text = type.getText(void 0, tsObj.TypeFormatFlags.NoTruncation);
 		if (text.includes("import(")) return "unknown";
@@ -562,9 +872,6 @@ function writeInertiaTypes(outputPath, content) {
 	renameSync(tmpPath, outputPath);
 	return true;
 }
-function findAppModulePath(cwd) {
-	return [join(cwd, "src", "app.module.ts"), join(cwd, "src", "app.module.tsx")].find(existsSync);
-}
 function findPagesDir(cwd) {
 	return join(cwd, "src", "inertia", "pages");
 }
@@ -579,17 +886,19 @@ async function runTypeGeneration(cwd) {
 	const pagesDir = findPagesDir(cwd);
 	const srcDir = join(cwd, "src");
 	const outputPath = findOutputPath(cwd);
-	const moduleFilePath = findAppModulePath(cwd);
 	const { project, SyntaxKind, ts } = await createProject(findTsConfigPath(cwd));
-	const pages = extractControllerPageTypes(project, SyntaxKind, ts, srcDir, pagesDir);
-	const sharedData = moduleFilePath ? extractSharedDataType(project, SyntaxKind, ts, moduleFilePath) : null;
+	project.addSourceFilesAtPaths(join(srcDir, "**/*.ts"));
 	const i18n = detectI18nConfig(project, SyntaxKind, srcDir);
+	seedInertiaI18nAugmentation(project, outputPath, i18n);
+	primeTranslationKeys(project, i18n.only, srcDir);
+	const pages = extractControllerPageTypes(project, SyntaxKind, ts, srcDir, pagesDir);
 	writeInertiaTypes(outputPath, generateInertiaTypes({
 		pages,
-		sharedData,
+		sharedData: extractSharedDataType(project, SyntaxKind, ts, srcDir),
 		shareCallTypes: extractShareCallTypes(project, SyntaxKind, ts, srcDir),
 		i18n,
-		flashTypes: extractFlashTypes(project, SyntaxKind, ts, srcDir)
+		flashTypes: extractFlashTypes(project, SyntaxKind, ts, srcDir),
+		accessControl: extractAccessControlType(project, SyntaxKind, srcDir)
 	}));
 	return {
 		outputPath,
@@ -599,4 +908,4 @@ async function runTypeGeneration(cwd) {
 //#endregion
 export { runTypeGeneration as n, findPagesDir as t };
 
-//# sourceMappingURL=type-generator-DFpha_Fp.mjs.map
+//# sourceMappingURL=type-generator-BVw8mj1y.mjs.map