@marktiderman/genesis-core 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +27 -0
  2. package/dist/{chunk-PSFKIG27.js → chunk-2K4747KX.js} +7 -4
  3. package/dist/chunk-2K4747KX.js.map +1 -0
  4. package/dist/{chunk-ZYJUEJ4Z.js → chunk-4PTQYT5J.js} +11 -5
  5. package/dist/chunk-4PTQYT5J.js.map +1 -0
  6. package/dist/{chunk-HBAPYA5K.js → chunk-5ASUMG6K.js} +3 -3
  7. package/dist/{chunk-HBAPYA5K.js.map → chunk-5ASUMG6K.js.map} +1 -1
  8. package/dist/{chunk-AKF2RAGX.js → chunk-AHFIS42U.js} +6 -6
  9. package/dist/{chunk-AKF2RAGX.js.map → chunk-AHFIS42U.js.map} +1 -1
  10. package/dist/{chunk-VJGU6E4U.js → chunk-DFABPMEQ.js} +13 -9
  11. package/dist/chunk-DFABPMEQ.js.map +1 -0
  12. package/dist/{chunk-POMTRNAL.js → chunk-G6GQPXQS.js} +4 -4
  13. package/dist/{chunk-POMTRNAL.js.map → chunk-G6GQPXQS.js.map} +1 -1
  14. package/dist/{chunk-ZHC3MDCS.js → chunk-JN47G4UE.js} +25 -16
  15. package/dist/chunk-JN47G4UE.js.map +1 -0
  16. package/dist/{chunk-2VJQVAJD.js → chunk-KA3BUJ4H.js} +3 -3
  17. package/dist/{chunk-2VJQVAJD.js.map → chunk-KA3BUJ4H.js.map} +1 -1
  18. package/dist/{chunk-2WS4LGYU.js → chunk-LKRJB632.js} +3 -3
  19. package/dist/{chunk-2WS4LGYU.js.map → chunk-LKRJB632.js.map} +1 -1
  20. package/dist/{chunk-LOJGHR5O.js → chunk-NE2D74BP.js} +4 -4
  21. package/dist/{chunk-LOJGHR5O.js.map → chunk-NE2D74BP.js.map} +1 -1
  22. package/dist/{chunk-VFT6QKZW.js → chunk-NOPS5EIH.js} +3 -3
  23. package/dist/{chunk-VFT6QKZW.js.map → chunk-NOPS5EIH.js.map} +1 -1
  24. package/dist/{chunk-52T2EYXH.js → chunk-NQFIAULD.js} +3 -3
  25. package/dist/{chunk-52T2EYXH.js.map → chunk-NQFIAULD.js.map} +1 -1
  26. package/dist/{chunk-3B5O36DU.js → chunk-OYDJGPDY.js} +7 -7
  27. package/dist/{chunk-3B5O36DU.js.map → chunk-OYDJGPDY.js.map} +1 -1
  28. package/dist/{chunk-OC4OGB2K.js → chunk-P3FHXRS2.js} +9 -6
  29. package/dist/chunk-P3FHXRS2.js.map +1 -0
  30. package/dist/{chunk-YNXLPOAB.js → chunk-RFHUOXZC.js} +4 -4
  31. package/dist/{chunk-YNXLPOAB.js.map → chunk-RFHUOXZC.js.map} +1 -1
  32. package/dist/{chunk-XVRIWP7B.js → chunk-S2VYJWB4.js} +3 -3
  33. package/dist/{chunk-XVRIWP7B.js.map → chunk-S2VYJWB4.js.map} +1 -1
  34. package/dist/chunk-SDAJSJNN.js +85 -0
  35. package/dist/chunk-SDAJSJNN.js.map +1 -0
  36. package/dist/{chunk-42QPCDQF.js → chunk-WDPM5TBO.js} +3 -3
  37. package/dist/{chunk-42QPCDQF.js.map → chunk-WDPM5TBO.js.map} +1 -1
  38. package/dist/{chunk-LG6TUBVM.js → chunk-WLDSIQJ2.js} +4 -3
  39. package/dist/chunk-WLDSIQJ2.js.map +1 -0
  40. package/dist/{chunk-YQBWXG2G.js → chunk-YZV3Z6ZA.js} +3 -3
  41. package/dist/{chunk-YQBWXG2G.js.map → chunk-YZV3Z6ZA.js.map} +1 -1
  42. package/dist/conversation/index.d.ts +13 -2
  43. package/dist/conversation/index.js +7 -2
  44. package/dist/conversation/index.js.map +1 -1
  45. package/dist/csv.d.ts +1 -1
  46. package/dist/errors.js +2 -2
  47. package/dist/form-types.d.ts +1 -1
  48. package/dist/hooks/draft-controller.js +2 -2
  49. package/dist/hooks/index.d.ts +2 -1
  50. package/dist/hooks/index.js +19 -18
  51. package/dist/hooks/mutation-mode.d.ts +1 -1
  52. package/dist/hooks/mutation-mode.js +6 -6
  53. package/dist/hooks/related-keys.d.ts +1 -1
  54. package/dist/hooks/use-capabilities.d.ts +1 -1
  55. package/dist/hooks/use-capabilities.js +3 -3
  56. package/dist/hooks/use-draft.js +3 -3
  57. package/dist/hooks/use-infinite-resource.d.ts +1 -1
  58. package/dist/hooks/use-infinite-resource.js +4 -4
  59. package/dist/hooks/use-link-options.d.ts +2 -1
  60. package/dist/hooks/use-link-options.js +6 -6
  61. package/dist/hooks/use-live.d.ts +1 -1
  62. package/dist/hooks/use-live.js +3 -3
  63. package/dist/hooks/use-one.d.ts +1 -1
  64. package/dist/hooks/use-one.js +4 -4
  65. package/dist/hooks/use-persisted-ui-state.d.ts +12 -0
  66. package/dist/hooks/use-persisted-ui-state.js +5 -0
  67. package/dist/hooks/use-persisted-ui-state.js.map +1 -0
  68. package/dist/hooks/use-relation-label.d.ts +1 -1
  69. package/dist/hooks/use-relation-label.js +3 -3
  70. package/dist/hooks/use-resource-form.d.ts +1 -1
  71. package/dist/hooks/use-resource-form.js +10 -10
  72. package/dist/hooks/use-resource.d.ts +1 -1
  73. package/dist/hooks/use-resource.js +8 -8
  74. package/dist/hooks/use-write.d.ts +1 -1
  75. package/dist/hooks/use-write.js +2 -2
  76. package/dist/index.d.ts +4 -3
  77. package/dist/index.js +20 -19
  78. package/dist/navigation.d.ts +18 -1
  79. package/dist/navigation.js +7 -1
  80. package/dist/navigation.js.map +1 -1
  81. package/dist/provider/index.d.ts +4 -4
  82. package/dist/provider/index.js +5 -5
  83. package/dist/resource-view/index.d.ts +9 -2
  84. package/dist/resource-view/index.js +13 -4
  85. package/dist/resource-view/index.js.map +1 -1
  86. package/dist/schema/index.d.ts +3 -3
  87. package/dist/schema/index.js +2 -2
  88. package/dist/storage/index.js +1 -1
  89. package/dist/testing/index.d.ts +2 -2
  90. package/dist/testing/index.js +1 -1
  91. package/dist/{types-BzLv8yOm.d.ts → types-CtJxwoyv.d.ts} +6 -0
  92. package/dist/{write-outcome-DC5hORz-.d.ts → write-outcome-Goy1v39G.d.ts} +4 -2
  93. package/package.json +1 -1
  94. package/dist/chunk-LG6TUBVM.js.map +0 -1
  95. package/dist/chunk-OC4OGB2K.js.map +0 -1
  96. package/dist/chunk-PSFKIG27.js.map +0 -1
  97. package/dist/chunk-VJGU6E4U.js.map +0 -1
  98. package/dist/chunk-ZHC3MDCS.js.map +0 -1
  99. package/dist/chunk-ZYJUEJ4Z.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-relation-label.ts"],"names":[],"mappings":"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","file":"chunk-42QPCDQF.js","sourcesContent":["// A link's words: the linked row's name in place of its id (docs/RESOURCE-VIEW.md, \"Relation\n// labels\"). Every cell asks for its own id, and the ids asked for in the same moment go out as\n// one `in` query per linked resource, so a page of 50 rows costs one request, never 50.\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { DataProvider, Identifier } from \"../provider/types\";\nimport type { FieldReference } from \"../schema/types\";\n\nexport interface UseRelationLabelOptions {\n /** The linked row's field that names it. Default: the linked resource's `labelField` (`describe`). */\n labelField?: string;\n /** Default `true`. */\n enabled?: boolean;\n}\n\n// Ids per request: an `in` list stays well inside a URL.\nconst CHUNK = 100;\n// Field names only go into `select`, so nothing else rides along in the request.\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n// What names a row when nothing says (as `defineView` guesses a contract's labelField).\nconst NAMING = /^(name|title|label|full_name|display_name)$/;\n\ntype Waiter = { resolve: (label: string | null) => void; reject: (error: unknown) => void };\n// Keyed by the id's type and text, so 1 and \"1\" are both sent as given: a provider that compares\n// strictly (the mock's `in`) must get a number as a number. Rows match by text either way, since\n// a database may hand back 1 for \"1\".\ntype Asked = { id: Identifier; waiters: Waiter[] };\ntype Batch = { reference: FieldReference; labelField: string | undefined; ids: Map<string, Asked> };\n\n// Per provider, so two providers (two apps, a test each) never share a batch or a guess.\nconst batches = new WeakMap<DataProvider, Map<string, Batch>>();\nconst namers = new WeakMap<DataProvider, Map<string, Promise<string | undefined>>>();\n// How long a label waits on `describe` or `capabilities` before going on without them.\nconst SETTLE_MS = 10_000;\n\n/** A promise's value, or `fallback` when it fails, throws or takes longer than SETTLE_MS. */\nfunction within<T>(work: () => Promise<T>, fallback: T): Promise<T> {\n return new Promise<T>((resolve) => {\n const timer = setTimeout(() => resolve(fallback), SETTLE_MS);\n const done = (value: T) => {\n clearTimeout(timer);\n resolve(value);\n };\n try {\n work().then(done, () => done(fallback));\n } catch {\n done(fallback);\n }\n });\n}\n\n/**\n * The linked resource's naming field, from `describe` once per resource; undefined when it can't\n * say. A failed `describe` isn't remembered, so the next page asks again.\n */\nfunction namingField(provider: DataProvider, resource: string): Promise<string | undefined> {\n let known = namers.get(provider);\n if (!known) namers.set(provider, (known = new Map()));\n let found = known.get(resource);\n if (!found) {\n const describe = provider.describe?.bind(provider);\n const table = known;\n found = describe\n ? within(\n () =>\n describe(resource).then((schema) => schema.labelField ?? schema.fields.find((f) => NAMING.test(f.name))?.name ?? null),\n undefined as string | null | undefined,\n ).then((field) => {\n // undefined: describe failed. null: it answered, with no naming field.\n if (field === undefined) table.delete(resource);\n return field ?? undefined;\n })\n : Promise.resolve(undefined);\n known.set(resource, found);\n }\n return found;\n}\n\n/**\n * The linked resource's naming field, as a link's words find it: its `labelField` from\n * `describe`, else a `name`/`title`-like field. Undefined when it can't say. Asked once per\n * resource and provider; a picker uses it to search and sort the rows it lists.\n */\nexport function relationNamingField(provider: DataProvider, resource: string): Promise<string | undefined> {\n return namingField(provider, resource);\n}\n\n/** Ids per request: the provider's page limit, at most CHUNK. */\nasync function chunkSize(provider: DataProvider, resource: string): Promise<number> {\n const capabilities = provider.capabilities?.bind(provider);\n const max = capabilities ? await within(() => capabilities(resource).then((c) => c.maxPerPage), undefined) : undefined;\n return typeof max === \"number\" && max >= 1 ? Math.min(CHUNK, Math.floor(max)) : CHUNK;\n}\n\n/** A value as words, or null when it has none. */\nfunction words(value: unknown): string | null {\n if (typeof value === \"number\" && Number.isFinite(value)) return String(value);\n if (typeof value !== \"string\") return null;\n return value.trim() || null;\n}\n\nasync function flush(provider: DataProvider, batch: Batch): Promise<void> {\n const { reference, ids } = batch;\n const fail = (keys: readonly string[], error: unknown) => keys.forEach((k) => ids.get(k)?.waiters.forEach((w) => w.reject(error)));\n const all = [...ids.keys()];\n let labelField: string | undefined;\n let size: number;\n try {\n labelField = batch.labelField ?? (await namingField(provider, reference.resource));\n if (labelField !== undefined && !IDENTIFIER.test(labelField)) labelField = undefined;\n size = await chunkSize(provider, reference.resource);\n } catch (error) {\n // Every waiter settles, whatever went wrong.\n fail(all, error);\n return;\n }\n const select = labelField && IDENTIFIER.test(reference.field) ? `${reference.field},${labelField}` : undefined;\n for (let i = 0; i < all.length; i += size) {\n const chunk = all.slice(i, i + size);\n try {\n const { data } = await provider.getList(reference.resource, {\n // The whole page: a link to a field that isn't unique can match more rows than ids.\n pagination: { page: 1, perPage: size },\n filters: [{ field: reference.field, operator: \"in\", value: chunk.map((k) => ids.get(k)!.id) as string[] | number[] }],\n count: \"none\",\n ...(select ? { select } : {}),\n });\n const found = new Map<string, string | null>();\n for (const row of data as Record<string, unknown>[]) {\n const key = String(row[reference.field]);\n if (found.get(key)) continue;\n const name = labelField ? row[labelField] : row[Object.keys(row).find((k) => NAMING.test(k)) ?? \"\"];\n found.set(key, words(name));\n }\n // An id the viewer can't see, or one that's gone, has no words.\n for (const k of chunk) {\n const asked = ids.get(k);\n asked?.waiters.forEach((w) => w.resolve(found.get(String(asked.id)) ?? null));\n }\n } catch (error) {\n fail(chunk, error);\n }\n }\n}\n\n/**\n * The words for one linked id, batched with every other id asked for in the same tick: one\n * `getList(resource, { filters: [{ field, operator: \"in\" }] })` per linked resource and naming\n * field. Resolves null when the row has no words or isn't visible to this viewer.\n */\nexport function loadRelationLabel(\n provider: DataProvider,\n reference: FieldReference,\n id: Identifier,\n labelField?: string,\n): Promise<string | null> {\n let pending = batches.get(provider);\n if (!pending) batches.set(provider, (pending = new Map()));\n const key = `${reference.resource}\\u0000${reference.field}\\u0000${labelField ?? \"\"}`;\n let batch = pending.get(key);\n if (!batch) {\n const created: Batch = { reference, labelField, ids: new Map() };\n pending.set(key, (batch = created));\n // A macrotask, not a microtask: every cell's effect in a commit has asked by then.\n setTimeout(() => {\n pending!.delete(key);\n void flush(provider, created);\n }, 0);\n }\n return new Promise((resolve, reject) => {\n const idKey = `${typeof id}:${String(id)}`;\n const asked = batch!.ids.get(idKey) ?? { id, waiters: [] };\n asked.waiters.push({ resolve, reject });\n batch!.ids.set(idKey, asked);\n });\n}\n\n/**\n * A linked row's words for a `relation` cell: `undefined` while they load, `null` when there are\n * none (the row is hidden from this viewer, gone, unnamed, or the read failed), so a screen shows\n * its own words then, never the raw id. Cached per id for a minute and refreshed when the linked\n * resource changes (its writes invalidate `[resource]`).\n */\nexport function useRelationLabel(\n reference: FieldReference | undefined,\n id: unknown,\n options: UseRelationLabelOptions = {},\n): string | null | undefined {\n const provider = useDataProvider();\n const { labelField, enabled = true } = options;\n const linked: Identifier | null = typeof id === \"string\" || (typeof id === \"number\" && Number.isFinite(id)) ? id : null;\n const key = linked === null ? null : `${typeof linked}:${String(linked)}`;\n const query = useQuery({\n queryKey: [reference?.resource, \"relation-label\", { field: reference?.field, labelField: labelField ?? null, id: key }],\n enabled: enabled && Boolean(reference && key),\n staleTime: 60_000,\n retry: false,\n queryFn: () => loadRelationLabel(provider, reference!, linked!, labelField),\n });\n if (query.isError) return null;\n return query.data;\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-relation-label.ts"],"names":[],"mappings":"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","file":"chunk-WDPM5TBO.js","sourcesContent":["// A link's words: the linked row's name in place of its id (docs/RESOURCE-VIEW.md, \"Relation\n// labels\"). Every cell asks for its own id, and the ids asked for in the same moment go out as\n// one `in` query per linked resource, so a page of 50 rows costs one request, never 50.\n\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { DataProvider, Identifier } from \"../provider/types\";\nimport type { FieldReference } from \"../schema/types\";\n\nexport interface UseRelationLabelOptions {\n /** The linked row's field that names it. Default: the linked resource's `labelField` (`describe`). */\n labelField?: string;\n /** Default `true`. */\n enabled?: boolean;\n}\n\n// Ids per request: an `in` list stays well inside a URL.\nconst CHUNK = 100;\n// Field names only go into `select`, so nothing else rides along in the request.\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n// What names a row when nothing says (as `defineView` guesses a contract's labelField).\nconst NAMING = /^(name|title|label|full_name|display_name)$/;\n\ntype Waiter = { resolve: (label: string | null) => void; reject: (error: unknown) => void };\n// Keyed by the id's type and text, so 1 and \"1\" are both sent as given: a provider that compares\n// strictly (the mock's `in`) must get a number as a number. Rows match by text either way, since\n// a database may hand back 1 for \"1\".\ntype Asked = { id: Identifier; waiters: Waiter[] };\ntype Batch = { reference: FieldReference; labelField: string | undefined; ids: Map<string, Asked> };\n\n// Per provider, so two providers (two apps, a test each) never share a batch or a guess.\nconst batches = new WeakMap<DataProvider, Map<string, Batch>>();\nconst namers = new WeakMap<DataProvider, Map<string, Promise<string | undefined>>>();\n// How long a label waits on `describe` or `capabilities` before going on without them.\nconst SETTLE_MS = 10_000;\n\n/** A promise's value, or `fallback` when it fails, throws or takes longer than SETTLE_MS. */\nfunction within<T>(work: () => Promise<T>, fallback: T): Promise<T> {\n return new Promise<T>((resolve) => {\n const timer = setTimeout(() => resolve(fallback), SETTLE_MS);\n const done = (value: T) => {\n clearTimeout(timer);\n resolve(value);\n };\n try {\n work().then(done, () => done(fallback));\n } catch {\n done(fallback);\n }\n });\n}\n\n/**\n * The linked resource's naming field, from `describe` once per resource; undefined when it can't\n * say. A failed `describe` isn't remembered, so the next page asks again.\n */\nfunction namingField(provider: DataProvider, resource: string): Promise<string | undefined> {\n let known = namers.get(provider);\n if (!known) namers.set(provider, (known = new Map()));\n let found = known.get(resource);\n if (!found) {\n const describe = provider.describe?.bind(provider);\n const table = known;\n found = describe\n ? within(\n () =>\n describe(resource).then((schema) => schema.labelField ?? schema.fields.find((f) => NAMING.test(f.name))?.name ?? null),\n undefined as string | null | undefined,\n ).then((field) => {\n // undefined: describe failed. null: it answered, with no naming field.\n if (field === undefined) table.delete(resource);\n return field ?? undefined;\n })\n : Promise.resolve(undefined);\n known.set(resource, found);\n }\n return found;\n}\n\n/**\n * The linked resource's naming field, as a link's words find it: its `labelField` from\n * `describe`, else a `name`/`title`-like field. Undefined when it can't say. Asked once per\n * resource and provider; a picker uses it to search and sort the rows it lists.\n */\nexport function relationNamingField(provider: DataProvider, resource: string): Promise<string | undefined> {\n return namingField(provider, resource);\n}\n\n/** Ids per request: the provider's page limit, at most CHUNK. */\nasync function chunkSize(provider: DataProvider, resource: string): Promise<number> {\n const capabilities = provider.capabilities?.bind(provider);\n const max = capabilities ? await within(() => capabilities(resource).then((c) => c.maxPerPage), undefined) : undefined;\n return typeof max === \"number\" && max >= 1 ? Math.min(CHUNK, Math.floor(max)) : CHUNK;\n}\n\n/** A value as words, or null when it has none. */\nfunction words(value: unknown): string | null {\n if (typeof value === \"number\" && Number.isFinite(value)) return String(value);\n if (typeof value !== \"string\") return null;\n return value.trim() || null;\n}\n\nasync function flush(provider: DataProvider, batch: Batch): Promise<void> {\n const { reference, ids } = batch;\n const fail = (keys: readonly string[], error: unknown) => keys.forEach((k) => ids.get(k)?.waiters.forEach((w) => w.reject(error)));\n const all = [...ids.keys()];\n let labelField: string | undefined;\n let size: number;\n try {\n labelField = batch.labelField ?? (await namingField(provider, reference.resource));\n if (labelField !== undefined && !IDENTIFIER.test(labelField)) labelField = undefined;\n size = await chunkSize(provider, reference.resource);\n } catch (error) {\n // Every waiter settles, whatever went wrong.\n fail(all, error);\n return;\n }\n const select = labelField && IDENTIFIER.test(reference.field) ? `${reference.field},${labelField}` : undefined;\n for (let i = 0; i < all.length; i += size) {\n const chunk = all.slice(i, i + size);\n try {\n const { data } = await provider.getList(reference.resource, {\n // The whole page: a link to a field that isn't unique can match more rows than ids.\n pagination: { page: 1, perPage: size },\n filters: [{ field: reference.field, operator: \"in\", value: chunk.map((k) => ids.get(k)!.id) as string[] | number[] }],\n count: \"none\",\n ...(select ? { select } : {}),\n });\n const found = new Map<string, string | null>();\n for (const row of data as Record<string, unknown>[]) {\n const key = String(row[reference.field]);\n if (found.get(key)) continue;\n const name = labelField ? row[labelField] : row[Object.keys(row).find((k) => NAMING.test(k)) ?? \"\"];\n found.set(key, words(name));\n }\n // An id the viewer can't see, or one that's gone, has no words.\n for (const k of chunk) {\n const asked = ids.get(k);\n asked?.waiters.forEach((w) => w.resolve(found.get(String(asked.id)) ?? null));\n }\n } catch (error) {\n fail(chunk, error);\n }\n }\n}\n\n/**\n * The words for one linked id, batched with every other id asked for in the same tick: one\n * `getList(resource, { filters: [{ field, operator: \"in\" }] })` per linked resource and naming\n * field. Resolves null when the row has no words or isn't visible to this viewer.\n */\nexport function loadRelationLabel(\n provider: DataProvider,\n reference: FieldReference,\n id: Identifier,\n labelField?: string,\n): Promise<string | null> {\n let pending = batches.get(provider);\n if (!pending) batches.set(provider, (pending = new Map()));\n const key = `${reference.resource}\\u0000${reference.field}\\u0000${labelField ?? \"\"}`;\n let batch = pending.get(key);\n if (!batch) {\n const created: Batch = { reference, labelField, ids: new Map() };\n pending.set(key, (batch = created));\n // A macrotask, not a microtask: every cell's effect in a commit has asked by then.\n setTimeout(() => {\n pending!.delete(key);\n void flush(provider, created);\n }, 0);\n }\n return new Promise((resolve, reject) => {\n const idKey = `${typeof id}:${String(id)}`;\n const asked = batch!.ids.get(idKey) ?? { id, waiters: [] };\n asked.waiters.push({ resolve, reject });\n batch!.ids.set(idKey, asked);\n });\n}\n\n/**\n * A linked row's words for a `relation` cell: `undefined` while they load, `null` when there are\n * none (the row is hidden from this viewer, gone, unnamed, or the read failed), so a screen shows\n * its own words then, never the raw id. Cached per id for a minute and refreshed when the linked\n * resource changes (its writes invalidate `[resource]`).\n */\nexport function useRelationLabel(\n reference: FieldReference | undefined,\n id: unknown,\n options: UseRelationLabelOptions = {},\n): string | null | undefined {\n const provider = useDataProvider();\n const { labelField, enabled = true } = options;\n const linked: Identifier | null = typeof id === \"string\" || (typeof id === \"number\" && Number.isFinite(id)) ? id : null;\n const key = linked === null ? null : `${typeof linked}:${String(linked)}`;\n const query = useQuery({\n queryKey: [reference?.resource, \"relation-label\", { field: reference?.field, labelField: labelField ?? null, id: key }],\n enabled: enabled && Boolean(reference && key),\n staleTime: 60_000,\n retry: false,\n queryFn: () => loadRelationLabel(provider, reference!, linked!, labelField),\n });\n if (query.isError) return null;\n return query.data;\n}\n"]}
@@ -1,4 +1,5 @@
1
1
  // src/schema/write-outcome.ts
2
+ var NO_ROWS_MATCHED = "GENESIS_NO_ROWS";
2
3
  var DataWriteError = class extends Error {
3
4
  outcome;
4
5
  current;
@@ -26,6 +27,6 @@ function isDataWriteError(error) {
26
27
  return error instanceof Error && error.name === "DataWriteError" && typeof error.outcome === "string";
27
28
  }
28
29
 
29
- export { DataWriteError, isDataWriteError };
30
- //# sourceMappingURL=chunk-LG6TUBVM.js.map
31
- //# sourceMappingURL=chunk-LG6TUBVM.js.map
30
+ export { DataWriteError, NO_ROWS_MATCHED, isDataWriteError };
31
+ //# sourceMappingURL=chunk-WLDSIQJ2.js.map
32
+ //# sourceMappingURL=chunk-WLDSIQJ2.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/schema/write-outcome.ts"],"names":[],"mappings":";AA4BO,IAAM,eAAA,GAAkB;AAkCxB,IAAM,cAAA,GAAN,cAA6B,KAAA,CAAM;AAAA,EAC/B,OAAA;AAAA,EACA,OAAA;AAAA,EACA,cAAA;AAAA;AAAA,EAEA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAA;AAAA,EAET,WAAA,CAAY,OAAA,EAAuB,OAAA,EAAiB,OAAA,GAAiC,EAAC,EAAG;AACvF,IAAA,KAAA,CAAM,OAAA,EAAS,QAAQ,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAO,CAAA;AACjF,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,IAAA,CAAK,iBAAiB,OAAA,CAAQ,cAAA;AAC9B,IAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,IAAA,CAAK,OAAO,OAAA,CAAQ,IAAA;AACpD,IAAA,IAAI,OAAA,CAAQ,UAAU,MAAA,CAAO,IAAA,CAAK,QAAQ,MAAM,CAAA,CAAE,SAAS,CAAA,EAAG;AAC5D,MAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA,CAAO,EAAE,GAAG,OAAA,CAAQ,QAAQ,CAAA;AAAA,IACnD;AAAA,EACF;AACF;AAMO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,iBAAiB,KAAA,IACjB,KAAA,CAAM,SAAS,gBAAA,IACf,OAAQ,MAAgC,OAAA,KAAY,QAAA;AAExD","file":"chunk-WLDSIQJ2.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Why a write did not save (DATA-STUDIO.md \"Write safety\")\n//\n// A write that changes nothing is never reported as \"permission denied\" by\n// assumption. The provider re-reads the row and says what actually happened.\n// ---------------------------------------------------------------------------\n\nimport type { DataRow } from \"./types\";\n\n/**\n * - `conflict`: someone else changed the row since it was read. `current`\n * carries the row as it is now.\n * - `gone`: the row was deleted, or is no longer visible to this user. The\n * two cannot be told apart without a privileged look at the table, which\n * would show this user a fact about a row they cannot see.\n * - `forbidden`: the row is visible and unchanged, but the app or the\n * database does not let this user make this change. Only reported when\n * that is proven, never assumed from \"zero rows changed\".\n * - `duplicate`: a row with the same unique key already exists (`23505`).\n * A caller keeping \"one live row per key\" (a draft, a natural-key upsert)\n * adopts the existing row instead; `fields` still names the clashing field.\n * - `invalid`: the store rejected the value (type, constraint, not-null).\n * - `audit_failed`: the audit entry could not be written, so the edit was\n * rolled back with it.\n * - `unauthenticated`: no signed-in user, or the session expired.\n * - `error`: anything else. The edit did not commit.\n */\n/** `DataWriteError.code` when a write came back with no row: `useResource`'s `update` sets it. */\nexport const NO_ROWS_MATCHED = \"GENESIS_NO_ROWS\";\n\nexport type WriteOutcome =\n | \"conflict\"\n | \"gone\"\n | \"forbidden\"\n | \"duplicate\"\n | \"invalid\"\n | \"audit_failed\"\n | \"unauthenticated\"\n | \"error\";\n\nexport interface DataWriteErrorOptions {\n /** The row as it is now, for a `conflict`. Only fields the user may read. */\n current?: DataRow;\n /** The row's current version token, for a `conflict`. */\n currentVersion?: string | null;\n /**\n * The store's own error code, when it gave one (a Postgres SQLSTATE such as\n * `23505`, or a PostgREST code such as `PGRST301`).\n */\n code?: string;\n /**\n * Per-field messages, keyed by field (column) name, for a write the store\n * rejected because of particular values. Each message is safe to show next\n * to its input: plain words, never the store's raw text or the value.\n * `useResourceForm` puts each one on its field.\n */\n fields?: Record<string, string>;\n /** The underlying error, kept for logging. */\n cause?: unknown;\n}\n\n/** Thrown by a provider when a write did not commit. */\nexport class DataWriteError extends Error {\n readonly outcome: WriteOutcome;\n readonly current?: DataRow;\n readonly currentVersion?: string | null;\n /** The store's own error code, when it gave one. */\n readonly code?: string;\n /**\n * Per-field messages (field name → safe message), when the store said which\n * values it rejected. See `DataWriteErrorOptions.fields`.\n */\n readonly fields?: Readonly<Record<string, string>>;\n\n constructor(outcome: WriteOutcome, message: string, options: DataWriteErrorOptions = {}) {\n super(message, options.cause === undefined ? undefined : { cause: options.cause });\n this.name = \"DataWriteError\";\n this.outcome = outcome;\n this.current = options.current;\n this.currentVersion = options.currentVersion;\n if (options.code !== undefined) this.code = options.code;\n if (options.fields && Object.keys(options.fields).length > 0) {\n this.fields = Object.freeze({ ...options.fields });\n }\n }\n}\n\n/**\n * `instanceof` fails when two copies of this package are installed, so check\n * the shape instead.\n */\nexport function isDataWriteError(error: unknown): error is DataWriteError {\n return (\n error instanceof Error &&\n error.name === \"DataWriteError\" &&\n typeof (error as { outcome?: unknown }).outcome === \"string\"\n );\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { DraftController } from './chunk-HBAPYA5K.js';
1
+ import { DraftController } from './chunk-5ASUMG6K.js';
2
2
  import { pageWindow } from './chunk-AJGVLF37.js';
3
3
  import { useRef, useState, useSyncExternalStore, useEffect } from 'react';
4
4
 
@@ -35,5 +35,5 @@ function useDraft(options) {
35
35
  }
36
36
 
37
37
  export { useDraft };
38
- //# sourceMappingURL=chunk-YQBWXG2G.js.map
39
- //# sourceMappingURL=chunk-YQBWXG2G.js.map
38
+ //# sourceMappingURL=chunk-YZV3Z6ZA.js.map
39
+ //# sourceMappingURL=chunk-YZV3Z6ZA.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-draft.ts"],"names":[],"mappings":";;;;AAsCO,SAAS,SAAkC,OAAA,EAAmD;AACnG,EAAA,MAAM,MAAA,GAAS,OAAO,OAAO,CAAA;AAC7B,EAAA,MAAA,CAAO,OAAA,GAAU,OAAA;AAEjB,EAAA,MAAM,CAAC,KAAK,CAAA,GAAI,QAAA,CAAS,MAAM,IAAI,eAAA,CAAsB,MAAM,MAAA,CAAO,OAAO,CAAC,CAAA;AAC9E,EAAA,MAAM,QAAQ,oBAAA,CAAqB,KAAA,CAAM,WAAW,KAAA,CAAM,QAAA,EAAU,MAAM,QAAQ,CAAA;AAElF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAG7C,CAAA,EAAG,CAAC,KAAA,EAAO,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAE5B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAA,CAAM,IAAA,EAAK;AAAA,EACb,CAAA,EAAG,CAAC,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAC,CAAA;AAE3B,EAAA,SAAA,CAAU,MAAM;AAEd,IAAA,MAAM,OAAO,UAAA,EAAW;AACxB,IAAA,MAAM,YAAA,GAAe,CAAC,KAAA,KAA6B;AACjD,MAAA,IAAI,CAAC,KAAA,CAAM,OAAA,EAAQ,EAAG;AACtB,MAAA,KAAK,KAAA,CAAM,KAAA,CAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACpC,MAAA,KAAA,CAAM,cAAA,EAAe;AAAA,IACvB,CAAA;AACA,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,IAAI,KAAA,CAAM,SAAQ,EAAG,KAAK,MAAM,KAAA,CAAM,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAAA,IAC3D,CAAA;AACA,IAAA,IAAA,EAAM,gBAAA,CAAiB,gBAAgB,YAAY,CAAA;AACnD,IAAA,IAAA,EAAM,gBAAA,CAAiB,YAAY,QAAQ,CAAA;AAC3C,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,EAAM,mBAAA,CAAoB,gBAAgB,YAAY,CAAA;AACtD,MAAA,IAAA,EAAM,mBAAA,CAAoB,YAAY,QAAQ,CAAA;AAE9C,MAAA,IAAI,KAAA,CAAM,OAAA,EAAQ,EAAG,KAAK,MAAM,KAAA,EAAM;AAAA,IACxC,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAA,EAAK,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO;AAC9E","file":"chunk-YQBWXG2G.js","sourcesContent":["import { useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport {\n DraftController,\n type DraftOptions,\n type DraftState,\n type DraftValue,\n} from \"./draft-controller\";\nimport { pageWindow } from \"./page-window\";\n\nexport interface UseDraftReturn<V extends DraftValue, R> extends DraftState<V, R> {\n /** The editor's new value; saved a moment after the last change. */\n set: (value: V) => void;\n /** Save now. Never rejects; a failure shows in `status` and `error`. */\n flush: () => Promise<void>;\n /** The final write (a submit); see `DraftController.commit`. */\n commit: DraftController<V, R>[\"commit\"];\n}\n\n/**\n * Autosave one draft row: saved a moment after each change, one write at a\n * time, added on the first save that has something in it, merged into a row\n * another tab started (`adopt`), and started again when the server's copy wins\n * (`revision`). Leaving the page saves what's pending (and warns while it\n * can't), and `commit` makes the final write. The app supplies the writes.\n *\n * ```tsx\n * const draft = useDraft({\n * seed: { row: entry, value: entry?.answers ?? {} },\n * revision: `${entry?.id}:${entry?.status}`,\n * enabled: entry?.status !== \"sent\",\n * create: (answers) => api.addEntry(answers),\n * update: (row, answers) => api.saveEntry(row.id, answers),\n * toValue: (row) => row.answers,\n * onSaved: (row) => queryClient.setQueryData([\"entry\", row.id], row),\n * });\n * <Editor key={draft.key} value={draft.value} onChange={draft.set} />\n * ```\n */\nexport function useDraft<V extends DraftValue, R>(options: DraftOptions<V, R>): UseDraftReturn<V, R> {\n const latest = useRef(options);\n latest.current = options;\n // Created once; reads the latest options on every use, so callbacks are never stale.\n const [draft] = useState(() => new DraftController<V, R>(() => latest.current));\n const state = useSyncExternalStore(draft.subscribe, draft.getState, draft.getState);\n\n useEffect(() => {\n draft.reseed(options.seed, options.revision);\n // Only a new revision starts the draft again; a new seed object alone doesn't.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [draft, options.revision]);\n\n useEffect(() => {\n draft.sync();\n }, [draft, options.enabled]);\n\n useEffect(() => {\n // No page to leave (SSR, React Native): a pending draft still saves on unmount.\n const page = pageWindow();\n const beforeUnload = (event: BeforeUnloadEvent) => {\n if (!draft.pending()) return;\n void draft.flush({ keepalive: true });\n event.preventDefault();\n };\n const pageHide = () => {\n if (draft.pending()) void draft.flush({ keepalive: true });\n };\n page?.addEventListener(\"beforeunload\", beforeUnload);\n page?.addEventListener(\"pagehide\", pageHide);\n return () => {\n page?.removeEventListener(\"beforeunload\", beforeUnload);\n page?.removeEventListener(\"pagehide\", pageHide);\n // Leaving the page within the app: save what's pending.\n if (draft.pending()) void draft.flush();\n };\n }, [draft]);\n\n return { ...state, set: draft.set, flush: draft.flush, commit: draft.commit };\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-draft.ts"],"names":[],"mappings":";;;;AAsCO,SAAS,SAAkC,OAAA,EAAmD;AACnG,EAAA,MAAM,MAAA,GAAS,OAAO,OAAO,CAAA;AAC7B,EAAA,MAAA,CAAO,OAAA,GAAU,OAAA;AAEjB,EAAA,MAAM,CAAC,KAAK,CAAA,GAAI,QAAA,CAAS,MAAM,IAAI,eAAA,CAAsB,MAAM,MAAA,CAAO,OAAO,CAAC,CAAA;AAC9E,EAAA,MAAM,QAAQ,oBAAA,CAAqB,KAAA,CAAM,WAAW,KAAA,CAAM,QAAA,EAAU,MAAM,QAAQ,CAAA;AAElF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAG7C,CAAA,EAAG,CAAC,KAAA,EAAO,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAE5B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAA,CAAM,IAAA,EAAK;AAAA,EACb,CAAA,EAAG,CAAC,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAC,CAAA;AAE3B,EAAA,SAAA,CAAU,MAAM;AAEd,IAAA,MAAM,OAAO,UAAA,EAAW;AACxB,IAAA,MAAM,YAAA,GAAe,CAAC,KAAA,KAA6B;AACjD,MAAA,IAAI,CAAC,KAAA,CAAM,OAAA,EAAQ,EAAG;AACtB,MAAA,KAAK,KAAA,CAAM,KAAA,CAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACpC,MAAA,KAAA,CAAM,cAAA,EAAe;AAAA,IACvB,CAAA;AACA,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,IAAI,KAAA,CAAM,SAAQ,EAAG,KAAK,MAAM,KAAA,CAAM,EAAE,SAAA,EAAW,IAAA,EAAM,CAAA;AAAA,IAC3D,CAAA;AACA,IAAA,IAAA,EAAM,gBAAA,CAAiB,gBAAgB,YAAY,CAAA;AACnD,IAAA,IAAA,EAAM,gBAAA,CAAiB,YAAY,QAAQ,CAAA;AAC3C,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,EAAM,mBAAA,CAAoB,gBAAgB,YAAY,CAAA;AACtD,MAAA,IAAA,EAAM,mBAAA,CAAoB,YAAY,QAAQ,CAAA;AAE9C,MAAA,IAAI,KAAA,CAAM,OAAA,EAAQ,EAAG,KAAK,MAAM,KAAA,EAAM;AAAA,IACxC,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,GAAA,EAAK,KAAA,CAAM,GAAA,EAAK,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO;AAC9E","file":"chunk-YZV3Z6ZA.js","sourcesContent":["import { useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport {\n DraftController,\n type DraftOptions,\n type DraftState,\n type DraftValue,\n} from \"./draft-controller\";\nimport { pageWindow } from \"./page-window\";\n\nexport interface UseDraftReturn<V extends DraftValue, R> extends DraftState<V, R> {\n /** The editor's new value; saved a moment after the last change. */\n set: (value: V) => void;\n /** Save now. Never rejects; a failure shows in `status` and `error`. */\n flush: () => Promise<void>;\n /** The final write (a submit); see `DraftController.commit`. */\n commit: DraftController<V, R>[\"commit\"];\n}\n\n/**\n * Autosave one draft row: saved a moment after each change, one write at a\n * time, added on the first save that has something in it, merged into a row\n * another tab started (`adopt`), and started again when the server's copy wins\n * (`revision`). Leaving the page saves what's pending (and warns while it\n * can't), and `commit` makes the final write. The app supplies the writes.\n *\n * ```tsx\n * const draft = useDraft({\n * seed: { row: entry, value: entry?.answers ?? {} },\n * revision: `${entry?.id}:${entry?.status}`,\n * enabled: entry?.status !== \"sent\",\n * create: (answers) => api.addEntry(answers),\n * update: (row, answers) => api.saveEntry(row.id, answers),\n * toValue: (row) => row.answers,\n * onSaved: (row) => queryClient.setQueryData([\"entry\", row.id], row),\n * });\n * <Editor key={draft.key} value={draft.value} onChange={draft.set} />\n * ```\n */\nexport function useDraft<V extends DraftValue, R>(options: DraftOptions<V, R>): UseDraftReturn<V, R> {\n const latest = useRef(options);\n latest.current = options;\n // Created once; reads the latest options on every use, so callbacks are never stale.\n const [draft] = useState(() => new DraftController<V, R>(() => latest.current));\n const state = useSyncExternalStore(draft.subscribe, draft.getState, draft.getState);\n\n useEffect(() => {\n draft.reseed(options.seed, options.revision);\n // Only a new revision starts the draft again; a new seed object alone doesn't.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [draft, options.revision]);\n\n useEffect(() => {\n draft.sync();\n }, [draft, options.enabled]);\n\n useEffect(() => {\n // No page to leave (SSR, React Native): a pending draft still saves on unmount.\n const page = pageWindow();\n const beforeUnload = (event: BeforeUnloadEvent) => {\n if (!draft.pending()) return;\n void draft.flush({ keepalive: true });\n event.preventDefault();\n };\n const pageHide = () => {\n if (draft.pending()) void draft.flush({ keepalive: true });\n };\n page?.addEventListener(\"beforeunload\", beforeUnload);\n page?.addEventListener(\"pagehide\", pageHide);\n return () => {\n page?.removeEventListener(\"beforeunload\", beforeUnload);\n page?.removeEventListener(\"pagehide\", pageHide);\n // Leaving the page within the app: save what's pending.\n if (draft.pending()) void draft.flush();\n };\n }, [draft]);\n\n return { ...state, set: draft.set, flush: draft.flush, commit: draft.commit };\n}\n"]}
@@ -17,8 +17,12 @@ import { ReactNode } from 'react';
17
17
 
18
18
  interface ThreadAttachment {
19
19
  id: string;
20
- /** An image URI (a signed URL, a file:// path). */
20
+ /** `image` shows the picture; `file` shows its name, and opens `uri`. Default `image`. */
21
+ kind?: "image" | "file";
22
+ /** An image URI, or a file's link (a signed URL, a file:// path). */
21
23
  uri: string;
24
+ /** A file's name, as shown. */
25
+ name?: string;
22
26
  width?: number;
23
27
  height?: number;
24
28
  accessibilityLabel?: string;
@@ -35,6 +39,8 @@ type MessageTone = "default" | "internal";
35
39
  interface ThreadMessage {
36
40
  /** Stays the same across refreshes, or the list jumps. */
37
41
  id: string;
42
+ /** The id `jumpTo` names it by, when that isn't `id`: a message kept by the id the client gave it and gone to by the server's. Default `id`. */
43
+ jumpId?: string;
38
44
  /** `event`: a centred line between messages ("Sam was assigned"); `body` is its text. Default `message`. */
39
45
  kind?: "message" | "event";
40
46
  body: string;
@@ -78,6 +84,8 @@ interface ThreadComposer {
78
84
  maxLines?: number;
79
85
  /** Ways to send ("Reply", "Internal note"); two or more show the picker. */
80
86
  modes?: readonly ComposerMode[];
87
+ /** The picker's name, to a screen reader. Default "Send as". */
88
+ modesLabel?: string;
81
89
  mode?: string;
82
90
  onModeChange?: (id: string) => void;
83
91
  }
@@ -114,6 +122,8 @@ interface InboxSwipeAction {
114
122
  onPress: () => void;
115
123
  /** Destructive tone (delete, leave). */
116
124
  destructive?: boolean;
125
+ /** Which side of the row a swipe uncovers it from, on the phone. Default `trailing`. */
126
+ side?: "leading" | "trailing";
117
127
  }
118
128
  interface InboxItem {
119
129
  /** Stable id for keying. */
@@ -182,7 +192,7 @@ interface UseThreadJumpOptions {
182
192
  onStart?: (() => void) | undefined;
183
193
  /** Scrolled to it (say so to VoiceOver). */
184
194
  onLanded?: ((id: string) => void) | undefined;
185
- /** It isn't there (go back to where the thread was). */
195
+ /** No row answers to it once `loadUntil` has settled, or `loadUntil` failed (go back to where the thread was). */
186
196
  onGone?: ((id: string) => void) | undefined;
187
197
  }
188
198
  /** After `loadUntil` resolves, how long the rows have to arrive before the row counts as gone. */
@@ -190,6 +200,7 @@ declare const JUMP_SETTLE_MS = 400;
190
200
  declare function useThreadJump({ target, has, loading, loadUntil, scrollTo, onStart, onLanded, onGone }: UseThreadJumpOptions): {
191
201
  highlightedId: string | null;
192
202
  jumping: boolean;
203
+ cancel: () => void;
193
204
  };
194
205
 
195
206
  export { type ComposerMode, type ComposerTone, DEFAULT_THREAD_LABELS, type InboxItem, type InboxSwipeAction, JUMP_SETTLE_MS, type MessageTone, type ThreadAttachment, type ThreadComposer, type ThreadLabels, type ThreadMessage, type ThreadMessageStatus, type UseThreadJumpOptions, formatInboxTime, formatMessageTime, isDelivered, readReceiptFor, useThreadJump };
@@ -25,7 +25,7 @@ function readReceiptFor(messages, readAt) {
25
25
  const read = toDate(readAt).getTime();
26
26
  for (let i = messages.length - 1; i >= 0; i--) {
27
27
  const m = messages[i];
28
- if (m.kind !== "event" && m.mine && isDelivered(m) && toDate(m.timestamp).getTime() <= read) return m.id;
28
+ if (m.kind !== "event" && m.tone !== "internal" && m.mine && isDelivered(m) && toDate(m.timestamp).getTime() <= read) return m.id;
29
29
  }
30
30
  return null;
31
31
  }
@@ -102,7 +102,12 @@ function useThreadJump({ target, has, loading = false, loadUntil, scrollTo, onSt
102
102
  const settle = () => setPending((p) => p && p.id === id ? { ...p, phase: "loaded" } : p);
103
103
  void latest.current.loadUntil(id).then(settle, settle);
104
104
  }, [pending, loading, has, go]);
105
- return { highlightedId, jumping: pending !== null };
105
+ const cancel = useCallback(() => {
106
+ if (goneTimer.current) clearTimeout(goneTimer.current);
107
+ armed.current = null;
108
+ setPending(null);
109
+ }, [goneTimer]);
110
+ return { highlightedId, jumping: pending !== null, cancel };
106
111
  }
107
112
 
108
113
  export { DEFAULT_THREAD_LABELS, JUMP_SETTLE_MS, formatInboxTime, formatMessageTime, isDelivered, readReceiptFor, useThreadJump };
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/conversation/types.ts","../../src/conversation/format.ts","../../src/conversation/use-thread-jump.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The conversation contract: what a thread, its messages, its composer and an\n * inbox row are, for web (genesis-ui) and native (genesis-ui-native) alike.\n * One description serves both: the same `ThreadMessage[]` renders in ui's\n * `ThreadPage` and ui-native's `ThreadPage`, and genesis-chat, the help desk\n * or an app's own thread feed either.\n *\n * Data, not behaviour: a row's send state (`status`) and its actions come in\n * from whatever owns the data (an outbox, the offline queue, the server), and\n * the layouts never fetch. Ids stay the same across refreshes (a cache, then\n * the server): pass `clientId ?? serverId` as `id`.\n *\n * @stability Beta\n */\nimport type { ReactNode } from \"react\";\n\nexport interface ThreadAttachment {\n id: string;\n /** An image URI (a signed URL, a file:// path). */\n uri: string;\n width?: number;\n height?: number;\n accessibilityLabel?: string;\n onPress?: () => void;\n}\n\n/**\n * Where a message is on its way. `sending` (in flight), `sent`, `pending`\n * (queued: offline), `paused` (the session expired: sign in to send),\n * `failed` and `conflict` (changed elsewhere) with `onRetry` / `onDiscard`.\n */\nexport type ThreadMessageStatus = \"sending\" | \"sent\" | \"pending\" | \"paused\" | \"failed\" | \"conflict\";\n\n/** How a message reads: `default`, or `internal` (a staff-only note, never mistaken for a reply). */\nexport type MessageTone = \"default\" | \"internal\";\n\nexport interface ThreadMessage {\n /** Stays the same across refreshes, or the list jumps. */\n id: string;\n /** `event`: a centred line between messages (\"Sam was assigned\"); `body` is its text. Default `message`. */\n kind?: \"message\" | \"event\";\n body: string;\n /** Sent by the person using the app: trailing side, tint. */\n mine: boolean;\n /** Shown over theirs (\"Support\"); never over mine. */\n authorName?: string;\n timestamp: string | Date;\n status?: ThreadMessageStatus;\n onRetry?: () => void;\n onDiscard?: () => void;\n /** `internal`: a staff-only note, tinted so it never reads like a reply. */\n tone?: MessageTone;\n attachments?: ThreadAttachment[];\n}\n\n/** How a composer mode reads. The same tones as a message. */\nexport type ComposerTone = MessageTone;\n\nexport interface ComposerMode {\n id: string;\n label: string;\n tone?: ComposerTone;\n}\n\nexport interface ThreadComposer {\n value: string;\n onChangeText: (text: string) => void;\n onSend: () => void;\n /** A send is in flight: the button spins and won't send twice. */\n sending?: boolean;\n placeholder?: string;\n sendLabel?: string;\n /** Turns the send button off (besides an empty or blank value). */\n disabled?: boolean;\n maxLength?: number;\n /** Said while sending. Default `labels.sending`. */\n sendingLabel?: string;\n /** Above the input: a reply preview, attachments waiting to send. */\n above?: ReactNode;\n /** Beside send: a mic. */\n trailing?: ReactNode;\n /** The input grows to this many lines, then scrolls. Default 6. */\n maxLines?: number;\n /** Ways to send (\"Reply\", \"Internal note\"); two or more show the picker. */\n modes?: readonly ComposerMode[];\n mode?: string;\n onModeChange?: (id: string) => void;\n}\n\n/** What the default parts of a thread say. */\nexport interface ThreadLabels {\n /** Who \"mine\" is, to a screen reader. */\n you: string;\n sending: string;\n /** Queued while offline. */\n pending: string;\n /** The session expired. */\n paused: string;\n notSent: string;\n /** Changed somewhere else before it was sent. */\n conflict: string;\n retryHint: string;\n discard: string;\n /** The first unread message's divider. */\n newMessages: string;\n /** The pill that goes back to the newest message. */\n jumpToLatest: string;\n /** While `updating`. */\n updating: string;\n /** Said with an internal note, so a screen reader never reads it as a reply. */\n internal: string;\n /** Said when a `jumpTo` message can't be found. */\n messageGone: string;\n}\n\nexport const DEFAULT_THREAD_LABELS: Readonly<ThreadLabels> = Object.freeze({\n you: \"You\",\n sending: \"Sending\",\n pending: \"Waiting to send\",\n paused: \"Sign in to send\",\n notSent: \"Not sent. Tap to retry.\",\n conflict: \"Not sent: changed elsewhere. Tap to retry.\",\n retryHint: \"Double tap to send again\",\n discard: \"Discard\",\n newMessages: \"New messages\",\n jumpToLatest: \"Jump to latest\",\n updating: \"Updating…\",\n internal: \"Internal note\",\n messageGone: \"That message isn't available.\",\n});\n\n/** An action on an inbox row: a swipe, a long press or context menu, an accessibility action. */\nexport interface InboxSwipeAction {\n id: string;\n label: string;\n onPress: () => void;\n /** Destructive tone (delete, leave). */\n destructive?: boolean;\n}\n\nexport interface InboxItem {\n /** Stable id for keying. */\n id: string;\n title: string;\n /** The latest message or a summary, at most two lines. */\n preview?: string;\n /** When it last changed. Shown as a short time or date. */\n timestamp?: string | Date;\n /** Something new the person hasn't read: a dot, and the title in bold. */\n unread?: boolean;\n /** How many unread messages; shown as a count instead of the dot when above 0. */\n unreadCount?: number;\n /** A short status shown under the preview (\"In progress\", \"12 votes\"). */\n meta?: string;\n /** Replaces the unread dot (an icon). For a picture of who it is, use `avatar`, which keeps the dot. */\n leading?: ReactNode;\n /**\n * A picture of who or what it is (an avatar, about 40px), between the\n * unread dot and the text. It is hidden from screen readers; when it shows\n * someone `title` doesn't name, say who in `avatarLabel`.\n */\n avatar?: ReactNode;\n /** Who the avatar shows, read before the title, when `title` doesn't name them. */\n avatarLabel?: string;\n /** Shown at the end of the row (a vote button, a badge). Replaces the chevron. */\n trailing?: ReactNode;\n /** Opens the conversation. */\n onPress?: () => void;\n /** Swipe actions on native; a row menu on web. Always reachable as accessibility actions. */\n swipeActions?: InboxSwipeAction[];\n /** The row is the conversation open beside the list (a 3-pane inbox). */\n selected?: boolean;\n /** testID override. Default `<page testID>-row-<id>`. */\n testID?: string;\n}\n","/**\n * The conversation contract's shared logic: which message shows the read\n * receipt, and how an inbox row's time reads. Platform-neutral.\n *\n * @stability Beta\n */\nimport type { ThreadMessage } from \"./types\";\n\nconst toDate = (value: string | Date) => (typeof value === \"string\" ? new Date(value) : value);\n\n/** Sent and delivered: a read receipt can mark it. */\nexport const isDelivered = (m: ThreadMessage): boolean => m.status === undefined || m.status === \"sent\";\n\n/** The newest of my messages the other side has read, or null. Events and undelivered messages never count. */\nexport function readReceiptFor(messages: readonly ThreadMessage[], readAt: string | Date | null | undefined): string | null {\n if (!readAt) return null;\n const read = toDate(readAt).getTime();\n for (let i = messages.length - 1; i >= 0; i--) {\n const m = messages[i]!;\n if (m.kind !== \"event\" && m.mine && isDelivered(m) && toDate(m.timestamp).getTime() <= read) return m.id;\n }\n return null;\n}\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** The default inbox row time: `9:41`, `Yesterday`, `Monday`, then a short date. */\nexport function formatInboxTime(date: Date, now: Date): string {\n const start = (d: Date) => new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();\n const days = Math.round((start(now) - start(date)) / DAY_MS);\n if (days <= 0) return date.toLocaleTimeString(undefined, { hour: \"numeric\", minute: \"2-digit\" });\n if (days === 1) return \"Yesterday\";\n if (days < 7) return date.toLocaleDateString(undefined, { weekday: \"long\" });\n return date.toLocaleDateString(undefined, { day: \"numeric\", month: \"short\", year: date.getFullYear() === now.getFullYear() ? undefined : \"numeric\" });\n}\n\n/** The default message time: \"Oct 24, 9:41 AM\". */\nexport function formatMessageTime(date: Date): string {\n return date.toLocaleString(undefined, { month: \"short\", day: \"numeric\", hour: \"numeric\", minute: \"2-digit\" });\n}\n","/**\n * useThreadJump — going to one row of a thread (a search result, a pinned\n * message, the first unread): load earlier pages until the row is held, then\n * scroll to it and highlight it for two seconds. A row that can't be found\n * says so.\n *\n * Promoted from genesis-chat's `useJumpToMessage` (G4), generalised from\n * chat's sequence numbers to row ids. It's a state machine driven by the\n * rows, not a one-shot: a target set before the first page has loaded waits\n * for `loading` to end, a row that arrives a render or two after `loadUntil`\n * resolves is still found, and going to the same id again (after `null`)\n * goes again.\n *\n * @stability Beta\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseThreadJumpOptions {\n /** The row to go to; `null` clears it, and a new id (or the same one after `null`) starts again. */\n target: string | null | undefined;\n /** Whether the row is held now. */\n has: (id: string) => boolean;\n /** The first page is still loading: don't start until it's in. */\n loading?: boolean | undefined;\n /** Load earlier pages until the row is held; resolve false when it can't be. Without it, a row not held is gone. */\n loadUntil?: ((id: string) => Promise<boolean>) | undefined;\n /** Scroll to the row. */\n scrollTo: (id: string) => void;\n /** Before loading or scrolling (stop following the bottom). */\n onStart?: (() => void) | undefined;\n /** Scrolled to it (say so to VoiceOver). */\n onLanded?: ((id: string) => void) | undefined;\n /** It isn't there (go back to where the thread was). */\n onGone?: ((id: string) => void) | undefined;\n}\n\ntype Pending = { id: string; phase: \"new\" | \"loading\" | \"loaded\" };\n\n/** After `loadUntil` resolves, how long the rows have to arrive before the row counts as gone. */\nexport const JUMP_SETTLE_MS = 400;\n\nexport function useThreadJump({ target, has, loading = false, loadUntil, scrollTo, onStart, onLanded, onGone }: UseThreadJumpOptions) {\n const [pending, setPending] = useState<Pending | null>(target ? { id: target, phase: \"new\" } : null);\n const [highlightedId, setHighlightedId] = useState<string | null>(null);\n const armed = useRef<Pending | null>(null);\n const goneTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n useEffect(() => {\n if (target) setPending({ id: target, phase: \"new\" });\n else {\n // null cancels a jump in progress.\n if (goneTimerRef.current) clearTimeout(goneTimerRef.current);\n armed.current = null;\n setPending(null);\n }\n }, [target]);\n\n const latest = useRef({ scrollTo, onStart, onLanded, onGone, loadUntil });\n latest.current = { scrollTo, onStart, onLanded, onGone, loadUntil };\n const highlightTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n const goneTimer = goneTimerRef;\n useEffect(\n () => () => {\n if (highlightTimer.current) clearTimeout(highlightTimer.current);\n if (goneTimer.current) clearTimeout(goneTimer.current);\n },\n [],\n );\n\n const go = useCallback((id: string) => {\n latest.current.onStart?.();\n latest.current.scrollTo(id);\n latest.current.onLanded?.(id);\n setHighlightedId(id);\n if (highlightTimer.current) clearTimeout(highlightTimer.current);\n highlightTimer.current = setTimeout(() => setHighlightedId((h) => (h === id ? null : h)), 2000);\n }, []);\n\n useEffect(() => {\n if (!pending || loading) return;\n const { id, phase } = pending;\n if (has(id)) {\n if (goneTimer.current) clearTimeout(goneTimer.current);\n setPending(null);\n go(id);\n return;\n }\n if (phase === \"loading\") return;\n if (phase === \"loaded\" || !latest.current.loadUntil) {\n // The rows may reach the list a render or two after the load resolved: give them a moment,\n // once per pending jump (new rows arriving in a busy thread don't restart it).\n if (armed.current === pending) return;\n armed.current = pending;\n if (goneTimer.current) clearTimeout(goneTimer.current);\n goneTimer.current = setTimeout(\n () => {\n setPending((p) => (p && p.id === id ? null : p));\n latest.current.onGone?.(id);\n },\n phase === \"loaded\" ? JUMP_SETTLE_MS : 0,\n );\n return;\n }\n latest.current.onStart?.();\n setPending({ id, phase: \"loading\" });\n const settle = () => setPending((p) => (p && p.id === id ? { ...p, phase: \"loaded\" } : p));\n void latest.current.loadUntil(id).then(settle, settle);\n }, [pending, loading, has, go]);\n\n return { highlightedId, jumping: pending !== null };\n}\n"]}
1
+ {"version":3,"sources":["../../src/conversation/types.ts","../../src/conversation/format.ts","../../src/conversation/use-thread-jump.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The conversation contract: what a thread, its messages, its composer and an\n * inbox row are, for web (genesis-ui) and native (genesis-ui-native) alike.\n * One description serves both: the same `ThreadMessage[]` renders in ui's\n * `ThreadPage` and ui-native's `ThreadPage`, and genesis-chat, the help desk\n * or an app's own thread feed either.\n *\n * Data, not behaviour: a row's send state (`status`) and its actions come in\n * from whatever owns the data (an outbox, the offline queue, the server), and\n * the layouts never fetch. Ids stay the same across refreshes (a cache, then\n * the server): pass `clientId ?? serverId` as `id`.\n *\n * @stability Beta\n */\nimport type { ReactNode } from \"react\";\n\nexport interface ThreadAttachment {\n id: string;\n /** `image` shows the picture; `file` shows its name, and opens `uri`. Default `image`. */\n kind?: \"image\" | \"file\";\n /** An image URI, or a file's link (a signed URL, a file:// path). */\n uri: string;\n /** A file's name, as shown. */\n name?: string;\n width?: number;\n height?: number;\n accessibilityLabel?: string;\n onPress?: () => void;\n}\n\n/**\n * Where a message is on its way. `sending` (in flight), `sent`, `pending`\n * (queued: offline), `paused` (the session expired: sign in to send),\n * `failed` and `conflict` (changed elsewhere) with `onRetry` / `onDiscard`.\n */\nexport type ThreadMessageStatus = \"sending\" | \"sent\" | \"pending\" | \"paused\" | \"failed\" | \"conflict\";\n\n/** How a message reads: `default`, or `internal` (a staff-only note, never mistaken for a reply). */\nexport type MessageTone = \"default\" | \"internal\";\n\nexport interface ThreadMessage {\n /** Stays the same across refreshes, or the list jumps. */\n id: string;\n /** The id `jumpTo` names it by, when that isn't `id`: a message kept by the id the client gave it and gone to by the server's. Default `id`. */\n jumpId?: string;\n /** `event`: a centred line between messages (\"Sam was assigned\"); `body` is its text. Default `message`. */\n kind?: \"message\" | \"event\";\n body: string;\n /** Sent by the person using the app: trailing side, tint. */\n mine: boolean;\n /** Shown over theirs (\"Support\"); never over mine. */\n authorName?: string;\n timestamp: string | Date;\n status?: ThreadMessageStatus;\n onRetry?: () => void;\n onDiscard?: () => void;\n /** `internal`: a staff-only note, tinted so it never reads like a reply. */\n tone?: MessageTone;\n attachments?: ThreadAttachment[];\n}\n\n/** How a composer mode reads. The same tones as a message. */\nexport type ComposerTone = MessageTone;\n\nexport interface ComposerMode {\n id: string;\n label: string;\n tone?: ComposerTone;\n}\n\nexport interface ThreadComposer {\n value: string;\n onChangeText: (text: string) => void;\n onSend: () => void;\n /** A send is in flight: the button spins and won't send twice. */\n sending?: boolean;\n placeholder?: string;\n sendLabel?: string;\n /** Turns the send button off (besides an empty or blank value). */\n disabled?: boolean;\n maxLength?: number;\n /** Said while sending. Default `labels.sending`. */\n sendingLabel?: string;\n /** Above the input: a reply preview, attachments waiting to send. */\n above?: ReactNode;\n /** Beside send: a mic. */\n trailing?: ReactNode;\n /** The input grows to this many lines, then scrolls. Default 6. */\n maxLines?: number;\n /** Ways to send (\"Reply\", \"Internal note\"); two or more show the picker. */\n modes?: readonly ComposerMode[];\n /** The picker's name, to a screen reader. Default \"Send as\". */\n modesLabel?: string;\n mode?: string;\n onModeChange?: (id: string) => void;\n}\n\n/** What the default parts of a thread say. */\nexport interface ThreadLabels {\n /** Who \"mine\" is, to a screen reader. */\n you: string;\n sending: string;\n /** Queued while offline. */\n pending: string;\n /** The session expired. */\n paused: string;\n notSent: string;\n /** Changed somewhere else before it was sent. */\n conflict: string;\n retryHint: string;\n discard: string;\n /** The first unread message's divider. */\n newMessages: string;\n /** The pill that goes back to the newest message. */\n jumpToLatest: string;\n /** While `updating`. */\n updating: string;\n /** Said with an internal note, so a screen reader never reads it as a reply. */\n internal: string;\n /** Said when a `jumpTo` message can't be found. */\n messageGone: string;\n}\n\nexport const DEFAULT_THREAD_LABELS: Readonly<ThreadLabels> = Object.freeze({\n you: \"You\",\n sending: \"Sending\",\n pending: \"Waiting to send\",\n paused: \"Sign in to send\",\n notSent: \"Not sent. Tap to retry.\",\n conflict: \"Not sent: changed elsewhere. Tap to retry.\",\n retryHint: \"Double tap to send again\",\n discard: \"Discard\",\n newMessages: \"New messages\",\n jumpToLatest: \"Jump to latest\",\n updating: \"Updating…\",\n internal: \"Internal note\",\n messageGone: \"That message isn't available.\",\n});\n\n/** An action on an inbox row: a swipe, a long press or context menu, an accessibility action. */\nexport interface InboxSwipeAction {\n id: string;\n label: string;\n onPress: () => void;\n /** Destructive tone (delete, leave). */\n destructive?: boolean;\n /** Which side of the row a swipe uncovers it from, on the phone. Default `trailing`. */\n side?: \"leading\" | \"trailing\";\n}\n\nexport interface InboxItem {\n /** Stable id for keying. */\n id: string;\n title: string;\n /** The latest message or a summary, at most two lines. */\n preview?: string;\n /** When it last changed. Shown as a short time or date. */\n timestamp?: string | Date;\n /** Something new the person hasn't read: a dot, and the title in bold. */\n unread?: boolean;\n /** How many unread messages; shown as a count instead of the dot when above 0. */\n unreadCount?: number;\n /** A short status shown under the preview (\"In progress\", \"12 votes\"). */\n meta?: string;\n /** Replaces the unread dot (an icon). For a picture of who it is, use `avatar`, which keeps the dot. */\n leading?: ReactNode;\n /**\n * A picture of who or what it is (an avatar, about 40px), between the\n * unread dot and the text. It is hidden from screen readers; when it shows\n * someone `title` doesn't name, say who in `avatarLabel`.\n */\n avatar?: ReactNode;\n /** Who the avatar shows, read before the title, when `title` doesn't name them. */\n avatarLabel?: string;\n /** Shown at the end of the row (a vote button, a badge). Replaces the chevron. */\n trailing?: ReactNode;\n /** Opens the conversation. */\n onPress?: () => void;\n /** Swipe actions on native; a row menu on web. Always reachable as accessibility actions. */\n swipeActions?: InboxSwipeAction[];\n /** The row is the conversation open beside the list (a 3-pane inbox). */\n selected?: boolean;\n /** testID override. Default `<page testID>-row-<id>`. */\n testID?: string;\n}\n","/**\n * The conversation contract's shared logic: which message shows the read\n * receipt, and how an inbox row's time reads. Platform-neutral.\n *\n * @stability Beta\n */\nimport type { ThreadMessage } from \"./types\";\n\nconst toDate = (value: string | Date) => (typeof value === \"string\" ? new Date(value) : value);\n\n/** Sent and delivered: a read receipt can mark it. */\nexport const isDelivered = (m: ThreadMessage): boolean => m.status === undefined || m.status === \"sent\";\n\n/** The newest of my messages the other side has read, or null. Events and undelivered messages never count. */\nexport function readReceiptFor(messages: readonly ThreadMessage[], readAt: string | Date | null | undefined): string | null {\n if (!readAt) return null;\n const read = toDate(readAt).getTime();\n for (let i = messages.length - 1; i >= 0; i--) {\n const m = messages[i]!;\n if (m.kind !== \"event\" && m.tone !== \"internal\" && m.mine && isDelivered(m) && toDate(m.timestamp).getTime() <= read) return m.id;\n }\n return null;\n}\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** The default inbox row time: `9:41`, `Yesterday`, `Monday`, then a short date. */\nexport function formatInboxTime(date: Date, now: Date): string {\n const start = (d: Date) => new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();\n const days = Math.round((start(now) - start(date)) / DAY_MS);\n if (days <= 0) return date.toLocaleTimeString(undefined, { hour: \"numeric\", minute: \"2-digit\" });\n if (days === 1) return \"Yesterday\";\n if (days < 7) return date.toLocaleDateString(undefined, { weekday: \"long\" });\n return date.toLocaleDateString(undefined, { day: \"numeric\", month: \"short\", year: date.getFullYear() === now.getFullYear() ? undefined : \"numeric\" });\n}\n\n/** The default message time: \"Oct 24, 9:41 AM\". */\nexport function formatMessageTime(date: Date): string {\n return date.toLocaleString(undefined, { month: \"short\", day: \"numeric\", hour: \"numeric\", minute: \"2-digit\" });\n}\n","/**\n * useThreadJump — going to one row of a thread (a search result, a pinned\n * message, the first unread): load earlier pages until the row is held, then\n * scroll to it and highlight it for two seconds. A row that can't be found\n * says so: a row is gone when, once `loadUntil` has settled (or failed), no\n * row answers to its id. What counts is what's drawn, not what a cache holds.\n *\n * Promoted from genesis-chat's `useJumpToMessage` (G4), generalised from\n * chat's sequence numbers to row ids. It's a state machine driven by the\n * rows, not a one-shot: a target set before the first page has loaded waits\n * for `loading` to end, a row that arrives a render or two after `loadUntil`\n * resolves is still found, and going to the same id again (after `null`)\n * goes again. `cancel()` drops a jump the reader has taken over from: whatever\n * it was waiting on, it won't scroll or report the row gone.\n *\n * @stability Beta\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseThreadJumpOptions {\n /** The row to go to; `null` clears it, and a new id (or the same one after `null`) starts again. */\n target: string | null | undefined;\n /** Whether the row is held now. */\n has: (id: string) => boolean;\n /** The first page is still loading: don't start until it's in. */\n loading?: boolean | undefined;\n /** Load earlier pages until the row is held; resolve false when it can't be. Without it, a row not held is gone. */\n loadUntil?: ((id: string) => Promise<boolean>) | undefined;\n /** Scroll to the row. */\n scrollTo: (id: string) => void;\n /** Before loading or scrolling (stop following the bottom). */\n onStart?: (() => void) | undefined;\n /** Scrolled to it (say so to VoiceOver). */\n onLanded?: ((id: string) => void) | undefined;\n /** No row answers to it once `loadUntil` has settled, or `loadUntil` failed (go back to where the thread was). */\n onGone?: ((id: string) => void) | undefined;\n}\n\ntype Pending = { id: string; phase: \"new\" | \"loading\" | \"loaded\" };\n\n/** After `loadUntil` resolves, how long the rows have to arrive before the row counts as gone. */\nexport const JUMP_SETTLE_MS = 400;\n\nexport function useThreadJump({ target, has, loading = false, loadUntil, scrollTo, onStart, onLanded, onGone }: UseThreadJumpOptions) {\n const [pending, setPending] = useState<Pending | null>(target ? { id: target, phase: \"new\" } : null);\n const [highlightedId, setHighlightedId] = useState<string | null>(null);\n const armed = useRef<Pending | null>(null);\n const goneTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n useEffect(() => {\n if (target) setPending({ id: target, phase: \"new\" });\n else {\n // null cancels a jump in progress.\n if (goneTimerRef.current) clearTimeout(goneTimerRef.current);\n armed.current = null;\n setPending(null);\n }\n }, [target]);\n\n const latest = useRef({ scrollTo, onStart, onLanded, onGone, loadUntil });\n latest.current = { scrollTo, onStart, onLanded, onGone, loadUntil };\n const highlightTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n const goneTimer = goneTimerRef;\n useEffect(\n () => () => {\n if (highlightTimer.current) clearTimeout(highlightTimer.current);\n if (goneTimer.current) clearTimeout(goneTimer.current);\n },\n [],\n );\n\n const go = useCallback((id: string) => {\n latest.current.onStart?.();\n latest.current.scrollTo(id);\n latest.current.onLanded?.(id);\n setHighlightedId(id);\n if (highlightTimer.current) clearTimeout(highlightTimer.current);\n highlightTimer.current = setTimeout(() => setHighlightedId((h) => (h === id ? null : h)), 2000);\n }, []);\n\n useEffect(() => {\n if (!pending || loading) return;\n const { id, phase } = pending;\n if (has(id)) {\n if (goneTimer.current) clearTimeout(goneTimer.current);\n setPending(null);\n go(id);\n return;\n }\n if (phase === \"loading\") return;\n if (phase === \"loaded\" || !latest.current.loadUntil) {\n // The rows may reach the list a render or two after the load resolved: give them a moment,\n // once per pending jump (new rows arriving in a busy thread don't restart it).\n if (armed.current === pending) return;\n armed.current = pending;\n if (goneTimer.current) clearTimeout(goneTimer.current);\n goneTimer.current = setTimeout(\n () => {\n setPending((p) => (p && p.id === id ? null : p));\n latest.current.onGone?.(id);\n },\n phase === \"loaded\" ? JUMP_SETTLE_MS : 0,\n );\n return;\n }\n latest.current.onStart?.();\n setPending({ id, phase: \"loading\" });\n const settle = () => setPending((p) => (p && p.id === id ? { ...p, phase: \"loaded\" } : p));\n void latest.current.loadUntil(id).then(settle, settle);\n }, [pending, loading, has, go]);\n\n const cancel = useCallback(() => {\n if (goneTimer.current) clearTimeout(goneTimer.current);\n armed.current = null;\n setPending(null);\n }, [goneTimer]);\n\n return { highlightedId, jumping: pending !== null, cancel };\n}\n"]}
package/dist/csv.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { D as DataProvider, F as FieldSchema, S as SortParam, a as FilterParam } from './types-BzLv8yOm.js';
1
+ import { D as DataProvider, F as FieldSchema, S as SortParam, a as FilterParam } from './types-CtJxwoyv.js';
2
2
 
3
3
  /** RFC 4180 field: quoted when it holds a comma, quote or line break. */
4
4
  declare function csvField(value: unknown): string;
package/dist/errors.js CHANGED
@@ -1,6 +1,6 @@
1
- export { classifyError, defaultErrorReporter, errorMessages, getErrorReporter, isDevelopment, reportError, setErrorReporter } from './chunk-VFT6QKZW.js';
1
+ export { classifyError, defaultErrorReporter, errorMessages, getErrorReporter, isDevelopment, reportError, setErrorReporter } from './chunk-NOPS5EIH.js';
2
2
  import './chunk-HUNGCTRA.js';
3
3
  import './chunk-RYEXWQFD.js';
4
- import './chunk-LG6TUBVM.js';
4
+ import './chunk-WLDSIQJ2.js';
5
5
  //# sourceMappingURL=errors.js.map
6
6
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- export { m as FieldType, y as ResourceFormFieldDef, T as SelectOption } from './types-BzLv8yOm.js';
1
+ export { m as FieldType, y as ResourceFormFieldDef, T as SelectOption } from './types-CtJxwoyv.js';
@@ -1,4 +1,4 @@
1
- export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftController, isNetworkFailure, stableJson } from '../chunk-HBAPYA5K.js';
2
- import '../chunk-LG6TUBVM.js';
1
+ export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftController, isNetworkFailure, stableJson } from '../chunk-5ASUMG6K.js';
2
+ import '../chunk-WLDSIQJ2.js';
3
3
  //# sourceMappingURL=draft-controller.js.map
4
4
  //# sourceMappingURL=draft-controller.js.map
@@ -4,6 +4,7 @@ export { UseRelationLabelOptions, loadRelationLabel, relationNamingField, useRel
4
4
  export { LinkOption, LinkTarget, UseLinkOptionsOptions, UseLinkOptionsReturn, useLinkOptions } from './use-link-options.js';
5
5
  export { InfinitePageParam, UseInfiniteResourceOptions, UseInfiniteResourceReturn, useInfiniteResource } from './use-infinite-resource.js';
6
6
  export { useCapabilities } from './use-capabilities.js';
7
+ export { PersistedUiStateOptions, usePersistedUiState } from './use-persisted-ui-state.js';
7
8
  export { UseWriteOptions, UseWriteReturn, WRITE_FAILED, useWrite } from './use-write.js';
8
9
  export { UseDraftReturn, useDraft } from './use-draft.js';
9
10
  export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftAdoption, DraftController, DraftOptions, DraftSeed, DraftState, DraftStatus, DraftValue, isNetworkFailure, stableJson } from './draft-controller.js';
@@ -17,7 +18,7 @@ export { UseWizardReturn, WizardStep, useWizard } from './use-wizard.js';
17
18
  export { DEFAULT_UNDO_DELAY_MS, MutationMode, MutationModeOptions, UndoableWrite, dropPendingWrites, flushPendingWrites, pendingWriteCount } from './mutation-mode.js';
18
19
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, UseUnsavedChangesGuardOptions, UseUnsavedChangesGuardReturn, useUnsavedChangesGuard } from './use-unsaved-changes-guard.js';
19
20
  import '@tanstack/react-query';
20
- import '../types-BzLv8yOm.js';
21
+ import '../types-CtJxwoyv.js';
21
22
  import '../dates.js';
22
23
  import 'react-hook-form';
23
24
  import '../write-state-DVC4Yq9T.js';
@@ -1,31 +1,32 @@
1
- export { ViewerScope, WorkspaceScope, clearViewerCache, rememberedWorkspaceId, scopeClock, useOptionalViewerScope, useViewer, useViewerScope, useWorkspace } from '../chunk-AKF2RAGX.js';
1
+ export { ViewerScope, WorkspaceScope, clearViewerCache, rememberedWorkspaceId, scopeClock, useOptionalViewerScope, useViewer, useViewerScope, useWorkspace } from '../chunk-AHFIS42U.js';
2
2
  export { NO_VIEWER } from '../chunk-OZYF55E3.js';
3
- export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-3B5O36DU.js';
4
- import '../chunk-2WS4LGYU.js';
5
- export { useResource } from '../chunk-OC4OGB2K.js';
3
+ export { usePersistedUiState } from '../chunk-SDAJSJNN.js';
4
+ export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-OYDJGPDY.js';
5
+ import '../chunk-LKRJB632.js';
6
+ export { useResource } from '../chunk-P3FHXRS2.js';
6
7
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, useUnsavedChangesGuard } from '../chunk-RVWKVD5Q.js';
7
8
  export { useWizard } from '../chunk-7KOLYF27.js';
8
- export { WRITE_FAILED, useWrite } from '../chunk-52T2EYXH.js';
9
+ export { WRITE_FAILED, useWrite } from '../chunk-NQFIAULD.js';
9
10
  import '../chunk-7NUL32W7.js';
10
- export { useDraft } from '../chunk-YQBWXG2G.js';
11
- export { useLinkOptions } from '../chunk-VJGU6E4U.js';
12
- export { loadRelationLabel, relationNamingField, useRelationLabel } from '../chunk-42QPCDQF.js';
13
- export { useInfiniteResource } from '../chunk-POMTRNAL.js';
14
- export { useOne } from '../chunk-LOJGHR5O.js';
15
- export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-XVRIWP7B.js';
11
+ export { useDraft } from '../chunk-YZV3Z6ZA.js';
12
+ export { useLinkOptions } from '../chunk-DFABPMEQ.js';
13
+ export { loadRelationLabel, relationNamingField, useRelationLabel } from '../chunk-WDPM5TBO.js';
14
+ export { useInfiniteResource } from '../chunk-G6GQPXQS.js';
15
+ export { useOne } from '../chunk-NE2D74BP.js';
16
+ export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-S2VYJWB4.js';
16
17
  import '../chunk-UHOMTFBD.js';
17
- export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftController, isNetworkFailure, stableJson } from '../chunk-HBAPYA5K.js';
18
- export { DEFAULT_UNDO_DELAY_MS, dropPendingWrites, flushPendingWrites, pendingWriteCount } from '../chunk-YNXLPOAB.js';
19
- export { useCapabilities } from '../chunk-2VJQVAJD.js';
18
+ export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftController, isNetworkFailure, stableJson } from '../chunk-5ASUMG6K.js';
19
+ export { DEFAULT_UNDO_DELAY_MS, dropPendingWrites, flushPendingWrites, pendingWriteCount } from '../chunk-RFHUOXZC.js';
20
+ export { useCapabilities } from '../chunk-KA3BUJ4H.js';
20
21
  import '../chunk-AJGVLF37.js';
21
22
  import '../chunk-7PUFVNPB.js';
22
- import '../chunk-PSFKIG27.js';
23
- import '../chunk-ZYJUEJ4Z.js';
23
+ import '../chunk-2K4747KX.js';
24
+ import '../chunk-4PTQYT5J.js';
24
25
  import '../chunk-AUVKRXRC.js';
25
26
  import '../chunk-WXENWPWP.js';
26
- import '../chunk-VFT6QKZW.js';
27
+ import '../chunk-NOPS5EIH.js';
27
28
  import '../chunk-HUNGCTRA.js';
28
29
  import '../chunk-RYEXWQFD.js';
29
- import '../chunk-LG6TUBVM.js';
30
+ import '../chunk-WLDSIQJ2.js';
30
31
  //# sourceMappingURL=index.js.map
31
32
  //# sourceMappingURL=index.js.map
@@ -1,5 +1,5 @@
1
1
  import { QueryClient } from '@tanstack/react-query';
2
- import { b as Identifier, B as BaseRecord, D as DataProvider, c as AuditEntry } from '../types-BzLv8yOm.js';
2
+ import { b as Identifier, B as BaseRecord, D as DataProvider, c as AuditEntry } from '../types-CtJxwoyv.js';
3
3
 
4
4
  type MutationMode = "pessimistic" | "optimistic" | "undoable";
5
5
  /** How long an `undoable` write waits for an undo before it is sent. */
@@ -1,13 +1,13 @@
1
- export { DEFAULT_UNDO_DELAY_MS, DROPPED_WRITE_MESSAGE, cachedRecord, cachedVersion, dropPendingWrites, executeWrite, flushPendingWrites, invalidateResource, pendingWriteCount, providerServesUndo, sameValue } from '../chunk-YNXLPOAB.js';
2
- import '../chunk-2VJQVAJD.js';
1
+ export { DEFAULT_UNDO_DELAY_MS, DROPPED_WRITE_MESSAGE, cachedRecord, cachedVersion, dropPendingWrites, executeWrite, flushPendingWrites, invalidateResource, pendingWriteCount, providerServesUndo, sameValue } from '../chunk-RFHUOXZC.js';
2
+ import '../chunk-KA3BUJ4H.js';
3
3
  import '../chunk-AJGVLF37.js';
4
4
  import '../chunk-7PUFVNPB.js';
5
- import '../chunk-PSFKIG27.js';
6
- import '../chunk-ZYJUEJ4Z.js';
5
+ import '../chunk-2K4747KX.js';
6
+ import '../chunk-4PTQYT5J.js';
7
7
  import '../chunk-AUVKRXRC.js';
8
- import '../chunk-VFT6QKZW.js';
8
+ import '../chunk-NOPS5EIH.js';
9
9
  import '../chunk-HUNGCTRA.js';
10
10
  import '../chunk-RYEXWQFD.js';
11
- import '../chunk-LG6TUBVM.js';
11
+ import '../chunk-WLDSIQJ2.js';
12
12
  //# sourceMappingURL=mutation-mode.js.map
13
13
  //# sourceMappingURL=mutation-mode.js.map
@@ -1,4 +1,4 @@
1
- import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-BzLv8yOm.js';
1
+ import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-CtJxwoyv.js';
2
2
 
3
3
  /**
4
4
  * The cache keys a committed write makes stale beyond `[resource]`: the
@@ -1,5 +1,5 @@
1
1
  import { UseQueryResult } from '@tanstack/react-query';
2
- import { t as ProviderCapabilities } from '../types-BzLv8yOm.js';
2
+ import { t as ProviderCapabilities } from '../types-CtJxwoyv.js';
3
3
 
4
4
  /**
5
5
  * The query key for `provider`'s capabilities for `resource`. It includes
@@ -1,5 +1,5 @@
1
- export { capabilitiesQueryKey, useCapabilities } from '../chunk-2VJQVAJD.js';
2
- import '../chunk-PSFKIG27.js';
3
- import '../chunk-ZYJUEJ4Z.js';
1
+ export { capabilitiesQueryKey, useCapabilities } from '../chunk-KA3BUJ4H.js';
2
+ import '../chunk-2K4747KX.js';
3
+ import '../chunk-4PTQYT5J.js';
4
4
  //# sourceMappingURL=use-capabilities.js.map
5
5
  //# sourceMappingURL=use-capabilities.js.map
@@ -1,6 +1,6 @@
1
- export { useDraft } from '../chunk-YQBWXG2G.js';
2
- import '../chunk-HBAPYA5K.js';
1
+ export { useDraft } from '../chunk-YZV3Z6ZA.js';
2
+ import '../chunk-5ASUMG6K.js';
3
3
  import '../chunk-AJGVLF37.js';
4
- import '../chunk-LG6TUBVM.js';
4
+ import '../chunk-WLDSIQJ2.js';
5
5
  //# sourceMappingURL=use-draft.js.map
6
6
  //# sourceMappingURL=use-draft.js.map
@@ -1,5 +1,5 @@
1
1
  import { UseInfiniteQueryResult, InfiniteData } from '@tanstack/react-query';
2
- import { S as SortParam, a as FilterParam, s as ListResult, L as ListParams, B as BaseRecord } from '../types-BzLv8yOm.js';
2
+ import { S as SortParam, a as FilterParam, s as ListResult, L as ListParams, B as BaseRecord } from '../types-CtJxwoyv.js';
3
3
  import { LiveOptions } from './use-live.js';
4
4
 
5
5
  interface UseInfiniteResourceOptions {
@@ -1,8 +1,8 @@
1
- export { useInfiniteResource } from '../chunk-POMTRNAL.js';
2
- import '../chunk-XVRIWP7B.js';
1
+ export { useInfiniteResource } from '../chunk-G6GQPXQS.js';
2
+ import '../chunk-S2VYJWB4.js';
3
3
  import '../chunk-7PUFVNPB.js';
4
- import '../chunk-PSFKIG27.js';
5
- import '../chunk-ZYJUEJ4Z.js';
4
+ import '../chunk-2K4747KX.js';
5
+ import '../chunk-4PTQYT5J.js';
6
6
  import '../chunk-AUVKRXRC.js';
7
7
  //# sourceMappingURL=use-infinite-resource.js.map
8
8
  //# sourceMappingURL=use-infinite-resource.js.map
@@ -1,4 +1,4 @@
1
- import { a as FilterParam } from '../types-BzLv8yOm.js';
1
+ import { a as FilterParam } from '../types-CtJxwoyv.js';
2
2
 
3
3
  interface LinkTarget {
4
4
  /** The linked resource. */
@@ -16,6 +16,7 @@ interface LinkTarget {
16
16
  orderBy?: {
17
17
  readonly field: string;
18
18
  readonly direction?: "asc" | "desc" | undefined;
19
+ readonly nulls?: "first" | "last" | undefined;
19
20
  } | undefined;
20
21
  }
21
22
  interface UseLinkOptionsOptions {
@@ -1,10 +1,10 @@
1
- export { useLinkOptions } from '../chunk-VJGU6E4U.js';
2
- import '../chunk-42QPCDQF.js';
3
- import '../chunk-POMTRNAL.js';
4
- import '../chunk-XVRIWP7B.js';
1
+ export { useLinkOptions } from '../chunk-DFABPMEQ.js';
2
+ import '../chunk-WDPM5TBO.js';
3
+ import '../chunk-G6GQPXQS.js';
4
+ import '../chunk-S2VYJWB4.js';
5
5
  import '../chunk-7PUFVNPB.js';
6
- import '../chunk-PSFKIG27.js';
7
- import '../chunk-ZYJUEJ4Z.js';
6
+ import '../chunk-2K4747KX.js';
7
+ import '../chunk-4PTQYT5J.js';
8
8
  import '../chunk-AUVKRXRC.js';
9
9
  //# sourceMappingURL=use-link-options.js.map
10
10
  //# sourceMappingURL=use-link-options.js.map
@@ -1,5 +1,5 @@
1
1
  import { QueryKey } from '@tanstack/react-query';
2
- import { V as SubscribeParams, w as ResourceChangeEvent } from '../types-BzLv8yOm.js';
2
+ import { V as SubscribeParams, w as ResourceChangeEvent } from '../types-CtJxwoyv.js';
3
3
 
4
4
  /** How long a burst of change events is gathered into one refetch. */
5
5
  declare const DEFAULT_LIVE_DEBOUNCE_MS = 250;
@@ -1,6 +1,6 @@
1
- export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-XVRIWP7B.js';
2
- import '../chunk-PSFKIG27.js';
3
- import '../chunk-ZYJUEJ4Z.js';
1
+ export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-S2VYJWB4.js';
2
+ import '../chunk-2K4747KX.js';
3
+ import '../chunk-4PTQYT5J.js';
4
4
  import '../chunk-AUVKRXRC.js';
5
5
  //# sourceMappingURL=use-live.js.map
6
6
  //# sourceMappingURL=use-live.js.map
@@ -1,5 +1,5 @@
1
1
  import { UseQueryResult } from '@tanstack/react-query';
2
- import { B as BaseRecord, b as Identifier } from '../types-BzLv8yOm.js';
2
+ import { B as BaseRecord, b as Identifier } from '../types-CtJxwoyv.js';
3
3
  import { LiveOptions } from './use-live.js';
4
4
 
5
5
  interface UseOneOptions {
@@ -1,8 +1,8 @@
1
- export { useOne } from '../chunk-LOJGHR5O.js';
2
- import '../chunk-XVRIWP7B.js';
1
+ export { useOne } from '../chunk-NE2D74BP.js';
2
+ import '../chunk-S2VYJWB4.js';
3
3
  import '../chunk-7PUFVNPB.js';
4
- import '../chunk-PSFKIG27.js';
5
- import '../chunk-ZYJUEJ4Z.js';
4
+ import '../chunk-2K4747KX.js';
5
+ import '../chunk-4PTQYT5J.js';
6
6
  import '../chunk-AUVKRXRC.js';
7
7
  //# sourceMappingURL=use-one.js.map
8
8
  //# sourceMappingURL=use-one.js.map