@analogjs/platform 3.0.0-alpha.7 → 3.0.0-alpha.70

package/src/lib/server-fn-client-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fn-client-transform.js","names":[],"sources":["../../../src/lib/server-fn-client-transform.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\n// Light subpath (no vite/nitro barrel): the built scrub is loaded outside a\n// build too, so it must not pull the plugin graph in.\nimport { deriveServerFnId } from './server-fn-id.js';\n\n/**\n * Client-build scrub + proxy generation for server functions.\n *\n * On the client build a `*.server.ts` module must not carry server handler\n * bodies (which `inject()` server services, read the request, hit the database).\n * But the client still imports the named `serverFn` exports to dispatch them.\n * This transform regenerates the module so each `export const NAME = serverFn(\n * config, handler)` becomes a call to the client-safe `createServerFnRef`\n * factory — keeping the `{ id, url, method }` metadata `injectServerFn` needs,\n * dropping the handler and every server-only import. Because the regenerated\n * module references nothing else, the server code tree-shakes away entirely.\n *\n * Returns the new module source, or `null` when the module defines no server\n * function (the caller falls back to the page-endpoint scrub for those).\n */\nexport interface ServerFnProxy {\n  name: string;\n  id: string;\n  method: 'GET' | 'POST';\n}\n\nexport interface ScrubResult {\n  code: string;\n  proxies: ServerFnProxy[];\n  hadDefaultExport: boolean;\n}\n\nconst SERVER_FN_SOURCE = '@analogjs/router/server';\n\nexport function scrubServerFnModule(\n  code: string,\n  fileId = 'file.ts',\n): ScrubResult | null {\n  // Cheap bail-out before parsing: no `serverFn` token, nothing to do.\n  if (!code.includes('serverFn')) {\n    return null;\n  }\n\n  const { program } = parseSync(fileId, code);\n  const body = (program as { body: any[] }).body;\n\n  const serverFnLocalNames = collectServerFnLocalNames(body);\n  const hadDefaultExport = body.some(\n    (node) => node.type === 'ExportDefaultDeclaration',\n  );\n\n  const proxies: ServerFnProxy[] = [];\n  for (const node of body) {\n    if (\n      node.type !== 'ExportNamedDeclaration' ||\n      node.declaration?.type !== 'VariableDeclaration'\n    ) {\n      continue;\n    }\n    for (const declarator of node.declaration.declarations) {\n      if (\n        declarator.id?.type !== 'Identifier' ||\n        declarator.init?.type !== 'CallExpression' ||\n        declarator.init.callee?.type !== 'Identifier' ||\n        !serverFnLocalNames.has(declarator.init.callee.name)\n      ) {\n        continue;\n      }\n      proxies.push(\n        toProxy(declarator.id.name, declarator.init.arguments ?? [], fileId),\n      );\n    }\n  }\n\n  // Every `serverFn(...)` call in the module must have become a proxy. If one\n  // did not, the module uses a shape this transform cannot rewrite (e.g.\n  // `const fn = serverFn(...); export { fn };`) and returning `null` would leave\n  // it untouched — shipping the handler and its server imports to the browser.\n  // Fail the build instead: a scrub that silently opts out is a code leak.\n  const callCount = countServerFnCalls(program, serverFnLocalNames);\n  if (callCount > proxies.length) {\n    throw new Error(\n      `[analog] ${fileId}: found ${callCount} serverFn call(s) but could only rewrite ${proxies.length} for the client build. ` +\n        `Server functions must be declared as a directly exported const — \\`export const name = serverFn(…)\\` — so the handler can be stripped from the browser bundle.`,\n    );\n  }\n\n  if (proxies.length === 0) {\n    return null;\n  }\n\n  const lines = [\n    `import { createServerFnRef } from '@analogjs/router';`,\n    '',\n    ...proxies.map(\n      (p) =>\n        `export const ${p.name} = createServerFnRef({ id: ${JSON.stringify(\n          p.id,\n        )}, method: ${JSON.stringify(p.method)} });`,\n    ),\n  ];\n  // A file that is also a page endpoint keeps the load-shim the router expects.\n  if (hadDefaultExport) {\n    lines.push('', 'export default undefined;');\n  }\n\n  return { code: lines.join('\\n') + '\\n', proxies, hadDefaultExport };\n}\n\n/** Local identifier(s) `serverFn` is imported under from `@analogjs/router/server`. */\nfunction collectServerFnLocalNames(body: any[]): Set<string> {\n  const names = new Set<string>();\n  for (const node of body) {\n    if (\n      node.type !== 'ImportDeclaration' ||\n      node.source?.value !== SERVER_FN_SOURCE\n    ) {\n      continue;\n    }\n    for (const spec of node.specifiers ?? []) {\n      if (\n        spec.type === 'ImportSpecifier' &&\n        spec.imported?.name === 'serverFn'\n      ) {\n        names.add(spec.local.name);\n      }\n    }\n  }\n  // Fallback: if the module never imported it (unusual), still match the\n  // conventional name so a mis-resolved import doesn't leak server code.\n  if (names.size === 0) {\n    names.add('serverFn');\n  }\n  return names;\n}\n\nfunction toProxy(name: string, args: any[], fileId: string): ServerFnProxy {\n  const method = methodForCall(name, args, fileId);\n  // The id is derived, never read from source — same algorithm the server\n  // registration uses, so client proxy and server route always match.\n  return { name, id: deriveServerFnId(fileId, name), method };\n}\n\n/**\n * Resolve the HTTP method from the call shape, matching the runtime overloads:\n * `serverFn(handler)` ⇒ GET, `serverFn(schema, handler)` ⇒ POST,\n * `serverFn(config, handler)` ⇒ config-driven.\n */\nfunction methodForCall(\n  name: string,\n  args: any[],\n  fileId: string,\n): 'GET' | 'POST' {\n  const arg0 = args[0];\n\n  // serverFn(handler) — input-less GET.\n  if (isFunctionNode(arg0)) return 'GET';\n\n  // serverFn(config, handler) — read method/input off the object.\n  if (arg0?.type === 'ObjectExpression') {\n    let method: 'GET' | 'POST' | undefined;\n    let hasInput = false;\n    for (const prop of arg0.properties ?? []) {\n      if (prop.type !== 'Property') continue;\n      const key =\n        prop.key?.type === 'Identifier' ? prop.key.name : prop.key?.value;\n      if (key === 'method' && isStringLiteral(prop.value)) {\n        method = prop.value.value as 'GET' | 'POST';\n      } else if (key === 'input') {\n        hasInput = true;\n      }\n    }\n    if (method === 'GET' && hasInput) {\n      throw new Error(\n        `[analog] serverFn \"${name}\" in ${fileId} declares method: 'GET' with an input schema; GET carries no body. Use POST or drop the input.`,\n      );\n    }\n    return method ?? (hasInput ? 'POST' : 'GET');\n  }\n\n  // serverFn(schema, handler) — a schema ⇒ POST + input.\n  if (arg0 && args.length >= 2) return 'POST';\n\n  throw new Error(\n    `[analog] serverFn \"${name}\" in ${fileId} must be called as serverFn(handler), serverFn(schema, handler), or serverFn(config, handler).`,\n  );\n}\n\nfunction isFunctionNode(node: any): boolean {\n  return (\n    node?.type === 'ArrowFunctionExpression' ||\n    node?.type === 'FunctionExpression'\n  );\n}\n\nfunction isStringLiteral(\n  node: any,\n): node is { type: 'Literal'; value: string } {\n  return node?.type === 'Literal' && typeof node.value === 'string';\n}\n\n/** Every `serverFn(...)` call anywhere in the module, not just exported ones. */\nfunction countServerFnCalls(node: unknown, names: Set<string>): number {\n  if (!node || typeof node !== 'object') {\n    return 0;\n  }\n  if (Array.isArray(node)) {\n    return node.reduce(\n      (total, child) => total + countServerFnCalls(child, names),\n      0,\n    );\n  }\n\n  const record = node as Record<string, unknown> & { type?: string };\n  let count = 0;\n  if (record.type === 'CallExpression') {\n    const callee = record['callee'] as { type?: string; name?: string };\n    if (\n      callee?.type === 'Identifier' &&\n      callee.name &&\n      names.has(callee.name)\n    ) {\n      count += 1;\n    }\n  }\n  for (const key of Object.keys(record)) {\n    count += countServerFnCalls(record[key], names);\n  }\n  return count;\n}\n"],"mappings":"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"}

package/src/lib/server-fn-id.d.ts

@@ -0,0 +1,25 @@
+/**
+* Server-function ids are derived, never author-chosen, for security:
+*
+* - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so
+*   two functions can never share a route and hijack each other's dispatch — a
+*   real risk with hand-picked ids where two authors independently pick `getUser`.
+* - **Non-enumerable.** The public route is an opaque digest, not a guessable
+*   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.
+* - **Not author-controlled.** Authors cannot expose a meaningful or duplicate
+*   route by accident; the id is a pure function of location.
+*
+* Both build transforms (server registration + client proxy) MUST derive the
+* same id, so this is the single source of truth for the algorithm and the
+* `fileId` must be the **project-root-relative** POSIX path — identical across
+* the client, SSR, and Nitro builds regardless of absolute checkout location.
+*/
+/** Project-root-relative POSIX module path used as the stable hash input. */
+export declare function serverFnFileId(absPath: string, projectRoot: string): string;
+/**
+* Derives the opaque, collision-free id for a server function from its
+* project-root-relative file id and export name. 16 hex chars (64 bits) is far
+* beyond birthday-collision range for any realistic function count while keeping
+* the route short.
+*/
+export declare function deriveServerFnId(fileId: string, exportName: string): string;

package/src/lib/server-fn-id.js

@@ -0,0 +1,37 @@
+import { relative } from "node:path";
+import { createHash } from "node:crypto";
+//#region packages/platform/src/lib/server-fn-id.ts
+var toPosix = (p) => p.replace(/\\/g, "/");
+/**
+* Server-function ids are derived, never author-chosen, for security:
+*
+* - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so
+*   two functions can never share a route and hijack each other's dispatch — a
+*   real risk with hand-picked ids where two authors independently pick `getUser`.
+* - **Non-enumerable.** The public route is an opaque digest, not a guessable
+*   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.
+* - **Not author-controlled.** Authors cannot expose a meaningful or duplicate
+*   route by accident; the id is a pure function of location.
+*
+* Both build transforms (server registration + client proxy) MUST derive the
+* same id, so this is the single source of truth for the algorithm and the
+* `fileId` must be the **project-root-relative** POSIX path — identical across
+* the client, SSR, and Nitro builds regardless of absolute checkout location.
+*/
+/** Project-root-relative POSIX module path used as the stable hash input. */
+function serverFnFileId(absPath, projectRoot) {
+	return toPosix(relative(projectRoot, absPath));
+}
+/**
+* Derives the opaque, collision-free id for a server function from its
+* project-root-relative file id and export name. 16 hex chars (64 bits) is far
+* beyond birthday-collision range for any realistic function count while keeping
+* the route short.
+*/
+function deriveServerFnId(fileId, exportName) {
+	return createHash("sha256").update(`${fileId}#${exportName}`).digest("hex").slice(0, 16);
+}
+//#endregion
+export { deriveServerFnId, serverFnFileId };
+
+//# sourceMappingURL=server-fn-id.js.map

package/src/lib/server-fn-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fn-id.js","names":[],"sources":["../../../src/lib/server-fn-id.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { relative } from 'node:path';\n\n// Intentionally dependency-light (node built-ins only): this module is loaded by\n// the client scrub, so it must not drag in vite/nitro. POSIX-normalize inline.\nconst toPosix = (p: string): string => p.replace(/\\\\/g, '/');\n\n/**\n * Server-function ids are derived, never author-chosen, for security:\n *\n * - **Collision-free.** `hash(fileId + exportName)` is unique per file+export, so\n *   two functions can never share a route and hijack each other's dispatch — a\n *   real risk with hand-picked ids where two authors independently pick `getUser`.\n * - **Non-enumerable.** The public route is an opaque digest, not a guessable\n *   verb like `/_analog/fn/deleteAccount`, shrinking the discoverable surface.\n * - **Not author-controlled.** Authors cannot expose a meaningful or duplicate\n *   route by accident; the id is a pure function of location.\n *\n * Both build transforms (server registration + client proxy) MUST derive the\n * same id, so this is the single source of truth for the algorithm and the\n * `fileId` must be the **project-root-relative** POSIX path — identical across\n * the client, SSR, and Nitro builds regardless of absolute checkout location.\n */\n\n/** Project-root-relative POSIX module path used as the stable hash input. */\nexport function serverFnFileId(absPath: string, projectRoot: string): string {\n  return toPosix(relative(projectRoot, absPath));\n}\n\n/**\n * Derives the opaque, collision-free id for a server function from its\n * project-root-relative file id and export name. 16 hex chars (64 bits) is far\n * beyond birthday-collision range for any realistic function count while keeping\n * the route short.\n */\nexport function deriveServerFnId(fileId: string, exportName: string): string {\n  return createHash('sha256')\n    .update(`${fileId}#${exportName}`)\n    .digest('hex')\n    .slice(0, 16);\n}\n"],"mappings":";;;AAKA,IAAM,WAAW,MAAsB,EAAE,QAAQ,OAAO,IAAI;;;;;;;;;;;;;;;;;;AAoB5D,SAAgB,eAAe,SAAiB,aAA6B;AAC3E,QAAO,QAAQ,SAAS,aAAa,QAAQ,CAAC;;;;;;;;AAShD,SAAgB,iBAAiB,QAAgB,YAA4B;AAC3E,QAAO,WAAW,SAAS,CACxB,OAAO,GAAG,OAAO,GAAG,aAAa,CACjC,OAAO,MAAM,CACb,MAAM,GAAG,GAAG"}

package/src/lib/ssr/defer-streaming-plugin.d.ts

@@ -0,0 +1,65 @@
+import type { Plugin } from "vite";
+/**
+* Minimum Angular major whose compiled `@angular/core` FESM matches the
+* streaming patch anchors. Incremental hydration is a stable public API from
+* v20 (`withIncrementalHydration`, `@publicApi 20.0`), but v20's FESM inlines
+* the injection anchor's `DeferBlockStateEnd` profiler event to its numeric
+* ordinal, whereas v21+ keeps the symbolic `ProfilerEvent.DeferBlockStateEnd`
+* form the anchor matches on. Keying on the literal ordinal would be fragile
+* (enum values shift between versions), so v21 is the floor.
+*/
+export declare const MIN_STREAMING_ANGULAR_MAJOR = 21;
+/**
+* Whether the streaming SSR patch can be applied to the installed Angular.
+* A `null` major (version undetectable) returns `true`: don't block on a failed
+* detection — the plugin's anchor-drift detection catches a real mismatch at
+* build time and falls back to buffered rendering.
+*/
+export declare function streamingSupportedOnAngular(major: number | null): boolean;
+/**
+* Pure transform that injects the streaming-SSR per-block resolution hook into
+* `@angular/core`'s compiled output. It is the same class of transform as
+* `i18nDefRegistryPlugin` in ./ssr-build-plugin — a string patch of Angular's
+* bundle applied only to SSR builds. Exported separately so it can be unit
+* tested against a bundle string.
+*
+* Two edits, both keyed on single-occurrence anchors in the module that holds
+* the defer runtime:
+*   1. Inside `applyDeferBlockState`, fire `globalThis.__analogSsrDeferCapture`
+*      when a `@defer` block reaches `Complete` on the server, passing the
+*      block's live `lContainer` — this is the per-block resolution signal a
+*      streaming renderer consumes.
+*   2. Expose `collectNativeNodesInLContainer` via `globalThis.__analogSsrInternals`
+*      so the renderer can serialize a block's subtree.
+*
+* Returns `null` when the module is not the one carrying the defer runtime, so
+* it is a no-op on every other Angular module.
+*/
+export declare function injectDeferStreamingHook(code: string): string | null;
+/**
+* Classify an `@angular/core` module for the streaming patch. The patch anchors
+* on internal symbol names, so when Angular changes those the transform would
+* otherwise become a silent no-op and streaming would degrade to buffered with
+* no signal. This distinguishes "not the target module" (skip quietly) from
+* "this IS the `@defer` runtime module but the anchors drifted" (worth warning).
+*/
+export declare function inspectAngularCoreModule(code: string): {
+	kind: "not-target";
+} | {
+	kind: "patchable";
+} | {
+	kind: "drifted";
+	reason: string;
+};
+/**
+* Vite plugin that applies {@link injectDeferStreamingHook} to `@angular/core`
+* during SSR builds, so `@analogjs/router`'s `renderStream` can flush `@defer`
+* blocks as they resolve on the server — without hand-patching node_modules.
+*
+* Only active for SSR. Mirrors the enforce/filter/ssr-gate shape of
+* `i18nDefRegistryPlugin`. If the `@defer` runtime module is found but its
+* anchors have drifted (Angular changed internals), or if it is never
+* encountered at all, the plugin warns rather than silently producing a build
+* that falls back to buffered rendering.
+*/
+export declare function deferStreamingPlugin(): Plugin;

package/src/lib/ssr/inject-html-plugin.d.ts

@@ -1,2 +1,2 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
 export declare function injectHTMLPlugin(): Plugin[];

package/src/lib/ssr/inject-html-plugin.js

@@ -1,28 +1,28 @@
-import { VERSION } from '@angular/compiler-cli';
-import { readFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
+import { createRequire } from "node:module";
+import { VERSION } from "@angular/compiler-cli";
+import { readFile } from "node:fs/promises";
+//#region packages/platform/src/lib/ssr/inject-html-plugin.ts
+var require = createRequire(import.meta.url);
 function eventReplayPlugin() {
-    return {
-        name: 'analogjs-event-replay-plugin',
-        async transformIndexHtml() {
-            const eventReplayScript = await readFile(require.resolve('@angular/core/event-dispatch-contract.min.js'), 'utf-8');
-            return [
-                {
-                    tag: 'script',
-                    attrs: {
-                        type: 'text/javascript',
-                        id: 'ng-event-dispatch-contract',
-                    },
-                    children: eventReplayScript,
-                    injectTo: 'body',
-                },
-            ];
-        },
-    };
+	return {
+		name: "analogjs-event-replay-plugin",
+		async transformIndexHtml() {
+			return [{
+				tag: "script",
+				attrs: {
+					type: "text/javascript",
+					id: "ng-event-dispatch-contract"
+				},
+				children: await readFile(require.resolve("@angular/core/event-dispatch-contract.min.js"), "utf-8"),
+				injectTo: "body"
+			}];
+		}
+	};
 }
-export function injectHTMLPlugin() {
-    const hasEventReplay = Number(VERSION.major) >= 18;
-    return hasEventReplay ? [eventReplayPlugin()] : [];
+function injectHTMLPlugin() {
+	return Number(VERSION.major) >= 18 ? [eventReplayPlugin()] : [];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5qZWN0LWh0bWwtcGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vcGFja2FnZXMvcGxhdGZvcm0vc3JjL2xpYi9zc3IvaW5qZWN0LWh0bWwtcGx1Z2luLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVoRCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUU1QyxNQUFNLE9BQU8sR0FBRyxhQUFhLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUUvQyxTQUFTLGlCQUFpQjtJQUN4QixPQUFPO1FBQ0wsSUFBSSxFQUFFLDhCQUE4QjtRQUNwQyxLQUFLLENBQUMsa0JBQWtCO1lBQ3RCLE1BQU0saUJBQWlCLEdBQUcsTUFBTSxRQUFRLENBQ3RDLE9BQU8sQ0FBQyxPQUFPLENBQUMsOENBQThDLENBQUMsRUFDL0QsT0FBTyxDQUNSLENBQUM7WUFFRixPQUFPO2dCQUNMO29CQUNFLEdBQUcsRUFBRSxRQUFRO29CQUNiLEtBQUssRUFBRTt3QkFDTCxJQUFJLEVBQUUsaUJBQWlCO3dCQUN2QixFQUFFLEVBQUUsNEJBQTRCO3FCQUNqQztvQkFDRCxRQUFRLEVBQUUsaUJBQWlCO29CQUMzQixRQUFRLEVBQUUsTUFBTTtpQkFDakI7YUFDRixDQUFDO1FBQ0osQ0FBQztLQUNGLENBQUM7QUFDSixDQUFDO0FBRUQsTUFBTSxVQUFVLGdCQUFnQjtJQUM5QixNQUFNLGNBQWMsR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUVuRCxPQUFPLGNBQWMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxpQkFBaUIsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNyRCxDQUFDIn0=
+//#endregion
+export { injectHTMLPlugin };
+
+//# sourceMappingURL=inject-html-plugin.js.map

package/src/lib/ssr/inject-html-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-html-plugin.js","names":[],"sources":["../../../../src/lib/ssr/inject-html-plugin.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { Plugin } from 'vite';\nimport { readFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\nfunction eventReplayPlugin(): Plugin {\n  return {\n    name: 'analogjs-event-replay-plugin',\n    async transformIndexHtml() {\n      const eventReplayScript = await readFile(\n        require.resolve('@angular/core/event-dispatch-contract.min.js'),\n        'utf-8',\n      );\n\n      return [\n        {\n          tag: 'script',\n          attrs: {\n            type: 'text/javascript',\n            id: 'ng-event-dispatch-contract',\n          },\n          children: eventReplayScript,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n}\n\nexport function injectHTMLPlugin(): Plugin[] {\n  const hasEventReplay = Number(VERSION.major) >= 18;\n\n  return hasEventReplay ? [eventReplayPlugin()] : [];\n}\n"],"mappings":";;;;AAKA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,SAAS,oBAA4B;AACnC,QAAO;EACL,MAAM;EACN,MAAM,qBAAqB;AAMzB,UAAO,CACL;IACE,KAAK;IACL,OAAO;KACL,MAAM;KACN,IAAI;KACL;IACD,UAZsB,MAAM,SAC9B,QAAQ,QAAQ,+CAA+C,EAC/D,QACD;IAUG,UAAU;IACX,CACF;;EAEJ;;AAGH,SAAgB,mBAA6B;AAG3C,QAFuB,OAAO,QAAQ,MAAM,IAAI,KAExB,CAAC,mBAAmB,CAAC,GAAG,EAAE"}

package/src/lib/ssr/ssr-build-plugin.d.ts

@@ -1,2 +1,26 @@
-import { Plugin } from 'vite';
-export declare function ssrBuildPlugin(): Plugin;
+import * as vite from "vite";
+/**
+* SSR build patches for Angular platform-server, Zone.js, and Domino.
+*
+* **Why each patch exists:**
+* - zone-node: removes a `const global = globalThis` alias that shadows the
+*   real global in strict mode.
+* - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
+*   replaces bare `global` references with `globalThis`.
+* - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
+* - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
+*/
+export declare function ssrBuildPlugin(): vite.Plugin[];
+/**
+* Vite plugin that patches `@angular/core`'s `getComponentId()` to
+* mirror every compiled component definition to a global Set, bypassing
+* the `ngServerMode` guard that normally prevents registration on the
+* server. The set lives at `globalThis.__ngComponentDefs` and is read by
+* `@analogjs/router`'s SSR render function to null cached `tView`
+* objects between requests so that `$localize` tagged templates in
+* `consts()` re-evaluate with the freshly loaded translations.
+*
+* Only active when the platform's `i18n` option is configured.
+* Only transforms `@angular/core` modules in SSR builds.
+*/
+export declare function i18nDefRegistryPlugin(): Plugin;

package/src/lib/ssr/ssr-build-plugin.js

@@ -1,31 +1,39 @@
-import { normalizePath } from 'vite';
-export function ssrBuildPlugin() {
-    return {
-        name: 'analogjs-ssr-build-plugin',
-        transform(code, id) {
-            if (id.includes('zone-node') &&
-                code.includes('const global = globalThis;')) {
-                return {
-                    code: code.replace('const global = globalThis;', ''),
-                };
-            }
-            if (id.includes('platform-server')) {
-                return {
-                    code: code
-                        .replace('new xhr2.XMLHttpRequest', 'new (xhr2.default.XMLHttpRequest || xhr2.default)')
-                        .replaceAll('global.', 'globalThis.')
-                        .replaceAll('global,', 'globalThis,')
-                        .replaceAll(' global[', ' globalThis['),
-                };
-            }
-            // Remove usage of `with()` in sloppy.js file
-            if (id.includes(normalizePath('domino/lib/sloppy.js'))) {
-                return {
-                    code: code.replace(/with\(/gi, 'if('),
-                };
-            }
-            return;
-        },
-    };
+import * as vite from "vite";
+//#region packages/platform/src/lib/ssr/ssr-build-plugin.ts
+/**
+* SSR build patches for Angular platform-server, Zone.js, and Domino.
+*
+* **Why each patch exists:**
+* - zone-node: removes a `const global = globalThis` alias that shadows the
+*   real global in strict mode.
+* - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and
+*   replaces bare `global` references with `globalThis`.
+* - xhr2: strips Node-specific `os`/`process` references for SSR bundling.
+* - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.
+*/
+function ssrBuildPlugin() {
+	return [{
+		name: "analogjs-ssr-build-plugin",
+		apply: "build",
+		config() {
+			return { ssr: { noExternal: ["xhr2"] } };
+		},
+		transform: {
+			filter: { id: /zone-node|platform-server|xhr2\.js|domino\/lib\/sloppy\.js/ },
+			handler(code, id) {
+				if (id.includes("zone-node") && code.includes("const global = globalThis;")) return { code: code.replace("const global = globalThis;", "") };
+				if (id.includes("platform-server")) {
+					let result = code.replace("new xhr2.XMLHttpRequest", "new (xhr2.default.XMLHttpRequest || xhr2.default)");
+					result = result.replaceAll("global.", "globalThis.").replaceAll("global,", "globalThis,").replaceAll(" global[", " globalThis[");
+					return { code: result };
+				}
+				if (id.includes(vite.normalizePath("xhr2.js"))) return { code: code.replace("os.type()", `''`).replace("os.arch()", `''`).replace("process.versions.node", `'node'`).replace("process.versions.v8", `'v8'`) };
+				if (id.includes(vite.normalizePath("domino/lib/sloppy.js"))) return { code: code.replace(/with\(/gi, "if(") };
+			}
+		}
+	}];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3NyLWJ1aWxkLXBsdWdpbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL3BsYXRmb3JtL3NyYy9saWIvc3NyL3Nzci1idWlsZC1wbHVnaW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBVSxNQUFNLE1BQU0sQ0FBQztBQUU3QyxNQUFNLFVBQVUsY0FBYztJQUM1QixPQUFPO1FBQ0wsSUFBSSxFQUFFLDJCQUEyQjtRQUNqQyxTQUFTLENBQUMsSUFBSSxFQUFFLEVBQUU7WUFDaEIsSUFDRSxFQUFFLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQztnQkFDeEIsSUFBSSxDQUFDLFFBQVEsQ0FBQyw0QkFBNEIsQ0FBQyxFQUMzQyxDQUFDO2dCQUNELE9BQU87b0JBQ0wsSUFBSSxFQUFFLElBQUksQ0FBQyxPQUFPLENBQUMsNEJBQTRCLEVBQUUsRUFBRSxDQUFDO2lCQUNyRCxDQUFDO1lBQ0osQ0FBQztZQUVELElBQUksRUFBRSxDQUFDLFFBQVEsQ0FBQyxpQkFBaUIsQ0FBQyxFQUFFLENBQUM7Z0JBQ25DLE9BQU87b0JBQ0wsSUFBSSxFQUFFLElBQUk7eUJBQ1AsT0FBTyxDQUNOLHlCQUF5QixFQUN6QixtREFBbUQsQ0FDcEQ7eUJBQ0EsVUFBVSxDQUFDLFNBQVMsRUFBRSxhQUFhLENBQUM7eUJBQ3BDLFVBQVUsQ0FBQyxTQUFTLEVBQUUsYUFBYSxDQUFDO3lCQUNwQyxVQUFVLENBQUMsVUFBVSxFQUFFLGNBQWMsQ0FBQztpQkFDMUMsQ0FBQztZQUNKLENBQUM7WUFFRCw2Q0FBNkM7WUFDN0MsSUFBSSxFQUFFLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxzQkFBc0IsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDdkQsT0FBTztvQkFDTCxJQUFJLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxVQUFVLEVBQUUsS0FBSyxDQUFDO2lCQUN0QyxDQUFDO1lBQ0osQ0FBQztZQUVELE9BQU87UUFDVCxDQUFDO0tBQ0YsQ0FBQztBQUNKLENBQUMifQ==
+//#endregion
+export { ssrBuildPlugin };
+
+//# sourceMappingURL=ssr-build-plugin.js.map

package/src/lib/ssr/ssr-build-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-build-plugin.js","names":[],"sources":["../../../../src/lib/ssr/ssr-build-plugin.ts"],"sourcesContent":["import * as vite from 'vite';\n\n/**\n * SSR build patches for Angular platform-server, Zone.js, and Domino.\n *\n * **Why each patch exists:**\n * - zone-node: removes a `const global = globalThis` alias that shadows the\n *   real global in strict mode.\n * - platform-server: rewrites `xhr2.XMLHttpRequest` for CJS/ESM compat and\n *   replaces bare `global` references with `globalThis`.\n * - xhr2: strips Node-specific `os`/`process` references for SSR bundling.\n * - domino/sloppy.js: replaces `with()` statements that are illegal in ESM.\n */\nexport function ssrBuildPlugin(): vite.Plugin[] {\n  const plugins: vite.Plugin[] = [\n    {\n      name: 'analogjs-ssr-build-plugin',\n      apply: 'build',\n      config() {\n        return {\n          ssr: {\n            noExternal: ['xhr2'],\n          },\n        };\n      },\n      transform: {\n        filter: {\n          id: /zone-node|platform-server|xhr2\\.js|domino\\/lib\\/sloppy\\.js/,\n        },\n        handler(code, id) {\n          if (\n            id.includes('zone-node') &&\n            code.includes('const global = globalThis;')\n          ) {\n            return {\n              code: code.replace('const global = globalThis;', ''),\n            };\n          }\n\n          if (id.includes('platform-server')) {\n            let result = code.replace(\n              'new xhr2.XMLHttpRequest',\n              'new (xhr2.default.XMLHttpRequest || xhr2.default)',\n            );\n\n            // Narrowly scoped text replacement of the bare `global`\n            // identifier. Matching `global.`, `global,` and ` global[`\n            // targets the known occurrences in the @angular/platform-server\n            // bundle while leaving strings, comments and asset paths that\n            // merely contain the word `global` untouched (see #2426).\n            result = result\n              .replaceAll('global.', 'globalThis.')\n              .replaceAll('global,', 'globalThis,')\n              .replaceAll(' global[', ' globalThis[');\n\n            return { code: result };\n          }\n\n          if (id.includes(vite.normalizePath('xhr2.js'))) {\n            return {\n              code: code\n                .replace('os.type()', `''`)\n                .replace('os.arch()', `''`)\n                .replace('process.versions.node', `'node'`)\n                .replace('process.versions.v8', `'v8'`),\n            };\n          }\n\n          if (id.includes(vite.normalizePath('domino/lib/sloppy.js'))) {\n            return {\n              code: code.replace(/with\\(/gi, 'if('),\n            };\n          }\n\n          return;\n        },\n      },\n    },\n  ];\n\n  return plugins;\n}\n\n/**\n * Vite plugin that patches `@angular/core`'s `getComponentId()` to\n * mirror every compiled component definition to a global Set, bypassing\n * the `ngServerMode` guard that normally prevents registration on the\n * server. The set lives at `globalThis.__ngComponentDefs` and is read by\n * `@analogjs/router`'s SSR render function to null cached `tView`\n * objects between requests so that `$localize` tagged templates in\n * `consts()` re-evaluate with the freshly loaded translations.\n *\n * Only active when the platform's `i18n` option is configured.\n * Only transforms `@angular/core` modules in SSR builds.\n */\nexport function i18nDefRegistryPlugin(): Plugin {\n  const DETECT_MARKER = 'GENERATED_COMP_IDS.set(compId, componentDef.type);';\n  const RETURN_STMT = 'return compId;\\n}';\n\n  return {\n    name: 'analogjs-i18n-def-registry',\n    enforce: 'post',\n\n    transform: {\n      filter: {\n        id: /\\/@angular\\/core\\//,\n      },\n      handler(code, id, options) {\n        if (!options?.ssr) return;\n        if (!code.includes(DETECT_MARKER)) return;\n\n        return {\n          code: code.replace(\n            RETURN_STMT,\n            '(globalThis.__ngComponentDefs ??= new Set()).add(componentDef);\\n' +\n              RETURN_STMT,\n          ),\n        };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,iBAAgC;AAmE9C,QAlE+B,CAC7B;EACE,MAAM;EACN,OAAO;EACP,SAAS;AACP,UAAO,EACL,KAAK,EACH,YAAY,CAAC,OAAO,EACrB,EACF;;EAEH,WAAW;GACT,QAAQ,EACN,IAAI,8DACL;GACD,QAAQ,MAAM,IAAI;AAChB,QACE,GAAG,SAAS,YAAY,IACxB,KAAK,SAAS,6BAA6B,CAE3C,QAAO,EACL,MAAM,KAAK,QAAQ,8BAA8B,GAAG,EACrD;AAGH,QAAI,GAAG,SAAS,kBAAkB,EAAE;KAClC,IAAI,SAAS,KAAK,QAChB,2BACA,oDACD;AAOD,cAAS,OACN,WAAW,WAAW,cAAc,CACpC,WAAW,WAAW,cAAc,CACpC,WAAW,YAAY,eAAe;AAEzC,YAAO,EAAE,MAAM,QAAQ;;AAGzB,QAAI,GAAG,SAAS,KAAK,cAAc,UAAU,CAAC,CAC5C,QAAO,EACL,MAAM,KACH,QAAQ,aAAa,KAAK,CAC1B,QAAQ,aAAa,KAAK,CAC1B,QAAQ,yBAAyB,SAAS,CAC1C,QAAQ,uBAAuB,OAAO,EAC1C;AAGH,QAAI,GAAG,SAAS,KAAK,cAAc,uBAAuB,CAAC,CACzD,QAAO,EACL,MAAM,KAAK,QAAQ,YAAY,MAAM,EACtC;;GAKN;EACF,CACF"}

package/src/lib/style-pipeline.d.ts

@@ -0,0 +1,33 @@
+import type { Plugin } from "vite";
+import type { StylesheetDependency, StylesheetDiagnostic, StylesheetTransformContext, StylesheetTransformResult } from "./style-preprocessor.js";
+export interface StylePipelineStylesheetRegistry {
+	getPublicIdsForSource(sourcePath: string): string[];
+	getRequestIdsForSource(sourcePath: string): string[];
+	getDependenciesForSource(sourcePath: string): StylesheetDependency[];
+	getDiagnosticsForSource(sourcePath: string): StylesheetDiagnostic[];
+	getTagsForSource(sourcePath: string): string[];
+}
+export interface AngularStylePipelineContext {
+	workspaceRoot: string;
+}
+export interface AngularStylePipelinePlugin {
+	name: string;
+	preprocessStylesheet?: (code: string, context: StylesheetTransformContext) => string | StylesheetTransformResult | undefined;
+	configureStylesheetRegistry?: (registry: StylePipelineStylesheetRegistry, context: AngularStylePipelineContext) => void;
+}
+export interface AngularStylePipelineOptions {
+	plugins: AngularStylePipelinePlugin[];
+}
+export declare function defineAngularStylePipeline<const T extends AngularStylePipelineOptions>(options: T): T;
+export declare function defineAngularStylePipelinePlugins<const T extends AngularStylePipelinePlugin[]>(plugins: T): T;
+export interface StylePipelineContext {
+	workspaceRoot: string;
+}
+export type StylePipelinePluginFactory = (context: StylePipelineContext) => Plugin | Plugin[] | false | null | undefined;
+export type StylePipelinePluginEntry = Plugin | Plugin[] | StylePipelinePluginFactory | false | null | undefined;
+export interface StylePipelineOptions {
+	plugins?: StylePipelinePluginEntry[];
+}
+export declare function defineStylePipeline<const T extends StylePipelineOptions>(options: T): T;
+export declare function defineStylePipelinePlugins<const T extends StylePipelinePluginEntry[]>(plugins: T): T;
+export declare function resolveStylePipelinePlugins(options: StylePipelineOptions | false | undefined, workspaceRoot?: string): Plugin[];

package/src/lib/style-pipeline.js

@@ -0,0 +1,32 @@
+//#region packages/platform/src/lib/style-pipeline.ts
+function defineAngularStylePipeline(options) {
+	return options;
+}
+function defineAngularStylePipelinePlugins(plugins) {
+	return plugins;
+}
+function defineStylePipeline(options) {
+	return options;
+}
+function defineStylePipelinePlugins(plugins) {
+	return plugins;
+}
+function resolveStylePipelinePlugins(options, workspaceRoot) {
+	if (!options?.plugins?.length) return [];
+	const context = { workspaceRoot: workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd() };
+	const resolved = [];
+	for (const entry of options.plugins) {
+		const plugins = typeof entry === "function" ? entry(context) : entry;
+		if (!plugins) continue;
+		if (Array.isArray(plugins)) {
+			resolved.push(...plugins);
+			continue;
+		}
+		resolved.push(plugins);
+	}
+	return resolved;
+}
+//#endregion
+export { defineAngularStylePipeline, defineAngularStylePipelinePlugins, defineStylePipeline, defineStylePipelinePlugins, resolveStylePipelinePlugins };
+
+//# sourceMappingURL=style-pipeline.js.map

package/src/lib/style-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-pipeline.js","names":[],"sources":["../../../src/lib/style-pipeline.ts"],"sourcesContent":["import type { Plugin } from 'vite';\nimport type {\n  StylesheetDependency,\n  StylesheetDiagnostic,\n  StylesheetTransformContext,\n  StylesheetTransformResult,\n} from './style-preprocessor.js';\n\nexport interface StylePipelineStylesheetRegistry {\n  getPublicIdsForSource(sourcePath: string): string[];\n  getRequestIdsForSource(sourcePath: string): string[];\n  getDependenciesForSource(sourcePath: string): StylesheetDependency[];\n  getDiagnosticsForSource(sourcePath: string): StylesheetDiagnostic[];\n  getTagsForSource(sourcePath: string): string[];\n}\n\nexport interface AngularStylePipelineContext {\n  workspaceRoot: string;\n}\n\nexport interface AngularStylePipelinePlugin {\n  name: string;\n  preprocessStylesheet?: (\n    code: string,\n    context: StylesheetTransformContext,\n  ) => string | StylesheetTransformResult | undefined;\n  configureStylesheetRegistry?: (\n    registry: StylePipelineStylesheetRegistry,\n    context: AngularStylePipelineContext,\n  ) => void;\n}\n\nexport interface AngularStylePipelineOptions {\n  plugins: AngularStylePipelinePlugin[];\n}\n\nexport function defineAngularStylePipeline<\n  const T extends AngularStylePipelineOptions,\n>(options: T): T {\n  return options;\n}\n\nexport function defineAngularStylePipelinePlugins<\n  const T extends AngularStylePipelinePlugin[],\n>(plugins: T): T {\n  return plugins;\n}\n\nexport interface StylePipelineContext {\n  workspaceRoot: string;\n}\n\nexport type StylePipelinePluginFactory = (\n  context: StylePipelineContext,\n) => Plugin | Plugin[] | false | null | undefined;\n\nexport type StylePipelinePluginEntry =\n  | Plugin\n  | Plugin[]\n  | StylePipelinePluginFactory\n  | false\n  | null\n  | undefined;\n\nexport interface StylePipelineOptions {\n  plugins?: StylePipelinePluginEntry[];\n}\n\nexport function defineStylePipeline<const T extends StylePipelineOptions>(\n  options: T,\n): T {\n  return options;\n}\n\nexport function defineStylePipelinePlugins<\n  const T extends StylePipelinePluginEntry[],\n>(plugins: T): T {\n  return plugins;\n}\n\nexport function resolveStylePipelinePlugins(\n  options: StylePipelineOptions | false | undefined,\n  workspaceRoot?: string,\n): Plugin[] {\n  if (!options?.plugins?.length) {\n    return [];\n  }\n\n  const context: StylePipelineContext = {\n    workspaceRoot:\n      workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd(),\n  };\n\n  const resolved: Plugin[] = [];\n\n  for (const entry of options.plugins) {\n    const plugins = typeof entry === 'function' ? entry(context) : entry;\n\n    if (!plugins) {\n      continue;\n    }\n\n    if (Array.isArray(plugins)) {\n      resolved.push(...plugins);\n      continue;\n    }\n\n    resolved.push(plugins);\n  }\n\n  return resolved;\n}\n"],"mappings":";AAoCA,SAAgB,2BAEd,SAAe;AACf,QAAO;;AAGT,SAAgB,kCAEd,SAAe;AACf,QAAO;;AAuBT,SAAgB,oBACd,SACG;AACH,QAAO;;AAGT,SAAgB,2BAEd,SAAe;AACf,QAAO;;AAGT,SAAgB,4BACd,SACA,eACU;AACV,KAAI,CAAC,SAAS,SAAS,OACrB,QAAO,EAAE;CAGX,MAAM,UAAgC,EACpC,eACE,iBAAiB,QAAQ,IAAI,wBAAwB,QAAQ,KAAK,EACrE;CAED,MAAM,WAAqB,EAAE;AAE7B,MAAK,MAAM,SAAS,QAAQ,SAAS;EACnC,MAAM,UAAU,OAAO,UAAU,aAAa,MAAM,QAAQ,GAAG;AAE/D,MAAI,CAAC,QACH;AAGF,MAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,YAAS,KAAK,GAAG,QAAQ;AACzB;;AAGF,WAAS,KAAK,QAAQ;;AAGxB,QAAO"}

package/src/lib/style-preprocessor.d.ts

@@ -0,0 +1,28 @@
+export interface StylesheetTransformContext {
+	filename: string;
+	containingFile?: string;
+	resourceFile?: string;
+	className?: string;
+	order?: number;
+	inline: boolean;
+}
+export interface StylesheetDependency {
+	id: string;
+	kind?: "file" | "virtual" | "token" | "bridge" | "manifest" | "runtime";
+	owner?: string;
+}
+export interface StylesheetDiagnostic {
+	severity: "warning" | "error";
+	code: string;
+	message: string;
+}
+export interface StylesheetTransformResult {
+	code: string;
+	dependencies?: Array<string | StylesheetDependency>;
+	diagnostics?: StylesheetDiagnostic[];
+	tags?: string[];
+}
+export type StylePreprocessor = (code: string, filename: string, context?: StylesheetTransformContext) => string | StylesheetTransformResult;
+export declare function normalizeStylesheetTransformResult(value: string | StylesheetTransformResult | undefined, fallbackCode: string): StylesheetTransformResult;
+export declare function normalizeStylesheetDependencies(dependencies: Array<string | StylesheetDependency> | undefined): StylesheetDependency[];
+export declare function composeStylePreprocessors(preprocessors: Array<StylePreprocessor | false | null | undefined>): StylePreprocessor | undefined;

package/src/lib/style-preprocessor.js

@@ -0,0 +1,35 @@
+//#region packages/platform/src/lib/style-preprocessor.ts
+function normalizeStylesheetTransformResult(value, fallbackCode) {
+	if (value == null) return { code: fallbackCode };
+	if (typeof value === "string") return { code: value };
+	return {
+		code: value.code ?? fallbackCode,
+		dependencies: normalizeStylesheetDependencies(value.dependencies),
+		diagnostics: value.diagnostics ?? [],
+		tags: value.tags ?? []
+	};
+}
+function normalizeStylesheetDependencies(dependencies) {
+	return (dependencies ?? []).map((dependency) => typeof dependency === "string" ? { id: dependency } : dependency);
+}
+function composeStylePreprocessors(preprocessors) {
+	const active = preprocessors.filter((preprocessor) => !!preprocessor);
+	if (!active.length) return;
+	return (code, filename, context) => {
+		let current = normalizeStylesheetTransformResult(void 0, code);
+		for (const preprocessor of active) {
+			const next = normalizeStylesheetTransformResult(preprocessor(current.code, filename, context), current.code);
+			current = {
+				code: next.code,
+				dependencies: [...current.dependencies ?? [], ...next.dependencies ?? []],
+				diagnostics: [...current.diagnostics ?? [], ...next.diagnostics ?? []],
+				tags: [...current.tags ?? [], ...next.tags ?? []]
+			};
+		}
+		return current;
+	};
+}
+//#endregion
+export { composeStylePreprocessors, normalizeStylesheetDependencies, normalizeStylesheetTransformResult };
+
+//# sourceMappingURL=style-preprocessor.js.map

package/src/lib/style-preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-preprocessor.js","names":[],"sources":["../../../src/lib/style-preprocessor.ts"],"sourcesContent":["export interface StylesheetTransformContext {\n  filename: string;\n  containingFile?: string;\n  resourceFile?: string;\n  className?: string;\n  order?: number;\n  inline: boolean;\n}\n\nexport interface StylesheetDependency {\n  id: string;\n  kind?: 'file' | 'virtual' | 'token' | 'bridge' | 'manifest' | 'runtime';\n  owner?: string;\n}\n\nexport interface StylesheetDiagnostic {\n  severity: 'warning' | 'error';\n  code: string;\n  message: string;\n}\n\nexport interface StylesheetTransformResult {\n  code: string;\n  dependencies?: Array<string | StylesheetDependency>;\n  diagnostics?: StylesheetDiagnostic[];\n  tags?: string[];\n}\n\nexport type StylePreprocessor = (\n  code: string,\n  filename: string,\n  context?: StylesheetTransformContext,\n) => string | StylesheetTransformResult;\n\nexport function normalizeStylesheetTransformResult(\n  value: string | StylesheetTransformResult | undefined,\n  fallbackCode: string,\n): StylesheetTransformResult {\n  if (value == null) {\n    return { code: fallbackCode };\n  }\n\n  if (typeof value === 'string') {\n    return { code: value };\n  }\n\n  return {\n    code: value.code ?? fallbackCode,\n    dependencies: normalizeStylesheetDependencies(value.dependencies),\n    diagnostics: value.diagnostics ?? [],\n    tags: value.tags ?? [],\n  };\n}\n\nexport function normalizeStylesheetDependencies(\n  dependencies: Array<string | StylesheetDependency> | undefined,\n): StylesheetDependency[] {\n  return (dependencies ?? []).map((dependency) =>\n    typeof dependency === 'string' ? { id: dependency } : dependency,\n  );\n}\n\nexport function composeStylePreprocessors(\n  preprocessors: Array<StylePreprocessor | false | null | undefined>,\n): StylePreprocessor | undefined {\n  const active = preprocessors.filter(\n    (preprocessor): preprocessor is StylePreprocessor => !!preprocessor,\n  );\n\n  if (!active.length) {\n    return undefined;\n  }\n\n  return (code, filename, context) => {\n    let current = normalizeStylesheetTransformResult(undefined, code);\n\n    for (const preprocessor of active) {\n      const next = normalizeStylesheetTransformResult(\n        preprocessor(current.code, filename, context),\n        current.code,\n      );\n      current = {\n        code: next.code,\n        dependencies: [\n          ...(current.dependencies ?? []),\n          ...(next.dependencies ?? []),\n        ],\n        diagnostics: [\n          ...(current.diagnostics ?? []),\n          ...(next.diagnostics ?? []),\n        ],\n        tags: [...(current.tags ?? []), ...(next.tags ?? [])],\n      };\n    }\n\n    return current;\n  };\n}\n"],"mappings":";AAkCA,SAAgB,mCACd,OACA,cAC2B;AAC3B,KAAI,SAAS,KACX,QAAO,EAAE,MAAM,cAAc;AAG/B,KAAI,OAAO,UAAU,SACnB,QAAO,EAAE,MAAM,OAAO;AAGxB,QAAO;EACL,MAAM,MAAM,QAAQ;EACpB,cAAc,gCAAgC,MAAM,aAAa;EACjE,aAAa,MAAM,eAAe,EAAE;EACpC,MAAM,MAAM,QAAQ,EAAE;EACvB;;AAGH,SAAgB,gCACd,cACwB;AACxB,SAAQ,gBAAgB,EAAE,EAAE,KAAK,eAC/B,OAAO,eAAe,WAAW,EAAE,IAAI,YAAY,GAAG,WACvD;;AAGH,SAAgB,0BACd,eAC+B;CAC/B,MAAM,SAAS,cAAc,QAC1B,iBAAoD,CAAC,CAAC,aACxD;AAED,KAAI,CAAC,OAAO,OACV;AAGF,SAAQ,MAAM,UAAU,YAAY;EAClC,IAAI,UAAU,mCAAmC,KAAA,GAAW,KAAK;AAEjE,OAAK,MAAM,gBAAgB,QAAQ;GACjC,MAAM,OAAO,mCACX,aAAa,QAAQ,MAAM,UAAU,QAAQ,EAC7C,QAAQ,KACT;AACD,aAAU;IACR,MAAM,KAAK;IACX,cAAc,CACZ,GAAI,QAAQ,gBAAgB,EAAE,EAC9B,GAAI,KAAK,gBAAgB,EAAE,CAC5B;IACD,aAAa,CACX,GAAI,QAAQ,eAAe,EAAE,EAC7B,GAAI,KAAK,eAAe,EAAE,CAC3B;IACD,MAAM,CAAC,GAAI,QAAQ,QAAQ,EAAE,EAAG,GAAI,KAAK,QAAQ,EAAE,CAAE;IACtD;;AAGH,SAAO"}

package/src/lib/tailwind-preprocessor.d.ts

@@ -0,0 +1,23 @@
+import type { StylePreprocessor } from "./style-preprocessor.js";
+export type TailwindPreprocessorMode = "auto" | "disabled" | {
+	prefix: string;
+};
+export interface TailwindPreprocessorOptions {
+	/** Absolute path to the Tailwind root CSS file that imports `tailwindcss`. */
+	tailwindRootCss: string;
+	/**
+	* Controls whether the preprocessor auto-detects, disables, or manually
+	* overrides the Tailwind prefix for a given file.
+	*/
+	mode?: TailwindPreprocessorMode | ((filename: string) => TailwindPreprocessorMode);
+	/**
+	* Optional predicate to override the default `@reference` injection behavior.
+	*/
+	shouldInject?: (code: string, filename: string, resolvedPrefix: string | null) => boolean;
+}
+/**
+* Creates a stylesheet preprocessor that injects Tailwind v4 `@reference`
+* directives into Angular component styles when needed. The Tailwind prefix is
+* detected from the configured root CSS file.
+*/
+export declare function tailwindPreprocessor(options: TailwindPreprocessorOptions): StylePreprocessor;