@farm.js/core 0.1.61 → 0.1.62

package/dist/internal/react-cache.cjs

@@ -0,0 +1,51 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkHNAISJFDcjs = require('../chunk-HNAISJFD.cjs');
+require('../chunk-3BIASUGR.cjs');
+require('../chunk-BTZ5O6VM.cjs');
+
+// src/react-cache.ts
+var requests = /* @__PURE__ */ new WeakMap();
+function cache(fn) {
+  const memoized = function(...args) {
+    const request = _chunkHNAISJFDcjs.getCurrentRequestOrNull.call(void 0, );
+    if (!request) return fn.apply(this, args);
+    let functions = requests.get(request);
+    if (!functions) requests.set(request, functions = /* @__PURE__ */ new WeakMap());
+    let node = functions.get(memoized);
+    if (!node) {
+      node = { status: 0 };
+      functions.set(memoized, node);
+    }
+    for (const arg of args) {
+      const keyed = typeof arg === "object" && arg !== null || typeof arg === "function";
+      let next;
+      if (keyed) {
+        const objects = _nullishCoalesce(node.objects, () => ( (node.objects = /* @__PURE__ */ new WeakMap())));
+        next = objects.get(arg);
+        if (!next) objects.set(arg, next = { status: 0 });
+      } else {
+        const primitives = _nullishCoalesce(node.primitives, () => ( (node.primitives = /* @__PURE__ */ new Map())));
+        next = primitives.get(arg);
+        if (!next) primitives.set(arg, next = { status: 0 });
+      }
+      node = next;
+    }
+    if (node.status === 1) return node.value;
+    if (node.status === 2) throw node.value;
+    try {
+      const value = fn.apply(this, args);
+      node.status = 1;
+      node.value = value;
+      return value;
+    } catch (error) {
+      node.status = 2;
+      node.value = error;
+      throw error;
+    }
+  };
+  return memoized;
+}
+
+
+exports.cache = cache;

package/dist/internal/react-cache.d.mts

@@ -0,0 +1,3 @@
+declare function cache<Fn extends (...args: any[]) => any>(fn: Fn): Fn;
+
+export { cache };

package/dist/internal/react-cache.d.ts

@@ -0,0 +1,3 @@
+declare function cache<Fn extends (...args: any[]) => any>(fn: Fn): Fn;
+
+export { cache };

package/dist/internal/react-cache.mjs

@@ -0,0 +1,51 @@
+import {
+  getCurrentRequestOrNull
+} from "../chunk-6HRAK7I5.mjs";
+import "../chunk-VIXTAVEA.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+
+// src/react-cache.ts
+var requests = /* @__PURE__ */ new WeakMap();
+function cache(fn) {
+  const memoized = function(...args) {
+    const request = getCurrentRequestOrNull();
+    if (!request) return fn.apply(this, args);
+    let functions = requests.get(request);
+    if (!functions) requests.set(request, functions = /* @__PURE__ */ new WeakMap());
+    let node = functions.get(memoized);
+    if (!node) {
+      node = { status: 0 };
+      functions.set(memoized, node);
+    }
+    for (const arg of args) {
+      const keyed = typeof arg === "object" && arg !== null || typeof arg === "function";
+      let next;
+      if (keyed) {
+        const objects = node.objects ?? (node.objects = /* @__PURE__ */ new WeakMap());
+        next = objects.get(arg);
+        if (!next) objects.set(arg, next = { status: 0 });
+      } else {
+        const primitives = node.primitives ?? (node.primitives = /* @__PURE__ */ new Map());
+        next = primitives.get(arg);
+        if (!next) primitives.set(arg, next = { status: 0 });
+      }
+      node = next;
+    }
+    if (node.status === 1) return node.value;
+    if (node.status === 2) throw node.value;
+    try {
+      const value = fn.apply(this, args);
+      node.status = 1;
+      node.value = value;
+      return value;
+    } catch (error) {
+      node.status = 2;
+      node.value = error;
+      throw error;
+    }
+  };
+  return memoized;
+}
+export {
+  cache
+};

package/dist/internal/request-cookies.cjs

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkAI7QMY7Ocjs = require('../chunk-AI7QMY7O.cjs');
-require('../chunk-S3JO3N4H.cjs');
+var _chunkR5U7OIPIcjs = require('../chunk-R5U7OIPI.cjs');
+require('../chunk-BTZ5O6VM.cjs');
 
 
 
-exports.decodeCookieName = _chunkAI7QMY7Ocjs.decodeCookieName; exports.parseRequestCookieHeader = _chunkAI7QMY7Ocjs.parseRequestCookieHeader;
+exports.decodeCookieName = _chunkR5U7OIPIcjs.decodeCookieName; exports.parseRequestCookieHeader = _chunkR5U7OIPIcjs.parseRequestCookieHeader;

package/dist/internal/request-cookies.d.mts

@@ -0,0 +1,16 @@
+interface ParsedRequestCookie {
+    name: string;
+    value: string;
+}
+/** Parse request cookies in wire order without collapsing duplicate names. */
+declare function parseRequestCookieHeader(header: string | null | undefined): ParsedRequestCookie[];
+/**
+ * A cookie name as Farm wrote it: names are percent-encoded when set, so they are decoded when read.
+ * A browser enforces the `__Host-` / `__Secure-` prefixes on the raw name only, so an encoded name
+ * like `__Host%2Dsid` reaches the server without the guarantees. Decoded, it would read as the
+ * protected `__Host-sid`: a sibling subdomain could set it with a longer Path, which browsers send
+ * first, and shadow the real one. A name keeps its raw form when decoding would add the prefix.
+ */
+declare function decodeCookieName(raw: string): string;
+
+export { type ParsedRequestCookie, decodeCookieName, parseRequestCookieHeader };

package/dist/internal/request-cookies.d.ts

@@ -0,0 +1,16 @@
+interface ParsedRequestCookie {
+    name: string;
+    value: string;
+}
+/** Parse request cookies in wire order without collapsing duplicate names. */
+declare function parseRequestCookieHeader(header: string | null | undefined): ParsedRequestCookie[];
+/**
+ * A cookie name as Farm wrote it: names are percent-encoded when set, so they are decoded when read.
+ * A browser enforces the `__Host-` / `__Secure-` prefixes on the raw name only, so an encoded name
+ * like `__Host%2Dsid` reaches the server without the guarantees. Decoded, it would read as the
+ * protected `__Host-sid`: a sibling subdomain could set it with a longer Path, which browsers send
+ * first, and shadow the real one. A name keeps its raw form when decoding would add the prefix.
+ */
+declare function decodeCookieName(raw: string): string;
+
+export { type ParsedRequestCookie, decodeCookieName, parseRequestCookieHeader };

package/dist/internal/request-cookies.mjs

@@ -1,8 +1,8 @@
 import {
   decodeCookieName,
   parseRequestCookieHeader
-} from "../chunk-JM5XPKWH.mjs";
-import "../chunk-LPEX4YW6.mjs";
+} from "../chunk-AY2YD5ZX.mjs";
+import "../chunk-Y6FXYEAI.mjs";
 export {
   decodeCookieName,
   parseRequestCookieHeader

package/dist/internal/server-fn-transform.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkPIUTGRDIcjs = require('../chunk-PIUTGRDI.cjs');
+require('../chunk-BTZ5O6VM.cjs');
+
+
+
+
+
+exports.FARM_SERVER_FN_BOUNDARY_QUERY = _chunkPIUTGRDIcjs.FARM_SERVER_FN_BOUNDARY_QUERY; exports.createFarmServerFnBoundaryModule = _chunkPIUTGRDIcjs.createFarmServerFnBoundaryModule; exports.isFarmServerFnBoundaryId = _chunkPIUTGRDIcjs.isFarmServerFnBoundaryId; exports.transformFarmServerFns = _chunkPIUTGRDIcjs.transformFarmServerFns;

package/dist/internal/server-fn-transform.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Query that marks the generated "use server" boundary of a module whose server
+ * functions were found implicitly. Only the server functions are exported from
+ * it, so @vitejs/plugin-rsc registers nothing else from the source module.
+ */
+declare const FARM_SERVER_FN_BOUNDARY_QUERY = "?farm-server-fns";
+type FarmServerFnTransformOptions = {
+    /** Vite environment being transformed. Anything other than "rsc" gets the client view. */
+    environment?: string;
+};
+type FarmServerFnTransformResult = {
+    code: string;
+    exports: string[];
+};
+declare function transformFarmServerFns(code: string, id: string, options?: FarmServerFnTransformOptions): FarmServerFnTransformResult | null;
+/**
+ * Source of the generated boundary for a module without an explicit
+ * "use server". Its wrappers call the source module's private bindings lazily,
+ * so the import cycle between the two modules is safe in any load order.
+ */
+declare function createFarmServerFnBoundaryModule(code: string, id: string): string | null;
+declare function isFarmServerFnBoundaryId(id: string): boolean;
+
+export { FARM_SERVER_FN_BOUNDARY_QUERY, type FarmServerFnTransformOptions, type FarmServerFnTransformResult, createFarmServerFnBoundaryModule, isFarmServerFnBoundaryId, transformFarmServerFns };

package/dist/internal/server-fn-transform.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Query that marks the generated "use server" boundary of a module whose server
+ * functions were found implicitly. Only the server functions are exported from
+ * it, so @vitejs/plugin-rsc registers nothing else from the source module.
+ */
+declare const FARM_SERVER_FN_BOUNDARY_QUERY = "?farm-server-fns";
+type FarmServerFnTransformOptions = {
+    /** Vite environment being transformed. Anything other than "rsc" gets the client view. */
+    environment?: string;
+};
+type FarmServerFnTransformResult = {
+    code: string;
+    exports: string[];
+};
+declare function transformFarmServerFns(code: string, id: string, options?: FarmServerFnTransformOptions): FarmServerFnTransformResult | null;
+/**
+ * Source of the generated boundary for a module without an explicit
+ * "use server". Its wrappers call the source module's private bindings lazily,
+ * so the import cycle between the two modules is safe in any load order.
+ */
+declare function createFarmServerFnBoundaryModule(code: string, id: string): string | null;
+declare function isFarmServerFnBoundaryId(id: string): boolean;
+
+export { FARM_SERVER_FN_BOUNDARY_QUERY, type FarmServerFnTransformOptions, type FarmServerFnTransformResult, createFarmServerFnBoundaryModule, isFarmServerFnBoundaryId, transformFarmServerFns };

package/dist/internal/server-fn-transform.mjs

@@ -0,0 +1,13 @@
+import {
+  FARM_SERVER_FN_BOUNDARY_QUERY,
+  createFarmServerFnBoundaryModule,
+  isFarmServerFnBoundaryId,
+  transformFarmServerFns
+} from "../chunk-GNZIAJGB.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+export {
+  FARM_SERVER_FN_BOUNDARY_QUERY,
+  createFarmServerFnBoundaryModule,
+  isFarmServerFnBoundaryId,
+  transformFarmServerFns
+};

package/dist/internal/server-tree.cjs

@@ -2,11 +2,14 @@
 
 
 
-var _chunkYSLWRWWPcjs = require('../chunk-YSLWRWWP.cjs');
-require('../chunk-WWFTAUFG.cjs');
-require('../chunk-S3JO3N4H.cjs');
 
+var _chunk72KCTHLVcjs = require('../chunk-72KCTHLV.cjs');
+require('../chunk-ATYTLVSI.cjs');
+require('../chunk-CQL5ZGFU.cjs');
+require('../chunk-BTZ5O6VM.cjs');
 
 
 
-exports.FARM_SERVER_TREE_ATTRIBUTE = _chunkYSLWRWWPcjs.FARM_SERVER_TREE_ATTRIBUTE; exports.createFarmServerTreeElement = _chunkYSLWRWWPcjs.createFarmServerTreeElement; exports.renderFarmServerTreePage = _chunkYSLWRWWPcjs.renderFarmServerTreePage;
+
+
+exports.FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE = _chunk72KCTHLVcjs.FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE; exports.FARM_SERVER_TREE_SCRIPT_TYPE = _chunk72KCTHLVcjs.FARM_SERVER_TREE_SCRIPT_TYPE; exports.createFarmServerTreeElement = _chunk72KCTHLVcjs.createFarmServerTreeElement; exports.renderFarmServerTreePage = _chunk72KCTHLVcjs.renderFarmServerTreePage;

package/dist/internal/server-tree.d.mts

@@ -0,0 +1,50 @@
+import React__default from 'react';
+import { F as FarmIslandValueStore } from '../island-value-protocol.d-BRayRghM.mjs';
+
+/** The script type of a page's tree. */
+declare const FARM_SERVER_TREE_SCRIPT_TYPE = "f/tree";
+/**
+ * Marks a navigation response that carries only the page's payload. The browser rebuilds such a
+ * page in its layout's React root and never shows its HTML, so the server leaves the HTML out.
+ */
+declare const FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE = "partial";
+interface FarmServerTreeRenderOptions {
+    /** Renders a subtree the resolver could not represent with its client components as islands. */
+    isolate(element: React__default.ReactNode): React__default.ReactNode;
+    /**
+     * Islands mode: large values in the payload travel once, keyed by content, and a navigation
+     * leaves out the ones the browser holds.
+     */
+    values?: boolean;
+    /**
+     * A navigation the browser renders in its layout's React root: send the payload, the chunks it
+     * streams and the server HTML parts it cannot represent, without the page's rendered HTML.
+     */
+    payloadOnly?: boolean;
+}
+/**
+ * @internal Resolves a server page and returns the page boundary's children: the resolved tree
+ * and its payload. Errors from the page's own code, including redirect and notFound controls,
+ * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
+ */
+declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
+interface FarmServerTreeElementOptions {
+    load(reference: string): Promise<Record<string, unknown>>;
+    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
+    ServerHtml: React__default.ComponentType<any>;
+    /** Remounts the page's client components when it changes, as a navigation does. */
+    key?: string;
+    /** Islands mode's value store, for payloads that reference island values. */
+    values?: Pick<FarmIslandValueStore, "ingest" | "resolve">;
+    /** Islands mode: the function a server action reference stands for. */
+    actions?(id: string): (...args: unknown[]) => unknown;
+    /** Islands mode: decodes props JSON cannot hold (`decodeFarmTagged` in island-codec.ts). */
+    decode?(object: Record<string, unknown>, decodeChild: (value: unknown) => unknown): unknown;
+}
+/**
+ * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
+ * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
+ */
+declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
+
+export { FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE, FARM_SERVER_TREE_SCRIPT_TYPE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/internal/server-tree.d.ts

@@ -0,0 +1,50 @@
+import React__default from 'react';
+import { F as FarmIslandValueStore } from '../island-value-protocol.d-BRayRghM.js';
+
+/** The script type of a page's tree. */
+declare const FARM_SERVER_TREE_SCRIPT_TYPE = "f/tree";
+/**
+ * Marks a navigation response that carries only the page's payload. The browser rebuilds such a
+ * page in its layout's React root and never shows its HTML, so the server leaves the HTML out.
+ */
+declare const FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE = "partial";
+interface FarmServerTreeRenderOptions {
+    /** Renders a subtree the resolver could not represent with its client components as islands. */
+    isolate(element: React__default.ReactNode): React__default.ReactNode;
+    /**
+     * Islands mode: large values in the payload travel once, keyed by content, and a navigation
+     * leaves out the ones the browser holds.
+     */
+    values?: boolean;
+    /**
+     * A navigation the browser renders in its layout's React root: send the payload, the chunks it
+     * streams and the server HTML parts it cannot represent, without the page's rendered HTML.
+     */
+    payloadOnly?: boolean;
+}
+/**
+ * @internal Resolves a server page and returns the page boundary's children: the resolved tree
+ * and its payload. Errors from the page's own code, including redirect and notFound controls,
+ * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
+ */
+declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
+interface FarmServerTreeElementOptions {
+    load(reference: string): Promise<Record<string, unknown>>;
+    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
+    ServerHtml: React__default.ComponentType<any>;
+    /** Remounts the page's client components when it changes, as a navigation does. */
+    key?: string;
+    /** Islands mode's value store, for payloads that reference island values. */
+    values?: Pick<FarmIslandValueStore, "ingest" | "resolve">;
+    /** Islands mode: the function a server action reference stands for. */
+    actions?(id: string): (...args: unknown[]) => unknown;
+    /** Islands mode: decodes props JSON cannot hold (`decodeFarmTagged` in island-codec.ts). */
+    decode?(object: Record<string, unknown>, decodeChild: (value: unknown) => unknown): unknown;
+}
+/**
+ * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
+ * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
+ */
+declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
+
+export { FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE, FARM_SERVER_TREE_SCRIPT_TYPE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/internal/server-tree.mjs

@@ -1,12 +1,15 @@
 import {
-  FARM_SERVER_TREE_ATTRIBUTE,
+  FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE,
+  FARM_SERVER_TREE_SCRIPT_TYPE,
   createFarmServerTreeElement,
   renderFarmServerTreePage
-} from "../chunk-OFZUJMCU.mjs";
-import "../chunk-NRDBW4MP.mjs";
-import "../chunk-LPEX4YW6.mjs";
+} from "../chunk-QGJ4FI2G.mjs";
+import "../chunk-FHURJABM.mjs";
+import "../chunk-NBIVGHAT.mjs";
+import "../chunk-Y6FXYEAI.mjs";
 export {
-  FARM_SERVER_TREE_ATTRIBUTE,
+  FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE,
+  FARM_SERVER_TREE_SCRIPT_TYPE,
   createFarmServerTreeElement,
   renderFarmServerTreePage
 };

package/dist/island-value-protocol.d-BRayRghM.d.mts

@@ -0,0 +1,12 @@
+interface FarmIslandValueStore {
+    /** Reads the value scripts under `root` that the store does not hold yet. */
+    ingest(root: ParentNode): void;
+    /** Replaces value references in parsed props with the values they name. */
+    resolve(value: unknown): unknown;
+    /** The header value naming the keys the store holds, or undefined when it holds none. */
+    heldHeader(): string | undefined;
+}
+/** Headers a navigation sends so the server can leave out values the browser holds. */
+declare function getFarmIslandValueHeaders(): Record<string, string>;
+
+export { type FarmIslandValueStore as F, getFarmIslandValueHeaders as g };

package/dist/island-value-protocol.d-BRayRghM.d.ts

@@ -0,0 +1,12 @@
+interface FarmIslandValueStore {
+    /** Reads the value scripts under `root` that the store does not hold yet. */
+    ingest(root: ParentNode): void;
+    /** Replaces value references in parsed props with the values they name. */
+    resolve(value: unknown): unknown;
+    /** The header value naming the keys the store holds, or undefined when it holds none. */
+    heldHeader(): string | undefined;
+}
+/** Headers a navigation sends so the server can leave out values the browser holds. */
+declare function getFarmIslandValueHeaders(): Record<string, string>;
+
+export { type FarmIslandValueStore as F, getFarmIslandValueHeaders as g };

package/dist/island.d-CfGru1MO.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Controls when Farm loads and hydrates a server-rendered client boundary.
+ *
+ * `load` is the compatibility-first default. The deferred strategies keep the
+ * server-rendered HTML visible while postponing the boundary's JavaScript.
+ */
+type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
+
+export type { FarmIslandStrategy as F };

package/dist/island.d-CfGru1MO.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Controls when Farm loads and hydrates a server-rendered client boundary.
+ *
+ * `load` is the compatibility-first default. The deferred strategies keep the
+ * server-rendered HTML visible while postponing the boundary's JavaScript.
+ */
+type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
+
+export type { FarmIslandStrategy as F };

package/dist/json-ld.cjs

@@ -1,6 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
-
-var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }require('./chunk-BTZ5O6VM.cjs');
 
 // src/json-ld.ts
 var SCHEMA_CONTEXT = "https://schema.org";
@@ -23,7 +21,6 @@ function article(input) {
     }
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, article, "article");
 function breadcrumbList(items) {
   return thing("BreadcrumbList", {
     itemListElement: items.map((item, index) => ({
@@ -33,7 +30,6 @@ function breadcrumbList(items) {
     }))
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, breadcrumbList, "breadcrumbList");
 function faqPage(items) {
   return thing("FAQPage", {
     mainEntity: items.map((item) => ({
@@ -43,7 +39,6 @@ function faqPage(items) {
     }))
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, faqPage, "faqPage");
 function product(input) {
   return thing("Product", {
     name: input.name,
@@ -56,7 +51,6 @@ function product(input) {
     aggregateRating: rating(input.aggregateRating)
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, product, "product");
 function softwareApplication(input) {
   return thing("SoftwareApplication", {
     name: input.name,
@@ -70,19 +64,16 @@ function softwareApplication(input) {
     aggregateRating: rating(input.aggregateRating)
   });
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, softwareApplication, "softwareApplication");
 function thing(type, properties) {
   return { "@context": SCHEMA_CONTEXT, "@type": type, ...prune(properties) };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, thing, "thing");
 function person(input) {
   if (typeof input === "string") return { "@type": "Person", name: input };
   return { "@type": _nullishCoalesce(input.type, () => ( "Person")), ...prune({ name: input.name, url: input.url }) };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, person, "person");
 function offers(input) {
   if (!input) return void 0;
-  const offer = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (value) => ({
+  const offer = (value) => ({
     "@type": "Offer",
     ...prune({
       price: value.price,
@@ -90,19 +81,16 @@ function offers(input) {
       availability: value.availability && `${SCHEMA_CONTEXT}/${value.availability}`,
       url: value.url
     })
-  }), "offer");
+  });
   return Array.isArray(input) ? input.map(offer) : offer(input);
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, offers, "offers");
 function rating(input) {
   return input && { "@type": "AggregateRating", ...prune({ ...input }) };
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, rating, "rating");
 function toDate(value) {
   if (!(value instanceof Date)) return value;
   return Number.isNaN(value.getTime()) ? void 0 : value.toISOString();
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, toDate, "toDate");
 function prune(object) {
   const result = {};
   for (const [key, value] of Object.entries(object)) {
@@ -112,7 +100,6 @@ function prune(object) {
   }
   return result;
 }
-_chunkS3JO3N4Hcjs.__name.call(void 0, prune, "prune");
 
 
 

package/dist/json-ld.d.mts

@@ -0,0 +1,94 @@
+/**
+ * Typed builders for common schema.org JSON-LD objects. Each returns a plain
+ * object for `metadata.jsonLd`; spread the result to add more properties. Values
+ * are passed through as written, so prefer absolute URLs.
+ *
+ * ```ts
+ * import * as jsonLd from "@farm.js/core/json-ld";
+ *
+ * export const metadata = {
+ *   jsonLd: jsonLd.breadcrumbList([{ name: "Docs", url: "https://acme.test/docs" }]),
+ * };
+ * ```
+ */
+declare const SCHEMA_CONTEXT = "https://schema.org";
+/** A schema.org JSON-LD object with its `@context` and `@type`. */
+type JsonLd<TType extends string = string> = {
+    "@context": typeof SCHEMA_CONTEXT;
+    "@type": TType;
+    [property: string]: unknown;
+};
+/** A person or organization: a plain name, or a name with a URL. */
+type JsonLdPersonInput = string | {
+    name: string;
+    url?: string;
+    type?: "Person" | "Organization";
+};
+interface JsonLdOfferInput {
+    price: number | string;
+    /** ISO 4217 currency code, for example `"USD"`. */
+    priceCurrency: string;
+    availability?: "InStock" | "OutOfStock" | "PreOrder" | "BackOrder" | "Discontinued" | "LimitedAvailability" | "OnlineOnly" | "SoldOut";
+    url?: string;
+}
+interface JsonLdRatingInput {
+    ratingValue: number | string;
+    reviewCount?: number;
+    ratingCount?: number;
+    bestRating?: number | string;
+}
+type ArticleJsonLdType = "Article" | "BlogPosting" | "NewsArticle" | "TechArticle";
+interface ArticleJsonLdInput {
+    /** @default "Article" */
+    type?: ArticleJsonLdType;
+    headline: string;
+    description?: string;
+    url?: string;
+    image?: string | string[];
+    datePublished?: string | Date;
+    dateModified?: string | Date;
+    author?: JsonLdPersonInput | JsonLdPersonInput[];
+    publisher?: {
+        name: string;
+        url?: string;
+        logo?: string;
+    };
+}
+declare function article(input: ArticleJsonLdInput): JsonLd<ArticleJsonLdType>;
+interface BreadcrumbJsonLdItem {
+    name: string;
+    /** Omit for the current page, which may be the last item. */
+    url?: string;
+}
+declare function breadcrumbList(items: BreadcrumbJsonLdItem[]): JsonLd<"BreadcrumbList">;
+interface FaqJsonLdItem {
+    question: string;
+    answer: string;
+}
+declare function faqPage(items: FaqJsonLdItem[]): JsonLd<"FAQPage">;
+interface ProductJsonLdInput {
+    name: string;
+    description?: string;
+    url?: string;
+    image?: string | string[];
+    sku?: string;
+    brand?: string;
+    offers?: JsonLdOfferInput | JsonLdOfferInput[];
+    aggregateRating?: JsonLdRatingInput;
+}
+declare function product(input: ProductJsonLdInput): JsonLd<"Product">;
+interface SoftwareApplicationJsonLdInput {
+    name: string;
+    description?: string;
+    url?: string;
+    image?: string | string[];
+    /** For example `"DeveloperApplication"` or `"BusinessApplication"`. */
+    applicationCategory?: string;
+    operatingSystem?: string;
+    softwareVersion?: string;
+    offers?: JsonLdOfferInput | JsonLdOfferInput[];
+    aggregateRating?: JsonLdRatingInput;
+}
+declare function softwareApplication(input: SoftwareApplicationJsonLdInput): JsonLd<"SoftwareApplication">;
+
+export { type ArticleJsonLdInput, type ArticleJsonLdType, type BreadcrumbJsonLdItem, type FaqJsonLdItem, type JsonLd, type JsonLdOfferInput, type JsonLdPersonInput, type JsonLdRatingInput, type ProductJsonLdInput, type SoftwareApplicationJsonLdInput, article, breadcrumbList, faqPage, product, softwareApplication };