@analogjs/platform 3.0.0-alpha.8 → 3.0.0-alpha.80

package/src/lib/json-ld-manifest-plugin.js

@@ -0,0 +1,84 @@
+import { normalizeJsonLd } from "./route-manifest.js";
+import { dirname, relative } from "node:path";
+import { normalizePath } from "vite";
+import fm from "front-matter";
+//#region packages/platform/src/lib/json-ld-manifest-plugin.ts
+/**
+* Heuristic detector for JSON-LD exports in route modules.
+*
+* This is intentionally regex-based for speed during file scanning.
+* It reliably detects these direct export patterns:
+*
+* - `export const routeJsonLd = ...`
+* - `export const routeMeta = { ..., jsonLd: ... }`
+* - `export const routeJsonLd = (route) => ...` (function form)
+*
+* Known limitations (not detected):
+*
+* - re-exports: `export { routeJsonLd } from './data'`
+* - aliased exports: `export { something as routeJsonLd }`
+* - default exports: `export default { jsonLd: ... }`
+* - indirect assignment: `const data = { jsonLd: ... }; export const routeMeta = data`
+*
+* Known false-positive risks:
+*
+* - comment text containing `export const routeJsonLd`
+* - unrelated `jsonLd` text appearing after `export const routeMeta`
+*
+* Prefer the supported direct export patterns listed above.
+*/
+function detectJsonLdModuleExports(fileContent) {
+	return /export\s+const\s+routeJsonLd\b/.test(fileContent) || /export\s+const\s+routeMeta\b[\s\S]*?\bjsonLd\b/.test(fileContent);
+}
+function extractMarkdownJsonLd(rawContent) {
+	const { attributes } = fm(rawContent);
+	return normalizeJsonLd(attributes["jsonLd"]);
+}
+function generateJsonLdManifestSource(entries, outFile) {
+	const lines = [];
+	const moduleEntries = entries.filter((entry) => entry.kind === "module");
+	lines.push("// This file is auto-generated by @analogjs/platform");
+	lines.push("// Do not edit manually");
+	lines.push("");
+	lines.push("import type { Graph, Thing, WithContext } from 'schema-dts';");
+	moduleEntries.forEach((entry) => {
+		lines.push(`import * as ${entry.importAlias} from '${toImportPath(outFile, entry.sourceFile)}';`);
+	});
+	lines.push("");
+	lines.push("export type AnalogJsonLdDocument = WithContext<Thing> | Graph | Array<WithContext<Thing>>;");
+	lines.push("export type GeneratedJsonLdManifestEntry = { routePath: string; sourceFile: string; kind: 'module' | 'content'; resolveJsonLd: () => AnalogJsonLdDocument[]; };");
+	lines.push("");
+	lines.push("function normalizeJsonLd(value: unknown): AnalogJsonLdDocument[] {");
+	lines.push("  if (Array.isArray(value)) {");
+	lines.push("    return value.filter((entry): entry is AnalogJsonLdDocument => typeof entry === 'object' && entry !== null && !Array.isArray(entry));");
+	lines.push("  }");
+	lines.push("");
+	lines.push("  return typeof value === 'object' && value !== null ? [value as AnalogJsonLdDocument] : [];");
+	lines.push("}");
+	lines.push("");
+	lines.push("function resolveModuleJsonLd(routeModule: unknown): AnalogJsonLdDocument[] {");
+	lines.push("  const typedRouteModule = routeModule as { routeJsonLd?: unknown; routeMeta?: { jsonLd?: unknown } };");
+	lines.push("  return normalizeJsonLd(typedRouteModule.routeMeta?.jsonLd ?? typedRouteModule.routeJsonLd);");
+	lines.push("}");
+	lines.push("");
+	lines.push("export const routeJsonLdManifest = new Map<string, GeneratedJsonLdManifestEntry>([");
+	entries.forEach((entry) => {
+		if (entry.kind === "module") {
+			lines.push(`  ['${entry.routePath}', { routePath: '${entry.routePath}', sourceFile: '${entry.sourceFile}', kind: 'module', resolveJsonLd: () => resolveModuleJsonLd(${entry.importAlias}) }],`);
+			return;
+		}
+		lines.push(`  ['${entry.routePath}', { routePath: '${entry.routePath}', sourceFile: '${entry.sourceFile}', kind: 'content', resolveJsonLd: () => ${JSON.stringify(entry.jsonLd)} }],`);
+	});
+	lines.push("]);");
+	lines.push("");
+	return lines.join("\n");
+}
+function toImportPath(outFile, sourceFile) {
+	const relativePath = normalizePath(relative(dirname(outFile), sourceFile.replace(/^\//, "").replace(/\.(ts|js|analog|ag)$/, "")));
+	if (relativePath.startsWith(".")) return relativePath;
+	return `./${relativePath}`;
+}
+//#endregion
+export { detectJsonLdModuleExports, extractMarkdownJsonLd, generateJsonLdManifestSource };
+
+//# sourceMappingURL=json-ld-manifest-plugin.js.map

package/src/lib/json-ld-manifest-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld-manifest-plugin.js","names":[],"sources":["../../../src/lib/json-ld-manifest-plugin.ts"],"sourcesContent":["import fm from 'front-matter';\nimport { normalizePath } from 'vite';\nimport { dirname, relative } from 'node:path';\n\nimport { normalizeJsonLd, type JsonLdObject } from './route-manifest.js';\n\nexport type JsonLdModuleManifestEntry = {\n  kind: 'module';\n  routePath: string;\n  sourceFile: string;\n  importAlias: string;\n};\n\nexport type JsonLdContentManifestEntry = {\n  kind: 'content';\n  routePath: string;\n  sourceFile: string;\n  jsonLd: JsonLdObject[];\n};\n\nexport type JsonLdManifestEntry =\n  | JsonLdModuleManifestEntry\n  | JsonLdContentManifestEntry;\n\n/**\n * Heuristic detector for JSON-LD exports in route modules.\n *\n * This is intentionally regex-based for speed during file scanning.\n * It reliably detects these direct export patterns:\n *\n * - `export const routeJsonLd = ...`\n * - `export const routeMeta = { ..., jsonLd: ... }`\n * - `export const routeJsonLd = (route) => ...` (function form)\n *\n * Known limitations (not detected):\n *\n * - re-exports: `export { routeJsonLd } from './data'`\n * - aliased exports: `export { something as routeJsonLd }`\n * - default exports: `export default { jsonLd: ... }`\n * - indirect assignment: `const data = { jsonLd: ... }; export const routeMeta = data`\n *\n * Known false-positive risks:\n *\n * - comment text containing `export const routeJsonLd`\n * - unrelated `jsonLd` text appearing after `export const routeMeta`\n *\n * Prefer the supported direct export patterns listed above.\n */\nexport function detectJsonLdModuleExports(fileContent: string): boolean {\n  return (\n    /export\\s+const\\s+routeJsonLd\\b/.test(fileContent) ||\n    /export\\s+const\\s+routeMeta\\b[\\s\\S]*?\\bjsonLd\\b/.test(fileContent)\n  );\n}\n\nexport function extractMarkdownJsonLd(rawContent: string): JsonLdObject[] {\n  const { attributes } = fm<Record<string, unknown>>(rawContent);\n  return normalizeJsonLd(attributes['jsonLd']);\n}\n\nexport function generateJsonLdManifestSource(\n  entries: JsonLdManifestEntry[],\n  outFile: string,\n): string {\n  const lines: string[] = [];\n  const moduleEntries = entries.filter(\n    (entry): entry is JsonLdModuleManifestEntry => entry.kind === 'module',\n  );\n\n  lines.push('// This file is auto-generated by @analogjs/platform');\n  lines.push('// Do not edit manually');\n  lines.push('');\n\n  lines.push(\"import type { Graph, Thing, WithContext } from 'schema-dts';\");\n\n  moduleEntries.forEach((entry) => {\n    lines.push(\n      `import * as ${entry.importAlias} from '${toImportPath(outFile, entry.sourceFile)}';`,\n    );\n  });\n\n  lines.push('');\n  lines.push(\n    'export type AnalogJsonLdDocument = WithContext<Thing> | Graph | Array<WithContext<Thing>>;',\n  );\n  lines.push(\n    \"export type GeneratedJsonLdManifestEntry = { routePath: string; sourceFile: string; kind: 'module' | 'content'; resolveJsonLd: () => AnalogJsonLdDocument[]; };\",\n  );\n  lines.push('');\n  lines.push(\n    'function normalizeJsonLd(value: unknown): AnalogJsonLdDocument[] {',\n  );\n  lines.push('  if (Array.isArray(value)) {');\n  lines.push(\n    \"    return value.filter((entry): entry is AnalogJsonLdDocument => typeof entry === 'object' && entry !== null && !Array.isArray(entry));\",\n  );\n  lines.push('  }');\n  lines.push('');\n  lines.push(\n    \"  return typeof value === 'object' && value !== null ? [value as AnalogJsonLdDocument] : [];\",\n  );\n  lines.push('}');\n  lines.push('');\n  lines.push(\n    'function resolveModuleJsonLd(routeModule: unknown): AnalogJsonLdDocument[] {',\n  );\n  lines.push(\n    '  const typedRouteModule = routeModule as { routeJsonLd?: unknown; routeMeta?: { jsonLd?: unknown } };',\n  );\n  lines.push(\n    // Match runtime precedence (mergeRouteJsonLdIntoRouteMeta in routes.ts):\n    // routeMeta.jsonLd wins over standalone routeJsonLd.\n    '  return normalizeJsonLd(typedRouteModule.routeMeta?.jsonLd ?? typedRouteModule.routeJsonLd);',\n  );\n  lines.push('}');\n  lines.push('');\n  lines.push(\n    'export const routeJsonLdManifest = new Map<string, GeneratedJsonLdManifestEntry>([',\n  );\n\n  entries.forEach((entry) => {\n    if (entry.kind === 'module') {\n      lines.push(\n        `  ['${entry.routePath}', { routePath: '${entry.routePath}', sourceFile: '${entry.sourceFile}', kind: 'module', resolveJsonLd: () => resolveModuleJsonLd(${entry.importAlias}) }],`,\n      );\n      return;\n    }\n\n    lines.push(\n      `  ['${entry.routePath}', { routePath: '${entry.routePath}', sourceFile: '${entry.sourceFile}', kind: 'content', resolveJsonLd: () => ${JSON.stringify(entry.jsonLd)} }],`,\n    );\n  });\n\n  lines.push(']);');\n  lines.push('');\n\n  return lines.join('\\n');\n}\n\nfunction toImportPath(outFile: string, sourceFile: string): string {\n  // JSON-LD entries are emitted inside the same generated route module, so\n  // imports are always resolved relative to that single output file.\n  const fromDir = dirname(outFile);\n  const sourceNoExt = sourceFile\n    .replace(/^\\//, '')\n    .replace(/\\.(ts|js|analog|ag)$/, '');\n  const relativePath = normalizePath(relative(fromDir, sourceNoExt));\n\n  if (relativePath.startsWith('.')) {\n    return relativePath;\n  }\n\n  return `./${relativePath}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,0BAA0B,aAA8B;AACtE,QACE,iCAAiC,KAAK,YAAY,IAClD,iDAAiD,KAAK,YAAY;;AAItE,SAAgB,sBAAsB,YAAoC;CACxE,MAAM,EAAE,eAAe,GAA4B,WAAW;AAC9D,QAAO,gBAAgB,WAAW,UAAU;;AAG9C,SAAgB,6BACd,SACA,SACQ;CACR,MAAM,QAAkB,EAAE;CAC1B,MAAM,gBAAgB,QAAQ,QAC3B,UAA8C,MAAM,SAAS,SAC/D;AAED,OAAM,KAAK,uDAAuD;AAClE,OAAM,KAAK,0BAA0B;AACrC,OAAM,KAAK,GAAG;AAEd,OAAM,KAAK,+DAA+D;AAE1E,eAAc,SAAS,UAAU;AAC/B,QAAM,KACJ,eAAe,MAAM,YAAY,SAAS,aAAa,SAAS,MAAM,WAAW,CAAC,IACnF;GACD;AAEF,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,6FACD;AACD,OAAM,KACJ,kKACD;AACD,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,qEACD;AACD,OAAM,KAAK,gCAAgC;AAC3C,OAAM,KACJ,2IACD;AACD,OAAM,KAAK,MAAM;AACjB,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,+FACD;AACD,OAAM,KAAK,IAAI;AACf,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,+EACD;AACD,OAAM,KACJ,yGACD;AACD,OAAM,KAGJ,gGACD;AACD,OAAM,KAAK,IAAI;AACf,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,qFACD;AAED,SAAQ,SAAS,UAAU;AACzB,MAAI,MAAM,SAAS,UAAU;AAC3B,SAAM,KACJ,OAAO,MAAM,UAAU,mBAAmB,MAAM,UAAU,kBAAkB,MAAM,WAAW,8DAA8D,MAAM,YAAY,OAC9K;AACD;;AAGF,QAAM,KACJ,OAAO,MAAM,UAAU,mBAAmB,MAAM,UAAU,kBAAkB,MAAM,WAAW,2CAA2C,KAAK,UAAU,MAAM,OAAO,CAAC,MACtK;GACD;AAEF,OAAM,KAAK,MAAM;AACjB,OAAM,KAAK,GAAG;AAEd,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,aAAa,SAAiB,YAA4B;CAOjE,MAAM,eAAe,cAAc,SAJnB,QAAQ,QAAQ,EACZ,WACjB,QAAQ,OAAO,GAAG,CAClB,QAAQ,wBAAwB,GAAG,CAC2B,CAAC;AAElE,KAAI,aAAa,WAAW,IAAI,CAC9B,QAAO;AAGT,QAAO,KAAK"}

package/src/lib/library-pages-plugin.d.ts

@@ -0,0 +1,8 @@
+import type { AnalogIntegrationPlugin } from "@analogjs/vite-plugin-angular";
+import type { Options } from "./options.js";
+/**
+* Registers `additionalPagesDirs` with Angular compilation through
+* `analog.setup()`, so workspace library pages compile without a matching
+* `include` on `angular()`.
+*/
+export declare function libraryPagesPlugin(options?: Options): AnalogIntegrationPlugin[];

package/src/lib/library-pages-plugin.js

@@ -0,0 +1,21 @@
+import { pageGlobs } from "./discover-library-routes.js";
+//#region packages/platform/src/lib/library-pages-plugin.ts
+/**
+* Registers `additionalPagesDirs` with Angular compilation through
+* `analog.setup()`, so workspace library pages compile without a matching
+* `include` on `angular()`.
+*/
+function libraryPagesPlugin(options) {
+	const dirs = options?.additionalPagesDirs ?? [];
+	if (!dirs.length) return [];
+	return [{
+		name: "analogjs-platform-library-pages",
+		analog: { setup(ctx) {
+			ctx.addInclude(pageGlobs(dirs));
+		} }
+	}];
+}
+//#endregion
+export { libraryPagesPlugin };
+
+//# sourceMappingURL=library-pages-plugin.js.map

package/src/lib/library-pages-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-pages-plugin.js","names":[],"sources":["../../../src/lib/library-pages-plugin.ts"],"sourcesContent":["import type { AnalogIntegrationPlugin } from '@analogjs/vite-plugin-angular';\n\nimport { pageGlobs } from './discover-library-routes.js';\nimport type { Options } from './options.js';\n\n/**\n * Registers `additionalPagesDirs` with Angular compilation through\n * `analog.setup()`, so workspace library pages compile without a matching\n * `include` on `angular()`.\n */\nexport function libraryPagesPlugin(\n  options?: Options,\n): AnalogIntegrationPlugin[] {\n  const dirs = options?.additionalPagesDirs ?? [];\n  if (!dirs.length) {\n    return [];\n  }\n\n  return [\n    {\n      name: 'analogjs-platform-library-pages',\n      analog: {\n        setup(ctx) {\n          ctx.addInclude(pageGlobs(dirs));\n        },\n      },\n    },\n  ];\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,mBACd,SAC2B;CAC3B,MAAM,OAAO,SAAS,uBAAuB,EAAE;AAC/C,KAAI,CAAC,KAAK,OACR,QAAO,EAAE;AAGX,QAAO,CACL;EACE,MAAM;EACN,QAAQ,EACN,MAAM,KAAK;AACT,OAAI,WAAW,UAAU,KAAK,CAAC;KAElC;EACF,CACF"}

package/src/lib/nitro/analog-nitro-plugin.d.ts

@@ -0,0 +1,18 @@
+import type { Nitro } from "nitro/types";
+import type { Plugin } from "vite";
+import type { Options } from "../options.js";
+/**
+* Analog's NitroModule. Plug it into the Vite plugin chain alongside
+* `nitro()` from `nitro/vite`; nitro/vite picks up the `.nitro` property
+* and runs `setup(nitro)` once the Nitro instance is ready.
+*/
+export declare function analogNitroPlugin(options?: Options): Plugin;
+/**
+* Walks Nitro's resolved routeRules and stamps `x-analog-no-ssr: true` onto
+* any rule with `ssr: false`, and `x-analog-no-streaming: true` onto any rule
+* with `streaming: false`. Kept as response-header hints for downstream
+* consumers (CDN, edge logic); the actual SSR short-circuit happens inside
+* the SSR renderer virtual above, and the router falls back to a buffered
+* render when it sees the streaming hint.
+*/
+export declare function injectAnalogRouteRuleHeaders(nitro: Nitro): void;