@demiurgejs/core 0.1.1 → 0.2.0-beta.2

package/dist/cli.d.ts

@@ -0,0 +1,42 @@
+import type { InlineConfig } from "vite";
+import { type GenerateStaticOutputOptions, type StaticOutputManifest } from "./static";
+type CliEnvironment = Record<string, string | undefined>;
+export type CliOptions = {
+    command: "build" | "help" | "preview";
+    host: string;
+    origin?: string;
+    outDir: string;
+    port: number;
+};
+type StaticBuildRuntime = {
+    build: (config: InlineConfig) => Promise<unknown>;
+    generate: (options: GenerateStaticOutputOptions) => Promise<StaticOutputManifest>;
+    importModule: (specifier: string) => Promise<Record<string, unknown>>;
+    now: () => number;
+    readText: (file: string) => Promise<string>;
+    resolveConfig: () => Promise<{
+        plugins?: Array<{
+            api?: unknown;
+            name: string;
+        }>;
+        publicDir: false | string;
+        root: string;
+    }>;
+};
+export declare function parseCliArguments(arguments_: string[], environment?: CliEnvironment): CliOptions;
+export declare const helpText = "Usage: demiurge <command> [options]\n\nCommands:\n  build                 Build static production output\n  preview               Serve static output with its declared headers\n\nOptions:\n  --host <host>         Set the preview host (default: localhost)\n  --origin <origin>     Set the build origin (default: SITE_ORIGIN)\n  --out-dir <directory> Set the output directory (default: dist)\n  --port <port>         Set the preview port (default: 4173)\n  -h, --help            Show this help";
+export declare function buildStaticSite(options: CliOptions, runtime?: StaticBuildRuntime): Promise<{
+    deploymentOutDir: string | undefined;
+    manifest: StaticOutputManifest;
+    outDir: string;
+}>;
+export declare function resolvePreviewOutputDirectory(outDir: string, resolveConfig?: () => Promise<{
+    root: string;
+}>): Promise<string>;
+export declare function validateBuildOutputDirectory(root: string, outDir: string, publicDir: false | string, serverOutDir: string): Promise<void>;
+export declare function parseClientManifest(source: string): {
+    clientEntry: string;
+    styles: string[];
+};
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAGzC,OAAO,EAGL,KAAK,2BAA2B,EAEhC,KAAK,oBAAoB,EAE1B,MAAM,UAAU,CAAC;AAElB,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAIzD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,QAAQ,EAAE,CACR,OAAO,EAAE,2BAA2B,KACjC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,GAAG,CAAC,EAAE,OAAO,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;SACd,CAAC,CAAC;QACH,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,GAAE,cAAmB,GAC/B,UAAU,CA8CZ;AAED,eAAO,MAAM,QAAQ,gfAWkB,CAAC;AAExC,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,kBAAkB;;;;GA2E7B;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,mBAMhD;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,KAAK,GAAG,MAAM,EACzB,YAAY,EAAE,MAAM,iBAqCrB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM;;;EAmBjD"}

package/dist/cli.js

@@ -0,0 +1,173 @@
+import { readFile as b, readdir as E } from "node:fs/promises";
+import { resolve as c, relative as d, sep as g, isAbsolute as v } from "node:path";
+import { pathToFileURL as O } from "node:url";
+import { generateStaticOutput as S, generateVercelStaticOutput as D } from "./static/index.js";
+const T = /* @__PURE__ */ new Set(["--host", "--origin", "--out-dir", "--port"]);
+function B(t, e = {}) {
+  const r = t[0];
+  if (!r || r === "--help" || r === "-h" || r === "help")
+    return {
+      command: "help",
+      host: "localhost",
+      outDir: "dist",
+      port: 4173
+    };
+  if (r !== "build" && r !== "preview")
+    throw new Error(`Unknown command: ${r}`);
+  const i = {
+    command: r,
+    host: "localhost",
+    origin: e.SITE_ORIGIN,
+    outDir: "dist",
+    port: 4173
+  };
+  for (let n = 1; n < t.length; n += 1) {
+    const o = t[n], [s, l] = o.split("=", 2);
+    if (!T.has(s))
+      throw new Error(`Unknown option: ${o}`);
+    const u = l ?? t[++n];
+    if (!u || u.startsWith("--"))
+      throw new Error(`Option ${s} requires a value.`);
+    if (s === "--host" && (i.host = u), s === "--origin" && (i.origin = u), s === "--out-dir" && (i.outDir = u), s === "--port") {
+      const a = Number(u);
+      if (!Number.isSafeInteger(a) || a < 0 || a > 65535)
+        throw new Error("Preview port must be an integer from 0 through 65535.");
+      i.port = a;
+    }
+  }
+  return i;
+}
+const H = `Usage: demiurge <command> [options]
+
+Commands:
+  build                 Build static production output
+  preview               Serve static output with its declared headers
+
+Options:
+  --host <host>         Set the preview host (default: localhost)
+  --origin <origin>     Set the build origin (default: SITE_ORIGIN)
+  --out-dir <directory> Set the output directory (default: dist)
+  --port <port>         Set the preview port (default: 4173)
+  -h, --help            Show this help`;
+async function W(t, e) {
+  const r = e ? void 0 : await import("vite"), i = e ? await e.resolveConfig() : await r.resolveConfig({}, "build", "production"), n = i.root, o = c(n, t.outDir), s = c(n, ".demiurge/server"), l = e?.build ?? r.build;
+  await j(
+    n,
+    o,
+    i.publicDir,
+    s
+  ), await l({
+    build: {
+      emptyOutDir: !0,
+      outDir: o,
+      rollupOptions: { input: "virtual:demiurge/client-entry" }
+    }
+  }), await l({
+    build: {
+      copyPublicDir: !1,
+      emptyOutDir: !0,
+      outDir: s,
+      rollupOptions: {
+        input: "virtual:demiurge/server-entry",
+        output: { entryFileNames: "server-entry.js" }
+      },
+      ssr: !0
+    }
+  });
+  const u = N(
+    e ? await e.readText(c(o, "demiurge-manifest.json")) : await b(c(o, "demiurge-manifest.json"), "utf8")
+  ), a = `${O(c(s, "server-entry.js")).href}?build=${e?.now() ?? Date.now()}`, f = e ? await e.importModule(a) : await import(a);
+  if (!I(f.routes))
+    throw new Error("The framework server bundle does not export routes.");
+  const h = await (e?.generate ?? S)({
+    fonts: A(i.plugins),
+    images: F(i.plugins),
+    origin: t.origin,
+    outDir: o,
+    root: n,
+    routes: f.routes,
+    ssr: u,
+    staticFileHeaders: R(i.plugins)
+  }), m = P(i.plugins);
+  return { deploymentOutDir: m ? await D({
+    deployment: m,
+    manifest: h,
+    outDir: o,
+    projectRoot: process.cwd()
+  }) : void 0, manifest: h, outDir: o };
+}
+async function G(t, e) {
+  const r = e ? await e() : await (await import("vite")).resolveConfig({}, "serve", "production");
+  return c(r.root, t);
+}
+async function j(t, e, r, i) {
+  const n = d(t, e);
+  if (!n || n === ".." || n.startsWith(`..${g}`) || v(n))
+    throw new Error("The static output directory must be inside the Vite root.");
+  if (r && w(e, r))
+    throw new Error("The static output directory must not overlap the Vite public directory.");
+  if (w(e, i))
+    throw new Error("The static output directory must not overlap the framework server directory.");
+  let o;
+  try {
+    o = await E(e);
+  } catch (s) {
+    if ($(s)) return;
+    throw s;
+  }
+  if (o.length && !o.includes("demiurge-manifest.json") && !o.includes("demiurge-static-manifest.json"))
+    throw new Error(
+      "The static output directory contains files that a Demiurge build did not create."
+    );
+}
+function N(t) {
+  let e;
+  try {
+    e = JSON.parse(t);
+  } catch {
+    throw new Error("The client build manifest is not valid JSON.");
+  }
+  if (!e || typeof e != "object" || !("clientEntry" in e) || typeof e.clientEntry != "string" || !("styles" in e) || !Array.isArray(e.styles) || !e.styles.every((r) => typeof r == "string"))
+    throw new Error("The client build manifest has an unsupported format.");
+  return { clientEntry: e.clientEntry, styles: e.styles };
+}
+function I(t) {
+  return !t || typeof t != "object" || Array.isArray(t) ? !1 : Object.values(t).every((e) => typeof e == "function");
+}
+function P(t) {
+  return p(t)?.staticDeployment;
+}
+function A(t) {
+  return p(t)?.fonts;
+}
+function F(t) {
+  return p(t)?.images;
+}
+function R(t) {
+  return p(t)?.staticFileHeaders ?? [];
+}
+function p(t) {
+  return t?.filter((e) => e.name === "demiurge").map((e) => e.api).find(C);
+}
+function C(t) {
+  return !!t && t !== null && typeof t == "object" && "demiurge" in t && t.demiurge === !0;
+}
+function w(t, e) {
+  const r = d(t, e), i = d(e, t);
+  return y(r) || y(i);
+}
+function y(t) {
+  return !t || t !== ".." && !t.startsWith(`..${g}`) && !v(t);
+}
+function $(t) {
+  return t instanceof Error && "code" in t && t.code === "ENOENT";
+}
+export {
+  W as buildStaticSite,
+  H as helpText,
+  B as parseCliArguments,
+  N as parseClientManifest,
+  G as resolvePreviewOutputDirectory,
+  j as validateBuildOutputDirectory
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["import { readFile, readdir } from \"node:fs/promises\";\nimport { isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { InlineConfig } from \"vite\";\nimport type { FontContribution, ImagePolicy } from \"./platform\";\nimport type { RouteImporter } from \"./route\";\nimport {\n  generateVercelStaticOutput,\n  generateStaticOutput,\n  type GenerateStaticOutputOptions,\n  type StaticFileHeaderPatternRule,\n  type StaticOutputManifest,\n  type VercelStaticDeployment,\n} from \"./static\";\n\ntype CliEnvironment = Record<string, string | undefined>;\n\nconst cliOptionNames = new Set([\"--host\", \"--origin\", \"--out-dir\", \"--port\"]);\n\nexport type CliOptions = {\n  command: \"build\" | \"help\" | \"preview\";\n  host: string;\n  origin?: string;\n  outDir: string;\n  port: number;\n};\n\ntype StaticBuildRuntime = {\n  build: (config: InlineConfig) => Promise<unknown>;\n  generate: (\n    options: GenerateStaticOutputOptions,\n  ) => Promise<StaticOutputManifest>;\n  importModule: (specifier: string) => Promise<Record<string, unknown>>;\n  now: () => number;\n  readText: (file: string) => Promise<string>;\n  resolveConfig: () => Promise<{\n    plugins?: Array<{\n      api?: unknown;\n      name: string;\n    }>;\n    publicDir: false | string;\n    root: string;\n  }>;\n};\n\nexport function parseCliArguments(\n  arguments_: string[],\n  environment: CliEnvironment = {},\n): CliOptions {\n  const command = arguments_[0];\n  if (!command || command === \"--help\" || command === \"-h\" || command === \"help\") {\n    return {\n      command: \"help\",\n      host: \"localhost\",\n      outDir: \"dist\",\n      port: 4173,\n    };\n  }\n  if (command !== \"build\" && command !== \"preview\") {\n    throw new Error(`Unknown command: ${command}`);\n  }\n\n  const options: CliOptions = {\n    command,\n    host: \"localhost\",\n    origin: environment.SITE_ORIGIN,\n    outDir: \"dist\",\n    port: 4173,\n  };\n\n  for (let index = 1; index < arguments_.length; index += 1) {\n    const argument = arguments_[index]!;\n    const [name, inlineValue] = argument.split(\"=\", 2);\n    if (!cliOptionNames.has(name!)) {\n      throw new Error(`Unknown option: ${argument}`);\n    }\n    const value = inlineValue ?? arguments_[++index];\n    if (!value || value.startsWith(\"--\")) {\n      throw new Error(`Option ${name} requires a value.`);\n    }\n\n    if (name === \"--host\") options.host = value;\n    if (name === \"--origin\") options.origin = value;\n    if (name === \"--out-dir\") options.outDir = value;\n    if (name === \"--port\") {\n      const port = Number(value);\n      if (!Number.isSafeInteger(port) || port < 0 || port > 65_535) {\n        throw new Error(\"Preview port must be an integer from 0 through 65535.\");\n      }\n      options.port = port;\n    }\n  }\n\n  return options;\n}\n\nexport const helpText = `Usage: demiurge <command> [options]\n\nCommands:\n  build                 Build static production output\n  preview               Serve static output with its declared headers\n\nOptions:\n  --host <host>         Set the preview host (default: localhost)\n  --origin <origin>     Set the build origin (default: SITE_ORIGIN)\n  --out-dir <directory> Set the output directory (default: dist)\n  --port <port>         Set the preview port (default: 4173)\n  -h, --help            Show this help`;\n\nexport async function buildStaticSite(\n  options: CliOptions,\n  runtime?: StaticBuildRuntime,\n) {\n  const vite = runtime ? undefined : await import(\"vite\");\n  const config = runtime\n    ? await runtime.resolveConfig()\n    : await vite!.resolveConfig({}, \"build\", \"production\");\n  const root = config.root;\n  const outDir = resolve(root, options.outDir);\n  const serverOutDir = resolve(root, \".demiurge/server\");\n  const build = runtime?.build ?? vite!.build;\n\n  await validateBuildOutputDirectory(\n    root,\n    outDir,\n    config.publicDir,\n    serverOutDir,\n  );\n\n  await build({\n    build: {\n      emptyOutDir: true,\n      outDir,\n      rollupOptions: { input: \"virtual:demiurge/client-entry\" },\n    },\n  });\n  await build({\n    build: {\n      copyPublicDir: false,\n      emptyOutDir: true,\n      outDir: serverOutDir,\n      rollupOptions: {\n        input: \"virtual:demiurge/server-entry\",\n        output: { entryFileNames: \"server-entry.js\" },\n      },\n      ssr: true,\n    },\n  });\n\n  const clientManifest = parseClientManifest(\n    runtime\n      ? await runtime.readText(resolve(outDir, \"demiurge-manifest.json\"))\n      : await readFile(resolve(outDir, \"demiurge-manifest.json\"), \"utf8\"),\n  );\n  const serverEntryUrl = `${\n    pathToFileURL(resolve(serverOutDir, \"server-entry.js\")).href\n  }?build=${runtime?.now() ?? Date.now()}`;\n  const serverEntry = runtime\n    ? await runtime.importModule(serverEntryUrl)\n    : await import(serverEntryUrl);\n  if (!isRouteImporterRecord(serverEntry.routes)) {\n    throw new Error(\"The framework server bundle does not export routes.\");\n  }\n\n  const manifest = await (runtime?.generate ?? generateStaticOutput)({\n    fonts: findFontContribution(config.plugins),\n    images: findImagePolicy(config.plugins),\n    origin: options.origin,\n    outDir,\n    root,\n    routes: serverEntry.routes,\n    ssr: clientManifest,\n    staticFileHeaders: findStaticFileHeaderPatterns(config.plugins),\n  });\n\n  const deployment = findVercelStaticDeployment(config.plugins);\n  const deploymentOutDir = deployment\n    ? await generateVercelStaticOutput({\n      deployment,\n      manifest,\n      outDir,\n      projectRoot: process.cwd(),\n    })\n    : undefined;\n\n  return { deploymentOutDir, manifest, outDir };\n}\n\nexport async function resolvePreviewOutputDirectory(\n  outDir: string,\n  resolveConfig?: () => Promise<{ root: string }>,\n) {\n  const config = resolveConfig\n    ? await resolveConfig()\n    : await (await import(\"vite\")).resolveConfig({}, \"serve\", \"production\");\n  return resolve(config.root, outDir);\n}\n\nexport async function validateBuildOutputDirectory(\n  root: string,\n  outDir: string,\n  publicDir: false | string,\n  serverOutDir: string,\n) {\n  const pathFromRoot = relative(root, outDir);\n  if (\n    !pathFromRoot ||\n    pathFromRoot === \"..\" ||\n    pathFromRoot.startsWith(`..${sep}`) ||\n    isAbsolute(pathFromRoot)\n  ) {\n    throw new Error(\"The static output directory must be inside the Vite root.\");\n  }\n\n  if (publicDir && pathsOverlap(outDir, publicDir)) {\n    throw new Error(\"The static output directory must not overlap the Vite public directory.\");\n  }\n\n  if (pathsOverlap(outDir, serverOutDir)) {\n    throw new Error(\"The static output directory must not overlap the framework server directory.\");\n  }\n\n  let entries: string[];\n  try {\n    entries = await readdir(outDir);\n  } catch (error) {\n    if (isMissingPath(error)) return;\n    throw error;\n  }\n\n  if (\n    entries.length &&\n    !entries.includes(\"demiurge-manifest.json\") &&\n    !entries.includes(\"demiurge-static-manifest.json\")\n  ) {\n    throw new Error(\n      \"The static output directory contains files that a Demiurge build did not create.\",\n    );\n  }\n}\n\nexport function parseClientManifest(source: string) {\n  let value: unknown;\n  try {\n    value = JSON.parse(source);\n  } catch {\n    throw new Error(\"The client build manifest is not valid JSON.\");\n  }\n  if (\n    !value ||\n    typeof value !== \"object\" ||\n    !(\"clientEntry\" in value) ||\n    typeof value.clientEntry !== \"string\" ||\n    !(\"styles\" in value) ||\n    !Array.isArray(value.styles) ||\n    !value.styles.every((style) => typeof style === \"string\")\n  ) {\n    throw new Error(\"The client build manifest has an unsupported format.\");\n  }\n  return { clientEntry: value.clientEntry, styles: value.styles };\n}\n\nfunction isRouteImporterRecord(\n  value: unknown,\n): value is Record<string, RouteImporter> {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return false;\n  }\n\n  return Object.values(value).every((load) => typeof load === \"function\");\n}\n\nfunction findVercelStaticDeployment(\n  plugins: ReadonlyArray<{ api?: unknown; name: string }> | undefined,\n): VercelStaticDeployment | undefined {\n  return findDemiurgePluginApi(plugins)?.staticDeployment;\n}\n\nfunction findFontContribution(\n  plugins: ReadonlyArray<{ api?: unknown; name: string }> | undefined,\n): FontContribution | undefined {\n  return findDemiurgePluginApi(plugins)?.fonts;\n}\n\nfunction findImagePolicy(\n  plugins: ReadonlyArray<{ api?: unknown; name: string }> | undefined,\n): ImagePolicy | undefined {\n  return findDemiurgePluginApi(plugins)?.images;\n}\n\nfunction findStaticFileHeaderPatterns(\n  plugins: ReadonlyArray<{ api?: unknown; name: string }> | undefined,\n): readonly StaticFileHeaderPatternRule[] {\n  return findDemiurgePluginApi(plugins)?.staticFileHeaders ?? [];\n}\n\nfunction findDemiurgePluginApi(\n  plugins: ReadonlyArray<{ api?: unknown; name: string }> | undefined,\n) {\n  return plugins\n    ?.filter((plugin) => plugin.name === \"demiurge\")\n    .map((plugin) => plugin.api)\n    .find(isDemiurgePluginApi);\n}\n\nfunction isDemiurgePluginApi(value: unknown): value is {\n  demiurge: true;\n  fonts?: FontContribution;\n  images?: ImagePolicy;\n  staticDeployment?: VercelStaticDeployment;\n  staticFileHeaders?: readonly StaticFileHeaderPatternRule[];\n} {\n  return Boolean(value) &&\n    value !== null &&\n    typeof value === \"object\" &&\n    \"demiurge\" in value &&\n    value.demiurge === true;\n}\n\nfunction pathsOverlap(left: string, right: string) {\n  const fromLeft = relative(left, right);\n  const fromRight = relative(right, left);\n  return isSameOrChildPath(fromLeft) || isSameOrChildPath(fromRight);\n}\n\nfunction isSameOrChildPath(pathname: string) {\n  return !pathname ||\n    (pathname !== \"..\" && !pathname.startsWith(`..${sep}`) &&\n      !isAbsolute(pathname));\n}\n\nfunction isMissingPath(error: unknown) {\n  return error instanceof Error && \"code\" in error && error.code === \"ENOENT\";\n}\n"],"names":["cliOptionNames","parseCliArguments","arguments_","environment","command","options","index","argument","name","inlineValue","value","port","helpText","buildStaticSite","runtime","vite","config","root","outDir","resolve","serverOutDir","build","validateBuildOutputDirectory","clientManifest","parseClientManifest","readFile","serverEntryUrl","pathToFileURL","serverEntry","isRouteImporterRecord","manifest","generateStaticOutput","findFontContribution","findImagePolicy","findStaticFileHeaderPatterns","deployment","findVercelStaticDeployment","generateVercelStaticOutput","resolvePreviewOutputDirectory","resolveConfig","publicDir","pathFromRoot","relative","sep","isAbsolute","pathsOverlap","entries","readdir","error","isMissingPath","source","style","load","plugins","findDemiurgePluginApi","plugin","isDemiurgePluginApi","left","right","fromLeft","fromRight","isSameOrChildPath","pathname"],"mappings":"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"}

package/dist/document/deferred-scripts.d.ts

@@ -0,0 +1,11 @@
+import type { ScriptStrategy } from "./scripts";
+export declare const DEFERRED_SCRIPT_TYPE = "text/demiurge-script";
+export declare const DEFERRED_SCRIPT_ATTRIBUTE = "data-demiurge-script";
+export declare const DEFERRED_SCRIPT_SRC_ATTRIBUTE = "data-demiurge-script-src";
+export declare const DEFERRED_SCRIPT_TYPE_ATTRIBUTE = "data-demiurge-script-type";
+export declare const DEFERRED_SCRIPT_STARTED_ATTRIBUTE = "data-demiurge-script-started";
+export type DeferredScriptStrategy = "idle" | "worker";
+export declare function isDeferredScriptStrategy(strategy: ScriptStrategy): strategy is DeferredScriptStrategy;
+export declare function startDeferredScripts(target?: Document): void;
+export declare function getScriptWorker(src: string): Worker | undefined;
+//# sourceMappingURL=deferred-scripts.d.ts.map

package/dist/document/deferred-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-scripts.d.ts","sourceRoot":"","sources":["../../src/document/deferred-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAC1E,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAehF,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAIvD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,cAAc,GACvB,QAAQ,IAAI,sBAAsB,CAEpC;AAID,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ,QA2BrD;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,sBAE1C"}

package/dist/document/index.d.ts

@@ -1,13 +1,15 @@
 export { HYDRATION_DATA_ELEMENT_ID, HYDRATION_FALLBACK_ATTRIBUTE, HYDRATION_ROOT_ATTRIBUTE, readInitialRouteData, serializeInitialRouteData, } from "./hydration";
+export { getScriptWorker, startDeferredScripts, } from "./deferred-scripts";
 export { defineLinks, modulePreload, preconnect, preload, resolveLinks, } from "./links";
 export { defineMetadata, link, meta, resolveMetadata, structuredData, } from "./metadata";
 export { renderDocument, } from "./render";
-export { defineScripts, resolveScripts, script, } from "./scripts";
+export { defineScripts, Script, resolveScripts, script, } from "./scripts";
 export { defineOgImage, defineRobots, defineSitemap, renderOgImageResponse, renderOgImageSvg, renderRobots, renderSitemap, } from "./seo";
+export type { DeferredScriptStrategy } from "./deferred-scripts";
 export type { InitialRouteData } from "./hydration";
 export type { LinkContribution, PreconnectOptions, PreloadOptions, } from "./links";
 export type { DocumentMetadataTag, LinkTag, Metadata, MetadataTitle, MetaTag, OpenGraphMetadata, ResolvedMetadata, RobotsMetadata, StructuredDataTag, StructuredDataValue, } from "./metadata";
 export type { DocumentBody, RenderDocumentOptions, } from "./render";
-export type { ScriptContribution, ScriptStrategy, ScriptTag, } from "./scripts";
+export type { ScriptContribution, ScriptCspNeeds, ScriptProps, ScriptStrategy, ScriptTag, } from "./scripts";
 export type { OgImage, Robots, RobotsDirective, Sitemap, SitemapAlternate, SitemapChangeFrequency, SitemapEntry, } from "./seo";
 //# sourceMappingURL=index.d.ts.map

package/dist/document/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,OAAO,EACP,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,OAAO,EACP,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,MAAM,EACN,cAAc,EACd,MAAM,GACP,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,OAAO,CAAC"}

package/dist/document/render.d.ts

@@ -1,5 +1,5 @@
 import type { LinkTag, ResolvedMetadata } from "./metadata";
-import type { ScriptTag } from "./scripts";
+import { type ScriptTag } from "./scripts";
 export declare const STRUCTURED_DATA_ATTRIBUTE = "data-demiurge-structured-data";
 export type DocumentBody = {
     data: unknown;

package/dist/document/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/document/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,OAAO,EACP,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;IAC7E,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,UAS5D;AAED,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,QAAQ,EACR,IAAW,EACX,KAAU,EACV,QAAQ,EACR,KAAK,EACL,OAAY,EACZ,MAAW,EACX,KAAsB,GACvB,EAAE,0BAA0B;;;EAsB5B"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/document/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,OAAO,EACP,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5D,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;IAC7E,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,UAS5D;AAED,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,QAAQ,EACR,IAAW,EACX,KAAU,EACV,QAAQ,EACR,KAAK,EACL,OAAY,EACZ,MAAW,EACX,KAAsB,GACvB,EAAE,0BAA0B;;;EAwB5B"}

package/dist/document/scripts.d.ts

@@ -1,24 +1,57 @@
+import { type ReactNode } from "react";
 import type { HttpRouteContext, MaybePromise } from "../route";
-export type ScriptStrategy = "afterInteractive" | "beforeInteractive" | "module";
+export type ScriptStrategy = "afterInteractive" | "beforeInteractive" | "idle" | "module" | "worker";
+export declare const scriptPlacement: unique symbol;
+/**
+ * Directives a script needs at runtime beyond its own `script-src` entry. A
+ * beacon or an API call needs `connect-src`. A tracking pixel needs `img-src`.
+ * The build reads these and fails when the effective policy omits a source.
+ */
+export type ScriptCspNeeds = {
+    connect?: readonly string[];
+    img?: readonly string[];
+};
 export type ScriptTag = {
     async?: boolean;
+    crossOrigin?: "anonymous" | "use-credentials";
     dataApi?: string;
     dataDomain?: string;
     defer?: boolean;
     id?: string;
     integrity?: string;
     kind: "script";
+    needs?: ScriptCspNeeds;
     nonce?: string;
     purpose?: string;
     referrerPolicy?: ReferrerPolicy;
     src: string;
     strategy: ScriptStrategy;
     type?: "module" | "text/javascript";
+    [scriptPlacement]?: "hoisted" | "in-place";
 };
 export type ScriptContribution = readonly ScriptTag[] | ((context: HttpRouteContext) => MaybePromise<readonly ScriptTag[]>);
+export type ScriptProps = Omit<ScriptTag, "kind" | "nonce" | "strategy" | typeof scriptPlacement> & {
+    strategy?: ScriptStrategy;
+};
+export type ScriptRenderContext = {
+    dev: boolean;
+    headFlushed: boolean;
+    flushHead: () => void;
+    nonce?: string;
+    register: (scriptTag: ScriptTag) => "hoist" | "render" | "skip";
+    scripts: () => ScriptTag[];
+};
+export declare const ScriptContext: import("react").Context<ScriptRenderContext | undefined>;
+export declare function createScriptRenderContext(options?: {
+    dev?: boolean;
+    nonce?: string;
+    scripts?: readonly ScriptTag[];
+}): ScriptRenderContext;
+export declare function Script(props: ScriptProps): ReactNode;
 export declare function defineScripts(contribution: ScriptContribution): ScriptContribution;
 export declare function script(options: Omit<ScriptTag, "kind" | "strategy"> & {
     strategy?: ScriptStrategy;
 }): ScriptTag;
+export declare function withScriptContext(context: ScriptRenderContext, children: ReactNode): import("react").FunctionComponentElement<import("react").ProviderProps<ScriptRenderContext | undefined>>;
 export declare function resolveScripts(contributions: Array<ScriptContribution | false | undefined>, context: HttpRouteContext): Promise<ScriptTag[]>;
 //# sourceMappingURL=scripts.d.ts.map

package/dist/document/scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/document/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,CAAC;AAQb,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,QAAQ,GAAG,iBAAiB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,SAAS,SAAS,EAAE,GACpB,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC,CAAC;AAExE,wBAAgB,aAAa,CAAC,YAAY,EAAE,kBAAkB,sBAE7D;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACrE,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,SAAS,CAoBZ;AAED,wBAAsB,cAAc,CAClC,aAAa,EAAE,KAAK,CAAC,kBAAkB,GAAG,KAAK,GAAG,SAAS,CAAC,EAC5D,OAAO,EAAE,gBAAgB,wBAkB1B"}
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/document/scripts.ts"],"names":[],"mappings":"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"}

package/dist/edge/assets.d.ts

@@ -0,0 +1,14 @@
+export type EdgeAsset = {
+    body: ArrayBuffer | ArrayBufferView | string;
+    contentType?: string;
+    immutable?: boolean;
+};
+export type EdgeAssetMap = Readonly<Record<string, EdgeAsset>>;
+export type EdgeAssetHandler = (request: Request) => Promise<Response | null>;
+export type EdgeAssetHandlerOptions = {
+    assets: EdgeAssetMap;
+    immutable?: (fileName: string) => boolean;
+    prefix?: string;
+};
+export declare function createEdgeAssetHandler(options: EdgeAssetHandlerOptions): EdgeAssetHandler;
+//# sourceMappingURL=assets.d.ts.map

package/dist/edge/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/edge/assets.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAqCF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAyDlB"}

package/dist/edge/index.d.ts

@@ -0,0 +1,19 @@
+import { type RequestCacheStoreOptions, type RequestHandler, type RequestHandlerOptions } from "../server";
+import type { RateLimitStore } from "../security";
+import type { EdgeAssetHandler, EdgeAssetHandlerOptions } from "./assets";
+export { createEdgeAssetHandler } from "./assets";
+export { renderEdgePageResponse, renderEdgeStreamingPageResponse, } from "./streaming";
+export { createUnavailableCacheStore, createUnavailableRateLimitStore, EdgeSharedStoreError, } from "./stores";
+export type { EdgeAsset, EdgeAssetHandler, EdgeAssetHandlerOptions, EdgeAssetMap, } from "./assets";
+export declare const edgeAdapter: import("..").Adapter;
+export declare const EDGE_SHARED_STORE_UNAVAILABLE = "unavailable";
+export type EdgeCacheStoreOption = RequestCacheStoreOptions | typeof EDGE_SHARED_STORE_UNAVAILABLE;
+export type EdgeRateLimitStoreOption = RateLimitStore | typeof EDGE_SHARED_STORE_UNAVAILABLE;
+export type EdgeRequestHandlerOptions = Omit<RequestHandlerOptions, "adapter" | "cacheStore" | "rateLimitStore"> & {
+    assets?: EdgeAssetHandler | EdgeAssetHandlerOptions;
+    cacheStore: EdgeCacheStoreOption;
+    clientIp?: (request: Request) => string | undefined | null;
+    rateLimitStore: EdgeRateLimitStoreOption;
+};
+export declare function createEdgeRequestHandler(options: EdgeRequestHandlerOptions): RequestHandler;
+//# sourceMappingURL=index.d.ts.map

package/dist/edge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAO1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,GACb,MAAM,UAAU,CAAC;AASlB,eAAO,MAAM,WAAW,sBAOtB,CAAC;AAEH,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,OAAO,6BAA6B,CAAC;AAEzC,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,OAAO,6BAA6B,CAAC;AAEzC,MAAM,MAAM,yBAAyB,GACjC,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,YAAY,GAAG,gBAAgB,CAAC,GACxE;IACA,MAAM,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAAC;IAIpD,UAAU,EAAE,oBAAoB,CAAC;IAIjC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3D,cAAc,EAAE,wBAAwB,CAAC;CAC1C,CAAC;AAkBJ,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,cAAc,CAkChB"}