@marktiderman/genesis-core 2.13.0 → 2.15.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 (94) hide show
  1. package/dist/aggregate-y-qqJioF.d.ts +34 -0
  2. package/dist/{chunk-7PUFVNPB.js → chunk-2IGAUXYH.js} +5 -3
  3. package/dist/chunk-2IGAUXYH.js.map +1 -0
  4. package/dist/{chunk-KA3BUJ4H.js → chunk-42NVJJTT.js} +3 -3
  5. package/dist/{chunk-KA3BUJ4H.js.map → chunk-42NVJJTT.js.map} +1 -1
  6. package/dist/{chunk-JN47G4UE.js → chunk-7EFTWOMA.js} +56 -2
  7. package/dist/chunk-7EFTWOMA.js.map +1 -0
  8. package/dist/{chunk-S2VYJWB4.js → chunk-E3K2A3PK.js} +3 -3
  9. package/dist/{chunk-S2VYJWB4.js.map → chunk-E3K2A3PK.js.map} +1 -1
  10. package/dist/{chunk-SDAJSJNN.js → chunk-IYGVJFCV.js} +3 -3
  11. package/dist/{chunk-SDAJSJNN.js.map → chunk-IYGVJFCV.js.map} +1 -1
  12. package/dist/chunk-J54XXKQD.js +104 -0
  13. package/dist/chunk-J54XXKQD.js.map +1 -0
  14. package/dist/{chunk-OYDJGPDY.js → chunk-JFHRSG6G.js} +5 -5
  15. package/dist/{chunk-OYDJGPDY.js.map → chunk-JFHRSG6G.js.map} +1 -1
  16. package/dist/{chunk-UHOMTFBD.js → chunk-JTRRAVR4.js} +55 -3
  17. package/dist/chunk-JTRRAVR4.js.map +1 -0
  18. package/dist/{chunk-KV2HW4G4.js → chunk-LB6FMQQM.js} +11 -3
  19. package/dist/chunk-LB6FMQQM.js.map +1 -0
  20. package/dist/{chunk-G6GQPXQS.js → chunk-M5IX7C6U.js} +5 -5
  21. package/dist/{chunk-G6GQPXQS.js.map → chunk-M5IX7C6U.js.map} +1 -1
  22. package/dist/{chunk-AHFIS42U.js → chunk-NZP7YQHS.js} +5 -5
  23. package/dist/{chunk-AHFIS42U.js.map → chunk-NZP7YQHS.js.map} +1 -1
  24. package/dist/{chunk-DFABPMEQ.js → chunk-POUI7GAI.js} +5 -5
  25. package/dist/{chunk-DFABPMEQ.js.map → chunk-POUI7GAI.js.map} +1 -1
  26. package/dist/{chunk-NE2D74BP.js → chunk-QGWQ6LK3.js} +5 -5
  27. package/dist/{chunk-NE2D74BP.js.map → chunk-QGWQ6LK3.js.map} +1 -1
  28. package/dist/{chunk-2K4747KX.js → chunk-R3YXYVWF.js} +7 -2
  29. package/dist/chunk-R3YXYVWF.js.map +1 -0
  30. package/dist/{chunk-RFHUOXZC.js → chunk-SOO54YYY.js} +4 -4
  31. package/dist/{chunk-RFHUOXZC.js.map → chunk-SOO54YYY.js.map} +1 -1
  32. package/dist/{chunk-P3FHXRS2.js → chunk-TKK7D2ZT.js} +6 -6
  33. package/dist/{chunk-P3FHXRS2.js.map → chunk-TKK7D2ZT.js.map} +1 -1
  34. package/dist/{chunk-WDPM5TBO.js → chunk-UDSTWXXZ.js} +3 -3
  35. package/dist/{chunk-WDPM5TBO.js.map → chunk-UDSTWXXZ.js.map} +1 -1
  36. package/dist/chunk-XPBS5YE4.js +24 -0
  37. package/dist/chunk-XPBS5YE4.js.map +1 -0
  38. package/dist/csv.d.ts +1 -1
  39. package/dist/form-types.d.ts +1 -1
  40. package/dist/gallery/index.d.ts +5 -0
  41. package/dist/gallery/index.js.map +1 -1
  42. package/dist/hooks/index.d.ts +4 -2
  43. package/dist/hooks/index.js +16 -14
  44. package/dist/hooks/mutation-mode.d.ts +1 -1
  45. package/dist/hooks/mutation-mode.js +5 -4
  46. package/dist/hooks/related-keys.d.ts +1 -1
  47. package/dist/hooks/use-aggregate.d.ts +25 -0
  48. package/dist/hooks/use-aggregate.js +10 -0
  49. package/dist/hooks/use-aggregate.js.map +1 -0
  50. package/dist/hooks/use-capabilities.d.ts +1 -1
  51. package/dist/hooks/use-capabilities.js +4 -2
  52. package/dist/hooks/use-infinite-resource.d.ts +1 -1
  53. package/dist/hooks/use-infinite-resource.js +6 -4
  54. package/dist/hooks/use-link-options.d.ts +1 -1
  55. package/dist/hooks/use-link-options.js +8 -6
  56. package/dist/hooks/use-live.d.ts +1 -1
  57. package/dist/hooks/use-live.js +4 -2
  58. package/dist/hooks/use-one.d.ts +1 -1
  59. package/dist/hooks/use-one.js +6 -4
  60. package/dist/hooks/use-persisted-ui-state.js +4 -2
  61. package/dist/hooks/use-relation-label.d.ts +1 -1
  62. package/dist/hooks/use-relation-label.js +4 -2
  63. package/dist/hooks/use-resource-form.d.ts +1 -1
  64. package/dist/hooks/use-resource-form.js +8 -7
  65. package/dist/hooks/use-resource.d.ts +1 -1
  66. package/dist/hooks/use-resource.js +7 -6
  67. package/dist/hooks/use-write.d.ts +1 -1
  68. package/dist/index.d.ts +110 -6
  69. package/dist/index.js +125 -17
  70. package/dist/index.js.map +1 -1
  71. package/dist/navigation.d.ts +77 -1
  72. package/dist/navigation.js +32 -2
  73. package/dist/navigation.js.map +1 -1
  74. package/dist/provider/index.d.ts +12 -4
  75. package/dist/provider/index.js +3 -2
  76. package/dist/resource-view/index.d.ts +456 -166
  77. package/dist/resource-view/index.js +251 -5
  78. package/dist/resource-view/index.js.map +1 -1
  79. package/dist/schema/index.d.ts +3 -3
  80. package/dist/schema/index.js +1 -2
  81. package/dist/testing/index.d.ts +2 -2
  82. package/dist/{types-CtJxwoyv.d.ts → types-D4Bi_Iq8.d.ts} +76 -3
  83. package/dist/workspaces-BKhloJPK.d.ts +255 -0
  84. package/dist/workspaces.d.ts +2 -160
  85. package/dist/workspaces.js +1 -1
  86. package/dist/{write-outcome-Goy1v39G.d.ts → write-outcome-CHPT7Slm.d.ts} +1 -1
  87. package/package.json +1 -1
  88. package/dist/chunk-2K4747KX.js.map +0 -1
  89. package/dist/chunk-7PUFVNPB.js.map +0 -1
  90. package/dist/chunk-JN47G4UE.js.map +0 -1
  91. package/dist/chunk-KV2HW4G4.js.map +0 -1
  92. package/dist/chunk-UHOMTFBD.js.map +0 -1
  93. package/dist/chunk-YDMKMNDS.js +0 -8
  94. package/dist/chunk-YDMKMNDS.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-resource.ts"],"names":["keepPreviousData","keepPreviousPlaceholder","options"],"mappings":"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","file":"chunk-P3FHXRS2.js","sourcesContent":["import { useState, useCallback, useMemo } from \"react\";\nimport {\n keepPreviousData as keepPreviousPlaceholder,\n useQuery,\n useMutation,\n useQueryClient,\n type UseQueryResult,\n type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type {\n BaseRecord,\n Identifier,\n SortParam,\n FilterParam,\n ListParams,\n ListResult,\n InvalidationKey,\n WriteEvent,\n} from \"../provider/types\";\nimport { relatedKeys } from \"./related-keys\";\nimport {\n cachedRecord,\n executeWrite,\n invalidateResource,\n type MutationModeOptions,\n} from \"./mutation-mode\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { resourceKeys } from \"../query-keys\";\nimport { DataWriteError, isDataWriteError, NO_ROWS_MATCHED } from \"../schema/write-outcome\";\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceOptions<T> extends MutationModeOptions {\n defaultSort?: SortParam;\n /**\n * Re-synced whenever its value changes (deep-equal, order-independent),\n * not just its identity — safe to pass a scope/audience-derived array that\n * changes across renders. This only covers CHANGES on an already-mounted\n * hook, though: if this starts `undefined` while the real value resolves\n * asynchronously, gate `enabled` on that same readiness signal too — the\n * hook cannot tell \"no defaultFilters intended\" apart from \"not resolved\n * yet,\" so an ungated hook's very first fetch can still run unscoped.\n */\n defaultFilters?: FilterParam[];\n defaultPerPage?: number;\n /** The page to start on (from 1), e.g. restored from the URL. Default 1. */\n defaultPage?: number;\n /** The search to start with, e.g. restored from the URL. Default \"\". */\n defaultSearch?: string;\n /** Supabase select/join syntax, e.g. \"*, author:profiles(name)\". */\n select?: string;\n /** Fields to search across when setSearch is called. Required for server-side search. */\n searchFields?: string[];\n /** Disable auto-fetching. */\n enabled?: boolean;\n /**\n * Other query keys to invalidate after a create, update or delete, on top\n * of `[resource]` and the provider's own `invalidates` (e.g. `[[\"me\"]]`\n * when a write changes the signed-in user's roles).\n */\n invalidates?: InvalidationKey[];\n /**\n * While the next page / sort / search is loading, keep returning the\n * previous result (`list.isPlaceholderData` is true meanwhile) instead of\n * dropping to `undefined`. A paged list then stays on screen between pages\n * rather than flashing a skeleton. Default false.\n */\n keepPreviousData?: boolean;\n /**\n * Keep the list current while mounted: subscribe to the provider's change\n * events (`DataProvider.subscribe`) and refetch this resource's cached\n * reads (lists and records) when it reports one, once per burst of\n * events. Events are hints: rows always come from the provider's normal\n * read. Pending optimistic and undoable writes stay applied over the\n * refetch. Needs a provider that serves `subscribe` for the resource\n * (`capabilities(resource).realtime`); otherwise it does nothing. Off by\n * default.\n */\n live?: boolean | LiveOptions;\n /**\n * After the write commits, with the provider's row. In `optimistic` and\n * `undoable` modes that is after `create` / `update` / `remove` have\n * already resolved.\n */\n onCreateSuccess?: (data: T) => void;\n onUpdateSuccess?: (data: T) => void;\n onDeleteSuccess?: () => void;\n /**\n * A write failed. In `optimistic` and `undoable` modes this is the only\n * place a failure is reported (the cache has already been put back), so\n * show it to the user here.\n */\n onError?: (error: Error) => void;\n}\n\n/** What `update` can take beside the change. */\nexport interface UpdateOptions {\n /**\n * Check the write against this version instead of the cached row's: \"keep mine\" after a\n * conflict, at the version the conflict reported (`WriteConflict.currentVersion`). A version\n * already chained for the row wins over it: a write sent while an earlier write of the same row\n * is still in flight is checked against the version that one commits (as\n * `ExecuteWriteArgs.expectedVersion`). The write\n * still goes through the resource's write path (queued behind any other write of the row, its\n * committed version recorded), so a move made right after it is checked against it.\n */\n expectedVersion?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Return type\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceReturn<T> {\n /** TanStack Query result for the list query. */\n list: UseQueryResult<ListResult<T>>;\n /** Current list params (pagination, sort, filters, search). */\n params: ListParams;\n setSort: (sort: SortParam | undefined) => void;\n setFilters: (filters: FilterParam[]) => void;\n setPage: (page: number) => void;\n setPerPage: (perPage: number) => void;\n setSearch: (query: string) => void;\n /**\n * Create a new record. Returns the created item. In `optimistic` and\n * `undoable` modes it resolves at once with the values given (no `id` yet;\n * `onCreateSuccess` gets the stored row).\n */\n create: (data: Partial<T>) => Promise<T>;\n /**\n * Update an existing record by id. Returns the updated item. In\n * `optimistic` and `undoable` modes it resolves at once with the cached\n * row merged with `data`.\n */\n update: (id: Identifier, data: Partial<T>, options?: UpdateOptions) => Promise<T>;\n /** Delete a record by id. Resolves at once in `optimistic` / `undoable` modes. */\n remove: (id: Identifier) => Promise<void>;\n /** True when any mutation is in-flight. */\n isMutating: boolean;\n createMutation: UseMutationResult<T, Error, Partial<T>>;\n updateMutation: UseMutationResult<T, Error, { id: Identifier; data: Partial<T>; options?: UpdateOptions }>;\n deleteMutation: UseMutationResult<void, Error, Identifier>;\n}\n\n// ---------------------------------------------------------------------------\n// Filter identity — a deep-equality key independent of object-key order, so\n// a caller that rebuilds the same logical filters via a differently-ordered\n// spread (e.g. `{...base, operator: \"eq\"}` vs `{operator: \"eq\", ...base}`)\n// doesn't trip a spurious resync + pagination reset on an unrelated rerender.\n// ---------------------------------------------------------------------------\n\nfunction stableFilterKey(filters: FilterParam[] | undefined): string | undefined {\n if (!filters) return undefined;\n return JSON.stringify(\n filters.map((f) => {\n const sorted: Record<string, unknown> = {};\n for (const key of Object.keys(f).sort()) {\n sorted[key] = (f as unknown as Record<string, unknown>)[key];\n }\n return sorted;\n }),\n );\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useResource<T extends BaseRecord = BaseRecord>(\n resource: string,\n options: UseResourceOptions<T> = {},\n): UseResourceReturn<T> {\n const {\n defaultSort,\n defaultFilters,\n defaultPerPage = 25,\n defaultPage = 1,\n defaultSearch = \"\",\n select,\n searchFields: searchFieldsOption,\n enabled = true,\n invalidates,\n keepPreviousData = false,\n live,\n onCreateSuccess,\n onUpdateSuccess,\n onDeleteSuccess,\n onError,\n mutationMode = \"pessimistic\",\n undoDelayMs,\n onUndoable,\n } = options;\n\n const provider = useDataProvider();\n const queryClient = useQueryClient();\n\n // -------------------------------------------------------------------------\n // State\n // -------------------------------------------------------------------------\n\n const [sort, setSortRaw] = useState<SortParam | undefined>(defaultSort);\n const [filters, setFiltersRaw] = useState<FilterParam[]>(defaultFilters ?? []);\n const [page, setPage] = useState(Math.max(1, Math.floor(defaultPage)));\n const [perPage, setPerPageRaw] = useState(defaultPerPage);\n const [searchQuery, setSearchQuery] = useState(defaultSearch);\n\n // `defaultFilters` often resolves asynchronously — a caller's scope/audience\n // (team, project, ...) can still be loading on first render, so the array\n // it passes in changes value (not just identity) after mount, and may later\n // clear back to undefined (e.g. the scope itself is cleared). Re-syncing\n // here, during render rather than in an effect, means `filters` is already\n // correct by the time `params`/`list` below compute for this pass — no\n // stray unscoped fetch on the frame before an effect would have caught up.\n //\n // This only closes the gap for `defaultFilters` CHANGING across renders on\n // an already-mounted, already-enabled hook (e.g. a scope switch). It cannot\n // help the very first render: `filters` still seeds from whatever\n // `defaultFilters` is on mount, and `undefined` here is genuinely ambiguous\n // between \"this caller never uses defaultFilters\" (in which case forcing a\n // fetch to wait would break it forever) and \"the real value hasn't resolved\n // yet.\" A caller in the second case MUST also gate `enabled` on that same\n // readiness signal for its very first fetch to be correctly scoped — this\n // hook has no way to tell the two cases apart on its own.\n const defaultFiltersKey = stableFilterKey(defaultFilters);\n const [syncedFiltersKey, setSyncedFiltersKey] = useState(defaultFiltersKey);\n if (defaultFiltersKey !== syncedFiltersKey) {\n setSyncedFiltersKey(defaultFiltersKey);\n setFiltersRaw(defaultFilters ?? []);\n setPage(1);\n }\n\n const setSort = useCallback((s: SortParam | undefined) => {\n setSortRaw(s);\n setPage(1);\n }, []);\n\n const setFilters = useCallback((f: FilterParam[]) => {\n setFiltersRaw(f);\n setPage(1);\n }, []);\n\n const setPerPage = useCallback((value: number) => {\n setPerPageRaw(value);\n setPage(1);\n }, []);\n\n const setSearch = useCallback((query: string) => {\n setSearchQuery(query);\n setPage(1);\n }, []);\n\n // -------------------------------------------------------------------------\n // Params\n // -------------------------------------------------------------------------\n\n const params = useMemo<ListParams>(() => {\n const p: ListParams = {\n pagination: { page, perPage },\n sort,\n filters: filters.length > 0 ? filters : undefined,\n select,\n };\n if (searchQuery && searchFieldsOption && searchFieldsOption.length > 0) {\n p.search = { query: searchQuery, fields: searchFieldsOption };\n }\n return p;\n }, [page, perPage, sort, filters, select, searchQuery, searchFieldsOption]);\n\n // -------------------------------------------------------------------------\n // List query\n // -------------------------------------------------------------------------\n\n const listQueryKey = useMemo(\n () => resourceKeys(resource).list(params),\n [resource, params],\n );\n\n const list = useQuery<ListResult<T>>({\n queryKey: listQueryKey,\n queryFn: () => provider.getList<T>(resource, params),\n enabled,\n placeholderData: keepPreviousData ? keepPreviousPlaceholder : undefined,\n });\n\n // Every cached read of the resource: its lists, and the records a peek or\n // detail page shows from it.\n useLiveInvalidation(resource, live, enabled, { filters: params.filters }, [resource]);\n\n // -------------------------------------------------------------------------\n // Mutations\n // -------------------------------------------------------------------------\n\n const invalidateAfter = useCallback(\n (event: WriteEvent) => {\n // Pending optimistic/undoable patches are re-applied to the refetch.\n void invalidateResource(queryClient, resource);\n for (const queryKey of relatedKeys(provider, event, invalidates)) {\n void queryClient.invalidateQueries({ queryKey: [...queryKey] });\n }\n },\n [queryClient, resource, provider, invalidates],\n );\n\n const defaultOnError = useCallback(\n (error: Error) => {\n // A conflict is an outcome the caller shows (a conflict sheet), not a failure to log.\n if (isDataWriteError(error) && error.outcome === \"conflict\" && error.current) return;\n console.error(`[useResource] ${resource} mutation failed:`, error.message);\n },\n [resource],\n );\n const reportError = onError ?? defaultOnError;\n\n const modeArgs = {\n queryClient,\n provider,\n resource,\n mode: mutationMode,\n undoDelayMs,\n onUndoable,\n failedLater: reportError,\n };\n\n const createMutation = useMutation<T, Error, Partial<T>>({\n mutationFn: async (data) => {\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"create\",\n data: data as Record<string, unknown>,\n send: async ({ keepalive }) => {\n const result = await provider.create<T>(resource, { data, ...(keepalive ? { keepalive } : {}) });\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"create\", id: record.id, record });\n onCreateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\" ? outcome.record : (data as T);\n },\n onError: reportError,\n });\n\n const updateMutation = useMutation<\n T,\n Error,\n { id: Identifier; data: Partial<T>; options?: UpdateOptions }\n >({\n mutationFn: async ({ id, data, options }) => {\n const before = cachedRecord(queryClient, resource, id);\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"update\",\n id,\n data: data as Record<string, unknown>,\n ...(options?.expectedVersion !== undefined ? { expectedVersion: options.expectedVersion } : {}),\n send: async (ctx) => {\n const result = await provider.update<T>(resource, {\n id,\n data: (ctx.data ?? data) as Partial<T>,\n ...(ctx.keepalive ? { keepalive: true } : {}),\n ...(ctx.expectedVersion !== undefined ? { expectedVersion: ctx.expectedVersion } : {}),\n });\n // A write that matched no rows didn't save, whatever provider says so this way: it fails\n // here, before it counts as committed, so it never reads as a silent success.\n if (result.data === null || result.data === undefined) {\n throw new DataWriteError(\"forbidden\", \"This change wasn't saved: no row matched it.\", { code: NO_ROWS_MATCHED });\n }\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"update\", id, record });\n onUpdateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\"\n ? outcome.record\n : ({ ...(before ?? {}), ...data, id: before?.id ?? id } as T);\n },\n onError: reportError,\n });\n\n const deleteMutation = useMutation<void, Error, Identifier>({\n mutationFn: async (id) => {\n await executeWrite<void>({\n ...modeArgs,\n kind: \"delete\",\n id,\n send: async ({ keepalive, expectedVersion }) => {\n const result = await provider.deleteOne(resource, {\n id,\n ...(keepalive ? { keepalive } : {}),\n ...(expectedVersion !== undefined ? { expectedVersion } : {}),\n });\n return { record: undefined, audit: result?.audit };\n },\n committed: () => {\n invalidateAfter({ resource, kind: \"delete\", id });\n onDeleteSuccess?.();\n },\n });\n },\n onError: reportError,\n });\n\n // -------------------------------------------------------------------------\n // Convenience wrappers\n // -------------------------------------------------------------------------\n\n const create = useCallback(\n (data: Partial<T>) => createMutation.mutateAsync(data),\n [createMutation],\n );\n\n const update = useCallback(\n (id: Identifier, data: Partial<T>, options?: UpdateOptions) =>\n updateMutation.mutateAsync(options ? { id, data, options } : { id, data }),\n [updateMutation],\n );\n\n const remove = useCallback(\n (id: Identifier) => deleteMutation.mutateAsync(id),\n [deleteMutation],\n );\n\n const isMutating =\n createMutation.isPending ||\n updateMutation.isPending ||\n deleteMutation.isPending;\n\n return {\n list,\n params,\n setSort,\n setFilters,\n setPage,\n setPerPage,\n setSearch,\n create,\n update,\n remove,\n isMutating,\n createMutation,\n updateMutation,\n deleteMutation,\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-resource.ts"],"names":["keepPreviousData","keepPreviousPlaceholder","options"],"mappings":"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","file":"chunk-TKK7D2ZT.js","sourcesContent":["import { useState, useCallback, useMemo } from \"react\";\nimport {\n keepPreviousData as keepPreviousPlaceholder,\n useQuery,\n useMutation,\n useQueryClient,\n type UseQueryResult,\n type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type {\n BaseRecord,\n Identifier,\n SortParam,\n FilterParam,\n ListParams,\n ListResult,\n InvalidationKey,\n WriteEvent,\n} from \"../provider/types\";\nimport { relatedKeys } from \"./related-keys\";\nimport {\n cachedRecord,\n executeWrite,\n invalidateResource,\n type MutationModeOptions,\n} from \"./mutation-mode\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { resourceKeys } from \"../query-keys\";\nimport { DataWriteError, isDataWriteError, NO_ROWS_MATCHED } from \"../schema/write-outcome\";\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceOptions<T> extends MutationModeOptions {\n defaultSort?: SortParam;\n /**\n * Re-synced whenever its value changes (deep-equal, order-independent),\n * not just its identity — safe to pass a scope/audience-derived array that\n * changes across renders. This only covers CHANGES on an already-mounted\n * hook, though: if this starts `undefined` while the real value resolves\n * asynchronously, gate `enabled` on that same readiness signal too — the\n * hook cannot tell \"no defaultFilters intended\" apart from \"not resolved\n * yet,\" so an ungated hook's very first fetch can still run unscoped.\n */\n defaultFilters?: FilterParam[];\n defaultPerPage?: number;\n /** The page to start on (from 1), e.g. restored from the URL. Default 1. */\n defaultPage?: number;\n /** The search to start with, e.g. restored from the URL. Default \"\". */\n defaultSearch?: string;\n /** Supabase select/join syntax, e.g. \"*, author:profiles(name)\". */\n select?: string;\n /** Fields to search across when setSearch is called. Required for server-side search. */\n searchFields?: string[];\n /** Disable auto-fetching. */\n enabled?: boolean;\n /**\n * Other query keys to invalidate after a create, update or delete, on top\n * of `[resource]` and the provider's own `invalidates` (e.g. `[[\"me\"]]`\n * when a write changes the signed-in user's roles).\n */\n invalidates?: InvalidationKey[];\n /**\n * While the next page / sort / search is loading, keep returning the\n * previous result (`list.isPlaceholderData` is true meanwhile) instead of\n * dropping to `undefined`. A paged list then stays on screen between pages\n * rather than flashing a skeleton. Default false.\n */\n keepPreviousData?: boolean;\n /**\n * Keep the list current while mounted: subscribe to the provider's change\n * events (`DataProvider.subscribe`) and refetch this resource's cached\n * reads (lists and records) when it reports one, once per burst of\n * events. Events are hints: rows always come from the provider's normal\n * read. Pending optimistic and undoable writes stay applied over the\n * refetch. Needs a provider that serves `subscribe` for the resource\n * (`capabilities(resource).realtime`); otherwise it does nothing. Off by\n * default.\n */\n live?: boolean | LiveOptions;\n /**\n * After the write commits, with the provider's row. In `optimistic` and\n * `undoable` modes that is after `create` / `update` / `remove` have\n * already resolved.\n */\n onCreateSuccess?: (data: T) => void;\n onUpdateSuccess?: (data: T) => void;\n onDeleteSuccess?: () => void;\n /**\n * A write failed. In `optimistic` and `undoable` modes this is the only\n * place a failure is reported (the cache has already been put back), so\n * show it to the user here.\n */\n onError?: (error: Error) => void;\n}\n\n/** What `update` can take beside the change. */\nexport interface UpdateOptions {\n /**\n * Check the write against this version instead of the cached row's: \"keep mine\" after a\n * conflict, at the version the conflict reported (`WriteConflict.currentVersion`). A version\n * already chained for the row wins over it: a write sent while an earlier write of the same row\n * is still in flight is checked against the version that one commits (as\n * `ExecuteWriteArgs.expectedVersion`). The write\n * still goes through the resource's write path (queued behind any other write of the row, its\n * committed version recorded), so a move made right after it is checked against it.\n */\n expectedVersion?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Return type\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceReturn<T> {\n /** TanStack Query result for the list query. */\n list: UseQueryResult<ListResult<T>>;\n /** Current list params (pagination, sort, filters, search). */\n params: ListParams;\n setSort: (sort: SortParam | undefined) => void;\n setFilters: (filters: FilterParam[]) => void;\n setPage: (page: number) => void;\n setPerPage: (perPage: number) => void;\n setSearch: (query: string) => void;\n /**\n * Create a new record. Returns the created item. In `optimistic` and\n * `undoable` modes it resolves at once with the values given (no `id` yet;\n * `onCreateSuccess` gets the stored row).\n */\n create: (data: Partial<T>) => Promise<T>;\n /**\n * Update an existing record by id. Returns the updated item. In\n * `optimistic` and `undoable` modes it resolves at once with the cached\n * row merged with `data`.\n */\n update: (id: Identifier, data: Partial<T>, options?: UpdateOptions) => Promise<T>;\n /** Delete a record by id. Resolves at once in `optimistic` / `undoable` modes. */\n remove: (id: Identifier) => Promise<void>;\n /** True when any mutation is in-flight. */\n isMutating: boolean;\n createMutation: UseMutationResult<T, Error, Partial<T>>;\n updateMutation: UseMutationResult<T, Error, { id: Identifier; data: Partial<T>; options?: UpdateOptions }>;\n deleteMutation: UseMutationResult<void, Error, Identifier>;\n}\n\n// ---------------------------------------------------------------------------\n// Filter identity — a deep-equality key independent of object-key order, so\n// a caller that rebuilds the same logical filters via a differently-ordered\n// spread (e.g. `{...base, operator: \"eq\"}` vs `{operator: \"eq\", ...base}`)\n// doesn't trip a spurious resync + pagination reset on an unrelated rerender.\n// ---------------------------------------------------------------------------\n\nfunction stableFilterKey(filters: FilterParam[] | undefined): string | undefined {\n if (!filters) return undefined;\n return JSON.stringify(\n filters.map((f) => {\n const sorted: Record<string, unknown> = {};\n for (const key of Object.keys(f).sort()) {\n sorted[key] = (f as unknown as Record<string, unknown>)[key];\n }\n return sorted;\n }),\n );\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useResource<T extends BaseRecord = BaseRecord>(\n resource: string,\n options: UseResourceOptions<T> = {},\n): UseResourceReturn<T> {\n const {\n defaultSort,\n defaultFilters,\n defaultPerPage = 25,\n defaultPage = 1,\n defaultSearch = \"\",\n select,\n searchFields: searchFieldsOption,\n enabled = true,\n invalidates,\n keepPreviousData = false,\n live,\n onCreateSuccess,\n onUpdateSuccess,\n onDeleteSuccess,\n onError,\n mutationMode = \"pessimistic\",\n undoDelayMs,\n onUndoable,\n } = options;\n\n const provider = useDataProvider();\n const queryClient = useQueryClient();\n\n // -------------------------------------------------------------------------\n // State\n // -------------------------------------------------------------------------\n\n const [sort, setSortRaw] = useState<SortParam | undefined>(defaultSort);\n const [filters, setFiltersRaw] = useState<FilterParam[]>(defaultFilters ?? []);\n const [page, setPage] = useState(Math.max(1, Math.floor(defaultPage)));\n const [perPage, setPerPageRaw] = useState(defaultPerPage);\n const [searchQuery, setSearchQuery] = useState(defaultSearch);\n\n // `defaultFilters` often resolves asynchronously — a caller's scope/audience\n // (team, project, ...) can still be loading on first render, so the array\n // it passes in changes value (not just identity) after mount, and may later\n // clear back to undefined (e.g. the scope itself is cleared). Re-syncing\n // here, during render rather than in an effect, means `filters` is already\n // correct by the time `params`/`list` below compute for this pass — no\n // stray unscoped fetch on the frame before an effect would have caught up.\n //\n // This only closes the gap for `defaultFilters` CHANGING across renders on\n // an already-mounted, already-enabled hook (e.g. a scope switch). It cannot\n // help the very first render: `filters` still seeds from whatever\n // `defaultFilters` is on mount, and `undefined` here is genuinely ambiguous\n // between \"this caller never uses defaultFilters\" (in which case forcing a\n // fetch to wait would break it forever) and \"the real value hasn't resolved\n // yet.\" A caller in the second case MUST also gate `enabled` on that same\n // readiness signal for its very first fetch to be correctly scoped — this\n // hook has no way to tell the two cases apart on its own.\n const defaultFiltersKey = stableFilterKey(defaultFilters);\n const [syncedFiltersKey, setSyncedFiltersKey] = useState(defaultFiltersKey);\n if (defaultFiltersKey !== syncedFiltersKey) {\n setSyncedFiltersKey(defaultFiltersKey);\n setFiltersRaw(defaultFilters ?? []);\n setPage(1);\n }\n\n const setSort = useCallback((s: SortParam | undefined) => {\n setSortRaw(s);\n setPage(1);\n }, []);\n\n const setFilters = useCallback((f: FilterParam[]) => {\n setFiltersRaw(f);\n setPage(1);\n }, []);\n\n const setPerPage = useCallback((value: number) => {\n setPerPageRaw(value);\n setPage(1);\n }, []);\n\n const setSearch = useCallback((query: string) => {\n setSearchQuery(query);\n setPage(1);\n }, []);\n\n // -------------------------------------------------------------------------\n // Params\n // -------------------------------------------------------------------------\n\n const params = useMemo<ListParams>(() => {\n const p: ListParams = {\n pagination: { page, perPage },\n sort,\n filters: filters.length > 0 ? filters : undefined,\n select,\n };\n if (searchQuery && searchFieldsOption && searchFieldsOption.length > 0) {\n p.search = { query: searchQuery, fields: searchFieldsOption };\n }\n return p;\n }, [page, perPage, sort, filters, select, searchQuery, searchFieldsOption]);\n\n // -------------------------------------------------------------------------\n // List query\n // -------------------------------------------------------------------------\n\n const listQueryKey = useMemo(\n () => resourceKeys(resource).list(params),\n [resource, params],\n );\n\n const list = useQuery<ListResult<T>>({\n queryKey: listQueryKey,\n queryFn: () => provider.getList<T>(resource, params),\n enabled,\n placeholderData: keepPreviousData ? keepPreviousPlaceholder : undefined,\n });\n\n // Every cached read of the resource: its lists, and the records a peek or\n // detail page shows from it.\n useLiveInvalidation(resource, live, enabled, { filters: params.filters }, [resource]);\n\n // -------------------------------------------------------------------------\n // Mutations\n // -------------------------------------------------------------------------\n\n const invalidateAfter = useCallback(\n (event: WriteEvent) => {\n // Pending optimistic/undoable patches are re-applied to the refetch.\n void invalidateResource(queryClient, resource);\n for (const queryKey of relatedKeys(provider, event, invalidates)) {\n void queryClient.invalidateQueries({ queryKey: [...queryKey] });\n }\n },\n [queryClient, resource, provider, invalidates],\n );\n\n const defaultOnError = useCallback(\n (error: Error) => {\n // A conflict is an outcome the caller shows (a conflict sheet), not a failure to log.\n if (isDataWriteError(error) && error.outcome === \"conflict\" && error.current) return;\n console.error(`[useResource] ${resource} mutation failed:`, error.message);\n },\n [resource],\n );\n const reportError = onError ?? defaultOnError;\n\n const modeArgs = {\n queryClient,\n provider,\n resource,\n mode: mutationMode,\n undoDelayMs,\n onUndoable,\n failedLater: reportError,\n };\n\n const createMutation = useMutation<T, Error, Partial<T>>({\n mutationFn: async (data) => {\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"create\",\n data: data as Record<string, unknown>,\n send: async ({ keepalive }) => {\n const result = await provider.create<T>(resource, { data, ...(keepalive ? { keepalive } : {}) });\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"create\", id: record.id, record });\n onCreateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\" ? outcome.record : (data as T);\n },\n onError: reportError,\n });\n\n const updateMutation = useMutation<\n T,\n Error,\n { id: Identifier; data: Partial<T>; options?: UpdateOptions }\n >({\n mutationFn: async ({ id, data, options }) => {\n const before = cachedRecord(queryClient, resource, id);\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"update\",\n id,\n data: data as Record<string, unknown>,\n ...(options?.expectedVersion !== undefined ? { expectedVersion: options.expectedVersion } : {}),\n send: async (ctx) => {\n const result = await provider.update<T>(resource, {\n id,\n data: (ctx.data ?? data) as Partial<T>,\n ...(ctx.keepalive ? { keepalive: true } : {}),\n ...(ctx.expectedVersion !== undefined ? { expectedVersion: ctx.expectedVersion } : {}),\n });\n // A write that matched no rows didn't save, whatever provider says so this way: it fails\n // here, before it counts as committed, so it never reads as a silent success.\n if (result.data === null || result.data === undefined) {\n throw new DataWriteError(\"forbidden\", \"This change wasn't saved: no row matched it.\", { code: NO_ROWS_MATCHED });\n }\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"update\", id, record });\n onUpdateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\"\n ? outcome.record\n : ({ ...(before ?? {}), ...data, id: before?.id ?? id } as T);\n },\n onError: reportError,\n });\n\n const deleteMutation = useMutation<void, Error, Identifier>({\n mutationFn: async (id) => {\n await executeWrite<void>({\n ...modeArgs,\n kind: \"delete\",\n id,\n send: async ({ keepalive, expectedVersion }) => {\n const result = await provider.deleteOne(resource, {\n id,\n ...(keepalive ? { keepalive } : {}),\n ...(expectedVersion !== undefined ? { expectedVersion } : {}),\n });\n return { record: undefined, audit: result?.audit };\n },\n committed: () => {\n invalidateAfter({ resource, kind: \"delete\", id });\n onDeleteSuccess?.();\n },\n });\n },\n onError: reportError,\n });\n\n // -------------------------------------------------------------------------\n // Convenience wrappers\n // -------------------------------------------------------------------------\n\n const create = useCallback(\n (data: Partial<T>) => createMutation.mutateAsync(data),\n [createMutation],\n );\n\n const update = useCallback(\n (id: Identifier, data: Partial<T>, options?: UpdateOptions) =>\n updateMutation.mutateAsync(options ? { id, data, options } : { id, data }),\n [updateMutation],\n );\n\n const remove = useCallback(\n (id: Identifier) => deleteMutation.mutateAsync(id),\n [deleteMutation],\n );\n\n const isMutating =\n createMutation.isPending ||\n updateMutation.isPending ||\n deleteMutation.isPending;\n\n return {\n list,\n params,\n setSort,\n setFilters,\n setPage,\n setPerPage,\n setSearch,\n create,\n update,\n remove,\n isMutating,\n createMutation,\n updateMutation,\n deleteMutation,\n };\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { useDataProvider } from './chunk-2K4747KX.js';
1
+ import { useDataProvider } from './chunk-R3YXYVWF.js';
2
2
  import { useQuery } from '@tanstack/react-query';
3
3
 
4
4
  var CHUNK = 100;
@@ -130,5 +130,5 @@ function useRelationLabel(reference, id, options = {}) {
130
130
  }
131
131
 
132
132
  export { loadRelationLabel, relationNamingField, useRelationLabel };
133
- //# sourceMappingURL=chunk-WDPM5TBO.js.map
134
- //# sourceMappingURL=chunk-WDPM5TBO.js.map
133
+ //# sourceMappingURL=chunk-UDSTWXXZ.js.map
134
+ //# sourceMappingURL=chunk-UDSTWXXZ.js.map
@@ -1 +1 @@
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
+ {"version":3,"sources":["../src/hooks/use-relation-label.ts"],"names":[],"mappings":"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","file":"chunk-UDSTWXXZ.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"]}
@@ -0,0 +1,24 @@
1
+ import { useLiveInvalidation } from './chunk-E3K2A3PK.js';
2
+ import { resourceKeys } from './chunk-2IGAUXYH.js';
3
+ import { useDataProvider } from './chunk-R3YXYVWF.js';
4
+ import { resolveAggregate } from './chunk-J54XXKQD.js';
5
+ import { useQuery } from '@tanstack/react-query';
6
+
7
+ function useAggregate(resource, params, options = {}) {
8
+ const provider = useDataProvider();
9
+ const { enabled = true, live, pageSize, maxRows } = options;
10
+ const key = resourceKeys(resource).aggregate(params);
11
+ useLiveInvalidation(resource, live, enabled, params.filters ? { filters: params.filters } : {}, key);
12
+ return useQuery({
13
+ queryKey: key,
14
+ queryFn: () => resolveAggregate(provider, resource, params, {
15
+ ...pageSize !== void 0 ? { pageSize } : {},
16
+ ...maxRows !== void 0 ? { maxRows } : {}
17
+ }),
18
+ enabled
19
+ });
20
+ }
21
+
22
+ export { useAggregate };
23
+ //# sourceMappingURL=chunk-XPBS5YE4.js.map
24
+ //# sourceMappingURL=chunk-XPBS5YE4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/hooks/use-aggregate.ts"],"names":[],"mappings":";;;;;;AAyBO,SAAS,YAAA,CACd,QAAA,EACA,MAAA,EACA,OAAA,GAA+B,EAAC,EACC;AACjC,EAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,EAAA,MAAM,EAAE,OAAA,GAAU,IAAA,EAAM,IAAA,EAAM,QAAA,EAAU,SAAQ,GAAI,OAAA;AACpD,EAAA,MAAM,GAAA,GAAM,YAAA,CAAa,QAAQ,CAAA,CAAE,UAAU,MAAM,CAAA;AACnD,EAAA,mBAAA,CAAoB,QAAA,EAAU,IAAA,EAAM,OAAA,EAAS,MAAA,CAAO,OAAA,GAAU,EAAE,OAAA,EAAS,MAAA,CAAO,OAAA,EAAQ,GAAI,EAAC,EAAG,GAAG,CAAA;AACnG,EAAA,OAAO,QAAA,CAA0B;AAAA,IAC/B,QAAA,EAAU,GAAA;AAAA,IACV,OAAA,EAAS,MACP,gBAAA,CAAiB,QAAA,EAAU,UAAU,MAAA,EAAQ;AAAA,MAC3C,GAAI,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,KAAa,EAAC;AAAA,MAC7C,GAAI,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,KAAY;AAAC,KAC5C,CAAA;AAAA,IACH;AAAA,GACD,CAAA;AACH","file":"chunk-XPBS5YE4.js","sourcesContent":["import { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport { resolveAggregate, type ResolveAggregateOptions } from \"../provider/aggregate\";\nimport type { AggregateParams, AggregateResult } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\n\nexport interface UseAggregateOptions extends ResolveAggregateOptions {\n /** Default true. False waits (on a scope, say) and fetches nothing. */\n enabled?: boolean;\n /**\n * Keep the totals current while mounted: work them out again when the provider reports a\n * change to the resource (`DataProvider.subscribe`). Off by default.\n */\n live?: boolean | LiveOptions;\n}\n\n/**\n * Totals over a resource's rows (count, and sum, average, lowest or highest of a field), through\n * the data provider: its `aggregate`, or `resolveAggregate`'s fallback. Cached under the\n * resource's key, so any write to the resource through Genesis makes them stale, and `live`\n * keeps them current with changes made elsewhere. A widget reads a view's totals with it.\n *\n * @stability Beta\n */\nexport function useAggregate(\n resource: string,\n params: AggregateParams,\n options: UseAggregateOptions = {},\n): UseQueryResult<AggregateResult> {\n const provider = useDataProvider();\n const { enabled = true, live, pageSize, maxRows } = options;\n const key = resourceKeys(resource).aggregate(params);\n useLiveInvalidation(resource, live, enabled, params.filters ? { filters: params.filters } : {}, key);\n return useQuery<AggregateResult>({\n queryKey: key,\n queryFn: () =>\n resolveAggregate(provider, resource, params, {\n ...(pageSize !== undefined ? { pageSize } : {}),\n ...(maxRows !== undefined ? { maxRows } : {}),\n }),\n enabled,\n });\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-CtJxwoyv.js';
1
+ import { D as DataProvider, F as FieldSchema, S as SortParam, a as FilterParam } from './types-D4Bi_Iq8.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;
@@ -1 +1 @@
1
- export { m as FieldType, y as ResourceFormFieldDef, T as SelectOption } from './types-CtJxwoyv.js';
1
+ export { t as FieldType, R as ResourceFormFieldDef, Z as SelectOption } from './types-D4Bi_Iq8.js';
@@ -24,6 +24,11 @@ interface GalleryItem {
24
24
  width?: number;
25
25
  height?: number;
26
26
  caption?: string;
27
+ /**
28
+ * Native only: caches the picture under this key instead of `src` (`NativeImage`'s
29
+ * `cacheKey`), for signed URLs that rotate. The web grid ignores it.
30
+ */
31
+ cacheKey?: string;
27
32
  }
28
33
  /**
29
34
  * The gallery's defaults, the same on web and native: a target row height and the space between
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/gallery/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The gallery's data and layout, the same on every platform: one image's shape, the defaults, and\n * the justified-rows packing. genesis-ui's `GalleryGrid` and genesis-ui-native's\n * `NativeGalleryGrid` both lay out with `justifyRows` from here, as does ResourceView's\n * `mode=\"grid\"` over a view's `gallery` block, so the same items pack into the same rows anywhere.\n *\n * Pure: no React, no DOM.\n *\n * @stability Beta\n */\n\n/**\n * One image in a gallery. Shared by `GalleryGrid`, `Lightbox` and their native twins, so a\n * consumer passes the same array to the grid and to the viewer it opens.\n *\n * `width`/`height` are the image's intrinsic pixel size when known; the justified layout uses\n * their ratio to pack rows and falls back to 4:3 when they are absent.\n *\n * @stability Beta\n */\nexport interface GalleryItem {\n id: string;\n src: string;\n alt?: string;\n width?: number;\n height?: number;\n caption?: string;\n}\n\n/**\n * The gallery's defaults, the same on web and native: a target row height and the space between\n * tiles (px on web, points on native), and the columns of `layout=\"grid\"`.\n *\n * @stability Beta\n */\nexport const GALLERY_DEFAULTS = { rowHeight: 180, gap: 4, columns: 3 } as const;\n\n/**\n * A `layout=\"grid\"` tile's shape: a ratio (width / height; 1 is square, the default), or `\"item\"`\n * for each item's own (its `width`/`height`, 4:3 when unknown).\n *\n * @stability Beta\n */\nexport type GalleryTileAspect = number | \"item\";\n\n/** Used when an item has no `width`/`height` (or a degenerate one). */\nexport const DEFAULT_GALLERY_RATIO = 4 / 3;\n\nexport interface JustifiedTile {\n item: GalleryItem;\n /** Index of `item` in the input array. */\n index: number;\n width: number;\n height: number;\n}\n\nexport interface JustifiedRow {\n tiles: JustifiedTile[];\n /** The row's height after scaling to fill the container. */\n height: number;\n}\n\n/** Width ÷ height of an item, falling back to 4:3. */\nexport function galleryItemRatio(item: GalleryItem): number {\n const { width, height } = item;\n if (\n typeof width === \"number\" &&\n typeof height === \"number\" &&\n Number.isFinite(width) &&\n Number.isFinite(height) &&\n width > 0 &&\n height > 0\n ) {\n return width / height;\n }\n return DEFAULT_GALLERY_RATIO;\n}\n\n/**\n * Pack `items` into rows of a target `rowHeight`, then scale each row so its\n * tiles exactly fill `containerWidth` (minus `gap` between tiles). Pure: same\n * input, same rows.\n *\n * Greedy, as in the classic justified-gallery algorithm: tiles are added at\n * the target height until the row would overflow; the row is then closed at\n * whichever of \"with\" / \"without\" the overflowing tile is nearer the target\n * width, and scaled to fit. The last row is scaled too, but never above the\n * target height (a single landscape photo in the last row should not fill\n * the width as a banner); it is left-aligned at the target height instead.\n *\n * `containerWidth <= 0` (not measured yet) yields no rows, so callers render\n * nothing rather than divide by zero.\n */\nexport function justifyRows(\n items: readonly GalleryItem[],\n containerWidth: number,\n rowHeight: number,\n gap: number,\n): JustifiedRow[] {\n if (!(containerWidth > 0) || !(rowHeight > 0) || items.length === 0) return [];\n const spacing = Math.max(0, gap);\n\n const rows: JustifiedRow[] = [];\n let pending: JustifiedTile[] = [];\n let pendingWidth = 0; // tile widths only, no gaps\n\n const rowWidthWithGaps = (tiles: JustifiedTile[], widthSum: number) =>\n widthSum + spacing * Math.max(0, tiles.length - 1);\n\n const close = (tiles: JustifiedTile[], widthSum: number, capAtTarget: boolean) => {\n if (tiles.length === 0) return;\n const available = containerWidth - spacing * (tiles.length - 1);\n let scale = available > 0 ? available / widthSum : 1;\n if (capAtTarget && scale > 1) scale = 1;\n rows.push({\n height: rowHeight * scale,\n tiles: tiles.map((t) => ({\n ...t,\n width: t.width * scale,\n height: t.height * scale,\n })),\n });\n };\n\n items.forEach((item, index) => {\n const tile: JustifiedTile = {\n item,\n index,\n width: galleryItemRatio(item) * rowHeight,\n height: rowHeight,\n };\n const withTile = [...pending, tile];\n const withTileWidth = rowWidthWithGaps(withTile, pendingWidth + tile.width);\n\n if (withTileWidth < containerWidth) {\n pending = withTile;\n pendingWidth += tile.width;\n return;\n }\n\n // Overflow. Close the row with or without this tile, whichever is closer\n // to the container width; a row must hold at least one tile.\n const withoutWidth = rowWidthWithGaps(pending, pendingWidth);\n const keep =\n pending.length === 0 ||\n Math.abs(withTileWidth - containerWidth) <= Math.abs(containerWidth - withoutWidth);\n\n if (keep) {\n close(withTile, pendingWidth + tile.width, false);\n pending = [];\n pendingWidth = 0;\n } else {\n close(pending, pendingWidth, false);\n pending = [tile];\n pendingWidth = tile.width;\n }\n });\n\n close(pending, pendingWidth, true);\n return rows;\n}\n"]}
1
+ {"version":3,"sources":["../../src/gallery/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * The gallery's data and layout, the same on every platform: one image's shape, the defaults, and\n * the justified-rows packing. genesis-ui's `GalleryGrid` and genesis-ui-native's\n * `NativeGalleryGrid` both lay out with `justifyRows` from here, as does ResourceView's\n * `mode=\"grid\"` over a view's `gallery` block, so the same items pack into the same rows anywhere.\n *\n * Pure: no React, no DOM.\n *\n * @stability Beta\n */\n\n/**\n * One image in a gallery. Shared by `GalleryGrid`, `Lightbox` and their native twins, so a\n * consumer passes the same array to the grid and to the viewer it opens.\n *\n * `width`/`height` are the image's intrinsic pixel size when known; the justified layout uses\n * their ratio to pack rows and falls back to 4:3 when they are absent.\n *\n * @stability Beta\n */\nexport interface GalleryItem {\n id: string;\n src: string;\n alt?: string;\n width?: number;\n height?: number;\n caption?: string;\n /**\n * Native only: caches the picture under this key instead of `src` (`NativeImage`'s\n * `cacheKey`), for signed URLs that rotate. The web grid ignores it.\n */\n cacheKey?: string;\n}\n\n/**\n * The gallery's defaults, the same on web and native: a target row height and the space between\n * tiles (px on web, points on native), and the columns of `layout=\"grid\"`.\n *\n * @stability Beta\n */\nexport const GALLERY_DEFAULTS = { rowHeight: 180, gap: 4, columns: 3 } as const;\n\n/**\n * A `layout=\"grid\"` tile's shape: a ratio (width / height; 1 is square, the default), or `\"item\"`\n * for each item's own (its `width`/`height`, 4:3 when unknown).\n *\n * @stability Beta\n */\nexport type GalleryTileAspect = number | \"item\";\n\n/** Used when an item has no `width`/`height` (or a degenerate one). */\nexport const DEFAULT_GALLERY_RATIO = 4 / 3;\n\nexport interface JustifiedTile {\n item: GalleryItem;\n /** Index of `item` in the input array. */\n index: number;\n width: number;\n height: number;\n}\n\nexport interface JustifiedRow {\n tiles: JustifiedTile[];\n /** The row's height after scaling to fill the container. */\n height: number;\n}\n\n/** Width ÷ height of an item, falling back to 4:3. */\nexport function galleryItemRatio(item: GalleryItem): number {\n const { width, height } = item;\n if (\n typeof width === \"number\" &&\n typeof height === \"number\" &&\n Number.isFinite(width) &&\n Number.isFinite(height) &&\n width > 0 &&\n height > 0\n ) {\n return width / height;\n }\n return DEFAULT_GALLERY_RATIO;\n}\n\n/**\n * Pack `items` into rows of a target `rowHeight`, then scale each row so its\n * tiles exactly fill `containerWidth` (minus `gap` between tiles). Pure: same\n * input, same rows.\n *\n * Greedy, as in the classic justified-gallery algorithm: tiles are added at\n * the target height until the row would overflow; the row is then closed at\n * whichever of \"with\" / \"without\" the overflowing tile is nearer the target\n * width, and scaled to fit. The last row is scaled too, but never above the\n * target height (a single landscape photo in the last row should not fill\n * the width as a banner); it is left-aligned at the target height instead.\n *\n * `containerWidth <= 0` (not measured yet) yields no rows, so callers render\n * nothing rather than divide by zero.\n */\nexport function justifyRows(\n items: readonly GalleryItem[],\n containerWidth: number,\n rowHeight: number,\n gap: number,\n): JustifiedRow[] {\n if (!(containerWidth > 0) || !(rowHeight > 0) || items.length === 0) return [];\n const spacing = Math.max(0, gap);\n\n const rows: JustifiedRow[] = [];\n let pending: JustifiedTile[] = [];\n let pendingWidth = 0; // tile widths only, no gaps\n\n const rowWidthWithGaps = (tiles: JustifiedTile[], widthSum: number) =>\n widthSum + spacing * Math.max(0, tiles.length - 1);\n\n const close = (tiles: JustifiedTile[], widthSum: number, capAtTarget: boolean) => {\n if (tiles.length === 0) return;\n const available = containerWidth - spacing * (tiles.length - 1);\n let scale = available > 0 ? available / widthSum : 1;\n if (capAtTarget && scale > 1) scale = 1;\n rows.push({\n height: rowHeight * scale,\n tiles: tiles.map((t) => ({\n ...t,\n width: t.width * scale,\n height: t.height * scale,\n })),\n });\n };\n\n items.forEach((item, index) => {\n const tile: JustifiedTile = {\n item,\n index,\n width: galleryItemRatio(item) * rowHeight,\n height: rowHeight,\n };\n const withTile = [...pending, tile];\n const withTileWidth = rowWidthWithGaps(withTile, pendingWidth + tile.width);\n\n if (withTileWidth < containerWidth) {\n pending = withTile;\n pendingWidth += tile.width;\n return;\n }\n\n // Overflow. Close the row with or without this tile, whichever is closer\n // to the container width; a row must hold at least one tile.\n const withoutWidth = rowWidthWithGaps(pending, pendingWidth);\n const keep =\n pending.length === 0 ||\n Math.abs(withTileWidth - containerWidth) <= Math.abs(containerWidth - withoutWidth);\n\n if (keep) {\n close(withTile, pendingWidth + tile.width, false);\n pending = [];\n pendingWidth = 0;\n } else {\n close(pending, pendingWidth, false);\n pending = [tile];\n pendingWidth = tile.width;\n }\n });\n\n close(pending, pendingWidth, true);\n return rows;\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  export { UpdateOptions, UseResourceOptions, UseResourceReturn, useResource } from './use-resource.js';
2
2
  export { UseOneOptions, useOne } from './use-one.js';
3
+ export { UseAggregateOptions, useAggregate } from './use-aggregate.js';
3
4
  export { UseRelationLabelOptions, loadRelationLabel, relationNamingField, useRelationLabel } from './use-relation-label.js';
4
5
  export { LinkOption, LinkTarget, UseLinkOptionsOptions, UseLinkOptionsReturn, useLinkOptions } from './use-link-options.js';
5
6
  export { InfinitePageParam, UseInfiniteResourceOptions, UseInfiniteResourceReturn, useInfiniteResource } from './use-infinite-resource.js';
@@ -11,14 +12,15 @@ export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftAdoption, DraftController
11
12
  import { c as ViewerScopeProps } from '../viewer-scope-Dx0N9AYk.js';
12
13
  export { G as GenesisViewerRoles, N as NO_VIEWER, R as ResourceScope, V as Viewer, a as ViewerContext, b as ViewerScope, d as clearViewerCache, s as scopeClock, u as useOptionalViewerScope, e as useViewer, f as useViewerScope } from '../viewer-scope-Dx0N9AYk.js';
13
14
  import * as react from 'react';
14
- import { Workspace, WorkspaceHrefOptions } from '../workspaces.js';
15
+ import { W as Workspace, g as WorkspaceHrefOptions } from '../workspaces-BKhloJPK.js';
15
16
  export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, LiveOptions, useLiveInvalidation } from './use-live.js';
16
17
  export { UseResourceFormOptions, UseResourceFormReturn, blankValues, buildArrayItemDefaults, useResourceForm } from './use-resource-form.js';
17
18
  export { UseWizardReturn, WizardStep, useWizard } from './use-wizard.js';
18
19
  export { DEFAULT_UNDO_DELAY_MS, MutationMode, MutationModeOptions, UndoableWrite, dropPendingWrites, flushPendingWrites, pendingWriteCount } from './mutation-mode.js';
19
20
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, UseUnsavedChangesGuardOptions, UseUnsavedChangesGuardReturn, useUnsavedChangesGuard } from './use-unsaved-changes-guard.js';
20
21
  import '@tanstack/react-query';
21
- import '../types-CtJxwoyv.js';
22
+ import '../types-D4Bi_Iq8.js';
23
+ import '../aggregate-y-qqJioF.js';
22
24
  import '../dates.js';
23
25
  import 'react-hook-form';
24
26
  import '../write-state-DVC4Yq9T.js';
@@ -1,26 +1,28 @@
1
- export { ViewerScope, WorkspaceScope, clearViewerCache, rememberedWorkspaceId, scopeClock, useOptionalViewerScope, useViewer, useViewerScope, useWorkspace } from '../chunk-AHFIS42U.js';
1
+ export { ViewerScope, WorkspaceScope, clearViewerCache, rememberedWorkspaceId, scopeClock, useOptionalViewerScope, useViewer, useViewerScope, useWorkspace } from '../chunk-NZP7YQHS.js';
2
2
  export { NO_VIEWER } from '../chunk-OZYF55E3.js';
3
- export { usePersistedUiState } from '../chunk-SDAJSJNN.js';
4
- export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-OYDJGPDY.js';
3
+ export { usePersistedUiState } from '../chunk-IYGVJFCV.js';
4
+ export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-JFHRSG6G.js';
5
5
  import '../chunk-LKRJB632.js';
6
- export { useResource } from '../chunk-P3FHXRS2.js';
6
+ export { useOne } from '../chunk-QGWQ6LK3.js';
7
+ export { useResource } from '../chunk-TKK7D2ZT.js';
7
8
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, useUnsavedChangesGuard } from '../chunk-RVWKVD5Q.js';
8
9
  export { useWizard } from '../chunk-7KOLYF27.js';
9
10
  export { WRITE_FAILED, useWrite } from '../chunk-NQFIAULD.js';
10
11
  import '../chunk-7NUL32W7.js';
12
+ export { useAggregate } from '../chunk-XPBS5YE4.js';
11
13
  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';
17
- import '../chunk-UHOMTFBD.js';
14
+ export { useLinkOptions } from '../chunk-POUI7GAI.js';
15
+ export { loadRelationLabel, relationNamingField, useRelationLabel } from '../chunk-UDSTWXXZ.js';
16
+ export { useInfiniteResource } from '../chunk-M5IX7C6U.js';
17
+ export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-E3K2A3PK.js';
18
+ import '../chunk-JTRRAVR4.js';
18
19
  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
+ export { DEFAULT_UNDO_DELAY_MS, dropPendingWrites, flushPendingWrites, pendingWriteCount } from '../chunk-SOO54YYY.js';
21
+ export { useCapabilities } from '../chunk-42NVJJTT.js';
21
22
  import '../chunk-AJGVLF37.js';
22
- import '../chunk-7PUFVNPB.js';
23
- import '../chunk-2K4747KX.js';
23
+ import '../chunk-2IGAUXYH.js';
24
+ import '../chunk-R3YXYVWF.js';
25
+ import '../chunk-J54XXKQD.js';
24
26
  import '../chunk-4PTQYT5J.js';
25
27
  import '../chunk-AUVKRXRC.js';
26
28
  import '../chunk-WXENWPWP.js';
@@ -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-CtJxwoyv.js';
2
+ import { d as Identifier, B as BaseRecord, D as DataProvider, h as AuditEntry } from '../types-D4Bi_Iq8.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,8 +1,9 @@
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';
1
+ export { DEFAULT_UNDO_DELAY_MS, DROPPED_WRITE_MESSAGE, cachedRecord, cachedVersion, dropPendingWrites, executeWrite, flushPendingWrites, invalidateResource, pendingWriteCount, providerServesUndo, sameValue } from '../chunk-SOO54YYY.js';
2
+ import '../chunk-42NVJJTT.js';
3
3
  import '../chunk-AJGVLF37.js';
4
- import '../chunk-7PUFVNPB.js';
5
- import '../chunk-2K4747KX.js';
4
+ import '../chunk-2IGAUXYH.js';
5
+ import '../chunk-R3YXYVWF.js';
6
+ import '../chunk-J54XXKQD.js';
6
7
  import '../chunk-4PTQYT5J.js';
7
8
  import '../chunk-AUVKRXRC.js';
8
9
  import '../chunk-NOPS5EIH.js';
@@ -1,4 +1,4 @@
1
- import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-CtJxwoyv.js';
1
+ import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-D4Bi_Iq8.js';
2
2
 
3
3
  /**
4
4
  * The cache keys a committed write makes stale beyond `[resource]`: the
@@ -0,0 +1,25 @@
1
+ import { UseQueryResult } from '@tanstack/react-query';
2
+ import { R as ResolveAggregateOptions } from '../aggregate-y-qqJioF.js';
3
+ import { A as AggregateParams, b as AggregateResult } from '../types-D4Bi_Iq8.js';
4
+ import { LiveOptions } from './use-live.js';
5
+
6
+ interface UseAggregateOptions extends ResolveAggregateOptions {
7
+ /** Default true. False waits (on a scope, say) and fetches nothing. */
8
+ enabled?: boolean;
9
+ /**
10
+ * Keep the totals current while mounted: work them out again when the provider reports a
11
+ * change to the resource (`DataProvider.subscribe`). Off by default.
12
+ */
13
+ live?: boolean | LiveOptions;
14
+ }
15
+ /**
16
+ * Totals over a resource's rows (count, and sum, average, lowest or highest of a field), through
17
+ * the data provider: its `aggregate`, or `resolveAggregate`'s fallback. Cached under the
18
+ * resource's key, so any write to the resource through Genesis makes them stale, and `live`
19
+ * keeps them current with changes made elsewhere. A widget reads a view's totals with it.
20
+ *
21
+ * @stability Beta
22
+ */
23
+ declare function useAggregate(resource: string, params: AggregateParams, options?: UseAggregateOptions): UseQueryResult<AggregateResult>;
24
+
25
+ export { type UseAggregateOptions, useAggregate };
@@ -0,0 +1,10 @@
1
+ export { useAggregate } from '../chunk-XPBS5YE4.js';
2
+ import '../chunk-E3K2A3PK.js';
3
+ import '../chunk-2IGAUXYH.js';
4
+ import '../chunk-R3YXYVWF.js';
5
+ import '../chunk-J54XXKQD.js';
6
+ import '../chunk-4PTQYT5J.js';
7
+ import '../chunk-AUVKRXRC.js';
8
+ import '../chunk-HUNGCTRA.js';
9
+ //# sourceMappingURL=use-aggregate.js.map
10
+ //# sourceMappingURL=use-aggregate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"use-aggregate.js"}
@@ -1,5 +1,5 @@
1
1
  import { UseQueryResult } from '@tanstack/react-query';
2
- import { t as ProviderCapabilities } from '../types-CtJxwoyv.js';
2
+ import { P as ProviderCapabilities } from '../types-D4Bi_Iq8.js';
3
3
 
4
4
  /**
5
5
  * The query key for `provider`'s capabilities for `resource`. It includes
@@ -1,5 +1,7 @@
1
- export { capabilitiesQueryKey, useCapabilities } from '../chunk-KA3BUJ4H.js';
2
- import '../chunk-2K4747KX.js';
1
+ export { capabilitiesQueryKey, useCapabilities } from '../chunk-42NVJJTT.js';
2
+ import '../chunk-R3YXYVWF.js';
3
+ import '../chunk-J54XXKQD.js';
3
4
  import '../chunk-4PTQYT5J.js';
5
+ import '../chunk-HUNGCTRA.js';
4
6
  //# sourceMappingURL=use-capabilities.js.map
5
7
  //# sourceMappingURL=use-capabilities.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-CtJxwoyv.js';
2
+ import { S as SortParam, a as FilterParam, L as ListResult, c as ListParams, B as BaseRecord } from '../types-D4Bi_Iq8.js';
3
3
  import { LiveOptions } from './use-live.js';
4
4
 
5
5
  interface UseInfiniteResourceOptions {
@@ -1,8 +1,10 @@
1
- export { useInfiniteResource } from '../chunk-G6GQPXQS.js';
2
- import '../chunk-S2VYJWB4.js';
3
- import '../chunk-7PUFVNPB.js';
4
- import '../chunk-2K4747KX.js';
1
+ export { useInfiniteResource } from '../chunk-M5IX7C6U.js';
2
+ import '../chunk-E3K2A3PK.js';
3
+ import '../chunk-2IGAUXYH.js';
4
+ import '../chunk-R3YXYVWF.js';
5
+ import '../chunk-J54XXKQD.js';
5
6
  import '../chunk-4PTQYT5J.js';
6
7
  import '../chunk-AUVKRXRC.js';
8
+ import '../chunk-HUNGCTRA.js';
7
9
  //# sourceMappingURL=use-infinite-resource.js.map
8
10
  //# sourceMappingURL=use-infinite-resource.js.map
@@ -1,4 +1,4 @@
1
- import { a as FilterParam } from '../types-CtJxwoyv.js';
1
+ import { a as FilterParam } from '../types-D4Bi_Iq8.js';
2
2
 
3
3
  interface LinkTarget {
4
4
  /** The linked resource. */
@@ -1,10 +1,12 @@
1
- export { useLinkOptions } from '../chunk-DFABPMEQ.js';
2
- import '../chunk-WDPM5TBO.js';
3
- import '../chunk-G6GQPXQS.js';
4
- import '../chunk-S2VYJWB4.js';
5
- import '../chunk-7PUFVNPB.js';
6
- import '../chunk-2K4747KX.js';
1
+ export { useLinkOptions } from '../chunk-POUI7GAI.js';
2
+ import '../chunk-UDSTWXXZ.js';
3
+ import '../chunk-M5IX7C6U.js';
4
+ import '../chunk-E3K2A3PK.js';
5
+ import '../chunk-2IGAUXYH.js';
6
+ import '../chunk-R3YXYVWF.js';
7
+ import '../chunk-J54XXKQD.js';
7
8
  import '../chunk-4PTQYT5J.js';
8
9
  import '../chunk-AUVKRXRC.js';
10
+ import '../chunk-HUNGCTRA.js';
9
11
  //# sourceMappingURL=use-link-options.js.map
10
12
  //# 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-CtJxwoyv.js';
2
+ import { f as SubscribeParams, g as ResourceChangeEvent } from '../types-D4Bi_Iq8.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,8 @@
1
- export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-S2VYJWB4.js';
2
- import '../chunk-2K4747KX.js';
1
+ export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation } from '../chunk-E3K2A3PK.js';
2
+ import '../chunk-R3YXYVWF.js';
3
+ import '../chunk-J54XXKQD.js';
3
4
  import '../chunk-4PTQYT5J.js';
4
5
  import '../chunk-AUVKRXRC.js';
6
+ import '../chunk-HUNGCTRA.js';
5
7
  //# sourceMappingURL=use-live.js.map
6
8
  //# 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-CtJxwoyv.js';
2
+ import { B as BaseRecord, d as Identifier } from '../types-D4Bi_Iq8.js';
3
3
  import { LiveOptions } from './use-live.js';
4
4
 
5
5
  interface UseOneOptions {
@@ -1,8 +1,10 @@
1
- export { useOne } from '../chunk-NE2D74BP.js';
2
- import '../chunk-S2VYJWB4.js';
3
- import '../chunk-7PUFVNPB.js';
4
- import '../chunk-2K4747KX.js';
1
+ export { useOne } from '../chunk-QGWQ6LK3.js';
2
+ import '../chunk-E3K2A3PK.js';
3
+ import '../chunk-2IGAUXYH.js';
4
+ import '../chunk-R3YXYVWF.js';
5
+ import '../chunk-J54XXKQD.js';
5
6
  import '../chunk-4PTQYT5J.js';
6
7
  import '../chunk-AUVKRXRC.js';
8
+ import '../chunk-HUNGCTRA.js';
7
9
  //# sourceMappingURL=use-one.js.map
8
10
  //# sourceMappingURL=use-one.js.map
@@ -1,5 +1,7 @@
1
- export { usePersistedUiState } from '../chunk-SDAJSJNN.js';
2
- import '../chunk-2K4747KX.js';
1
+ export { usePersistedUiState } from '../chunk-IYGVJFCV.js';
2
+ import '../chunk-R3YXYVWF.js';
3
+ import '../chunk-J54XXKQD.js';
3
4
  import '../chunk-4PTQYT5J.js';
5
+ import '../chunk-HUNGCTRA.js';
4
6
  //# sourceMappingURL=use-persisted-ui-state.js.map
5
7
  //# sourceMappingURL=use-persisted-ui-state.js.map
@@ -1,4 +1,4 @@
1
- import { D as DataProvider, l as FieldReference, b as Identifier } from '../types-CtJxwoyv.js';
1
+ import { D as DataProvider, e as FieldReference, d as Identifier } from '../types-D4Bi_Iq8.js';
2
2
 
3
3
  interface UseRelationLabelOptions {
4
4
  /** The linked row's field that names it. Default: the linked resource's `labelField` (`describe`). */