@angriff36/manifest 2.18.0

package/dist/manifest/projections/hono/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Configuration options for the Hono projection.
+ *
+ * Controls auth middleware integration, request validation,
+ * and route structure for edge-runtime-optimized router
+ * generation from Manifest IR. Designed for Cloudflare Workers,
+ * Vercel Edge, and Deno Deploy with zero Node.js dependencies.
+ */
+/**
+ * Options for the Hono route handler projection.
+ */
+export interface HonoProjectionOptions {
+    /**
+     * Auth middleware import path.
+     * The module must export a Hono middleware that sets
+     * `c.set('user', ...)` on the context.
+     * Default: './middleware/auth'
+     */
+    authImportPath?: string;
+    /**
+     * Named export for the auth middleware function.
+     * Default: 'requireAuth'
+     */
+    authMiddlewareName?: string;
+    /**
+     * Import path for the Manifest runtime factory.
+     * The module must export a function that returns a runtime
+     * instance with `runCommand(entity, command, params, context)`.
+     * Default: './lib/manifest-runtime'
+     */
+    runtimeImportPath?: string;
+    /**
+     * Named export for the runtime factory function.
+     * Default: 'createManifestRuntime'
+     */
+    runtimeFactoryName?: string;
+    /**
+     * Import path for request validation schemas (Zod).
+     * When provided, generated handlers validate request bodies
+     * against Zod schemas before dispatching to the runtime.
+     * Default: undefined (no validation emitted)
+     */
+    validationImportPath?: string;
+    /**
+     * Base route prefix for all generated routes.
+     * Default: '/api'
+     */
+    basePath?: string;
+    /**
+     * Whether to include tenant context extraction from auth.
+     * When true, generates `c.get('user').tenantId` extraction.
+     * Default: true
+     */
+    includeTenantContext?: boolean;
+    /**
+     * Name of the tenant ID property on the auth user object.
+     * Default: 'tenantId'
+     */
+    tenantIdProperty?: string;
+    /**
+     * Whether to emit TypeScript type annotations.
+     * Default: true
+     */
+    emitTypes?: boolean;
+    /**
+     * Whether to emit a header comment with generation metadata.
+     * Default: true
+     */
+    emitHeader?: boolean;
+    /**
+     * Whether to skip auth middleware on read routes (GET).
+     * Default: false
+     */
+    publicReads?: boolean;
+    /**
+     * Whether to emit inline JSDoc comments describing guards,
+     * constraints, and policies for each command handler.
+     * Default: true
+     */
+    includeComments?: boolean;
+    /**
+     * ISO timestamp override for deterministic output (testing).
+     */
+    generatedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/manifest/projections/hono/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/hono/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/manifest/projections/hono/types.js

@@ -0,0 +1,10 @@
+/**
+ * Configuration options for the Hono projection.
+ *
+ * Controls auth middleware integration, request validation,
+ * and route structure for edge-runtime-optimized router
+ * generation from Manifest IR. Designed for Cloudflare Workers,
+ * Vercel Edge, and Deno Deploy with zero Node.js dependencies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/manifest/projections/hono/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/manifest/projections/hono/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/manifest/projections/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Projections module entry point.
+ *
+ * Projections consume IR and emit platform-specific code.
+ * They are NOT part of runtime semantics.
+ *
+ * The registry auto-registers builtins on first access, so consumers
+ * can simply call getProjection(name) without manual initialization.
+ *
+ * See docs/guides/writing-projections.md for detailed rationale.
+ */
+export * from './interface.js';
+export * from './registry.js';
+export { NextJsProjection } from './nextjs/generator.js';
+export { RoutesProjection } from './routes/generator.js';
+export { PrismaProjection } from './prisma/generator.js';
+export { PrismaStoreProjection } from './prisma-store/generator.js';
+export { OpenApiProjection } from './openapi/generator.js';
+export { ReactQueryProjection } from './react-query/generator.js';
+export { ZodProjection } from './zod/generator.js';
+export { DrizzleProjection } from './drizzle/generator.js';
+export { GraphQLProjection } from './graphql/generator.js';
+export { LlmContextProjection } from './llm-context/generator.js';
+export { ExpressProjection } from './express/generator.js';
+export { HonoProjection } from './hono/generator.js';
+export { MermaidProjection } from './mermaid/generator.js';
+export { JsonSchemaProjection } from './jsonschema/generator.js';
+export { StorybookProjection } from './storybook/generator.js';
+export { HealthCheckProjection } from './health/generator.js';
+export { MaterializedViewsProjection } from './materialized-views/generator.js';
+export { ElasticsearchProjection } from './elasticsearch/generator.js';
+export { TerraformProjection } from './terraform/generator.js';
+export { AnalyticsProjection } from './analytics/generator.js';
+export { SvelteKitProjection } from './sveltekit/generator.js';
+export { KyselyProjection } from './kysely/generator.js';
+export { DynamoDBProjection } from './dynamodb/generator.js';
+export { PydanticProjection } from './pydantic/generator.js';
+export { DartProjection } from './dart/generator.js';
+export { registerBuiltinProjections, listBuiltinProjections } from './builtins.js';
+export type { OpenApiProjectionOptions, OpenApiSecurityScheme } from './openapi/types.js';
+export type { ReactQueryProjectionOptions } from './react-query/generator.js';
+export type { ZodProjectionOptions } from './zod/types.js';
+export type { DrizzleProjectionOptions } from './drizzle/options.js';
+export type { GraphQLProjectionOptions } from './graphql/types.js';
+export type { LlmContextProjectionOptions } from './llm-context/types.js';
+export type { ExpressProjectionOptions } from './express/types.js';
+export type { HonoProjectionOptions } from './hono/types.js';
+export type { MermaidProjectionOptions } from './mermaid/generator.js';
+export type { JsonSchemaProjectionOptions } from './jsonschema/types.js';
+export type { StorybookProjectionOptions } from './storybook/generator.js';
+export type { HealthCheckProjectionOptions } from './health/types.js';
+export type { MaterializedViewsProjectionOptions } from './materialized-views/options.js';
+export type { ElasticsearchProjectionOptions } from './elasticsearch/options.js';
+export type { TerraformProjectionOptions, TerraformProvider, TerraformBucket, TerraformDatabaseConfig } from './terraform/options.js';
+export type { MaterializedViewDefinition, MaterializedViewIndex, MaterializedViewRefreshStrategy, MaterializedViewSchedule, MaterializedViewTrigger, } from './materialized-views/types.js';
+export type { ElasticsearchIndexDefinition, ESFieldOverride, ESIngestPipeline, ESIngestPipelineProcessor, ESAnalyzerConfig, ESIndexerConfig, } from './elasticsearch/types.js';
+export type { RouteEntry, RouteManifest, RouteParam, RoutesProjectionOptions, ManualRouteDeclaration, } from './routes/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/projections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/manifest/projections/index.ts"],"names":[],"mappings":"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"}

package/dist/manifest/projections/index.js

@@ -0,0 +1,41 @@
+/**
+ * Projections module entry point.
+ *
+ * Projections consume IR and emit platform-specific code.
+ * They are NOT part of runtime semantics.
+ *
+ * The registry auto-registers builtins on first access, so consumers
+ * can simply call getProjection(name) without manual initialization.
+ *
+ * See docs/guides/writing-projections.md for detailed rationale.
+ */
+export * from './interface.js';
+export * from './registry.js';
+// Re-export built-in projections for convenience
+export { NextJsProjection } from './nextjs/generator.js';
+export { RoutesProjection } from './routes/generator.js';
+export { PrismaProjection } from './prisma/generator.js';
+export { PrismaStoreProjection } from './prisma-store/generator.js';
+export { OpenApiProjection } from './openapi/generator.js';
+export { ReactQueryProjection } from './react-query/generator.js';
+export { ZodProjection } from './zod/generator.js';
+export { DrizzleProjection } from './drizzle/generator.js';
+export { GraphQLProjection } from './graphql/generator.js';
+export { LlmContextProjection } from './llm-context/generator.js';
+export { ExpressProjection } from './express/generator.js';
+export { HonoProjection } from './hono/generator.js';
+export { MermaidProjection } from './mermaid/generator.js';
+export { JsonSchemaProjection } from './jsonschema/generator.js';
+export { StorybookProjection } from './storybook/generator.js';
+export { HealthCheckProjection } from './health/generator.js';
+export { MaterializedViewsProjection } from './materialized-views/generator.js';
+export { ElasticsearchProjection } from './elasticsearch/generator.js';
+export { TerraformProjection } from './terraform/generator.js';
+export { AnalyticsProjection } from './analytics/generator.js';
+export { SvelteKitProjection } from './sveltekit/generator.js';
+export { KyselyProjection } from './kysely/generator.js';
+export { DynamoDBProjection } from './dynamodb/generator.js';
+export { PydanticProjection } from './pydantic/generator.js';
+export { DartProjection } from './dart/generator.js';
+export { registerBuiltinProjections, listBuiltinProjections } from './builtins.js';
+//# sourceMappingURL=index.js.map

package/dist/manifest/projections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/manifest/projections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAE9B,iDAAiD;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/manifest/projections/interface.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Projection targets consume Manifest IR and emit platform/tooling artifacts.
+ *
+ * Projections are TOOLING, not runtime semantics.
+ * They must not redefine execution order or policy/guard semantics.
+ */
+import type { IR } from '../ir';
+import type { NamingConventionInput } from './shared/naming';
+export interface ProjectionRequest {
+    /**
+     * Surface identifier (capability name).
+     * Examples: "nextjs.route", "nextjs.command", "ts.types", "ts.client", "zod.schema", "docs.markdown"
+     */
+    surface: string;
+    /**
+     * Entity name when the surface is entity-scoped.
+     * Example: "Recipe" for "nextjs.route" or "nextjs.command"
+     */
+    entity?: string;
+    /**
+     * Command name when the surface is command-scoped.
+     * Example: "create" for "nextjs.command"
+     * Promoted to first-class field because it is a routing key, not a configuration option.
+     */
+    command?: string;
+    /**
+     * Surface-specific options.
+     * Keep this generic at the interface boundary; projections cast internally.
+     */
+    options?: Record<string, unknown>;
+}
+export interface ProjectionArtifact {
+    /** Stable identifier for this artifact (for caching, diffing, or tooling) */
+    id: string;
+    /**
+     * Suggested output path (caller decides where/if to write).
+     * Example: "app/api/recipes/route.ts" or "src/types/manifest.ts"
+     */
+    pathHint?: string;
+    /** Content type hint: "typescript", "json", "markdown", etc. */
+    contentType?: string;
+    /** The generated content */
+    code: string;
+}
+export interface ProjectionDiagnostic {
+    severity: 'error' | 'warning' | 'info';
+    /** Machine-readable error code for programmatic handling */
+    code?: string;
+    message: string;
+    entity?: string;
+}
+export interface ProjectionResult {
+    artifacts: ProjectionArtifact[];
+    diagnostics: ProjectionDiagnostic[];
+}
+/**
+ * Projection target for platform-specific code generation and IR-derived artifacts.
+ *
+ * CRITICAL: Projections are TOOLING, not semantics.
+ * - Reads (GET operations) MAY bypass runtime entirely
+ * - Writes (POST/PUT/DELETE) MUST use runtime.executeCommand()
+ *
+ * See docs/guides/writing-projections.md for detailed rationale.
+ */
+export interface ProjectionTarget {
+    /** Unique identifier (e.g., "nextjs", "hono", "express") */
+    readonly name: string;
+    /** Human-readable description of what this projection generates */
+    readonly description: string;
+    /** Declares which surfaces this target can generate */
+    readonly surfaces: readonly string[];
+    /**
+     * Generate artifacts for a requested surface.
+     *
+     * @param ir - Compiled Manifest IR
+     * @param request - Surface + optional entity + options
+     */
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+}
+/**
+ * Configuration options specific to Next.js projections.
+ *
+ * Note: outputPath is NOT part of the projection API.
+ * The projection returns artifacts; the CLI layer handles file writing.
+ */
+export interface NextJsProjectionOptions {
+    /** Auth provider: 'clerk', 'nextauth', 'custom', or 'none' */
+    authProvider?: 'clerk' | 'nextauth' | 'custom' | 'none';
+    /** Custom import path for auth utilities (default: '@/lib/auth') */
+    authImportPath?: string;
+    /** Custom import path for database client (default: '@/lib/database') */
+    databaseImportPath?: string;
+    /** Custom import path for response helpers (default: '@/lib/manifest-response') */
+    responseImportPath?: string;
+    /** Whether to include tenant filtering (default: true) */
+    includeTenantFilter?: boolean;
+    /** Whether to include soft delete filtering (default: true) */
+    includeSoftDeleteFilter?: boolean;
+    /** Name of tenant ID property (default: 'tenantId') */
+    tenantIdProperty?: string;
+    /** Name of soft delete timestamp property (default: 'deletedAt') */
+    deletedAtProperty?: string;
+    /** App Router directory (default: 'app/api') */
+    appDir?: string;
+    /** Whether to generate TypeScript strict mode code (default: true) */
+    strictMode?: boolean;
+    /** Whether to include comments in generated code */
+    includeComments?: boolean;
+    /** Custom import path for Manifest runtime factory (default: '@/lib/manifest-runtime') */
+    runtimeImportPath?: string;
+    /**
+     * Pluggable tenant resolution strategy.
+     * When provided, replaces the default userTenantMapping.findUnique pattern.
+     * Example: { importPath: '@repo/database', functionName: 'getTenantIdForOrg', lookupKey: 'orgId' }
+     */
+    tenantProvider?: {
+        /** Import path for the tenant lookup function */
+        importPath: string;
+        /** Function name to call (e.g. 'getTenantIdForOrg') */
+        functionName: string;
+        /** Which auth field to pass as the lookup key */
+        lookupKey: 'orgId' | 'userId';
+    };
+    /** Custom indentation (default: 2 spaces) */
+    indentSize?: number;
+    /**
+     * HTTP status returned when the auth helper rejects the request OR when
+     * it throws (e.g. invalid/expired token). Default 401. Configurable so
+     * apps that standardise on 403 to avoid leaking user-existence can
+     * override without forking the generator.
+     *
+     * Auth failures MUST NEVER surface as 500.
+     */
+    unauthorizedStatus?: number;
+    /**
+     * Dispatcher configuration for the canonical write surface at
+     *   POST /api/manifest/[entity]/commands/[command]
+     *
+     * Defaults preserve the historical inline behaviour (the dispatcher
+     * constructs a `createManifestRuntime` instance per request and calls
+     * `runtime.runCommand`). Set `executionMode` to `'externalExecutor'` when
+     * the downstream app owns runtime construction and the dispatcher should
+     * be a thin transport adapter delegating to an app-supplied executor.
+     *
+     * See docs/spec/config/manifest.config.md for the full key reference and
+     * an externalExecutor migration example.
+     */
+    dispatcher?: {
+        /** Whether the dispatcher surface is emitted at all (default: true) */
+        enabled?: boolean;
+        /**
+         * Where command execution happens:
+         *   - 'inline' (default): emit `createManifestRuntime` + `runtime.runCommand`
+         *   - 'externalExecutor': import the configured executor and call it,
+         *     do NOT inline runtime construction
+         */
+        executionMode?: 'inline' | 'externalExecutor';
+        /** Import path for the external executor (only used in externalExecutor mode) */
+        executorImportPath?: string;
+        /** Named export to call on the external executor module */
+        executorImportName?: string;
+        /**
+         * When true (default), the dispatcher extracts an `instanceId` from
+         * `body.instanceId` or `body.id` and forwards it to runCommand /
+         * the configured executor. Non-create commands (update, archive,
+         * release, …) need this to address the target instance; create
+         * commands ignore it harmlessly.
+         */
+        deriveInstanceId?: boolean;
+        /**
+         * Dispatcher route path relative to `appDir`. Default
+         * `/manifest/[entity]/commands/[command]/route.ts`. Override only
+         * if your app uses a non-canonical prefix (e.g. `/api/v1/manifest/...`).
+         */
+        path?: string;
+    };
+    /**
+     * Policy for the deprecated per-command "concrete" routes
+     * (the `nextjs.command` surface).
+     *
+     * - `enabled: false` (default) — the canonical dispatcher is the single
+     *   write surface. Concrete per-command routes are not emitted by
+     *   `--surface all` and `manifest.command` requests return an info
+     *   diagnostic. Apps that still need them for legacy callers must
+     *   explicitly opt in with `enabled: true`.
+     * - `legacyAliasesOnly: true` (default) — emitted concrete routes
+     *   carry the DEPRECATED ALIAS banner pointing at the dispatcher.
+     *   Set to `false` only if you intentionally treat per-command routes
+     *   as a first-class surface.
+     */
+    concreteCommandRoutes?: {
+        enabled?: boolean;
+        legacyAliasesOnly?: boolean;
+    };
+    /**
+     * Policy for direct database read routes (GET list, GET detail).
+     *
+     * Direct reads bypass the runtime engine for read performance.
+     * They assume a Prisma-compatible client at `databaseImportPath`.
+     *
+     * - `enabled: false` suppresses both list and detail read routes
+     *   (no GET handlers emitted for the entity).
+     * - `directDbReads: false` emits read route stubs without inlining a
+     *   Prisma call — useful for projects that route reads through a
+     *   separate query layer.
+     *
+     * Defaults: { enabled: true, directDbReads: true } — preserves the
+     * historical behaviour.
+     */
+    readRoutes?: {
+        enabled?: boolean;
+        directDbReads?: boolean;
+    };
+    /**
+     * Base directory for generated non-route artifacts (types, client, hooks,
+     * shared-runtime). Default: `'src'`.
+     */
+    generatedDir?: string;
+    /**
+     * Fine-grained overrides for individual artifact paths. Each value is
+     * relative to project root. When set, it takes precedence over
+     * `generatedDir`.
+     */
+    paths?: {
+        /** pathHint for ts.types. Default: `${generatedDir}/types/manifest-generated.ts` */
+        typesFile?: string;
+        /** pathHint for ts.client. Default: `${generatedDir}/lib/manifest-client.ts` */
+        clientFile?: string;
+        /** Base dir for subscription hooks. Default: `${generatedDir}/hooks` */
+        hooksDir?: string;
+        /** pathHint for nextjs.sharedRuntime. Default: `${generatedDir}/lib/manifest-shared-runtime.ts` */
+        sharedRuntimeFile?: string;
+    };
+    /**
+     * Naming convention for database accessor names (`database.<accessor>` in
+     * generated read routes). Same shape as the Prisma projection's `naming`
+     * option: `'snake_case'` shorthand or `{ table, column, pluralizeTables }`.
+     * Applies `resolveTableName` to the entity name — use this when the
+     * database client exposes physical table names (Kysely, raw SQL) rather
+     * than Prisma's model-derived delegates. Response field names and local
+     * variables are NOT affected (they remain the camelCased entity name —
+     * the API contract is independent of physical DB naming).
+     */
+    naming?: NamingConventionInput;
+    /**
+     * Explicit per-entity database accessor overrides. Takes precedence over
+     * `naming`. e.g. `{ OrderLine: 'order_lines' }` →
+     * `database.order_lines.findMany(...)`.
+     */
+    accessorNames?: Record<string, string>;
+    /**
+     * Explicit per-entity URL path segment overrides for generated routes and
+     * the client SDK's fetch paths. Takes precedence over the default
+     * lowercased entity name. e.g. `{ OrderLine: 'order-lines' }` →
+     * `app/api/order-lines/list/route.ts` + `fetch('/api/order-lines/list')`.
+     */
+    routeSegments?: Record<string, string>;
+}
+/**
+ * Configuration options for Remix projections.
+ */
+export interface RemixProjectionOptions {
+    authProvider?: 'clerk' | 'remix-auth' | 'custom' | 'none';
+    authImportPath?: string;
+    databaseImportPath?: string;
+    responseImportPath?: string;
+    runtimeImportPath?: string;
+    sessionStoragePath?: string;
+    includeTenantFilter?: boolean;
+    includeSoftDeleteFilter?: boolean;
+    tenantIdProperty?: string;
+    deletedAtProperty?: string;
+    routesDir?: string;
+    strictMode?: boolean;
+    includeComments?: boolean;
+    includeErrorBoundary?: boolean;
+    unauthorizedStatus?: number;
+    remixVersion?: 'v2' | 'v7';
+    tenantProvider?: {
+        importPath: string;
+        functionName: string;
+        lookupKey: 'orgId' | 'userId';
+    };
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/manifest/projections/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/manifest/projections/interface.ts"],"names":[],"mappings":"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"}

package/dist/manifest/projections/interface.js

@@ -0,0 +1,8 @@
+/**
+ * Projection targets consume Manifest IR and emit platform/tooling artifacts.
+ *
+ * Projections are TOOLING, not runtime semantics.
+ * They must not redefine execution order or policy/guard semantics.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/manifest/projections/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/manifest/projections/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/manifest/projections/jsonschema/generator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * JSON Schema projection for Manifest IR.
+ *
+ * Generates JSON Schema documents (drafts 7, 2019-09, 2020-12) from IR entity
+ * definitions. Maps Manifest property types, modifiers, defaults, and
+ * constraints to JSON Schema keywords (`pattern`, `minimum`, `maximum`,
+ * `required`, `enum`, `minLength`, `maxLength`).
+ *
+ * Produces one schema file per entity.
+ *
+ * Surfaces:
+ *   - jsonschema.entity  → single entity schema (requires `entity` in request)
+ *   - jsonschema.schemas → all entity schemas as separate artifacts
+ */
+import type { IR } from '../../ir';
+import type { ProjectionTarget, ProjectionRequest, ProjectionResult } from '../interface';
+/**
+ * JSON Schema projection.
+ *
+ * Generates JSON Schema documents from Manifest IR entity definitions.
+ *
+ * Surfaces:
+ *   - jsonschema.entity  → single entity schema (entity name required)
+ *   - jsonschema.schemas → all entity schemas
+ */
+export declare class JsonSchemaProjection implements ProjectionTarget {
+    readonly name = "jsonschema";
+    readonly description = "JSON Schema (draft-07/2019-09/2020-12) generation from Manifest IR entities";
+    readonly surfaces: readonly ["jsonschema.entity", "jsonschema.schemas"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+    private generateEntitySurface;
+    private generateAllSurface;
+}
+export type { JsonSchemaProjectionOptions } from './types';
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/jsonschema/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/jsonschema/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,EAAE,EAMH,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,cAAc,CAAC;AAqVtB;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,iFAAiF;IACrG,QAAQ,CAAC,QAAQ,uDAAY;IAE7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IA2B9D,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,kBAAkB;CAuB3B;AAGD,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC"}