@bgub/fig 0.0.1 → 0.1.0-alpha.1

package/dist/payload-format-KTNaSI4h.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-format-KTNaSI4h.js","names":[],"sources":["../src/payload-format.ts"],"sourcesContent":["import type { FigDataHydrationEntry } from \"./data.ts\";\nimport type { Key } from \"./element.ts\";\nimport type {\n  FontResource,\n  MetaResource,\n  ModulePreloadResource,\n  PreconnectResource,\n  PreloadResource,\n  ScriptResource,\n  StylesheetResource,\n  TitleResource,\n} from \"./resource.ts\";\n\n// Asset resources represented as descriptor data. Optional fields stay optional\n// on the wire; omitted `undefined` values are part of the payload contract, not\n// a serializer implementation detail. Delivery assets prepare eagerly at row\n// arrival; document metadata stays attached to its owning decoded row until\n// that row commits.\nexport type SerializedAssetResource =\n  | {\n      crossorigin?: StylesheetResource[\"crossorigin\"];\n      href: string;\n      kind: \"stylesheet\";\n      media?: string;\n      precedence?: string;\n    }\n  | {\n      as: string;\n      crossorigin?: PreloadResource[\"crossorigin\"];\n      fetchpriority?: PreloadResource[\"fetchpriority\"];\n      href: string;\n      kind: \"preload\";\n      type?: string;\n    }\n  | {\n      crossorigin?: ModulePreloadResource[\"crossorigin\"];\n      fetchpriority?: ModulePreloadResource[\"fetchpriority\"];\n      href: string;\n      kind: \"modulepreload\";\n    }\n  | {\n      async?: boolean;\n      crossorigin?: ScriptResource[\"crossorigin\"];\n      defer?: boolean;\n      kind: \"script\";\n      module?: boolean;\n      src: string;\n    }\n  | {\n      crossorigin?: FontResource[\"crossorigin\"];\n      fetchpriority?: FontResource[\"fetchpriority\"];\n      href: string;\n      kind: \"font\";\n      type: string;\n    }\n  | {\n      crossorigin?: PreconnectResource[\"crossorigin\"];\n      href: string;\n      kind: \"preconnect\";\n    }\n  | {\n      kind: \"title\";\n      value: TitleResource[\"value\"];\n    }\n  | {\n      charset?: MetaResource[\"charset\"];\n      content?: MetaResource[\"content\"];\n      \"http-equiv\"?: MetaResource[\"http-equiv\"];\n      key?: string;\n      kind: \"meta\";\n      name?: MetaResource[\"name\"];\n      property?: MetaResource[\"property\"];\n    };\n\n/** The `error` row value under the server's `onError` contract. */\nexport interface PayloadErrorValue {\n  digest?: string;\n  message?: string;\n}\n\n/**\n * Semantic payload row before the internal codec turns it into bytes.\n */\nexport type PayloadRow =\n  | { for?: number; tag: \"assets\"; value: SerializedAssetResource[] }\n  | {\n      id: number;\n      tag: \"client\";\n      value: {\n        id: string;\n        assets?: SerializedAssetResource[];\n        exportName?: string;\n        ssr?: true;\n      };\n    }\n  | { tag: \"data\"; value: PayloadDataHydrationEntry[] }\n  | { id: number; tag: \"error\"; value: PayloadErrorValue }\n  | { id: number; tag: \"model\"; value: PayloadModel };\n\n/**\n * Transport-safe model value used inside internal payload rows. This is an\n * implementation format, not an application data format.\n */\nexport type PayloadModel =\n  | null\n  | boolean\n  | number\n  | string\n  | PayloadModel[]\n  | { [key: string]: PayloadModel }\n  | PayloadElementModel\n  | PayloadSpecialModel;\n\nexport type PayloadElementModel = {\n  $fig: \"element\";\n  id?: number;\n  key: Key | null;\n  props: PayloadModel;\n  type: string | PayloadSpecialModel;\n};\n\nexport type PayloadSpecialModel =\n  | { $fig: \"array\"; id: number; value: PayloadModel[] }\n  | { $fig: \"bigint\"; value: string }\n  | { $fig: \"client\"; id: number }\n  | { $fig: \"date\"; value: string }\n  | { $fig: \"fragment\" }\n  | { $fig: \"lazy\"; id: number }\n  | { $fig: \"map\"; entries: Array<[PayloadModel, PayloadModel]>; id: number }\n  | { $fig: \"number\"; value: \"Infinity\" | \"-Infinity\" | \"-0\" | \"NaN\" }\n  | { $fig: \"object\"; id?: number; value: Record<string, PayloadModel> }\n  | { $fig: \"promise\"; id: number }\n  | { $fig: \"ref\"; id: number }\n  | { $fig: \"set\"; id: number; values: PayloadModel[] }\n  | { $fig: \"symbol\"; key: string }\n  | { $fig: \"suspense\" }\n  | { $fig: \"undefined\" }\n  | { $fig: \"view-transition\" };\n\nexport type PayloadValueSpecialModel = Extract<\n  PayloadSpecialModel,\n  {\n    $fig:\n      | \"array\"\n      | \"bigint\"\n      | \"date\"\n      | \"map\"\n      | \"number\"\n      | \"object\"\n      | \"ref\"\n      | \"set\"\n      | \"symbol\"\n      | \"undefined\";\n  }\n>;\n\nexport type PayloadDataHydrationEntry = Omit<FigDataHydrationEntry, \"value\"> & {\n  value: PayloadModel;\n};\n\nexport interface PayloadCodec {\n  /**\n   * Opaque implementation id, e.g. \"json\" or \"binary\". Fig checks this id at\n   * transport boundaries; the encoded byte layout is not a public contract.\n   */\n  readonly id: string;\n  readonly contentType: string;\n  /**\n   * Creates a streaming row decoder. The decoder calls `onRow` for each\n   * complete semantic row. If `onRow` throws, the decoder must propagate that\n   * error; when it can already see more complete sibling rows in the same\n   * input chunk, it should process those siblings before rethrowing so\n   * notifications already implied by earlier rows are not lost.\n   */\n  createDecoder(onRow: (row: PayloadRow) => void): PayloadRowDecoder;\n  encodeRow(row: PayloadRow): Uint8Array;\n}\n\nexport interface PayloadRowDecoder {\n  decode(chunk: Uint8Array): void;\n  flush(): void;\n}\n\nconst textEncoder = new TextEncoder();\n\n/**\n * Readable development-oriented codec: one JSON payload row per newline.\n */\nexport const jsonPayloadCodec: PayloadCodec = {\n  id: \"json\",\n  contentType: \"text/x-fig-payload; codec=json; charset=utf-8\",\n  createDecoder(onRow) {\n    return createJsonPayloadDecoder(onRow);\n  },\n  encodeRow(row) {\n    return textEncoder.encode(`${JSON.stringify(row)}\\n`);\n  },\n};\n\nfunction createJsonPayloadDecoder(\n  onRow: (row: PayloadRow) => void,\n): PayloadRowDecoder {\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let searchStart = 0;\n\n  function processBufferedLines(): void {\n    let lineStart = 0;\n    let firstError: unknown;\n\n    for (;;) {\n      const newlineIndex = buffer.indexOf(\"\\n\", searchStart);\n      if (newlineIndex === -1) {\n        searchStart = buffer.length;\n        break;\n      }\n      try {\n        processPayloadLine(buffer.slice(lineStart, newlineIndex), onRow);\n      } catch (error) {\n        firstError ??= error;\n      }\n      lineStart = newlineIndex + 1;\n      searchStart = lineStart;\n    }\n\n    if (firstError !== undefined) {\n      buffer = \"\";\n      searchStart = 0;\n      throw firstError;\n    }\n    if (lineStart > 0) {\n      buffer = buffer.slice(lineStart);\n      searchStart -= lineStart;\n    }\n  }\n\n  return {\n    decode(chunk) {\n      buffer += decoder.decode(chunk, { stream: true });\n      processBufferedLines();\n    },\n    flush() {\n      buffer += decoder.decode();\n      if (buffer.length > 0) {\n        const line = buffer;\n        buffer = \"\";\n        searchStart = 0;\n        processPayloadLine(line, onRow);\n      }\n    },\n  };\n}\n\nfunction processPayloadLine(\n  line: string,\n  onRow: (row: PayloadRow) => void,\n): void {\n  if (line.length > 0) onRow(JSON.parse(line) as PayloadRow);\n}\n\n/**\n * Extract the codec id from a payload content-type header, or null when the\n * header carries no codec parameter.\n */\nexport function payloadCodecIdFromContentType(\n  contentTypeHeader: string,\n): string | null {\n  const parts = contentTypeHeader.split(\";\").slice(1);\n  for (const part of parts) {\n    const [name, rawValue] = part.split(\"=\");\n    if (name?.trim().toLowerCase() !== \"codec\") continue;\n    const value = rawValue?.trim();\n    if (value === undefined || value.length === 0) return null;\n    return value.replace(/^\"|\"$/g, \"\");\n  }\n  return null;\n}\n\n/**\n * Throw when a response content-type declares a codec other than the one this\n * client decodes with. A missing header or codec parameter passes: transports\n * that strip content types stay usable, and mismatches still fail fast when\n * declared.\n */\nexport function assertPayloadCodecMatches(\n  codec: PayloadCodec,\n  contentTypeHeader: string | null,\n): void {\n  if (contentTypeHeader === null) return;\n  const received = payloadCodecIdFromContentType(contentTypeHeader);\n  if (received === null || received === codec.id) return;\n  throw new Error(\n    `Payload codec mismatch: producer used \"${received}\" but this client expects \"${codec.id}\".`,\n  );\n}\n\n/** Decode an `error` row value into a digest-carrying Error. */\nexport function errorFromPayloadValue(value: PayloadErrorValue): Error & {\n  digest?: string;\n} {\n  const error = new Error(value.message ?? \"The server render failed.\");\n  return value.digest === undefined\n    ? error\n    : Object.assign(error, { digest: value.digest });\n}\n\nexport interface PayloadGraphEncodeContext {\n  // Ids are dense and monotonic: id = position in `defined` + 1, so rollback\n  // is popping the stack. A reverse id→object map would be redundant state.\n  defined: object[];\n  ids: WeakMap<object, number>;\n}\n\ninterface PayloadGraphDecodeContext {\n  decodeChild: (model: PayloadModel) => unknown;\n  refs: PayloadDecodeRefs;\n}\n\nfunction createPayloadGraphDecodeContext(): PayloadGraphDecodeContext {\n  const refs = new Map<number, unknown>();\n  const context: PayloadGraphDecodeContext = {\n    decodeChild: (model) => decodeModelValue(model, context),\n    refs: {\n      define(id, create, fill) {\n        const value = create();\n        refs.set(id, value);\n        fill(value);\n        return value;\n      },\n      read(id) {\n        if (!refs.has(id)) {\n          throw new Error(`Payload referenced unknown object id ${id}.`);\n        }\n        return refs.get(id);\n      },\n    },\n  };\n  return context;\n}\n\nexport function createPayloadGraphEncodeContext(): PayloadGraphEncodeContext {\n  return { defined: [], ids: new WeakMap() };\n}\n\nexport function isPlainPayloadValue(value: unknown): boolean {\n  return (\n    value === null ||\n    value === undefined ||\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\" ||\n    typeof value === \"bigint\" ||\n    typeof value === \"symbol\"\n  );\n}\n\n/**\n * Encode ordinary data values into PayloadModel. Server component references\n * such as Fig elements, promises, and client references are handled by the\n * payload renderer before ordinary values reach this helper.\n */\nexport function encodePayloadValue(value: unknown): PayloadModel {\n  return encodePayloadValueWithGraph(value, createPayloadGraphEncodeContext());\n}\n\nexport function encodePayloadValueWithGraph(\n  value: unknown,\n  graph: PayloadGraphEncodeContext,\n): PayloadModel {\n  if (value === null) return null;\n  if (value === undefined) return { $fig: \"undefined\" };\n\n  if (typeof value === \"string\" || typeof value === \"boolean\") return value;\n  if (typeof value === \"number\") return encodePayloadNumber(value);\n  if (typeof value === \"bigint\") {\n    return { $fig: \"bigint\", value: value.toString() };\n  }\n  if (typeof value === \"symbol\") {\n    const key = Symbol.keyFor(value);\n    if (key === undefined) {\n      throw new Error(\"Only global Symbol.for symbols can be serialized.\");\n    }\n    return { $fig: \"symbol\", key };\n  }\n  if (typeof value === \"function\") {\n    throw new Error(\"Functions cannot be serialized into the payload.\");\n  }\n\n  if (Array.isArray(value)) {\n    return serializePayloadArray(\n      value,\n      graph,\n      () => value,\n      (item) => encodePayloadValueWithGraph(item, graph),\n    );\n  }\n  if (value instanceof Date) {\n    const json = value.toJSON();\n    if (json === null) {\n      throw new Error(\"Invalid Date values cannot be serialized.\");\n    }\n    return { $fig: \"date\", value: json };\n  }\n  if (value instanceof Map) {\n    return serializePayloadMap(value, graph, ([key, item]) => [\n      encodePayloadValueWithGraph(key, graph),\n      encodePayloadValueWithGraph(item, graph),\n    ]);\n  }\n  if (value instanceof Set) {\n    return serializePayloadSet(value, graph, (item) =>\n      encodePayloadValueWithGraph(item, graph),\n    );\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    return serializePayloadPlainObject(value, graph, (child) =>\n      encodePayloadValueWithGraph(child, graph),\n    );\n  }\n\n  throw new Error(`Cannot serialize ${typeof value} into the payload.`);\n}\n\nexport function serializePayloadMap(\n  value: Map<unknown, unknown>,\n  graph: PayloadGraphEncodeContext,\n  encodeEntry: (entry: [unknown, unknown]) => [PayloadModel, PayloadModel],\n): PayloadModel {\n  const existing = payloadGraphReference(graph, value);\n  if (existing !== null) return existing;\n  const id = definePayloadGraphObject(graph, value);\n  const entries: Array<[PayloadModel, PayloadModel]> = [];\n  for (const entry of value) entries.push(encodeEntry(entry));\n  return { $fig: \"map\", id, entries };\n}\n\nexport function serializePayloadSet(\n  value: Set<unknown>,\n  graph: PayloadGraphEncodeContext,\n  encodeItem: (value: unknown) => PayloadModel,\n): PayloadModel {\n  const existing = payloadGraphReference(graph, value);\n  if (existing !== null) return existing;\n  const id = definePayloadGraphObject(graph, value);\n  const values: PayloadModel[] = [];\n  for (const item of value) values.push(encodeItem(item));\n  return { $fig: \"set\", id, values };\n}\n\nfunction payloadGraphReference(\n  graph: PayloadGraphEncodeContext,\n  value: object,\n): PayloadSpecialModel | null {\n  const id = graph.ids.get(value);\n  return id === undefined ? null : { $fig: \"ref\", id };\n}\n\nfunction definePayloadGraphObject(\n  graph: PayloadGraphEncodeContext,\n  value: object,\n): number {\n  graph.defined.push(value);\n  const id = graph.defined.length;\n  graph.ids.set(value, id);\n  return id;\n}\n\nexport function checkpointPayloadGraph(\n  graph: PayloadGraphEncodeContext,\n): number {\n  return graph.defined.length;\n}\n\nexport function rollbackPayloadGraph(\n  graph: PayloadGraphEncodeContext,\n  checkpoint: number,\n): void {\n  while (graph.defined.length > checkpoint) {\n    graph.ids.delete(graph.defined.pop() as object);\n  }\n}\n\nexport function definePayloadGraphElement(\n  graph: PayloadGraphEncodeContext,\n  value: object,\n): number | PayloadSpecialModel {\n  const existing = payloadGraphReference(graph, value);\n  if (existing !== null) return existing;\n  return definePayloadGraphObject(graph, value);\n}\n\nexport function serializePayloadArray<T>(\n  value: object,\n  graph: PayloadGraphEncodeContext,\n  entries: () => readonly T[],\n  encodeChild: (value: T) => PayloadModel,\n): PayloadModel {\n  const existing = payloadGraphReference(graph, value);\n  if (existing !== null) return existing;\n  const id = definePayloadGraphObject(graph, value);\n  return { $fig: \"array\", id, value: entries().map(encodeChild) };\n}\n\nexport function serializePayloadPlainObject(\n  value: object,\n  graph: PayloadGraphEncodeContext,\n  encodeChild: (value: unknown) => PayloadModel,\n): PayloadModel {\n  const existing = payloadGraphReference(graph, value);\n  if (existing !== null) return existing;\n  const id = definePayloadGraphObject(graph, value);\n  return {\n    $fig: \"object\",\n    id,\n    value: encodePayloadRecord(plainPayloadObject(value), encodeChild),\n  };\n}\n\nfunction plainPayloadObject(value: object): Record<string, unknown> {\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) {\n    throw new Error(\n      `Cannot serialize ${prototype?.constructor?.name ?? \"object\"} into the payload.`,\n    );\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction encodePayloadRecord(\n  record: Record<string, unknown>,\n  encodeChild: (value: unknown) => PayloadModel,\n): Record<string, PayloadModel> {\n  const encoded: Record<string, PayloadModel> = {};\n  for (const [name, child] of Object.entries(record)) {\n    encoded[name] = encodeChild(child);\n  }\n  return encoded;\n}\n\nfunction encodePayloadNumber(value: number): number | PayloadSpecialModel {\n  if (Number.isNaN(value)) return { $fig: \"number\", value: \"NaN\" };\n  if (value === Infinity) return { $fig: \"number\", value: \"Infinity\" };\n  if (value === -Infinity) return { $fig: \"number\", value: \"-Infinity\" };\n  if (Object.is(value, -0)) return { $fig: \"number\", value: \"-0\" };\n  return value;\n}\n\n/** Decode values produced by encodePayloadValue. */\nexport function decodePayloadValue(model: PayloadModel): unknown {\n  return decodeModelValue(model, createPayloadGraphDecodeContext());\n}\n\nfunction decodeModelValue(\n  model: PayloadModel,\n  graph: PayloadGraphDecodeContext,\n): unknown {\n  if (model === null) return null;\n  if (Array.isArray(model))\n    return model.map((item) => decodeModelValue(item, graph));\n  if (typeof model !== \"object\") return model;\n\n  if (isPayloadValueSpecialModel(model)) {\n    return decodePayloadValueTag(model, graph.refs, graph.decodeChild);\n  }\n\n  return decodePayloadRecord(model, graph.decodeChild);\n}\n\nexport function isPayloadValueSpecialModel(\n  model: object,\n): model is PayloadValueSpecialModel {\n  if (!(\"$fig\" in model)) return false;\n  const tag = model.$fig;\n  return (\n    tag === \"bigint\" ||\n    tag === \"array\" ||\n    tag === \"date\" ||\n    tag === \"map\" ||\n    tag === \"number\" ||\n    tag === \"object\" ||\n    tag === \"ref\" ||\n    tag === \"set\" ||\n    tag === \"symbol\" ||\n    tag === \"undefined\"\n  );\n}\n\n// The ref-store seam shared by the two decode entry points: the value codec\n// registers into a per-call refs map, while the stream decoder registers into\n// its request-wide chunk-adjacent store (with rollback on failed fills).\nexport interface PayloadDecodeRefs {\n  define<T>(id: number, create: () => T, fill: (value: T) => void): T;\n  read(id: number): unknown;\n}\n\nexport function decodePayloadValueTag(\n  model: PayloadValueSpecialModel,\n  refs: PayloadDecodeRefs,\n  decodeChild: (model: PayloadModel) => unknown,\n): unknown {\n  switch (model.$fig) {\n    case \"array\":\n      return refs.define<unknown[]>(\n        model.id,\n        () => [],\n        (value) => {\n          for (const item of model.value) value.push(decodeChild(item));\n        },\n      );\n    case \"bigint\":\n      return BigInt(model.value);\n    case \"date\":\n      return new Date(model.value);\n    case \"map\":\n      return refs.define(\n        model.id,\n        () => new Map<unknown, unknown>(),\n        (value) => {\n          for (const [key, item] of model.entries) {\n            value.set(decodeChild(key), decodeChild(item));\n          }\n        },\n      );\n    case \"number\":\n      return decodePayloadNumber(model.value);\n    case \"object\": {\n      if (model.id === undefined) {\n        return decodePayloadRecord(model.value, decodeChild);\n      }\n      return refs.define(\n        model.id,\n        () => ({}),\n        (value) => {\n          for (const [name, child] of Object.entries(model.value)) {\n            definePayloadProperty(value, name, decodeChild(child));\n          }\n        },\n      );\n    }\n    case \"ref\":\n      return refs.read(model.id);\n    case \"set\":\n      return refs.define(\n        model.id,\n        () => new Set<unknown>(),\n        (value) => {\n          for (const item of model.values) value.add(decodeChild(item));\n        },\n      );\n    case \"symbol\":\n      return Symbol.for(model.key);\n    case \"undefined\":\n      return undefined;\n  }\n}\n\nexport function decodePayloadRecord(\n  value: Record<string, PayloadModel>,\n  decodeChild: (model: PayloadModel) => unknown,\n): Record<string, unknown> {\n  const decoded: Record<string, unknown> = {};\n  for (const [name, child] of Object.entries(value)) {\n    definePayloadProperty(decoded, name, decodeChild(child));\n  }\n  return decoded;\n}\n\n// \"__proto__\" must go through defineProperty so a hostile payload key defines\n// an own property instead of mutating the prototype chain via the setter\n// path; every other key gets the identical own data property from plain\n// assignment at a fraction of the cost (this is the decode inner loop).\nexport function definePayloadProperty(\n  target: Record<string, unknown>,\n  name: string,\n  value: unknown,\n): void {\n  if (name === \"__proto__\") {\n    Object.defineProperty(target, name, {\n      configurable: true,\n      enumerable: true,\n      value,\n      writable: true,\n    });\n    return;\n  }\n  target[name] = value;\n}\n\nexport function decodePayloadNumber(\n  value: \"Infinity\" | \"-Infinity\" | \"-0\" | \"NaN\",\n): number {\n  switch (value) {\n    case \"Infinity\":\n      return Infinity;\n    case \"-Infinity\":\n      return -Infinity;\n    case \"-0\":\n      return -0;\n    case \"NaN\":\n      return NaN;\n  }\n}\n\nexport function encodePayloadDataEntries(\n  entries: readonly FigDataHydrationEntry[],\n): PayloadDataHydrationEntry[] {\n  const graph = createPayloadGraphEncodeContext();\n  return entries.map((entry) => ({\n    ...entry,\n    value: encodePayloadValueWithGraph(entry.value, graph),\n  }));\n}\n\nexport function decodePayloadDataEntries(\n  entries: readonly PayloadDataHydrationEntry[],\n): FigDataHydrationEntry[] {\n  const graph = createPayloadGraphDecodeContext();\n  return entries.map((entry) => ({\n    ...entry,\n    value: decodeModelValue(entry.value, graph),\n  }));\n}\n\nexport function isPayloadSpecialModel(\n  model: object,\n): model is PayloadElementModel | PayloadSpecialModel {\n  if (!(\"$fig\" in model)) return false;\n\n  switch (model.$fig) {\n    case \"array\":\n    case \"bigint\":\n    case \"client\":\n    case \"date\":\n    case \"element\":\n    case \"fragment\":\n    case \"lazy\":\n    case \"map\":\n    case \"number\":\n    case \"object\":\n    case \"promise\":\n    case \"ref\":\n    case \"set\":\n    case \"suspense\":\n    case \"symbol\":\n    case \"undefined\":\n    case \"view-transition\":\n      return true;\n    default:\n      return false;\n  }\n}\n"],"mappings":"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"}

package/dist/payload.d.ts

@@ -0,0 +1,92 @@
+import { Wt as FigDataHydrationEntry, a as AwaitedFigNode, ct as FigAssetResource, l as ElementType } from "./element-BZ7r9ncY.js";
+//#region src/payload.d.ts
+interface PayloadClientReference {
+  assets?: readonly FigAssetResource[];
+  exportName?: string;
+  id: string;
+  ssr?: boolean;
+}
+type ResolveClientReference = (reference: PayloadClientReference) => ElementType<any> | PromiseLike<ElementType<any>> | undefined;
+/**
+ * A caller-owned stateful resolver: a `ResolveClientReference` that also
+ * owns component identity. Decodes given one (as `resolveClientReference`)
+ * resolve every client reference to a single resolver-owned wrapper per
+ * reference id, so re-decoding a payload updates islands in place instead
+ * of remounting them. The caller owns the lifetime: drop entries when their
+ * modules change (HMR) or the manifest swaps.
+ */
+interface PayloadClientReferenceResolver {
+  (reference: PayloadClientReference): ElementType<any> | PromiseLike<ElementType<any>> | undefined;
+  clear(): void;
+  delete(id: string): boolean;
+}
+declare function createPayloadClientReferenceResolver(resolve: ResolveClientReference): PayloadClientReferenceResolver;
+type PayloadDecodeCompletion = {
+  status: "aborted";
+} | {
+  status: "complete";
+} | {
+  status: "failed";
+  error: unknown;
+};
+interface PayloadDecodeOptions {
+  /**
+   * Receives decoded `data` rows for hydration into a data store. The
+   * capability itself is expected to be generation-guarded and to ignore
+   * entries after its caller loses authority.
+   */
+  hydrate?: (entries: readonly FigDataHydrationEntry[]) => void;
+  /**
+   * Observes every outlined hole rejection — an `error` row or a stream
+   * failure stranding referenced rows, before or after the root fulfills.
+   * Abort cancellation is excluded. Called once per rejected hole; the
+   * observer is never awaited and cannot break decoding.
+   */
+  onHoleError?: (error: unknown) => unknown;
+  /**
+   * Observes the end of ingestion: called exactly once when the stream
+   * settles as complete, failed, or aborted. Post-root failures reject the
+   * holes they strand, but a failure with no pending slot is otherwise
+   * invisible — this is the hook for reporting it. The callback is never
+   * awaited, and its exceptions and rejections are swallowed, so an
+   * observer cannot block or break decode teardown.
+   */
+  onStreamDone?: (result: PayloadDecodeCompletion) => unknown;
+  /**
+   * Called with delivery asset resources as soon as their rows arrive
+   * (e.g. fig-dom's insertAssetResources). A returned promise gates the
+   * reveal of only the content that declared a dependency on those assets;
+   * gate settlement — fulfilled or rejected — releases the reveal, so a
+   * failed asset never blocks content.
+   */
+  prepareAssets?: (assets: readonly FigAssetResource[]) => void | PromiseLike<void>;
+  /**
+   * Retains delivery asset dependencies as `assets(...)` declarations on
+   * their decoded owners. Document metadata is always retained because its
+   * owner may mutate the document only when it commits. Server document
+   * renderers enable this option to retain delivery assets too.
+   */
+  retainAssets?: boolean;
+  /**
+   * Resolves client-reference rows to components. A plain function keeps
+   * identity per decode: gated and asynchronously resolved references decode
+   * to per-decode wrappers and remount on re-decode. A stateful resolver
+   * (created by `createPayloadClientReferenceResolver`) keeps every
+   * resolvable reference's identity stable across the decodes sharing it.
+   */
+  resolveClientReference?: ResolveClientReference;
+  signal?: AbortSignal;
+}
+/**
+ * Decode a payload row stream. The returned promise resolves with the
+ * decoded root FigNode as soon as the root row decodes (and rejects only
+ * when the stream fails before producing a root value, or with the root
+ * row's own error); decoding continues in the background, filling outlined
+ * holes as their rows arrive. Post-root failures reject the holes they
+ * strand and report through `onStreamDone`. Aborting `options.signal`
+ * ignores remaining rows and rejects unresolved holes with an internal
+ * cancellation reason.
+ */
+declare function decodePayloadStream(stream: ReadableStream<Uint8Array>, options?: PayloadDecodeOptions): Promise<AwaitedFigNode>;
+//#endregion
+export { PayloadClientReference, PayloadClientReferenceResolver, PayloadDecodeCompletion, PayloadDecodeOptions, ResolveClientReference, createPayloadClientReferenceResolver, decodePayloadStream };

package/dist/payload.js

@@ -0,0 +1,429 @@
+import { I as readPromise, f as Fragment, g as createElement, m as ViewTransition, p as Suspense, s as FigElementSymbol } from "./element-DmbzNH0T.js";
+import { b as trackThenable, l as isFigAssetResource, o as assets, t as assetResourceDestination, v as isThenable } from "./resource-kXeIR52S.js";
+import { a as decodePayloadRecord, f as errorFromPayloadValue, h as jsonPayloadCodec, i as decodePayloadDataEntries, p as isPayloadSpecialModel, s as decodePayloadValueTag } from "./payload-format-KTNaSI4h.js";
+//#region src/payload.ts
+const resolverEntries = /* @__PURE__ */ new WeakMap();
+function createPayloadClientReferenceResolver(resolve) {
+	const entries = /* @__PURE__ */ new Map();
+	const resolver = Object.assign((reference) => resolve(reference), {
+		clear: () => entries.clear(),
+		delete: (id) => entries.delete(id)
+	});
+	resolverEntries.set(resolver, entries);
+	return resolver;
+}
+const elementGates = /* @__PURE__ */ new WeakMap();
+const elementAssets = /* @__PURE__ */ new WeakMap();
+var PayloadDecodeAbortedError = class extends Error {
+	constructor(reason) {
+		super("Payload decode aborted.", reason === void 0 ? void 0 : { cause: reason });
+		this.name = "PayloadDecodeAbortedError";
+	}
+};
+/**
+* Decode a payload row stream. The returned promise resolves with the
+* decoded root FigNode as soon as the root row decodes (and rejects only
+* when the stream fails before producing a root value, or with the root
+* row's own error); decoding continues in the background, filling outlined
+* holes as their rows arrive. Post-root failures reject the holes they
+* strand and report through `onStreamDone`. Aborting `options.signal`
+* ignores remaining rows and rejects unresolved holes with an internal
+* cancellation reason.
+*/
+function decodePayloadStream(stream, options = {}) {
+	return new PayloadStreamDecode(stream, options).value;
+}
+const noop = () => void 0;
+function deferred() {
+	let resolve = noop;
+	let reject = noop;
+	return {
+		promise: new Promise((innerResolve, innerReject) => {
+			resolve = innerResolve;
+			reject = innerReject;
+		}),
+		reject,
+		resolve
+	};
+}
+function decodeAssetResources(serialized) {
+	if (serialized === void 0) return null;
+	const assets = serialized.filter(isFigAssetResource);
+	return assets.length === 0 ? null : assets;
+}
+var PayloadStreamDecode = class {
+	options;
+	value;
+	chunks = /* @__PURE__ */ new Map();
+	objectRefs = /* @__PURE__ */ new Map();
+	rowGates = /* @__PURE__ */ new Map();
+	rowAssets = /* @__PURE__ */ new Map();
+	clientRowGates = /* @__PURE__ */ new Map();
+	clientRowAssets = /* @__PURE__ */ new Map();
+	rowDecoder;
+	reader = null;
+	done = false;
+	gateRelease = deferred();
+	removeAbortListener = noop;
+	decodeChild = (model) => this.decodeModel(model);
+	valueRefs = {
+		define: (id, create, fill) => this.defineObjectRef(id, create, fill),
+		read: (id) => {
+			if (!this.objectRefs.has(id)) throw new Error(`Payload referenced unknown object id ${id}.`);
+			return this.objectRefs.get(id);
+		}
+	};
+	constructor(stream, options) {
+		this.options = options;
+		this.rowDecoder = jsonPayloadCodec.createDecoder((row) => this.handleRow(row));
+		this.value = this.chunkPromise(this.getChunk(0));
+		this.ingest(stream);
+		const signal = options.signal;
+		if (signal !== void 0) if (signal.aborted) this.abort(signal.reason);
+		else {
+			const onAbort = () => this.abort(signal.reason);
+			signal.addEventListener("abort", onAbort, { once: true });
+			this.removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+		}
+	}
+	abort(reason) {
+		if (this.done) return;
+		const error = new PayloadDecodeAbortedError(reason);
+		this.gateRelease.resolve(void 0);
+		this.reader?.cancel(error).catch(noop);
+		this.rejectUnresolved(error);
+		this.settle({ status: "aborted" });
+	}
+	async ingest(stream) {
+		const reader = stream.getReader();
+		this.reader = reader;
+		try {
+			for (;;) {
+				const { done, value } = await reader.read();
+				if (this.done) return;
+				if (done) break;
+				this.rowDecoder.decode(value);
+			}
+			this.rowDecoder.flush();
+			this.finishIngestion();
+		} catch (error) {
+			if (this.done) return;
+			reader.cancel(error).catch(noop);
+			this.failIngestion(error);
+		}
+	}
+	finishIngestion() {
+		let truncated = false;
+		for (const chunk of this.chunks.values()) if (!chunk.arrived) {
+			truncated = true;
+			break;
+		}
+		if (truncated) {
+			this.failIngestion(/* @__PURE__ */ new Error("Payload stream ended before all referenced rows arrived."));
+			return;
+		}
+		this.settle({ status: "complete" });
+	}
+	failIngestion(error) {
+		if (this.done) return;
+		this.rejectUnresolved(error);
+		this.settle({
+			status: "failed",
+			error
+		});
+	}
+	rejectUnresolved(error) {
+		for (const chunk of this.chunks.values()) {
+			if (chunk.arrived) continue;
+			chunk.arrived = true;
+			this.rejectChunk(chunk, error);
+		}
+	}
+	settle(result) {
+		if (this.done) return;
+		this.done = true;
+		this.removeAbortListener();
+		try {
+			const observed = this.options.onStreamDone?.(result);
+			if (isThenable(observed)) Promise.resolve(observed).then(noop, noop);
+		} catch {}
+	}
+	handleRow(row) {
+		if (this.done) return;
+		switch (row.tag) {
+			case "model": {
+				const chunk = this.getChunk(row.id);
+				let decoded = this.decodeModel(row.value);
+				const retainedAssets = this.rowAssets.get(row.id);
+				if (retainedAssets !== void 0) {
+					this.rowAssets.delete(row.id);
+					decoded = assets(retainedAssets, decoded);
+				}
+				chunk.arrived = true;
+				const gates = this.rowGates.get(row.id);
+				if (gates === void 0) {
+					this.fulfillChunk(chunk, decoded);
+					return;
+				}
+				this.rowGates.delete(row.id);
+				Promise.race([Promise.all(gates), this.gateRelease.promise]).then(() => this.fulfillChunk(chunk, decoded));
+				return;
+			}
+			case "client": {
+				const chunk = this.getChunk(row.id);
+				const reference = { id: row.value.id };
+				if (row.value.exportName !== void 0) reference.exportName = row.value.exportName;
+				if (row.value.ssr === true) reference.ssr = true;
+				const assets = decodeAssetResources(row.value.assets);
+				if (assets !== null) reference.assets = assets;
+				const retainedAssets = this.retainedAssets(assets);
+				if (retainedAssets !== null) this.clientRowAssets.set(row.id, retainedAssets);
+				const gate = this.prepareAssets(assets);
+				if (gate !== null) {
+					trackThenable(gate);
+					this.clientRowGates.set(row.id, gate);
+					gate.then(() => {
+						this.clientRowGates.delete(row.id);
+					});
+				}
+				const component = this.clientReferenceComponent(reference, gate, retainedAssets !== null);
+				chunk.arrived = true;
+				this.fulfillChunk(chunk, component);
+				return;
+			}
+			case "error": {
+				const chunk = this.getChunk(row.id);
+				chunk.arrived = true;
+				this.rowGates.delete(row.id);
+				this.rowAssets.delete(row.id);
+				this.rejectChunk(chunk, errorFromPayloadValue(row.value));
+				return;
+			}
+			case "data": {
+				const hydrate = this.options.hydrate;
+				if (hydrate === void 0) return;
+				hydrate(decodePayloadDataEntries(row.value));
+				return;
+			}
+			case "assets": {
+				const decodedAssets = decodeAssetResources(row.value);
+				const retainedAssets = this.retainedAssets(decodedAssets);
+				if (retainedAssets !== null && row.for !== void 0) {
+					const retained = this.rowAssets.get(row.for);
+					this.rowAssets.set(row.for, retained === void 0 ? retainedAssets : [...retained, ...retainedAssets]);
+				}
+				const gate = this.prepareAssets(decodedAssets);
+				if (gate === null || row.for === void 0) return;
+				const gates = this.rowGates.get(row.for);
+				if (gates === void 0) this.rowGates.set(row.for, [gate]);
+				else gates.push(gate);
+				return;
+			}
+		}
+	}
+	prepareAssets(assets) {
+		const prepare = this.options.prepareAssets;
+		if (prepare === void 0 || assets === null) return null;
+		const delivery = assets.filter((resource) => assetResourceDestination(resource) === "stream");
+		if (delivery.length === 0) return null;
+		let result;
+		try {
+			result = prepare(delivery);
+		} catch {
+			return null;
+		}
+		if (!isThenable(result)) return null;
+		const gate = Promise.resolve(result).then(noop, noop);
+		trackThenable(gate);
+		return gate;
+	}
+	retainedAssets(assets) {
+		if (assets === null) return null;
+		const retained = this.options.retainAssets === true ? assets : assets.filter((resource) => assetResourceDestination(resource) === "head");
+		return retained.length === 0 ? null : retained;
+	}
+	clientReferenceComponent(reference, gate, retainsAssets) {
+		const resolve = this.options.resolveClientReference;
+		const entries = resolve === void 0 ? void 0 : resolverEntries.get(resolve);
+		const existing = entries?.get(reference.id);
+		if (existing !== void 0) return existing;
+		let resolved;
+		try {
+			resolved = resolve?.(reference);
+		} catch (error) {
+			resolved = Promise.reject(error);
+		}
+		if (resolved === void 0) return function PayloadUnresolvedClientComponent() {
+			throw new Error(`Cannot render client reference "${reference.id}" because decodePayloadStream was not configured with a matching resolveClientReference.`);
+		};
+		if (entries === void 0 && gate === null && !isThenable(resolved) && !retainsAssets) return resolved;
+		const component = clientReferenceWrapper(resolved, reference.id);
+		entries?.set(reference.id, component);
+		return component;
+	}
+	getChunk(id) {
+		const existing = this.chunks.get(id);
+		if (existing !== void 0) return existing;
+		const chunk = {
+			arrived: false,
+			deferred: null,
+			id,
+			promise: null,
+			result: { status: "pending" }
+		};
+		this.chunks.set(id, chunk);
+		return chunk;
+	}
+	chunkPromise(chunk) {
+		if (chunk.promise !== null) return chunk.promise;
+		if (chunk.result.status === "fulfilled") chunk.promise = Promise.resolve(chunk.result.value);
+		else if (chunk.result.status === "rejected") {
+			chunk.promise = Promise.reject(chunk.result.error);
+			chunk.promise.catch(noop);
+		} else {
+			chunk.deferred = deferred();
+			chunk.promise = chunk.deferred.promise;
+		}
+		trackThenable(chunk.promise);
+		return chunk.promise;
+	}
+	fulfillChunk(chunk, value) {
+		if (chunk.result.status !== "pending") return;
+		chunk.result = {
+			status: "fulfilled",
+			value
+		};
+		chunk.deferred?.resolve(value);
+	}
+	rejectChunk(chunk, error) {
+		if (chunk.result.status !== "pending") return;
+		chunk.result = {
+			error,
+			status: "rejected"
+		};
+		if (chunk.deferred !== null) {
+			chunk.deferred.reject(error);
+			chunk.promise?.catch(noop);
+		}
+		if (chunk.id !== 0 && !(error instanceof PayloadDecodeAbortedError)) this.observeHoleError(error);
+	}
+	observeHoleError(error) {
+		try {
+			const observed = this.options.onHoleError?.(error);
+			if (isThenable(observed)) Promise.resolve(observed).then(noop, noop);
+		} catch {}
+	}
+	readChunkForRender(id) {
+		const chunk = this.getChunk(id);
+		if (chunk.result.status === "rejected") throw chunk.result.error;
+		if (chunk.result.status === "pending") return readPromise(this.chunkPromise(chunk));
+		return chunk.result.value;
+	}
+	decodeModel(model) {
+		if (model === null) return null;
+		if (Array.isArray(model)) return model.map(this.decodeChild);
+		if (typeof model !== "object") return model;
+		if (isPayloadSpecialModel(model)) return this.decodeSpecialModel(model);
+		return decodePayloadRecord(model, this.decodeChild);
+	}
+	decodeSpecialModel(model) {
+		switch (model.$fig) {
+			case "element": {
+				if (model.id !== void 0) return this.defineObjectRef(model.id, () => ({
+					$$typeof: FigElementSymbol,
+					key: model.key,
+					props: {},
+					type: Fragment
+				}), (element) => {
+					element.type = this.decodeElementType(model.type);
+					const props = this.decodeModel(model.props);
+					element.props = props;
+					this.attachElementDelivery(model.type, props);
+				});
+				const type = this.decodeElementType(model.type);
+				const props = this.decodeModel(model.props);
+				if (model.key !== null) props.key = model.key;
+				const element = createElement(type, props);
+				this.attachElementDelivery(model.type, element.props);
+				return element;
+			}
+			case "client": {
+				const chunk = this.chunks.get(model.id);
+				if (chunk === void 0 || chunk.result.status !== "fulfilled") throw new Error(`Payload model referenced client row ${model.id} before it arrived.`);
+				return chunk.result.value;
+			}
+			case "fragment": return Fragment;
+			case "lazy":
+				this.getChunk(model.id);
+				return createElement(PayloadStreamHole, {
+					decode: this,
+					id: model.id
+				});
+			case "promise": return this.chunkPromise(this.getChunk(model.id));
+			case "suspense": return Suspense;
+			case "view-transition": return ViewTransition;
+			default: return decodePayloadValueTag(model, this.valueRefs, this.decodeChild);
+		}
+	}
+	decodeElementType(type) {
+		if (typeof type === "string") return type;
+		return this.decodeSpecialModel(type);
+	}
+	attachElementDelivery(typeModel, props) {
+		if (typeof typeModel === "string" || typeModel.$fig !== "client") return;
+		const gate = this.clientRowGates.get(typeModel.id);
+		if (gate !== void 0) elementGates.set(props, gate);
+		const assets = this.clientRowAssets.get(typeModel.id);
+		if (assets !== void 0) elementAssets.set(props, assets);
+	}
+	defineObjectRef(id, create, fill) {
+		if (this.objectRefs.has(id)) return this.objectRefs.get(id);
+		const value = create();
+		this.objectRefs.set(id, value);
+		try {
+			fill(value);
+			return value;
+		} catch (error) {
+			this.objectRefs.delete(id);
+			throw error;
+		}
+	}
+};
+function PayloadStreamHole(props) {
+	return props.decode.readChunkForRender(props.id);
+}
+function clientReferenceWrapper(resolved, referenceId) {
+	let render;
+	if (!isThenable(resolved)) render = (props) => createElement(resolved, props);
+	else {
+		const pending = Promise.resolve(resolved);
+		trackThenable(pending);
+		let type = null;
+		render = (props) => {
+			if (type === null) type = clientReferenceType(readPromise(pending), referenceId);
+			return createElement(type, props);
+		};
+	}
+	function PayloadClientContent(content) {
+		if (content.gate !== void 0) readPromise(content.gate);
+		return render(content.props);
+	}
+	return function PayloadClientComponent(props) {
+		return attachElementAssets(props, createElement(PayloadClientContent, {
+			gate: elementGates.get(props),
+			props
+		}));
+	};
+}
+function attachElementAssets(props, node) {
+	const resources = elementAssets.get(props);
+	return resources === void 0 ? node : assets(resources, node);
+}
+function clientReferenceType(value, id) {
+	if (typeof value === "function") return value;
+	throw new Error(`Client reference "${id}" did not resolve to a component.`);
+}
+//#endregion
+export { createPayloadClientReferenceResolver, decodePayloadStream };
+
+//# sourceMappingURL=payload.js.map