@marktiderman/genesis-core 2.17.0 → 2.18.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 (80) hide show
  1. package/dist/{aggregate-v_r-nZbH.d.ts → aggregate-CUirs7ka.d.ts} +1 -1
  2. package/dist/{chunk-UNEZF3ZP.js → chunk-5PCGMSDX.js} +209 -28
  3. package/dist/chunk-5PCGMSDX.js.map +1 -0
  4. package/dist/{chunk-JNWTHDGF.js → chunk-AOIVTOHX.js} +3 -3
  5. package/dist/{chunk-JNWTHDGF.js.map → chunk-AOIVTOHX.js.map} +1 -1
  6. package/dist/{chunk-FBMKI22S.js → chunk-ATVK3VYS.js} +3 -3
  7. package/dist/{chunk-FBMKI22S.js.map → chunk-ATVK3VYS.js.map} +1 -1
  8. package/dist/{chunk-NOPS5EIH.js → chunk-CJ5V6JES.js} +5 -114
  9. package/dist/chunk-CJ5V6JES.js.map +1 -0
  10. package/dist/{chunk-TWLPC4S3.js → chunk-DJRT4DUF.js} +3 -3
  11. package/dist/{chunk-TWLPC4S3.js.map → chunk-DJRT4DUF.js.map} +1 -1
  12. package/dist/{chunk-WNOCPV4A.js → chunk-DTVYCATJ.js} +3 -3
  13. package/dist/{chunk-WNOCPV4A.js.map → chunk-DTVYCATJ.js.map} +1 -1
  14. package/dist/chunk-LYNIHY3F.js +115 -0
  15. package/dist/chunk-LYNIHY3F.js.map +1 -0
  16. package/dist/{chunk-6B4CN2TC.js → chunk-OCMYW2YE.js} +3 -3
  17. package/dist/{chunk-6B4CN2TC.js.map → chunk-OCMYW2YE.js.map} +1 -1
  18. package/dist/{chunk-AQX5HQD6.js → chunk-OTUTSAZD.js} +3 -3
  19. package/dist/{chunk-AQX5HQD6.js.map → chunk-OTUTSAZD.js.map} +1 -1
  20. package/dist/{chunk-KRRESUXT.js → chunk-PH25HOAL.js} +6 -6
  21. package/dist/{chunk-KRRESUXT.js.map → chunk-PH25HOAL.js.map} +1 -1
  22. package/dist/{chunk-XIBQ5BTZ.js → chunk-RZVLUUMY.js} +4 -4
  23. package/dist/{chunk-XIBQ5BTZ.js.map → chunk-RZVLUUMY.js.map} +1 -1
  24. package/dist/{chunk-2ORQLYVW.js → chunk-SMEG63MO.js} +4 -4
  25. package/dist/{chunk-2ORQLYVW.js.map → chunk-SMEG63MO.js.map} +1 -1
  26. package/dist/{chunk-YMFJLBIZ.js → chunk-UKJCF2CM.js} +3 -3
  27. package/dist/{chunk-YMFJLBIZ.js.map → chunk-UKJCF2CM.js.map} +1 -1
  28. package/dist/{chunk-K33LWVUF.js → chunk-UKWM32CG.js} +3 -3
  29. package/dist/{chunk-K33LWVUF.js.map → chunk-UKWM32CG.js.map} +1 -1
  30. package/dist/csv.d.ts +1 -1
  31. package/dist/errors.js +2 -1
  32. package/dist/form-types.d.ts +1 -1
  33. package/dist/headless/index.d.ts +1 -1
  34. package/dist/hooks/index.d.ts +4 -4
  35. package/dist/hooks/index.js +13 -12
  36. package/dist/hooks/mutation-mode.d.ts +1 -1
  37. package/dist/hooks/mutation-mode.js +3 -2
  38. package/dist/hooks/related-keys.d.ts +1 -1
  39. package/dist/hooks/use-aggregate.d.ts +2 -2
  40. package/dist/hooks/use-board-columns.d.ts +1 -1
  41. package/dist/hooks/use-capabilities.d.ts +1 -1
  42. package/dist/hooks/use-infinite-resource.d.ts +1 -1
  43. package/dist/hooks/use-link-options.d.ts +1 -1
  44. package/dist/hooks/use-list-state.d.ts +3 -3
  45. package/dist/hooks/use-list-state.js +5 -4
  46. package/dist/hooks/use-live.d.ts +1 -1
  47. package/dist/hooks/use-one.d.ts +1 -1
  48. package/dist/hooks/use-relation-label.d.ts +1 -1
  49. package/dist/hooks/use-resource-form.d.ts +1 -1
  50. package/dist/hooks/use-resource-form.js +4 -3
  51. package/dist/hooks/use-resource.d.ts +1 -1
  52. package/dist/hooks/use-resource.js +4 -3
  53. package/dist/hooks/use-segment-counts.d.ts +2 -2
  54. package/dist/hooks/use-segment-counts.js +5 -4
  55. package/dist/hooks/use-view-board.d.ts +2 -2
  56. package/dist/hooks/use-view-board.js +8 -7
  57. package/dist/hooks/use-view-calendar-range.d.ts +2 -2
  58. package/dist/hooks/use-view-calendar-range.js +6 -5
  59. package/dist/hooks/use-write.d.ts +1 -1
  60. package/dist/index.d.ts +8 -8
  61. package/dist/index.js +15 -14
  62. package/dist/index.js.map +1 -1
  63. package/dist/provider/index.d.ts +7 -378
  64. package/dist/provider/index.js +3 -2
  65. package/dist/{write-outcome-DuwfsnyO.d.ts → read-outcome-Cq0h2oAG.d.ts} +31 -2
  66. package/dist/resource-view/index.d.ts +4 -4
  67. package/dist/resource-view/index.js +5 -4
  68. package/dist/resource-view/index.js.map +1 -1
  69. package/dist/{saved-views-C45lRm7i.d.ts → saved-views-Bcox3blZ.d.ts} +2 -2
  70. package/dist/schema/index.d.ts +3 -4
  71. package/dist/supabase-provider-D5ditkHi.d.ts +465 -0
  72. package/dist/testing/index.d.ts +87 -3
  73. package/dist/testing/index.js +88 -1
  74. package/dist/testing/index.js.map +1 -1
  75. package/dist/{types-CiQY6hUy.d.ts → types-BnOCVJzm.d.ts} +1 -1
  76. package/dist/{types-BAhcze_-.d.ts → types-CBtBvGw0.d.ts} +1 -1
  77. package/package.json +1 -1
  78. package/dist/chunk-NOPS5EIH.js.map +0 -1
  79. package/dist/chunk-UNEZF3ZP.js.map +0 -1
  80. package/dist/read-outcome-BnboMYOV.d.ts +0 -30
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/viewer-scope.tsx"],"names":["Fragment"],"mappings":"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","file":"chunk-XIBQ5BTZ.js","sourcesContent":["import { useQueryClient, type QueryClient } from \"@tanstack/react-query\";\nimport { createContext, Fragment, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { dayIn, isTimeZone, personTimeZone, type Day } from \"../dates\";\nimport { reportError } from \"../errors\";\nimport { stableJson } from \"./draft-controller\";\nimport { NO_VIEWER, type GenesisViewerRoles, type Viewer } from \"../viewer\";\nimport { dropPendingWrites, flushPendingWrites } from \"./mutation-mode\";\nimport { PersistedClientContext, PersistedViewerContext } from \"../provider/context\";\n\nexport { NO_VIEWER, type GenesisViewerRoles, type Viewer };\n\nlet warnedNotPlain = false;\n\n/**\n * Roles as a value: object keys and lists sorted, so `[\"editor\", \"owner\"]` equals\n * `[\"owner\", \"editor\"]`. A Set, Map or class would stringify as `{}` and hide a change: in\n * development that throws; in production it warns once and the roles count as unknown (undefined).\n */\nfunction rolesKeyOf(roles: GenesisViewerRoles): string | undefined {\n let notPlain = false;\n const plain = (v: unknown): unknown => {\n if (Array.isArray(v)) return v.map(plain).map((x) => [stableJson(x), x] as const).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([, x]) => x);\n if (v && typeof v === \"object\") {\n const proto = Object.getPrototypeOf(v);\n if (proto !== Object.prototype && proto !== null) {\n if (process.env.NODE_ENV !== \"production\") throw new TypeError(\"[genesis-core] ViewerScope roles must be plain JSON (no Set, Map or class)\");\n notPlain = true;\n return null;\n }\n return Object.fromEntries(Object.entries(v as Record<string, unknown>).map(([k, x]) => [k, plain(x)]));\n }\n return v;\n };\n const key = stableJson(plain(roles));\n if (!notPlain) return key;\n if (!warnedNotPlain) {\n warnedNotPlain = true;\n reportError(new TypeError(\"ViewerScope roles must be plain JSON (no Set, Map or class); treating them as unknown, so guards that need them refuse\"), \"core:viewer-scope\");\n }\n return undefined;\n}\n\n/** Today in `zone`, rechecked when the page comes back into view and at the next minute boundary while it's open. */\nfunction useToday(zone: string): Day {\n const [day, setDay] = useState(() => dayIn(zone));\n useEffect(() => {\n const check = () => setDay(dayIn(zone));\n check();\n const onVisible = () => {\n if (typeof document === \"undefined\" || document.visibilityState === \"visible\") check();\n };\n if (typeof document !== \"undefined\") document.addEventListener(\"visibilitychange\", onVisible);\n // A page left open over midnight rolls over within a minute.\n const timer = setInterval(check, 60_000);\n return () => {\n if (typeof document !== \"undefined\") document.removeEventListener(\"visibilitychange\", onVisible);\n clearInterval(timer);\n };\n }, [zone]);\n return day;\n}\n\n/**\n * Empties the query cache for a new viewer: sends the old viewer's waiting\n * undoable writes (the session is still theirs), cancels reads in flight,\n * then removes every query. Call it in the sign-in and sign-out actions,\n * before the session changes.\n */\nexport async function clearViewerCache(queryClient: QueryClient): Promise<void> {\n await flushPendingWrites(queryClient);\n await queryClient.cancelQueries();\n queryClient.clear();\n}\n\n/**\n * Where the viewer is working: the person, space or set of people Genesis knows by name, plus\n * whatever the app scopes to under its own key (`{ orgId }`, `{ leagueId }`, `{ locationId }`).\n * Screens turn it into server filters and create defaults (a view's `scope: [\"league_id\"]` reads\n * `league_id`, then `leagueId`); it never decides access (row-level security does).\n */\nexport interface ResourceScope {\n personId?: string;\n spaceId?: string;\n /** Several people at once (a coach's client list, a group). */\n personIds?: readonly string[];\n /** The app's own scope keys: `orgId`, `leagueId`, `locationId`, … */\n [key: string]: unknown;\n}\n\nexport interface ViewerContext {\n viewer: string | null;\n scope: ResourceScope;\n /** The viewer's roles (see `GenesisViewerRoles`), when ViewerScope was given them. */\n roles?: GenesisViewerRoles;\n /** The zone the viewer's days are counted in: theirs if known, else the device's. */\n timeZone: string;\n /**\n * The zone of whatever the viewer is scoped to (a location, a league), for columns with\n * `timeZone: \"scope\"`: ViewerScope's `scopeTimeZone` when valid, else {@link timeZone}.\n */\n scopeTimeZone?: string;\n /**\n * Today on the viewer's clock (YYYY-MM-DD), kept current when the page comes back into view.\n * Use it for every \"today\" read and as query keys' `day`: `keys.for(useViewerScope())`.\n */\n day: Day;\n}\n\nconst ViewerContextValue = createContext<ViewerContext | null>(null);\n/**\n * The cache an outer ViewerScope guarded, and for whom: a nested scope keeps its cache only when\n * it's that same cache. With another QueryClientProvider between them, the inner cache was never\n * emptied for this viewer.\n */\nconst GuardedCacheContext = createContext<{ viewer: string | null; client: unknown } | null>(null);\n\n/** The viewer and scope from the nearest `ViewerScope`. Throws without one: screens that cache per viewer need it. */\nexport function useViewerScope(): ViewerContext {\n const value = useContext(ViewerContextValue);\n if (!value) throw new Error(\"[genesis-core] useViewerScope needs a <ViewerScope> above it\");\n return value;\n}\n\n/** Like useViewerScope, or null outside a ViewerScope. */\nexport function useOptionalViewerScope(): ViewerContext | null {\n return useContext(ViewerContextValue);\n}\n\n/**\n * The viewer for guards: `{ id, scope, roles }` from the nearest ViewerScope, or\n * {@link NO_VIEWER} without one. The object is stable while those are equal by value, so it can\n * sit in a memo's dependencies.\n */\nexport function useViewer(): Viewer {\n const context = useContext(ViewerContextValue);\n return useMemo<Viewer>(\n () =>\n context\n ? Object.freeze({ id: context.viewer, scope: context.scope, ...(context.roles !== undefined ? { roles: context.roles } : {}) })\n : NO_VIEWER,\n [context],\n );\n}\n\nexport interface ViewerScopeProps {\n /** The signed-in viewer's id, null when signed out, undefined while the session loads. */\n viewer: string | null | undefined;\n /**\n * The viewer whose session filled the cache before this scope mounted: a persisted cache\n * restored for them, or a router's loaders that prefetched under their session. When the first\n * known viewer is this one, the cache is kept; otherwise it's emptied. Inside a\n * `GenesisProvider` with `persist`, it defaults to its `persistScope`'s user. A ViewerScope\n * nested inside another for the same viewer always keeps it: the outer one already guards it.\n */\n persistedViewer?: string | null;\n /** Where the viewer is working (see `ResourceScope`). Changing it doesn't remount or clear anything. */\n scope?: ResourceScope;\n /**\n * What the viewer may do there (see `GenesisViewerRoles`), for view guards. Compared by value,\n * so a new object with the same roles changes nothing. Undefined while they load: guards that\n * need them refuse. Arriving (undefined → roles) or going back to undefined changes nothing;\n * different roles send the person's waiting writes, then reread every query, with nothing\n * remounted. Plain JSON values only (lists are compared as sets, in any order): a Set, Map or\n * class instance throws in development; in production it warns once and the roles count as\n * unknown (as if undefined), so guards that need them refuse.\n */\n roles?: GenesisViewerRoles;\n /**\n * The viewer's saved time zone (IANA), when known; else the device's is used. Pass it when\n * rendering on a server, whose own zone is rarely the viewer's.\n */\n timeZone?: string | null;\n /**\n * The IANA zone of whatever the viewer is scoped to (a location, a league), when it has one.\n * Columns with `timeZone: \"scope\"` read on it; without it they read on the viewer's clock.\n */\n scopeTimeZone?: string | null;\n /** Shown while the session loads (and for the one render a change takes). */\n fallback?: ReactNode;\n children: ReactNode;\n}\n\n/**\n * The scope's clock: `scopeTimeZone` when the runtime knows it, else the viewer's. A zone it\n * doesn't know is never a quiet fallback: it throws in development, and in production it is\n * reported (`reportError`, once per zone) before the viewer's clock is used, so a misspelt zone can't show\n * times on the wrong clock unnoticed.\n */\nexport function scopeClock(scopeTimeZone: string | null | undefined, viewerZone: string): string {\n if (scopeTimeZone === undefined || scopeTimeZone === null || scopeTimeZone === \"\") return viewerZone;\n if (isTimeZone(scopeTimeZone)) return scopeTimeZone;\n const error = new RangeError(`[genesis-core] scopeTimeZone \"${scopeTimeZone}\" isn't a time zone this runtime knows (an IANA name such as \"Europe/Berlin\")`);\n if (process.env.NODE_ENV !== \"production\") throw error;\n // Once per zone: a bad zone in a long-lived screen must not flood the error reporter.\n if (!reportedScopeZones.has(scopeTimeZone)) {\n reportedScopeZones.add(scopeTimeZone);\n reportError(error, \"core:viewer-scope\");\n }\n return viewerZone;\n}\n\n/** The unknown scope zones already reported, so each is reported once per page load. */\nconst reportedScopeZones = new Set<string>();\n\n/**\n * Keeps one viewer's cached data from ever showing to the next. Children\n * render only once the viewer is known, under a key of that viewer, so a\n * sign-out or a new person signing in unmounts every screen and its queries\n * before the cache is emptied and the new viewer's screens mount fresh. The\n * first known viewer empties a restored cache too, unless it's the\n * `persistedViewer` it was saved for.\n *\n * ```tsx\n * <ViewerScope viewer={session === undefined ? undefined : (session?.user.id ?? null)}>\n * <App />\n * </ViewerScope>\n * ```\n */\nexport function ViewerScope({ viewer, persistedViewer: persistedViewerProp, scope, roles, timeZone, scopeTimeZone, fallback = null, children }: ViewerScopeProps) {\n const queryClient = useQueryClient();\n // The viewer GenesisProvider restored reads for, only over the client it restored them into.\n const restoredInto = useContext(PersistedClientContext);\n const restoredFor = useContext(PersistedViewerContext);\n // An outer ViewerScope already emptied the cache for its viewer: a nested scope for the same\n // viewer (a sub-area with its own scope or roles) keeps it.\n const outer = useContext(GuardedCacheContext);\n const persistedViewer = persistedViewerProp !== undefined ? persistedViewerProp : restoredInto === queryClient ? restoredFor : undefined;\n const zone = personTimeZone({ timeZone });\n // Memoised, and scopeClock reports a zone once, so a bad zone isn't reported on every render.\n const scopeZone = useMemo(() => scopeClock(scopeTimeZone, zone), [scopeTimeZone, zone]);\n const day = useToday(zone);\n // A new scope object each render shouldn't re-render every reader: compare by value.\n const scopeKey = stableJson(scope ?? {});\n // Roles by value too: undefined stays undefined, so \"not known yet\" never equals \"none\".\n // Roles that aren't plain JSON count as unknown in production (rolesKeyOf warns; development throws).\n const rolesKey = roles === undefined ? undefined : rolesKeyOf(roles);\n const value = useMemo<ViewerContext>(\n () => ({ viewer: viewer ?? null, scope: scope ?? {}, ...(rolesKey !== undefined ? { roles } : {}), timeZone: zone, scopeTimeZone: scopeZone, day }),\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [viewer, scopeKey, rolesKey, zone, scopeZone, day],\n );\n // The last roles known for this viewer. Arriving (undefined → roles) or going back to undefined\n // changes nothing; different roles for the same person send their waiting writes, then reread\n // everything under the new roles. Nothing remounts: the person, their drafts and their\n // navigation are the same.\n const known = useRef<{ viewer: string | null | undefined; roles: string | undefined }>({ viewer, roles: undefined });\n useEffect(() => {\n if (known.current.viewer !== viewer) known.current = { viewer, roles: undefined };\n if (rolesKey === undefined) return;\n const previous = known.current.roles;\n known.current.roles = rolesKey;\n if (previous === undefined || previous === rolesKey) return;\n // The session is still theirs: their writes go out, and the database decides each one with the\n // roles as they are when it arrives (a refused one fails as any refused write does).\n void flushPendingWrites(queryClient).then(() => queryClient.invalidateQueries());\n }, [viewer, rolesKey, queryClient]);\n // Who the children were last mounted for, and how many times they were reset. Undefined before\n // the first mount.\n const [mounted, setMounted] = useState<{ viewer: string | null; epoch: number } | undefined>(undefined);\n const guarded = useMemo(() => ({ viewer: viewer ?? null, client: queryClient as unknown }), [viewer, queryClient]);\n if (viewer === undefined) return <>{fallback}</>;\n if (mounted === undefined || mounted.viewer !== viewer) {\n const keep =\n mounted === undefined &&\n ((outer !== null && outer.viewer === viewer && outer.client === queryClient) || (persistedViewer !== undefined && persistedViewer === viewer));\n // Nothing for the new viewer is mounted yet, so emptying now can't strand\n // a fetch; the old viewer's screens unmount with this render.\n if (!keep) {\n // The session already belongs to the new viewer: the old one's unsent\n // writes must never go out under it. (clearViewerCache, run before the\n // session changes, sends them instead.)\n dropPendingWrites(queryClient);\n void queryClient.cancelQueries();\n queryClient.clear();\n }\n setMounted({ viewer, epoch: (mounted?.epoch ?? 0) + 1 });\n return <>{fallback}</>;\n }\n return (\n <ViewerContextValue.Provider value={value}>\n <GuardedCacheContext.Provider value={guarded}>\n <Fragment key={`${viewer ?? \"signed-out\"}#${mounted.epoch}`}>{children}</Fragment>\n </GuardedCacheContext.Provider>\n </ViewerContextValue.Provider>\n );\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/viewer-scope.tsx"],"names":["Fragment"],"mappings":"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","file":"chunk-RZVLUUMY.js","sourcesContent":["import { useQueryClient, type QueryClient } from \"@tanstack/react-query\";\nimport { createContext, Fragment, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { dayIn, isTimeZone, personTimeZone, type Day } from \"../dates\";\nimport { reportError } from \"../errors\";\nimport { stableJson } from \"./draft-controller\";\nimport { NO_VIEWER, type GenesisViewerRoles, type Viewer } from \"../viewer\";\nimport { dropPendingWrites, flushPendingWrites } from \"./mutation-mode\";\nimport { PersistedClientContext, PersistedViewerContext } from \"../provider/context\";\n\nexport { NO_VIEWER, type GenesisViewerRoles, type Viewer };\n\nlet warnedNotPlain = false;\n\n/**\n * Roles as a value: object keys and lists sorted, so `[\"editor\", \"owner\"]` equals\n * `[\"owner\", \"editor\"]`. A Set, Map or class would stringify as `{}` and hide a change: in\n * development that throws; in production it warns once and the roles count as unknown (undefined).\n */\nfunction rolesKeyOf(roles: GenesisViewerRoles): string | undefined {\n let notPlain = false;\n const plain = (v: unknown): unknown => {\n if (Array.isArray(v)) return v.map(plain).map((x) => [stableJson(x), x] as const).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([, x]) => x);\n if (v && typeof v === \"object\") {\n const proto = Object.getPrototypeOf(v);\n if (proto !== Object.prototype && proto !== null) {\n if (process.env.NODE_ENV !== \"production\") throw new TypeError(\"[genesis-core] ViewerScope roles must be plain JSON (no Set, Map or class)\");\n notPlain = true;\n return null;\n }\n return Object.fromEntries(Object.entries(v as Record<string, unknown>).map(([k, x]) => [k, plain(x)]));\n }\n return v;\n };\n const key = stableJson(plain(roles));\n if (!notPlain) return key;\n if (!warnedNotPlain) {\n warnedNotPlain = true;\n reportError(new TypeError(\"ViewerScope roles must be plain JSON (no Set, Map or class); treating them as unknown, so guards that need them refuse\"), \"core:viewer-scope\");\n }\n return undefined;\n}\n\n/** Today in `zone`, rechecked when the page comes back into view and at the next minute boundary while it's open. */\nfunction useToday(zone: string): Day {\n const [day, setDay] = useState(() => dayIn(zone));\n useEffect(() => {\n const check = () => setDay(dayIn(zone));\n check();\n const onVisible = () => {\n if (typeof document === \"undefined\" || document.visibilityState === \"visible\") check();\n };\n if (typeof document !== \"undefined\") document.addEventListener(\"visibilitychange\", onVisible);\n // A page left open over midnight rolls over within a minute.\n const timer = setInterval(check, 60_000);\n return () => {\n if (typeof document !== \"undefined\") document.removeEventListener(\"visibilitychange\", onVisible);\n clearInterval(timer);\n };\n }, [zone]);\n return day;\n}\n\n/**\n * Empties the query cache for a new viewer: sends the old viewer's waiting\n * undoable writes (the session is still theirs), cancels reads in flight,\n * then removes every query. Call it in the sign-in and sign-out actions,\n * before the session changes.\n */\nexport async function clearViewerCache(queryClient: QueryClient): Promise<void> {\n await flushPendingWrites(queryClient);\n await queryClient.cancelQueries();\n queryClient.clear();\n}\n\n/**\n * Where the viewer is working: the person, space or set of people Genesis knows by name, plus\n * whatever the app scopes to under its own key (`{ orgId }`, `{ leagueId }`, `{ locationId }`).\n * Screens turn it into server filters and create defaults (a view's `scope: [\"league_id\"]` reads\n * `league_id`, then `leagueId`); it never decides access (row-level security does).\n */\nexport interface ResourceScope {\n personId?: string;\n spaceId?: string;\n /** Several people at once (a coach's client list, a group). */\n personIds?: readonly string[];\n /** The app's own scope keys: `orgId`, `leagueId`, `locationId`, … */\n [key: string]: unknown;\n}\n\nexport interface ViewerContext {\n viewer: string | null;\n scope: ResourceScope;\n /** The viewer's roles (see `GenesisViewerRoles`), when ViewerScope was given them. */\n roles?: GenesisViewerRoles;\n /** The zone the viewer's days are counted in: theirs if known, else the device's. */\n timeZone: string;\n /**\n * The zone of whatever the viewer is scoped to (a location, a league), for columns with\n * `timeZone: \"scope\"`: ViewerScope's `scopeTimeZone` when valid, else {@link timeZone}.\n */\n scopeTimeZone?: string;\n /**\n * Today on the viewer's clock (YYYY-MM-DD), kept current when the page comes back into view.\n * Use it for every \"today\" read and as query keys' `day`: `keys.for(useViewerScope())`.\n */\n day: Day;\n}\n\nconst ViewerContextValue = createContext<ViewerContext | null>(null);\n/**\n * The cache an outer ViewerScope guarded, and for whom: a nested scope keeps its cache only when\n * it's that same cache. With another QueryClientProvider between them, the inner cache was never\n * emptied for this viewer.\n */\nconst GuardedCacheContext = createContext<{ viewer: string | null; client: unknown } | null>(null);\n\n/** The viewer and scope from the nearest `ViewerScope`. Throws without one: screens that cache per viewer need it. */\nexport function useViewerScope(): ViewerContext {\n const value = useContext(ViewerContextValue);\n if (!value) throw new Error(\"[genesis-core] useViewerScope needs a <ViewerScope> above it\");\n return value;\n}\n\n/** Like useViewerScope, or null outside a ViewerScope. */\nexport function useOptionalViewerScope(): ViewerContext | null {\n return useContext(ViewerContextValue);\n}\n\n/**\n * The viewer for guards: `{ id, scope, roles }` from the nearest ViewerScope, or\n * {@link NO_VIEWER} without one. The object is stable while those are equal by value, so it can\n * sit in a memo's dependencies.\n */\nexport function useViewer(): Viewer {\n const context = useContext(ViewerContextValue);\n return useMemo<Viewer>(\n () =>\n context\n ? Object.freeze({ id: context.viewer, scope: context.scope, ...(context.roles !== undefined ? { roles: context.roles } : {}) })\n : NO_VIEWER,\n [context],\n );\n}\n\nexport interface ViewerScopeProps {\n /** The signed-in viewer's id, null when signed out, undefined while the session loads. */\n viewer: string | null | undefined;\n /**\n * The viewer whose session filled the cache before this scope mounted: a persisted cache\n * restored for them, or a router's loaders that prefetched under their session. When the first\n * known viewer is this one, the cache is kept; otherwise it's emptied. Inside a\n * `GenesisProvider` with `persist`, it defaults to its `persistScope`'s user. A ViewerScope\n * nested inside another for the same viewer always keeps it: the outer one already guards it.\n */\n persistedViewer?: string | null;\n /** Where the viewer is working (see `ResourceScope`). Changing it doesn't remount or clear anything. */\n scope?: ResourceScope;\n /**\n * What the viewer may do there (see `GenesisViewerRoles`), for view guards. Compared by value,\n * so a new object with the same roles changes nothing. Undefined while they load: guards that\n * need them refuse. Arriving (undefined → roles) or going back to undefined changes nothing;\n * different roles send the person's waiting writes, then reread every query, with nothing\n * remounted. Plain JSON values only (lists are compared as sets, in any order): a Set, Map or\n * class instance throws in development; in production it warns once and the roles count as\n * unknown (as if undefined), so guards that need them refuse.\n */\n roles?: GenesisViewerRoles;\n /**\n * The viewer's saved time zone (IANA), when known; else the device's is used. Pass it when\n * rendering on a server, whose own zone is rarely the viewer's.\n */\n timeZone?: string | null;\n /**\n * The IANA zone of whatever the viewer is scoped to (a location, a league), when it has one.\n * Columns with `timeZone: \"scope\"` read on it; without it they read on the viewer's clock.\n */\n scopeTimeZone?: string | null;\n /** Shown while the session loads (and for the one render a change takes). */\n fallback?: ReactNode;\n children: ReactNode;\n}\n\n/**\n * The scope's clock: `scopeTimeZone` when the runtime knows it, else the viewer's. A zone it\n * doesn't know is never a quiet fallback: it throws in development, and in production it is\n * reported (`reportError`, once per zone) before the viewer's clock is used, so a misspelt zone can't show\n * times on the wrong clock unnoticed.\n */\nexport function scopeClock(scopeTimeZone: string | null | undefined, viewerZone: string): string {\n if (scopeTimeZone === undefined || scopeTimeZone === null || scopeTimeZone === \"\") return viewerZone;\n if (isTimeZone(scopeTimeZone)) return scopeTimeZone;\n const error = new RangeError(`[genesis-core] scopeTimeZone \"${scopeTimeZone}\" isn't a time zone this runtime knows (an IANA name such as \"Europe/Berlin\")`);\n if (process.env.NODE_ENV !== \"production\") throw error;\n // Once per zone: a bad zone in a long-lived screen must not flood the error reporter.\n if (!reportedScopeZones.has(scopeTimeZone)) {\n reportedScopeZones.add(scopeTimeZone);\n reportError(error, \"core:viewer-scope\");\n }\n return viewerZone;\n}\n\n/** The unknown scope zones already reported, so each is reported once per page load. */\nconst reportedScopeZones = new Set<string>();\n\n/**\n * Keeps one viewer's cached data from ever showing to the next. Children\n * render only once the viewer is known, under a key of that viewer, so a\n * sign-out or a new person signing in unmounts every screen and its queries\n * before the cache is emptied and the new viewer's screens mount fresh. The\n * first known viewer empties a restored cache too, unless it's the\n * `persistedViewer` it was saved for.\n *\n * ```tsx\n * <ViewerScope viewer={session === undefined ? undefined : (session?.user.id ?? null)}>\n * <App />\n * </ViewerScope>\n * ```\n */\nexport function ViewerScope({ viewer, persistedViewer: persistedViewerProp, scope, roles, timeZone, scopeTimeZone, fallback = null, children }: ViewerScopeProps) {\n const queryClient = useQueryClient();\n // The viewer GenesisProvider restored reads for, only over the client it restored them into.\n const restoredInto = useContext(PersistedClientContext);\n const restoredFor = useContext(PersistedViewerContext);\n // An outer ViewerScope already emptied the cache for its viewer: a nested scope for the same\n // viewer (a sub-area with its own scope or roles) keeps it.\n const outer = useContext(GuardedCacheContext);\n const persistedViewer = persistedViewerProp !== undefined ? persistedViewerProp : restoredInto === queryClient ? restoredFor : undefined;\n const zone = personTimeZone({ timeZone });\n // Memoised, and scopeClock reports a zone once, so a bad zone isn't reported on every render.\n const scopeZone = useMemo(() => scopeClock(scopeTimeZone, zone), [scopeTimeZone, zone]);\n const day = useToday(zone);\n // A new scope object each render shouldn't re-render every reader: compare by value.\n const scopeKey = stableJson(scope ?? {});\n // Roles by value too: undefined stays undefined, so \"not known yet\" never equals \"none\".\n // Roles that aren't plain JSON count as unknown in production (rolesKeyOf warns; development throws).\n const rolesKey = roles === undefined ? undefined : rolesKeyOf(roles);\n const value = useMemo<ViewerContext>(\n () => ({ viewer: viewer ?? null, scope: scope ?? {}, ...(rolesKey !== undefined ? { roles } : {}), timeZone: zone, scopeTimeZone: scopeZone, day }),\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [viewer, scopeKey, rolesKey, zone, scopeZone, day],\n );\n // The last roles known for this viewer. Arriving (undefined → roles) or going back to undefined\n // changes nothing; different roles for the same person send their waiting writes, then reread\n // everything under the new roles. Nothing remounts: the person, their drafts and their\n // navigation are the same.\n const known = useRef<{ viewer: string | null | undefined; roles: string | undefined }>({ viewer, roles: undefined });\n useEffect(() => {\n if (known.current.viewer !== viewer) known.current = { viewer, roles: undefined };\n if (rolesKey === undefined) return;\n const previous = known.current.roles;\n known.current.roles = rolesKey;\n if (previous === undefined || previous === rolesKey) return;\n // The session is still theirs: their writes go out, and the database decides each one with the\n // roles as they are when it arrives (a refused one fails as any refused write does).\n void flushPendingWrites(queryClient).then(() => queryClient.invalidateQueries());\n }, [viewer, rolesKey, queryClient]);\n // Who the children were last mounted for, and how many times they were reset. Undefined before\n // the first mount.\n const [mounted, setMounted] = useState<{ viewer: string | null; epoch: number } | undefined>(undefined);\n const guarded = useMemo(() => ({ viewer: viewer ?? null, client: queryClient as unknown }), [viewer, queryClient]);\n if (viewer === undefined) return <>{fallback}</>;\n if (mounted === undefined || mounted.viewer !== viewer) {\n const keep =\n mounted === undefined &&\n ((outer !== null && outer.viewer === viewer && outer.client === queryClient) || (persistedViewer !== undefined && persistedViewer === viewer));\n // Nothing for the new viewer is mounted yet, so emptying now can't strand\n // a fetch; the old viewer's screens unmount with this render.\n if (!keep) {\n // The session already belongs to the new viewer: the old one's unsent\n // writes must never go out under it. (clearViewerCache, run before the\n // session changes, sends them instead.)\n dropPendingWrites(queryClient);\n void queryClient.cancelQueries();\n queryClient.clear();\n }\n setMounted({ viewer, epoch: (mounted?.epoch ?? 0) + 1 });\n return <>{fallback}</>;\n }\n return (\n <ViewerContextValue.Provider value={value}>\n <GuardedCacheContext.Provider value={guarded}>\n <Fragment key={`${viewer ?? \"signed-out\"}#${mounted.epoch}`}>{children}</Fragment>\n </GuardedCacheContext.Provider>\n </ViewerContextValue.Provider>\n );\n}\n"]}
@@ -1,6 +1,6 @@
1
- import { displayZone, timeStorage, windowBounds, warnOnce } from './chunk-YMFJLBIZ.js';
1
+ import { displayZone, timeStorage, windowBounds, warnOnce } from './chunk-UKJCF2CM.js';
2
2
  import { encodeRecordKey } from './chunk-KV2HW4G4.js';
3
- import { useOptionalViewerScope } from './chunk-XIBQ5BTZ.js';
3
+ import { useOptionalViewerScope } from './chunk-RZVLUUMY.js';
4
4
  import { useLiveInvalidation } from './chunk-6SHGMEA6.js';
5
5
  import { resourceKeys } from './chunk-2IGAUXYH.js';
6
6
  import { useDataProvider } from './chunk-OIZNABG4.js';
@@ -111,5 +111,5 @@ function useViewCalendarRange(view, range, options = {}) {
111
111
  }
112
112
 
113
113
  export { CALENDAR_LIMIT, useViewCalendarRange };
114
- //# sourceMappingURL=chunk-2ORQLYVW.js.map
115
- //# sourceMappingURL=chunk-2ORQLYVW.js.map
114
+ //# sourceMappingURL=chunk-SMEG63MO.js.map
115
+ //# sourceMappingURL=chunk-SMEG63MO.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-view-calendar-range.ts"],"names":[],"mappings":"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","file":"chunk-2ORQLYVW.js","sourcesContent":["// useViewCalendarRange: a calendar's data, shared by the web's calendar, a custom view (ADR 0019)\n// and the phone's calendar, so each places a view's rows by date from the same reads. One query\n// per visible window, live invalidation, and the same request rules everywhere.\n\nimport { useMemo } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { BaseRecord, FilterParam, ListParams } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport { encodeRecordKey } from \"../schema/keys\";\nimport type { DataRow, ResourceContract } from \"../schema/types\";\nimport { addDays, type Day } from \"../dates\";\nimport type { ResourceView as View } from \"../resource-view/types\";\nimport { displayZone, timeStorage, warnOnce, windowBounds } from \"../resource-view/calendar\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { useOptionalViewerScope } from \"./viewer-scope\";\n\ntype Row = Record<string, unknown>;\n\n/**\n * Most rows one request loads (a calendar with an `endField` makes two, so up to twice this).\n * A month grid is six weeks: 500 is about a dozen a day, more than a\n * busy shared calendar holds, and still one quick request. Past it the calendar says how many it\n * left out (\"+N more\") rather than dropping them silently.\n */\nexport const CALENDAR_LIMIT = 500;\n\nconst DURATION_MS = { minutes: 60_000, hours: 3_600_000, days: 86_400_000 } as const;\n\n/** The days a calendar shows: `start` inclusive, `end` exclusive, as `calendarWindow` gives them. @stability Beta */\nexport interface ViewCalendarRange {\n start: Day;\n end: Day;\n}\n\n/** @stability Beta */\nexport interface UseViewCalendarRangeOptions {\n /** The date or timestamp field. Default the view's `calendar.field`. */\n field?: string | undefined;\n /** Default the view's `calendar.endField`. */\n endField?: string | undefined;\n /** Default the view's `calendar.allDayField`. */\n allDayField?: string | undefined;\n /** Server filters (the scope's and the screen's), already as params (`useViewListParams().filters`). */\n filters?: readonly FilterParam[] | undefined;\n select?: string | undefined;\n /** False while the screen waits: nothing is fetched. Default true. */\n enabled?: boolean | undefined;\n live?: boolean | LiveOptions | undefined;\n /** Most rows per request. Default {@link CALENDAR_LIMIT}. */\n limit?: number | undefined;\n /**\n * The clock the window's days are on. Default the field's own (`fields.<field>.timeZone`),\n * else the viewer's, else the device's: the clock the field's cells use.\n */\n timeZone?: string | undefined;\n /** Default the view's `calendar.durationField`. */\n durationField?: string | undefined;\n /** Default the view's `calendar.durationUnit`, else minutes. */\n durationUnit?: \"minutes\" | \"hours\" | \"days\" | undefined;\n /** Default the view's `calendar.maxDuration`: how far before the window a row with a duration is read. */\n maxDuration?: number | undefined;\n /**\n * Fields the rows must carry besides the date, end and all-day fields, for the select check.\n * Default the view's `calendar.durationField` and `laneBy`.\n */\n needs?: readonly (string | undefined)[] | undefined;\n}\n\n/** @stability Beta */\nexport interface ViewCalendarRangeState<T extends Row = Row> {\n /** The rows in the window, each once. */\n rows: T[];\n /** Rows the provider counted in all; above `rows.length` when the limit cut some. */\n total: number;\n /** Nothing yet for this window (the last window's rows may stand in). */\n loading: boolean;\n error: unknown;\n refetch: () => void;\n /** The clock the window was read on. */\n timeZone: string;\n /** A row's record key. */\n keyOf: (row: T) => string;\n}\n\n/** The fields a Supabase select string doesn't fetch (`*` fetches all; `alias:col` fetches col). */\nfunction selectMissing(select: string, fields: readonly (string | undefined)[]): string[] {\n const top: string[] = [];\n let depth = 0;\n let token = \"\";\n for (const ch of select) {\n if (ch === \"(\") depth++;\n if (ch === \")\") depth--;\n if (ch === \",\" && depth === 0) {\n top.push(token);\n token = \"\";\n } else token += ch;\n }\n top.push(token);\n const names = new Set(top.map((t) => t.trim().replace(/\\(.*$/s, \"\").split(\":\").pop()!.split(\"::\")[0]!.trim()));\n if (names.has(\"*\")) return [];\n return fields.filter((f): f is string => Boolean(f) && !names.has(f!));\n}\n\n/**\n * A view's rows in one calendar window, for a screen that places them itself (a custom view,\n * ADR 0019). ResourceCalendar loads its rows through it.\n *\n * ```tsx\n * const range = calendarWindow(\"weeks\", today, { weeks: 1 });\n * const week = useViewCalendarRange(sessionsView, range, { filters: useViewListParams({ view: sessionsView }).filters });\n * ```\n *\n * At most two requests, each a plain filter list the provider rules apply to, that neither\n * overlap nor leave a gap: rows that start in the window, and, with an end field, rows that\n * started before it and end inside or after it. One query for both, under core's list keys, so a\n * save refreshes it; the last window's rows stand in while the next loads, never across a change\n * of filters.\n *\n * @stability Beta\n */\nexport function useViewCalendarRange<T extends Row = Row>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract; Row is what matters here\n view: View<ResourceContract<any>, T & DataRow>,\n range: ViewCalendarRange,\n options: UseViewCalendarRangeOptions = {},\n): ViewCalendarRangeState<T> {\n const own = view.definition.calendar;\n const fieldName = options.field ?? own?.field;\n const endField = options.endField ?? own?.endField;\n const allDayField = options.allDayField ?? own?.allDayField;\n const { filters = [], select, enabled = true, live, limit = CALENDAR_LIMIT } = options;\n const durationField = options.durationField ?? own?.durationField;\n const durationUnit = options.durationUnit ?? own?.durationUnit ?? \"minutes\";\n const maxDuration = options.maxDuration ?? own?.maxDuration;\n const needs = options.needs ?? [durationField, own?.laneBy];\n const provider = useDataProvider();\n const viewerScope = useOptionalViewerScope();\n if (!fieldName) throw new Error(`ResourceView(${view.resource}): a calendar needs a date field: the view's calendar.field, or { field }`);\n const zone = options.timeZone ?? displayZone(view.definition.fields?.[fieldName as never]?.timeZone, viewerScope?.timeZone, viewerScope?.scopeTimeZone);\n const storage = timeStorage(view.field(fieldName));\n const endStorage = endField ? timeStorage(view.field(endField)) : storage;\n // An all-day row stored as instants lands on its UTC day, which can be a day either side of the\n // window's own midnights on this clock: ask for a day more each side, and let placement keep\n // only the window's days.\n const fetched = allDayField && storage === \"zoned\" ? { start: addDays(range.start, -1), end: addDays(range.end, 1) } : range;\n const { from, to } = windowBounds(fetched, storage, zone);\n const end = endField ? windowBounds(allDayField && endStorage === \"zoned\" ? fetched : range, endStorage, zone) : undefined;\n\n // A select that leaves out the calendar's own fields makes every event vanish, silently: say so.\n if (select) {\n const missing = selectMissing(select, [fieldName, endField, allDayField, ...needs]);\n if (missing.length) warnOnce(`ResourceView(${view.resource}): calendar select \"${select}\" leaves out ${missing.join(\", \")}; events need them`);\n }\n // A row whose end is its start plus a duration (no end column, or an empty one) can start before\n // the window and run into it: with `maxDuration`, the rows that started that long before are read\n // too (whole days, so the start's clock doesn't matter), and placement keeps only the ones that\n // reach the window. Without it, such a row shows only from the days it starts on: said once.\n const leadDays = durationField && maxDuration && maxDuration > 0 ? Math.ceil((maxDuration * DURATION_MS[durationUnit]) / DURATION_MS.days) : 0;\n // With an end column, rows from before the window are read by their end already (`running`);\n // only a calendar with no end column misses them without `maxDuration`.\n if (durationField && !leadDays && !endField) {\n warnOnce(`ResourceView(${view.resource}): calendar durationField \"${durationField}\" has no maxDuration, so a row that starts before the window and runs into it isn't read; set calendar.maxDuration`);\n }\n // A zoned timestamp's duration is elapsed time (as calendarEvents adds it): the bound is the\n // window's first instant minus that many milliseconds, so a day shortened by a clock change\n // (spring forward) can't leave a row out. A date or a wall-clock time counts whole days.\n const lookback = !leadDays\n ? undefined\n : storage === \"zoned\"\n ? new Date(Date.parse(from) - maxDuration! * DURATION_MS[durationUnit]).toISOString()\n : windowBounds(fetched, storage, zone, leadDays).from;\n\n // Everything the rows depend on except the window: what decides whether the last rows may stand in.\n const listScope = JSON.stringify([filters, select ?? null, fieldName, endField ?? null, limit, durationField ?? null, durationUnit, maxDuration ?? null]);\n const base = { pagination: { page: 1, perPage: limit }, sort: { field: fieldName, order: \"asc\" as const }, ...(select ? { select } : {}) };\n const starting: ListParams = {\n ...base,\n filters: [...filters, { field: fieldName, operator: \"gte\", value: from }, { field: fieldName, operator: \"lt\", value: to }],\n };\n // A timestamp end is exclusive, so one exactly at the window's first midnight is out (`gt`); a\n // date end is the last day (`gte`).\n const running: ListParams | undefined = end && {\n ...base,\n filters: [...filters, { field: fieldName, operator: \"lt\", value: from }, { field: endField!, operator: endStorage === \"date\" ? \"gte\" : \"gt\", value: end.from }],\n };\n // Rows that started within `maxDuration` before the window with no end of their own (no end\n // column, or an empty one): their end is their duration's, which a filter can't compute.\n // Latest start first: past the limit, the rows kept are the ones that started just before the\n // window, the likeliest to reach it, not the earliest of the lookback.\n const lasting: ListParams | undefined = lookback !== undefined\n ? {\n ...base,\n sort: { field: fieldName, order: \"desc\" as const },\n filters: [\n ...filters,\n { field: fieldName, operator: \"gte\", value: lookback },\n { field: fieldName, operator: \"lt\", value: from },\n ...(endField ? [{ field: endField, operator: \"is_null\" as const }] : []),\n ],\n }\n : undefined;\n const reads = [starting, ...(running ? [running] : []), ...(lasting ? [lasting] : [])];\n const query = useQuery({\n queryKey: [...resourceKeys(view.resource).lists, { calendar: reads, scope: listScope }],\n placeholderData: (previous, previousQuery) =>\n (previousQuery?.queryKey[2] as { scope?: string } | undefined)?.scope === listScope ? keepPreviousData(previous) : undefined,\n enabled,\n queryFn: async () => {\n const lists = await Promise.all(reads.map((params) => provider.getList<BaseRecord>(view.resource, params)));\n return {\n data: lists.flatMap((l) => l.data),\n total: lists.reduce((n, l) => n + (l.total ?? l.data.length), 0),\n };\n },\n });\n // `live`, as a list has it: a change to the resource refetches the calendar.\n useLiveInvalidation(view.resource, live, enabled, { filters: [...filters] }, resourceKeys(view.resource).all);\n const keyOf = (row: T) => String(encodeRecordKey(view.contract, row as DataRow));\n // The two filters can't both match a row; keyed anyway, so a row is never drawn twice.\n const rows = useMemo(() => {\n const seen = new Set<string>();\n return ((query.data?.data ?? []) as unknown as T[]).filter((row) => {\n const key = String(encodeRecordKey(view.contract, row as DataRow));\n if (seen.has(key)) return false;\n seen.add(key);\n return true;\n });\n }, [query.data, view]);\n return {\n rows,\n total: query.data?.total ?? 0,\n loading: query.isPending || query.isPlaceholderData,\n error: query.error,\n refetch: () => void query.refetch(),\n timeZone: zone,\n keyOf,\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-view-calendar-range.ts"],"names":[],"mappings":"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","file":"chunk-SMEG63MO.js","sourcesContent":["// useViewCalendarRange: a calendar's data, shared by the web's calendar, a custom view (ADR 0019)\n// and the phone's calendar, so each places a view's rows by date from the same reads. One query\n// per visible window, live invalidation, and the same request rules everywhere.\n\nimport { useMemo } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { BaseRecord, FilterParam, ListParams } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport { encodeRecordKey } from \"../schema/keys\";\nimport type { DataRow, ResourceContract } from \"../schema/types\";\nimport { addDays, type Day } from \"../dates\";\nimport type { ResourceView as View } from \"../resource-view/types\";\nimport { displayZone, timeStorage, warnOnce, windowBounds } from \"../resource-view/calendar\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { useOptionalViewerScope } from \"./viewer-scope\";\n\ntype Row = Record<string, unknown>;\n\n/**\n * Most rows one request loads (a calendar with an `endField` makes two, so up to twice this).\n * A month grid is six weeks: 500 is about a dozen a day, more than a\n * busy shared calendar holds, and still one quick request. Past it the calendar says how many it\n * left out (\"+N more\") rather than dropping them silently.\n */\nexport const CALENDAR_LIMIT = 500;\n\nconst DURATION_MS = { minutes: 60_000, hours: 3_600_000, days: 86_400_000 } as const;\n\n/** The days a calendar shows: `start` inclusive, `end` exclusive, as `calendarWindow` gives them. @stability Beta */\nexport interface ViewCalendarRange {\n start: Day;\n end: Day;\n}\n\n/** @stability Beta */\nexport interface UseViewCalendarRangeOptions {\n /** The date or timestamp field. Default the view's `calendar.field`. */\n field?: string | undefined;\n /** Default the view's `calendar.endField`. */\n endField?: string | undefined;\n /** Default the view's `calendar.allDayField`. */\n allDayField?: string | undefined;\n /** Server filters (the scope's and the screen's), already as params (`useViewListParams().filters`). */\n filters?: readonly FilterParam[] | undefined;\n select?: string | undefined;\n /** False while the screen waits: nothing is fetched. Default true. */\n enabled?: boolean | undefined;\n live?: boolean | LiveOptions | undefined;\n /** Most rows per request. Default {@link CALENDAR_LIMIT}. */\n limit?: number | undefined;\n /**\n * The clock the window's days are on. Default the field's own (`fields.<field>.timeZone`),\n * else the viewer's, else the device's: the clock the field's cells use.\n */\n timeZone?: string | undefined;\n /** Default the view's `calendar.durationField`. */\n durationField?: string | undefined;\n /** Default the view's `calendar.durationUnit`, else minutes. */\n durationUnit?: \"minutes\" | \"hours\" | \"days\" | undefined;\n /** Default the view's `calendar.maxDuration`: how far before the window a row with a duration is read. */\n maxDuration?: number | undefined;\n /**\n * Fields the rows must carry besides the date, end and all-day fields, for the select check.\n * Default the view's `calendar.durationField` and `laneBy`.\n */\n needs?: readonly (string | undefined)[] | undefined;\n}\n\n/** @stability Beta */\nexport interface ViewCalendarRangeState<T extends Row = Row> {\n /** The rows in the window, each once. */\n rows: T[];\n /** Rows the provider counted in all; above `rows.length` when the limit cut some. */\n total: number;\n /** Nothing yet for this window (the last window's rows may stand in). */\n loading: boolean;\n error: unknown;\n refetch: () => void;\n /** The clock the window was read on. */\n timeZone: string;\n /** A row's record key. */\n keyOf: (row: T) => string;\n}\n\n/** The fields a Supabase select string doesn't fetch (`*` fetches all; `alias:col` fetches col). */\nfunction selectMissing(select: string, fields: readonly (string | undefined)[]): string[] {\n const top: string[] = [];\n let depth = 0;\n let token = \"\";\n for (const ch of select) {\n if (ch === \"(\") depth++;\n if (ch === \")\") depth--;\n if (ch === \",\" && depth === 0) {\n top.push(token);\n token = \"\";\n } else token += ch;\n }\n top.push(token);\n const names = new Set(top.map((t) => t.trim().replace(/\\(.*$/s, \"\").split(\":\").pop()!.split(\"::\")[0]!.trim()));\n if (names.has(\"*\")) return [];\n return fields.filter((f): f is string => Boolean(f) && !names.has(f!));\n}\n\n/**\n * A view's rows in one calendar window, for a screen that places them itself (a custom view,\n * ADR 0019). ResourceCalendar loads its rows through it.\n *\n * ```tsx\n * const range = calendarWindow(\"weeks\", today, { weeks: 1 });\n * const week = useViewCalendarRange(sessionsView, range, { filters: useViewListParams({ view: sessionsView }).filters });\n * ```\n *\n * At most two requests, each a plain filter list the provider rules apply to, that neither\n * overlap nor leave a gap: rows that start in the window, and, with an end field, rows that\n * started before it and end inside or after it. One query for both, under core's list keys, so a\n * save refreshes it; the last window's rows stand in while the next loads, never across a change\n * of filters.\n *\n * @stability Beta\n */\nexport function useViewCalendarRange<T extends Row = Row>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract; Row is what matters here\n view: View<ResourceContract<any>, T & DataRow>,\n range: ViewCalendarRange,\n options: UseViewCalendarRangeOptions = {},\n): ViewCalendarRangeState<T> {\n const own = view.definition.calendar;\n const fieldName = options.field ?? own?.field;\n const endField = options.endField ?? own?.endField;\n const allDayField = options.allDayField ?? own?.allDayField;\n const { filters = [], select, enabled = true, live, limit = CALENDAR_LIMIT } = options;\n const durationField = options.durationField ?? own?.durationField;\n const durationUnit = options.durationUnit ?? own?.durationUnit ?? \"minutes\";\n const maxDuration = options.maxDuration ?? own?.maxDuration;\n const needs = options.needs ?? [durationField, own?.laneBy];\n const provider = useDataProvider();\n const viewerScope = useOptionalViewerScope();\n if (!fieldName) throw new Error(`ResourceView(${view.resource}): a calendar needs a date field: the view's calendar.field, or { field }`);\n const zone = options.timeZone ?? displayZone(view.definition.fields?.[fieldName as never]?.timeZone, viewerScope?.timeZone, viewerScope?.scopeTimeZone);\n const storage = timeStorage(view.field(fieldName));\n const endStorage = endField ? timeStorage(view.field(endField)) : storage;\n // An all-day row stored as instants lands on its UTC day, which can be a day either side of the\n // window's own midnights on this clock: ask for a day more each side, and let placement keep\n // only the window's days.\n const fetched = allDayField && storage === \"zoned\" ? { start: addDays(range.start, -1), end: addDays(range.end, 1) } : range;\n const { from, to } = windowBounds(fetched, storage, zone);\n const end = endField ? windowBounds(allDayField && endStorage === \"zoned\" ? fetched : range, endStorage, zone) : undefined;\n\n // A select that leaves out the calendar's own fields makes every event vanish, silently: say so.\n if (select) {\n const missing = selectMissing(select, [fieldName, endField, allDayField, ...needs]);\n if (missing.length) warnOnce(`ResourceView(${view.resource}): calendar select \"${select}\" leaves out ${missing.join(\", \")}; events need them`);\n }\n // A row whose end is its start plus a duration (no end column, or an empty one) can start before\n // the window and run into it: with `maxDuration`, the rows that started that long before are read\n // too (whole days, so the start's clock doesn't matter), and placement keeps only the ones that\n // reach the window. Without it, such a row shows only from the days it starts on: said once.\n const leadDays = durationField && maxDuration && maxDuration > 0 ? Math.ceil((maxDuration * DURATION_MS[durationUnit]) / DURATION_MS.days) : 0;\n // With an end column, rows from before the window are read by their end already (`running`);\n // only a calendar with no end column misses them without `maxDuration`.\n if (durationField && !leadDays && !endField) {\n warnOnce(`ResourceView(${view.resource}): calendar durationField \"${durationField}\" has no maxDuration, so a row that starts before the window and runs into it isn't read; set calendar.maxDuration`);\n }\n // A zoned timestamp's duration is elapsed time (as calendarEvents adds it): the bound is the\n // window's first instant minus that many milliseconds, so a day shortened by a clock change\n // (spring forward) can't leave a row out. A date or a wall-clock time counts whole days.\n const lookback = !leadDays\n ? undefined\n : storage === \"zoned\"\n ? new Date(Date.parse(from) - maxDuration! * DURATION_MS[durationUnit]).toISOString()\n : windowBounds(fetched, storage, zone, leadDays).from;\n\n // Everything the rows depend on except the window: what decides whether the last rows may stand in.\n const listScope = JSON.stringify([filters, select ?? null, fieldName, endField ?? null, limit, durationField ?? null, durationUnit, maxDuration ?? null]);\n const base = { pagination: { page: 1, perPage: limit }, sort: { field: fieldName, order: \"asc\" as const }, ...(select ? { select } : {}) };\n const starting: ListParams = {\n ...base,\n filters: [...filters, { field: fieldName, operator: \"gte\", value: from }, { field: fieldName, operator: \"lt\", value: to }],\n };\n // A timestamp end is exclusive, so one exactly at the window's first midnight is out (`gt`); a\n // date end is the last day (`gte`).\n const running: ListParams | undefined = end && {\n ...base,\n filters: [...filters, { field: fieldName, operator: \"lt\", value: from }, { field: endField!, operator: endStorage === \"date\" ? \"gte\" : \"gt\", value: end.from }],\n };\n // Rows that started within `maxDuration` before the window with no end of their own (no end\n // column, or an empty one): their end is their duration's, which a filter can't compute.\n // Latest start first: past the limit, the rows kept are the ones that started just before the\n // window, the likeliest to reach it, not the earliest of the lookback.\n const lasting: ListParams | undefined = lookback !== undefined\n ? {\n ...base,\n sort: { field: fieldName, order: \"desc\" as const },\n filters: [\n ...filters,\n { field: fieldName, operator: \"gte\", value: lookback },\n { field: fieldName, operator: \"lt\", value: from },\n ...(endField ? [{ field: endField, operator: \"is_null\" as const }] : []),\n ],\n }\n : undefined;\n const reads = [starting, ...(running ? [running] : []), ...(lasting ? [lasting] : [])];\n const query = useQuery({\n queryKey: [...resourceKeys(view.resource).lists, { calendar: reads, scope: listScope }],\n placeholderData: (previous, previousQuery) =>\n (previousQuery?.queryKey[2] as { scope?: string } | undefined)?.scope === listScope ? keepPreviousData(previous) : undefined,\n enabled,\n queryFn: async () => {\n const lists = await Promise.all(reads.map((params) => provider.getList<BaseRecord>(view.resource, params)));\n return {\n data: lists.flatMap((l) => l.data),\n total: lists.reduce((n, l) => n + (l.total ?? l.data.length), 0),\n };\n },\n });\n // `live`, as a list has it: a change to the resource refetches the calendar.\n useLiveInvalidation(view.resource, live, enabled, { filters: [...filters] }, resourceKeys(view.resource).all);\n const keyOf = (row: T) => String(encodeRecordKey(view.contract, row as DataRow));\n // The two filters can't both match a row; keyed anyway, so a row is never drawn twice.\n const rows = useMemo(() => {\n const seen = new Set<string>();\n return ((query.data?.data ?? []) as unknown as T[]).filter((row) => {\n const key = String(encodeRecordKey(view.contract, row as DataRow));\n if (seen.has(key)) return false;\n seen.add(key);\n return true;\n });\n }, [query.data, view]);\n return {\n rows,\n total: query.data?.total ?? 0,\n loading: query.isPending || query.isPlaceholderData,\n error: query.error,\n refetch: () => void query.refetch(),\n timeZone: zone,\n keyOf,\n };\n}\n"]}
@@ -1,6 +1,6 @@
1
1
  import { encodeRecordKey } from './chunk-KV2HW4G4.js';
2
2
  import { monthGridRange, weeksRange, addMonths, addWeeks, dayIn, eachDay, addDays, rangeIn, isTimeZone, deviceTimeZone, readEventTime } from './chunk-WXENWPWP.js';
3
- import { isDevelopment } from './chunk-NOPS5EIH.js';
3
+ import { isDevelopment } from './chunk-CJ5V6JES.js';
4
4
 
5
5
  // src/resource-view/calendar.ts
6
6
  var warned = /* @__PURE__ */ new Set();
@@ -155,5 +155,5 @@ function calendarEvents(view, rows, options) {
155
155
  }
156
156
 
157
157
  export { calendarEvents, calendarLanes, calendarWindow, displayZone, eventDays, eventDots, laneKeys, placeEvents, shiftAnchor, timeStorage, warnOnce, windowBounds };
158
- //# sourceMappingURL=chunk-YMFJLBIZ.js.map
159
- //# sourceMappingURL=chunk-YMFJLBIZ.js.map
158
+ //# sourceMappingURL=chunk-UKJCF2CM.js.map
159
+ //# sourceMappingURL=chunk-UKJCF2CM.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/resource-view/calendar.ts"],"names":[],"mappings":"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","file":"chunk-YMFJLBIZ.js","sourcesContent":["// Calendars over a view's rows (ADR 0017, ADR 0021): the days a layout shows, where each event\n// lands, how a column stores time, and a view's rows as events. Pure, so the web's EventCalendar,\n// a custom view and the phone's calendar all place events the same way.\n\nimport {\n addDays,\n addMonths,\n addWeeks,\n dayIn,\n deviceTimeZone,\n eachDay,\n isTimeZone,\n monthGridRange,\n rangeIn,\n readEventTime,\n weeksRange,\n type Day,\n type DayRange,\n} from \"../dates\";\nimport { isDevelopment } from \"../errors\";\nimport { encodeRecordKey } from \"../schema/keys\";\nimport type { DataRow, ResourceContract } from \"../schema/types\";\nimport type { ResourceView, ViewCalendar, ViewCalendarDurationUnit } from \"./types\";\n\n// Each bad value is warned about once, not on every render while it stays in the URL.\nconst warned = new Set<string>();\n\n/** A development-only hint, once per message: a bad URL value or override that fell back. @stability Beta */\nexport function warnOnce(message: string): void {\n if (!isDevelopment() || warned.has(message)) return;\n warned.add(message);\n // genesis-allow-console: a development-only hint about a value that fell back; nothing failed.\n console.warn(message);\n}\n\n\n/** How a calendar lays out its window. @stability Beta */\nexport type CalendarLayout = \"month\" | \"weeks\" | \"agenda\" | \"lanes\";\n\n/** Weeks a `weeks`, `agenda` or `lanes` layout shows. @stability Beta */\nexport type CalendarWeeks = 1 | 2 | 3 | 4;\n\n/**\n * One event. An all-day event's `start` and `end` are days, `end` the last day it covers\n * (inclusive: a weekend away is Saturday to Sunday). A timed event's are instants, `end`\n * exclusive; without one it is a moment.\n *\n * @stability Beta\n */\nexport interface CalendarEvent<T = unknown> {\n key: string;\n title: string;\n start: Day | Date;\n end?: Day | Date | undefined;\n /** Default: true when `start` is a day. */\n allDay?: boolean | undefined;\n /** The lanes (people) it belongs to: one dot each, and a place in each lane of a `lanes` layout. */\n lanes?: readonly string[] | undefined;\n /** Dot colours, when not the lanes' own. Any CSS colour. */\n colors?: readonly string[] | undefined;\n /**\n * Classes for the event's item, on the grid and the printed agenda: `line-through opacity-60`\n * strikes out a cancelled event rather than dropping it. Pair a look with `status`, so it isn't\n * the only cue.\n */\n className?: string | undefined;\n /** Words read out after the title (\"Cancelled\"), for what `className` shows. Visually hidden. */\n status?: string | undefined;\n /** The record it came from, handed back on select. */\n row?: T;\n}\n\n/** A lane: one person (or room, or team) a `lanes` layout gives a row. @stability Beta */\nexport interface CalendarLane {\n key: string;\n label: string;\n /** Its dot colour, any CSS colour. */\n color?: string | undefined;\n}\n\n/** An event on one of its days. @stability Beta */\nexport interface PlacedEvent<T = unknown> {\n event: CalendarEvent<T>;\n day: Day;\n allDay: boolean;\n /** It started on an earlier day. */\n continued: boolean;\n /** It runs on past this day. */\n continues: boolean;\n}\n\n/** What a layout's window depends on. */\nexport interface CalendarWindowOptions {\n weeks?: CalendarWeeks | undefined;\n /** 0 Sunday or 1 Monday (default). */\n weekStartsOn?: 0 | 1 | undefined;\n}\n\n/**\n * The days a layout shows around `anchor`: a month grid's whole weeks, or `weeks` weeks from the\n * week `anchor` is in. This is the window a calendar asks its data for. @stability Beta\n */\nexport function calendarWindow(layout: CalendarLayout, anchor: Day, options: CalendarWindowOptions = {}): DayRange {\n const weekStartsOn = options.weekStartsOn ?? 1;\n return layout === \"month\" ? monthGridRange(anchor, weekStartsOn) : weeksRange(anchor, options.weeks ?? 2, weekStartsOn);\n}\n\n/** The anchor one step back (−1) or on (1): a month for `month`, else the window's weeks. @stability Beta */\nexport function shiftAnchor(layout: CalendarLayout, anchor: Day, step: number, weeks: CalendarWeeks = 2): Day {\n return layout === \"month\" ? addMonths(anchor, step) : addWeeks(anchor, step * weeks);\n}\n\nfunction isAllDay(event: CalendarEvent<unknown>): boolean {\n return event.allDay ?? typeof event.start === \"string\";\n}\n\n/** The first and last day an event covers on `zone`'s clock. */\nexport function eventDays(event: CalendarEvent<unknown>, zone: string): { first: Day; last: Day } {\n const dayOfValue = (v: Day | Date) => (typeof v === \"string\" ? v : dayIn(zone, v));\n const first = dayOfValue(event.start);\n if (event.end === undefined) return { first, last: first };\n let last: Day;\n if (typeof event.end === \"string\") last = event.end;\n // A timed end is exclusive: an event to midnight ends the day before.\n else last = dayIn(zone, new Date(Math.max(event.end.getTime() - 1, typeof event.start === \"string\" ? 0 : event.start.getTime())));\n return { first, last: last < first ? first : last };\n}\n\nconst startTime = (e: CalendarEvent<unknown>) => (typeof e.start === \"string\" ? 0 : e.start.getTime());\n\n/**\n * Each day of `range` with the events on it: an event that spans days is on each one, all-day\n * events (and the middle days of a long timed one) come first, then timed ones by start, then by\n * title. @stability Beta\n */\nexport function placeEvents<T>(events: readonly CalendarEvent<T>[], range: DayRange, zone: string): Map<Day, PlacedEvent<T>[]> {\n const byDay = new Map<Day, PlacedEvent<T>[]>(eachDay(range).map((d) => [d, []]));\n for (const event of events) {\n const { first, last } = eventDays(event, zone);\n if (last < range.start || first >= range.end) continue;\n const allDay = isAllDay(event);\n for (let day = first < range.start ? range.start : first; day <= last && day < range.end; day = addDays(day, 1)) {\n byDay.get(day)!.push({\n event,\n day,\n // A timed event's middle days have no start of their own: they read as all day.\n allDay: allDay || (day !== first && day !== last),\n continued: day !== first,\n continues: day !== last,\n });\n }\n }\n for (const list of byDay.values()) {\n list.sort(\n (a, b) =>\n Number(b.allDay) - Number(a.allDay) ||\n (a.allDay ? 0 : (a.continued ? 0 : startTime(a.event)) - (b.continued ? 0 : startTime(b.event))) ||\n a.event.title.localeCompare(b.event.title) ||\n a.event.key.localeCompare(b.event.key),\n );\n }\n return byDay;\n}\n\n/**\n * The lanes a `lanes` layout draws: the ones given, in order, then any an event names that\n * weren't given (labelled by key). @stability Beta\n */\nexport function calendarLanes(events: readonly CalendarEvent<unknown>[], lanes: readonly CalendarLane[] = []): CalendarLane[] {\n const out = [...lanes];\n const seen = new Set(out.map((l) => l.key));\n for (const e of events) {\n for (const key of e.lanes ?? []) {\n if (!seen.has(key)) {\n seen.add(key);\n out.push({ key, label: key });\n }\n }\n }\n return out;\n}\n\n/** An event's dots: its own colours, else its lanes' colours. @stability Beta */\nexport function eventDots(event: CalendarEvent<unknown>, lanes: readonly CalendarLane[]): { color: string; label?: string }[] {\n if (event.colors?.length) return event.colors.map((color) => ({ color }));\n const byKey = new Map(lanes.map((l) => [l.key, l]));\n return (event.lanes ?? []).flatMap((key) => {\n const lane = byKey.get(key);\n return lane?.color ? [{ color: lane.color, label: lane.label }] : [];\n });\n}\n\n\n\n/**\n * How a column stores time: `date` (a calendar day), `zoned` (an instant, `timestamptz`) or\n * `wall` (a wall time with no zone, `timestamp without time zone`). @stability Beta\n */\nexport type TimeStorage = \"date\" | \"zoned\" | \"wall\";\n\n/** How a field stores time, from its database type (an unknown type with a time counts as an instant). @stability Beta */\nexport function timeStorage(field: { dbType?: string | undefined; control?: string | undefined; widget?: string | undefined } | undefined): TimeStorage {\n if (!field || field.dbType === \"date\" || (field.control ?? field.widget) === \"date\") return \"date\";\n if (field.dbType === undefined || /with time zone|timestamptz/.test(field.dbType)) return \"zoned\";\n return \"wall\";\n}\n\n/**\n * A window as filter values for a column: days for a date column, ISO instants of `zone`'s\n * midnights for a timestamp, and wall-clock midnights (no zone) for a timestamp without one.\n * `[from, to)`; `lead` widens the start by days. @stability Beta\n */\nexport function windowBounds(range: DayRange, storage: TimeStorage, zone: string, lead = 0): { from: string; to: string } {\n const start = addDays(range.start, -lead);\n if (storage === \"date\") return { from: start, to: range.end };\n if (storage === \"wall\") return { from: `${start}T00:00:00`, to: `${range.end}T00:00:00` };\n const instants = rangeIn({ start, end: range.end }, zone);\n return { from: instants.start.toISOString(), to: instants.end.toISOString() };\n}\n\n/** The clock a field's cells use: its own zone, the scope's, the viewer's, the device's. @stability Beta */\nexport function displayZone(own: string | undefined, viewer: string | undefined, scope: string | undefined): string {\n if (own && own !== \"viewer\" && own !== \"scope\" && isTimeZone(own)) return own;\n const picked = own === \"scope\" ? (scope ?? viewer) : viewer;\n return picked && isTimeZone(picked) ? picked : deviceTimeZone();\n}\n\nconst UNIT_MS: Readonly<Record<ViewCalendarDurationUnit, number>> = { minutes: 60_000, hours: 3_600_000, days: 86_400_000 };\n\nfunction durationOf(value: unknown): number | null {\n const n = typeof value === \"string\" && value.trim() ? Number(value) : value;\n return typeof n === \"number\" && Number.isFinite(n) && n > 0 ? n : null;\n}\n\nconst atUtcMidnight = (at: Date) => at.getTime() % UNIT_MS.days === 0;\n\nconst MAX_TIME = 8.64e15;\n\nfunction durationEnd(start: Day | Date, startDay: Day, allDay: boolean, ms: number): Day | Date | null {\n if (!Number.isFinite(ms)) return null;\n if (typeof start === \"string\" || allDay) {\n const days = Math.max(1, Math.ceil(ms / UNIT_MS.days));\n if (!Number.isSafeInteger(days) || days * UNIT_MS.days > MAX_TIME) return null;\n try {\n return addDays(startDay, days - 1);\n } catch {\n return null;\n }\n }\n const end = start.getTime() + ms;\n return Number.isFinite(end) && Math.abs(end) <= MAX_TIME ? new Date(end) : null;\n}\n\n/** A lane field's value as lane keys. */\nexport function laneKeys(value: unknown): string[] {\n if (Array.isArray(value)) return value.filter((v) => v !== null && v !== undefined).map(String);\n return value === null || value === undefined || value === \"\" ? [] : [String(value)];\n}\n\n/** How a view's rows become events: its calendar block's fields, and the screen's look per row. @stability Beta */\nexport interface CalendarEventOptions<T> extends Pick<ViewCalendar, \"field\"> {\n endField?: string | undefined;\n durationField?: string | undefined;\n durationUnit?: ViewCalendarDurationUnit | undefined;\n allDayField?: string | undefined;\n laneBy?: string | undefined;\n /** The clock the rows are read on. */\n timeZone: string;\n lanesOf?: ((row: T) => readonly string[]) | undefined;\n colorsOf?: ((row: T) => readonly string[]) | undefined;\n classNameOf?: ((row: T) => string | undefined) | undefined;\n statusOf?: ((row: T) => string | undefined) | undefined;\n}\n\n/**\n * A view's rows as calendar events: each row's start (and its end, or start plus its duration),\n * all day or timed, its title from the view's summary and its lanes. A row without a start is\n * left out. The web's calendar and the phone's read rows through it.\n *\n * @stability Beta\n */\nexport function calendarEvents<T extends Record<string, unknown>>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract; Row is what matters here\n view: ResourceView<ResourceContract<any>, T & DataRow>,\n rows: readonly T[],\n options: CalendarEventOptions<T>,\n): CalendarEvent<T>[] {\n const { field: fieldName, endField, durationField, durationUnit = \"minutes\", allDayField, laneBy, timeZone: zone, lanesOf, colorsOf, classNameOf, statusOf } = options;\n const storage = timeStorage(view.field(fieldName));\n const endStorage = endField ? timeStorage(view.field(endField)) : storage;\n return rows.flatMap((row): CalendarEvent<T>[] => {\n const start = readEventTime(row[fieldName], { dateOnly: storage === \"date\", timeZone: zone });\n if (start === null) return [];\n const ownEnd = endField ? readEventTime(row[endField], { dateOnly: endStorage === \"date\", timeZone: zone }) : null;\n const allDay = allDayField ? Boolean(row[allDayField]) : typeof start === \"string\";\n // An all-day row's days. Stored as days (`YYYY-MM-DD`), they are those days, with no clock\n // at all. Stored as instants at UTC midnight (how Google's API and most sources write an\n // all-day event), they are read on UTC: on a clock behind UTC that midnight is the\n // evening before. Any other instants (a midnight on the viewer's clock) are read on the\n // viewer's clock.\n const clock = allDay && typeof start !== \"string\" && atUtcMidnight(start) && (ownEnd === null || typeof ownEnd === \"string\" || atUtcMidnight(ownEnd)) ? \"UTC\" : zone;\n const startDay = typeof start === \"string\" ? start : dayIn(clock, start);\n // No end of its own: the start plus its duration. A timed row ends that long after it starts\n // (exclusive, like a stored end); a date or an all-day row runs that many days from its start\n // day, so its last day is the one before, and never before its first. An end that can't be\n // represented leaves the row on its start alone.\n const length = ownEnd === null && durationField ? durationOf(row[durationField]) : null;\n const rowEnd = length === null ? ownEnd : durationEnd(start, startDay, allDay, length * UNIT_MS[durationUnit]);\n // An all-day row stored as instants runs to an exclusive end: its last day is the one before\n // the end instant, and never before its first.\n const lastDay = (v: Day | Date) => {\n const d = typeof v === \"string\" ? v : dayIn(clock, new Date(v.getTime() - 1));\n return d < startDay ? startDay : d;\n };\n const rowLanes = lanesOf ? lanesOf(row) : laneBy ? laneKeys(row[laneBy]) : undefined;\n const colors = colorsOf?.(row);\n const look = classNameOf?.(row);\n const status = statusOf?.(row);\n return [\n {\n key: String(encodeRecordKey(view.contract, row as T & DataRow)),\n title: view.summary(row as T & DataRow).title,\n start: allDay ? startDay : start,\n ...(rowEnd !== null ? { end: allDay ? lastDay(rowEnd) : rowEnd } : {}),\n allDay,\n ...(rowLanes ? { lanes: rowLanes } : {}),\n ...(colors ? { colors } : {}),\n ...(look ? { className: look } : {}),\n ...(status ? { status } : {}),\n row,\n },\n ];\n });\n}\n"]}
1
+ {"version":3,"sources":["../src/resource-view/calendar.ts"],"names":[],"mappings":"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","file":"chunk-UKJCF2CM.js","sourcesContent":["// Calendars over a view's rows (ADR 0017, ADR 0021): the days a layout shows, where each event\n// lands, how a column stores time, and a view's rows as events. Pure, so the web's EventCalendar,\n// a custom view and the phone's calendar all place events the same way.\n\nimport {\n addDays,\n addMonths,\n addWeeks,\n dayIn,\n deviceTimeZone,\n eachDay,\n isTimeZone,\n monthGridRange,\n rangeIn,\n readEventTime,\n weeksRange,\n type Day,\n type DayRange,\n} from \"../dates\";\nimport { isDevelopment } from \"../errors\";\nimport { encodeRecordKey } from \"../schema/keys\";\nimport type { DataRow, ResourceContract } from \"../schema/types\";\nimport type { ResourceView, ViewCalendar, ViewCalendarDurationUnit } from \"./types\";\n\n// Each bad value is warned about once, not on every render while it stays in the URL.\nconst warned = new Set<string>();\n\n/** A development-only hint, once per message: a bad URL value or override that fell back. @stability Beta */\nexport function warnOnce(message: string): void {\n if (!isDevelopment() || warned.has(message)) return;\n warned.add(message);\n // genesis-allow-console: a development-only hint about a value that fell back; nothing failed.\n console.warn(message);\n}\n\n\n/** How a calendar lays out its window. @stability Beta */\nexport type CalendarLayout = \"month\" | \"weeks\" | \"agenda\" | \"lanes\";\n\n/** Weeks a `weeks`, `agenda` or `lanes` layout shows. @stability Beta */\nexport type CalendarWeeks = 1 | 2 | 3 | 4;\n\n/**\n * One event. An all-day event's `start` and `end` are days, `end` the last day it covers\n * (inclusive: a weekend away is Saturday to Sunday). A timed event's are instants, `end`\n * exclusive; without one it is a moment.\n *\n * @stability Beta\n */\nexport interface CalendarEvent<T = unknown> {\n key: string;\n title: string;\n start: Day | Date;\n end?: Day | Date | undefined;\n /** Default: true when `start` is a day. */\n allDay?: boolean | undefined;\n /** The lanes (people) it belongs to: one dot each, and a place in each lane of a `lanes` layout. */\n lanes?: readonly string[] | undefined;\n /** Dot colours, when not the lanes' own. Any CSS colour. */\n colors?: readonly string[] | undefined;\n /**\n * Classes for the event's item, on the grid and the printed agenda: `line-through opacity-60`\n * strikes out a cancelled event rather than dropping it. Pair a look with `status`, so it isn't\n * the only cue.\n */\n className?: string | undefined;\n /** Words read out after the title (\"Cancelled\"), for what `className` shows. Visually hidden. */\n status?: string | undefined;\n /** The record it came from, handed back on select. */\n row?: T;\n}\n\n/** A lane: one person (or room, or team) a `lanes` layout gives a row. @stability Beta */\nexport interface CalendarLane {\n key: string;\n label: string;\n /** Its dot colour, any CSS colour. */\n color?: string | undefined;\n}\n\n/** An event on one of its days. @stability Beta */\nexport interface PlacedEvent<T = unknown> {\n event: CalendarEvent<T>;\n day: Day;\n allDay: boolean;\n /** It started on an earlier day. */\n continued: boolean;\n /** It runs on past this day. */\n continues: boolean;\n}\n\n/** What a layout's window depends on. */\nexport interface CalendarWindowOptions {\n weeks?: CalendarWeeks | undefined;\n /** 0 Sunday or 1 Monday (default). */\n weekStartsOn?: 0 | 1 | undefined;\n}\n\n/**\n * The days a layout shows around `anchor`: a month grid's whole weeks, or `weeks` weeks from the\n * week `anchor` is in. This is the window a calendar asks its data for. @stability Beta\n */\nexport function calendarWindow(layout: CalendarLayout, anchor: Day, options: CalendarWindowOptions = {}): DayRange {\n const weekStartsOn = options.weekStartsOn ?? 1;\n return layout === \"month\" ? monthGridRange(anchor, weekStartsOn) : weeksRange(anchor, options.weeks ?? 2, weekStartsOn);\n}\n\n/** The anchor one step back (−1) or on (1): a month for `month`, else the window's weeks. @stability Beta */\nexport function shiftAnchor(layout: CalendarLayout, anchor: Day, step: number, weeks: CalendarWeeks = 2): Day {\n return layout === \"month\" ? addMonths(anchor, step) : addWeeks(anchor, step * weeks);\n}\n\nfunction isAllDay(event: CalendarEvent<unknown>): boolean {\n return event.allDay ?? typeof event.start === \"string\";\n}\n\n/** The first and last day an event covers on `zone`'s clock. */\nexport function eventDays(event: CalendarEvent<unknown>, zone: string): { first: Day; last: Day } {\n const dayOfValue = (v: Day | Date) => (typeof v === \"string\" ? v : dayIn(zone, v));\n const first = dayOfValue(event.start);\n if (event.end === undefined) return { first, last: first };\n let last: Day;\n if (typeof event.end === \"string\") last = event.end;\n // A timed end is exclusive: an event to midnight ends the day before.\n else last = dayIn(zone, new Date(Math.max(event.end.getTime() - 1, typeof event.start === \"string\" ? 0 : event.start.getTime())));\n return { first, last: last < first ? first : last };\n}\n\nconst startTime = (e: CalendarEvent<unknown>) => (typeof e.start === \"string\" ? 0 : e.start.getTime());\n\n/**\n * Each day of `range` with the events on it: an event that spans days is on each one, all-day\n * events (and the middle days of a long timed one) come first, then timed ones by start, then by\n * title. @stability Beta\n */\nexport function placeEvents<T>(events: readonly CalendarEvent<T>[], range: DayRange, zone: string): Map<Day, PlacedEvent<T>[]> {\n const byDay = new Map<Day, PlacedEvent<T>[]>(eachDay(range).map((d) => [d, []]));\n for (const event of events) {\n const { first, last } = eventDays(event, zone);\n if (last < range.start || first >= range.end) continue;\n const allDay = isAllDay(event);\n for (let day = first < range.start ? range.start : first; day <= last && day < range.end; day = addDays(day, 1)) {\n byDay.get(day)!.push({\n event,\n day,\n // A timed event's middle days have no start of their own: they read as all day.\n allDay: allDay || (day !== first && day !== last),\n continued: day !== first,\n continues: day !== last,\n });\n }\n }\n for (const list of byDay.values()) {\n list.sort(\n (a, b) =>\n Number(b.allDay) - Number(a.allDay) ||\n (a.allDay ? 0 : (a.continued ? 0 : startTime(a.event)) - (b.continued ? 0 : startTime(b.event))) ||\n a.event.title.localeCompare(b.event.title) ||\n a.event.key.localeCompare(b.event.key),\n );\n }\n return byDay;\n}\n\n/**\n * The lanes a `lanes` layout draws: the ones given, in order, then any an event names that\n * weren't given (labelled by key). @stability Beta\n */\nexport function calendarLanes(events: readonly CalendarEvent<unknown>[], lanes: readonly CalendarLane[] = []): CalendarLane[] {\n const out = [...lanes];\n const seen = new Set(out.map((l) => l.key));\n for (const e of events) {\n for (const key of e.lanes ?? []) {\n if (!seen.has(key)) {\n seen.add(key);\n out.push({ key, label: key });\n }\n }\n }\n return out;\n}\n\n/** An event's dots: its own colours, else its lanes' colours. @stability Beta */\nexport function eventDots(event: CalendarEvent<unknown>, lanes: readonly CalendarLane[]): { color: string; label?: string }[] {\n if (event.colors?.length) return event.colors.map((color) => ({ color }));\n const byKey = new Map(lanes.map((l) => [l.key, l]));\n return (event.lanes ?? []).flatMap((key) => {\n const lane = byKey.get(key);\n return lane?.color ? [{ color: lane.color, label: lane.label }] : [];\n });\n}\n\n\n\n/**\n * How a column stores time: `date` (a calendar day), `zoned` (an instant, `timestamptz`) or\n * `wall` (a wall time with no zone, `timestamp without time zone`). @stability Beta\n */\nexport type TimeStorage = \"date\" | \"zoned\" | \"wall\";\n\n/** How a field stores time, from its database type (an unknown type with a time counts as an instant). @stability Beta */\nexport function timeStorage(field: { dbType?: string | undefined; control?: string | undefined; widget?: string | undefined } | undefined): TimeStorage {\n if (!field || field.dbType === \"date\" || (field.control ?? field.widget) === \"date\") return \"date\";\n if (field.dbType === undefined || /with time zone|timestamptz/.test(field.dbType)) return \"zoned\";\n return \"wall\";\n}\n\n/**\n * A window as filter values for a column: days for a date column, ISO instants of `zone`'s\n * midnights for a timestamp, and wall-clock midnights (no zone) for a timestamp without one.\n * `[from, to)`; `lead` widens the start by days. @stability Beta\n */\nexport function windowBounds(range: DayRange, storage: TimeStorage, zone: string, lead = 0): { from: string; to: string } {\n const start = addDays(range.start, -lead);\n if (storage === \"date\") return { from: start, to: range.end };\n if (storage === \"wall\") return { from: `${start}T00:00:00`, to: `${range.end}T00:00:00` };\n const instants = rangeIn({ start, end: range.end }, zone);\n return { from: instants.start.toISOString(), to: instants.end.toISOString() };\n}\n\n/** The clock a field's cells use: its own zone, the scope's, the viewer's, the device's. @stability Beta */\nexport function displayZone(own: string | undefined, viewer: string | undefined, scope: string | undefined): string {\n if (own && own !== \"viewer\" && own !== \"scope\" && isTimeZone(own)) return own;\n const picked = own === \"scope\" ? (scope ?? viewer) : viewer;\n return picked && isTimeZone(picked) ? picked : deviceTimeZone();\n}\n\nconst UNIT_MS: Readonly<Record<ViewCalendarDurationUnit, number>> = { minutes: 60_000, hours: 3_600_000, days: 86_400_000 };\n\nfunction durationOf(value: unknown): number | null {\n const n = typeof value === \"string\" && value.trim() ? Number(value) : value;\n return typeof n === \"number\" && Number.isFinite(n) && n > 0 ? n : null;\n}\n\nconst atUtcMidnight = (at: Date) => at.getTime() % UNIT_MS.days === 0;\n\nconst MAX_TIME = 8.64e15;\n\nfunction durationEnd(start: Day | Date, startDay: Day, allDay: boolean, ms: number): Day | Date | null {\n if (!Number.isFinite(ms)) return null;\n if (typeof start === \"string\" || allDay) {\n const days = Math.max(1, Math.ceil(ms / UNIT_MS.days));\n if (!Number.isSafeInteger(days) || days * UNIT_MS.days > MAX_TIME) return null;\n try {\n return addDays(startDay, days - 1);\n } catch {\n return null;\n }\n }\n const end = start.getTime() + ms;\n return Number.isFinite(end) && Math.abs(end) <= MAX_TIME ? new Date(end) : null;\n}\n\n/** A lane field's value as lane keys. */\nexport function laneKeys(value: unknown): string[] {\n if (Array.isArray(value)) return value.filter((v) => v !== null && v !== undefined).map(String);\n return value === null || value === undefined || value === \"\" ? [] : [String(value)];\n}\n\n/** How a view's rows become events: its calendar block's fields, and the screen's look per row. @stability Beta */\nexport interface CalendarEventOptions<T> extends Pick<ViewCalendar, \"field\"> {\n endField?: string | undefined;\n durationField?: string | undefined;\n durationUnit?: ViewCalendarDurationUnit | undefined;\n allDayField?: string | undefined;\n laneBy?: string | undefined;\n /** The clock the rows are read on. */\n timeZone: string;\n lanesOf?: ((row: T) => readonly string[]) | undefined;\n colorsOf?: ((row: T) => readonly string[]) | undefined;\n classNameOf?: ((row: T) => string | undefined) | undefined;\n statusOf?: ((row: T) => string | undefined) | undefined;\n}\n\n/**\n * A view's rows as calendar events: each row's start (and its end, or start plus its duration),\n * all day or timed, its title from the view's summary and its lanes. A row without a start is\n * left out. The web's calendar and the phone's read rows through it.\n *\n * @stability Beta\n */\nexport function calendarEvents<T extends Record<string, unknown>>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract; Row is what matters here\n view: ResourceView<ResourceContract<any>, T & DataRow>,\n rows: readonly T[],\n options: CalendarEventOptions<T>,\n): CalendarEvent<T>[] {\n const { field: fieldName, endField, durationField, durationUnit = \"minutes\", allDayField, laneBy, timeZone: zone, lanesOf, colorsOf, classNameOf, statusOf } = options;\n const storage = timeStorage(view.field(fieldName));\n const endStorage = endField ? timeStorage(view.field(endField)) : storage;\n return rows.flatMap((row): CalendarEvent<T>[] => {\n const start = readEventTime(row[fieldName], { dateOnly: storage === \"date\", timeZone: zone });\n if (start === null) return [];\n const ownEnd = endField ? readEventTime(row[endField], { dateOnly: endStorage === \"date\", timeZone: zone }) : null;\n const allDay = allDayField ? Boolean(row[allDayField]) : typeof start === \"string\";\n // An all-day row's days. Stored as days (`YYYY-MM-DD`), they are those days, with no clock\n // at all. Stored as instants at UTC midnight (how Google's API and most sources write an\n // all-day event), they are read on UTC: on a clock behind UTC that midnight is the\n // evening before. Any other instants (a midnight on the viewer's clock) are read on the\n // viewer's clock.\n const clock = allDay && typeof start !== \"string\" && atUtcMidnight(start) && (ownEnd === null || typeof ownEnd === \"string\" || atUtcMidnight(ownEnd)) ? \"UTC\" : zone;\n const startDay = typeof start === \"string\" ? start : dayIn(clock, start);\n // No end of its own: the start plus its duration. A timed row ends that long after it starts\n // (exclusive, like a stored end); a date or an all-day row runs that many days from its start\n // day, so its last day is the one before, and never before its first. An end that can't be\n // represented leaves the row on its start alone.\n const length = ownEnd === null && durationField ? durationOf(row[durationField]) : null;\n const rowEnd = length === null ? ownEnd : durationEnd(start, startDay, allDay, length * UNIT_MS[durationUnit]);\n // An all-day row stored as instants runs to an exclusive end: its last day is the one before\n // the end instant, and never before its first.\n const lastDay = (v: Day | Date) => {\n const d = typeof v === \"string\" ? v : dayIn(clock, new Date(v.getTime() - 1));\n return d < startDay ? startDay : d;\n };\n const rowLanes = lanesOf ? lanesOf(row) : laneBy ? laneKeys(row[laneBy]) : undefined;\n const colors = colorsOf?.(row);\n const look = classNameOf?.(row);\n const status = statusOf?.(row);\n return [\n {\n key: String(encodeRecordKey(view.contract, row as T & DataRow)),\n title: view.summary(row as T & DataRow).title,\n start: allDay ? startDay : start,\n ...(rowEnd !== null ? { end: allDay ? lastDay(rowEnd) : rowEnd } : {}),\n allDay,\n ...(rowLanes ? { lanes: rowLanes } : {}),\n ...(colors ? { colors } : {}),\n ...(look ? { className: look } : {}),\n ...(status ? { status } : {}),\n row,\n },\n ];\n });\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { useViewer } from './chunk-XIBQ5BTZ.js';
1
+ import { useViewer } from './chunk-RZVLUUMY.js';
2
2
  import { resourceKeys } from './chunk-2IGAUXYH.js';
3
3
  import { useDataProvider } from './chunk-OIZNABG4.js';
4
4
  import { resolveAggregate } from './chunk-J54XXKQD.js';
@@ -27,5 +27,5 @@ function useSegmentCounts(view, baseFilters, options = {}) {
27
27
  }
28
28
 
29
29
  export { useSegmentCounts };
30
- //# sourceMappingURL=chunk-K33LWVUF.js.map
31
- //# sourceMappingURL=chunk-K33LWVUF.js.map
30
+ //# sourceMappingURL=chunk-UKWM32CG.js.map
31
+ //# sourceMappingURL=chunk-UKWM32CG.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-segment-counts.ts"],"names":[],"mappings":";;;;;;AAkBO,SAAS,gBAAA,CAEd,IAAA,EACA,WAAA,EACA,OAAA,GAAiC,EAAC,EACY;AAC9C,EAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,MAAM,QAAA,GAAW,KAAK,QAAA,EAAS;AAC/B,EAAA,MAAM,UAAU,UAAA,CAAW;AAAA,IACzB,OAAA,EAAS,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM;AAC3B,MAAA,MAAM,MAAA,GAAS,EAAE,OAAA,EAAS,EAAE,GAAG,EAAE,EAAA,EAAI,OAAA,EAAiB,EAAE,EAAG,OAAA,EAAS,CAAC,GAAG,WAAA,EAAa,GAAG,IAAA,CAAK,cAAA,CAAe,CAAA,CAAE,IAAI,MAAM,CAAC,CAAA,EAAG,KAAA,EAAO,WAAA,EAAqB;AACxJ,MAAA,OAAO;AAAA,QACL,UAAU,YAAA,CAAa,IAAA,CAAK,QAAQ,CAAA,CAAE,UAAU,MAAM,CAAA;AAAA,QACtD,SAAS,MAAM,gBAAA,CAAiB,QAAA,EAAU,IAAA,CAAK,UAAU,MAAM,CAAA;AAAA,QAC/D,SAAS,CAAC,CAAC,CAAA,CAAE,KAAA,IAAS,QAAQ,OAAA,KAAY;AAAA,OAC5C;AAAA,IACF,CAAC;AAAA,GACF,CAAA;AACD,EAAA,MAAM,MAA0C,EAAC;AACjD,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,KAAM;AACzB,IAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,CAAA,EAAG,IAAA,EAAM,OAAO,GAAG,CAAA;AACtC,IAAA,GAAA,CAAI,EAAE,EAAE,CAAA,GAAI,OAAO,CAAA,KAAM,WAAW,CAAA,GAAI,MAAA;AAAA,EAC1C,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT","file":"chunk-K33LWVUF.js","sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport { resolveAggregate } from \"../provider/aggregate\";\nimport type { FilterParam } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport type { ResourceContract } from \"../schema/types\";\nimport type { ResourceView } from \"../resource-view/types\";\nimport { useViewer } from \"./viewer-scope\";\n\n/**\n * Each segment's row count for a view's list (ADR 0017), for the segments that ask for one\n * (`count: true`): the list's other filters (scope, the screen's, the declared filters) plus the\n * segment's own, counted through the provider (estimated). A segment without a count, or one not\n * counted yet, maps to undefined. The web's segment strip, the inbox rail and the phone's segment\n * chips all read it.\n *\n * @stability Beta\n */\nexport function useSegmentCounts(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract and row\n view: ResourceView<ResourceContract<any>, any>,\n baseFilters: readonly FilterParam[],\n options: { enabled?: boolean } = {},\n): Readonly<Record<string, number | undefined>> {\n const provider = useDataProvider();\n const viewer = useViewer();\n const segments = view.segments();\n const counted = useQueries({\n queries: segments.map((s) => {\n const params = { metrics: { n: { fn: \"count\" as const } }, filters: [...baseFilters, ...view.segmentFilters(s.id, viewer)], count: \"estimated\" as const };\n return {\n queryKey: resourceKeys(view.resource).aggregate(params),\n queryFn: () => resolveAggregate(provider, view.resource, params),\n enabled: !!s.count && options.enabled !== false,\n };\n }),\n });\n const out: Record<string, number | undefined> = {};\n segments.forEach((s, i) => {\n const n = counted[i]?.data?.values[\"n\"];\n out[s.id] = typeof n === \"number\" ? n : undefined;\n });\n return out;\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-segment-counts.ts"],"names":[],"mappings":";;;;;;AAkBO,SAAS,gBAAA,CAEd,IAAA,EACA,WAAA,EACA,OAAA,GAAiC,EAAC,EACY;AAC9C,EAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,MAAM,QAAA,GAAW,KAAK,QAAA,EAAS;AAC/B,EAAA,MAAM,UAAU,UAAA,CAAW;AAAA,IACzB,OAAA,EAAS,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM;AAC3B,MAAA,MAAM,MAAA,GAAS,EAAE,OAAA,EAAS,EAAE,GAAG,EAAE,EAAA,EAAI,OAAA,EAAiB,EAAE,EAAG,OAAA,EAAS,CAAC,GAAG,WAAA,EAAa,GAAG,IAAA,CAAK,cAAA,CAAe,CAAA,CAAE,IAAI,MAAM,CAAC,CAAA,EAAG,KAAA,EAAO,WAAA,EAAqB;AACxJ,MAAA,OAAO;AAAA,QACL,UAAU,YAAA,CAAa,IAAA,CAAK,QAAQ,CAAA,CAAE,UAAU,MAAM,CAAA;AAAA,QACtD,SAAS,MAAM,gBAAA,CAAiB,QAAA,EAAU,IAAA,CAAK,UAAU,MAAM,CAAA;AAAA,QAC/D,SAAS,CAAC,CAAC,CAAA,CAAE,KAAA,IAAS,QAAQ,OAAA,KAAY;AAAA,OAC5C;AAAA,IACF,CAAC;AAAA,GACF,CAAA;AACD,EAAA,MAAM,MAA0C,EAAC;AACjD,EAAA,QAAA,CAAS,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,KAAM;AACzB,IAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,CAAA,EAAG,IAAA,EAAM,OAAO,GAAG,CAAA;AACtC,IAAA,GAAA,CAAI,EAAE,EAAE,CAAA,GAAI,OAAO,CAAA,KAAM,WAAW,CAAA,GAAI,MAAA;AAAA,EAC1C,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT","file":"chunk-UKWM32CG.js","sourcesContent":["import { useQueries } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport { resolveAggregate } from \"../provider/aggregate\";\nimport type { FilterParam } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport type { ResourceContract } from \"../schema/types\";\nimport type { ResourceView } from \"../resource-view/types\";\nimport { useViewer } from \"./viewer-scope\";\n\n/**\n * Each segment's row count for a view's list (ADR 0017), for the segments that ask for one\n * (`count: true`): the list's other filters (scope, the screen's, the declared filters) plus the\n * segment's own, counted through the provider (estimated). A segment without a count, or one not\n * counted yet, maps to undefined. The web's segment strip, the inbox rail and the phone's segment\n * chips all read it.\n *\n * @stability Beta\n */\nexport function useSegmentCounts(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract and row\n view: ResourceView<ResourceContract<any>, any>,\n baseFilters: readonly FilterParam[],\n options: { enabled?: boolean } = {},\n): Readonly<Record<string, number | undefined>> {\n const provider = useDataProvider();\n const viewer = useViewer();\n const segments = view.segments();\n const counted = useQueries({\n queries: segments.map((s) => {\n const params = { metrics: { n: { fn: \"count\" as const } }, filters: [...baseFilters, ...view.segmentFilters(s.id, viewer)], count: \"estimated\" as const };\n return {\n queryKey: resourceKeys(view.resource).aggregate(params),\n queryFn: () => resolveAggregate(provider, view.resource, params),\n enabled: !!s.count && options.enabled !== false,\n };\n }),\n });\n const out: Record<string, number | undefined> = {};\n segments.forEach((s, i) => {\n const n = counted[i]?.data?.values[\"n\"];\n out[s.id] = typeof n === \"number\" ? n : undefined;\n });\n return out;\n}\n"]}
package/dist/csv.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { F as FieldSchema, D as DataProvider, S as SortParam, a as FilterParam } from './types-CiQY6hUy.js';
1
+ import { F as FieldSchema, D as DataProvider, S as SortParam, a as FilterParam } from './types-BnOCVJzm.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,4 +1,5 @@
1
- export { classifyError, defaultErrorReporter, errorMessages, getErrorReporter, isDevelopment, reportError, setErrorReporter } from './chunk-NOPS5EIH.js';
1
+ export { classifyError, defaultErrorReporter, errorMessages, getErrorReporter, isDevelopment, reportError, setErrorReporter } from './chunk-CJ5V6JES.js';
2
+ import './chunk-LYNIHY3F.js';
2
3
  import './chunk-HUNGCTRA.js';
3
4
  import './chunk-RYEXWQFD.js';
4
5
  import './chunk-WLDSIQJ2.js';
@@ -1 +1 @@
1
- export { w as FieldType, i as ResourceFormFieldDef, Z as SelectOption } from './types-CiQY6hUy.js';
1
+ export { w as FieldType, i as ResourceFormFieldDef, Z as SelectOption } from './types-BnOCVJzm.js';
@@ -1,4 +1,4 @@
1
- import { i as ResourceFormFieldDef } from '../types-CiQY6hUy.js';
1
+ import { i as ResourceFormFieldDef } from '../types-BnOCVJzm.js';
2
2
  import { Day } from '../dates.js';
3
3
 
4
4
  /**
@@ -24,14 +24,14 @@ export { UseWizardReturn, WizardStep, useWizard } from './use-wizard.js';
24
24
  export { DEFAULT_UNDO_DELAY_MS, MutationMode, MutationModeOptions, UndoableWrite, dropPendingWrites, flushPendingWrites, pendingWriteCount } from './mutation-mode.js';
25
25
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, UseUnsavedChangesGuardOptions, UseUnsavedChangesGuardReturn, useUnsavedChangesGuard } from './use-unsaved-changes-guard.js';
26
26
  import '@tanstack/react-query';
27
- import '../types-CiQY6hUy.js';
28
- import '../aggregate-v_r-nZbH.js';
29
- import '../types-BAhcze_-.js';
27
+ import '../types-BnOCVJzm.js';
28
+ import '../aggregate-CUirs7ka.js';
29
+ import '../types-CBtBvGw0.js';
30
30
  import '../status-BXRokZD9.js';
31
31
  import '../gallery/index.js';
32
32
  import '../dates.js';
33
33
  import '../write-state-DVC4Yq9T.js';
34
- import '../saved-views-C45lRm7i.js';
34
+ import '../saved-views-Bcox3blZ.js';
35
35
  import '../types-DKcxHXxq.js';
36
36
  import 'react-hook-form';
37
37
 
@@ -1,27 +1,27 @@
1
- export { WorkspaceScope, rememberedWorkspaceId, useWorkspace } from '../chunk-TWLPC4S3.js';
2
- export { useSegmentCounts } from '../chunk-K33LWVUF.js';
3
- export { useViewBoard } from '../chunk-KRRESUXT.js';
4
- import '../chunk-JNWTHDGF.js';
1
+ export { WorkspaceScope, rememberedWorkspaceId, useWorkspace } from '../chunk-DJRT4DUF.js';
2
+ export { useSegmentCounts } from '../chunk-UKWM32CG.js';
3
+ export { useViewBoard } from '../chunk-PH25HOAL.js';
4
+ import '../chunk-AOIVTOHX.js';
5
5
  import '../chunk-BNKP2H7J.js';
6
- export { CALENDAR_LIMIT, useViewCalendarRange } from '../chunk-2ORQLYVW.js';
7
- import '../chunk-YMFJLBIZ.js';
6
+ export { CALENDAR_LIMIT, useViewCalendarRange } from '../chunk-SMEG63MO.js';
7
+ import '../chunk-UKJCF2CM.js';
8
8
  import '../chunk-KV2HW4G4.js';
9
9
  export { useWizard } from '../chunk-7KOLYF27.js';
10
10
  export { WRITE_FAILED, useWrite } from '../chunk-NQFIAULD.js';
11
11
  export { useLinkOptions } from '../chunk-JF7FXSQB.js';
12
- export { useListState } from '../chunk-WNOCPV4A.js';
12
+ export { useListState } from '../chunk-DTVYCATJ.js';
13
13
  import '../chunk-MZVFOTAE.js';
14
14
  import '../chunk-6JOWGO2X.js';
15
- export { ViewerScope, clearViewerCache, scopeClock, useOptionalViewerScope, useViewer, useViewerScope } from '../chunk-XIBQ5BTZ.js';
15
+ export { ViewerScope, clearViewerCache, scopeClock, useOptionalViewerScope, useViewer, useViewerScope } from '../chunk-RZVLUUMY.js';
16
16
  export { NO_VIEWER } from '../chunk-OZYF55E3.js';
17
17
  export { usePersistedUiState } from '../chunk-5KLIFJYG.js';
18
18
  export { loadRelationLabel, relationNamingField, useRelationLabel } from '../chunk-ZKLB2HB5.js';
19
- export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-FBMKI22S.js';
19
+ export { blankValues, buildArrayItemDefaults, useResourceForm } from '../chunk-ATVK3VYS.js';
20
20
  export { DEFAULT_UNSAVED_CHANGES_MESSAGE, useUnsavedChangesGuard } from '../chunk-RVWKVD5Q.js';
21
21
  import '../chunk-LKRJB632.js';
22
22
  export { useOne } from '../chunk-QJOKZZKY.js';
23
- export { useResource } from '../chunk-6B4CN2TC.js';
24
- export { DEFAULT_UNDO_DELAY_MS, dropPendingWrites, flushPendingWrites, pendingWriteCount } from '../chunk-AQX5HQD6.js';
23
+ export { useResource } from '../chunk-OCMYW2YE.js';
24
+ export { DEFAULT_UNDO_DELAY_MS, dropPendingWrites, flushPendingWrites, pendingWriteCount } from '../chunk-OTUTSAZD.js';
25
25
  import '../chunk-7NUL32W7.js';
26
26
  export { useAggregate } from '../chunk-4POVYF6P.js';
27
27
  export { BOARD_NONE, BOARD_PAGE, boardColumnFilter, useBoardColumns } from '../chunk-6VNM6KAX.js';
@@ -39,7 +39,8 @@ import '../chunk-BDPRWVFW.js';
39
39
  export { DEFAULT_DRAFT_DELAY_MS, DRAFT_NOT_SAVED, DraftController, isNetworkFailure, stableJson } from '../chunk-5ASUMG6K.js';
40
40
  import '../chunk-AUVKRXRC.js';
41
41
  import '../chunk-WXENWPWP.js';
42
- import '../chunk-NOPS5EIH.js';
42
+ import '../chunk-CJ5V6JES.js';
43
+ import '../chunk-LYNIHY3F.js';
43
44
  import '../chunk-HUNGCTRA.js';
44
45
  import '../chunk-RYEXWQFD.js';
45
46
  import '../chunk-WLDSIQJ2.js';
@@ -1,5 +1,5 @@
1
1
  import { QueryClient } from '@tanstack/react-query';
2
- import { c as Identifier, B as BaseRecord, D as DataProvider, j as AuditEntry } from '../types-CiQY6hUy.js';
2
+ import { c as Identifier, B as BaseRecord, D as DataProvider, j as AuditEntry } from '../types-BnOCVJzm.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,4 +1,4 @@
1
- export { DEFAULT_UNDO_DELAY_MS, DROPPED_WRITE_MESSAGE, cachedRecord, cachedVersion, dropPendingWrites, executeWrite, flushPendingWrites, invalidateResource, pendingWriteCount, providerServesUndo, sameValue } from '../chunk-AQX5HQD6.js';
1
+ export { DEFAULT_UNDO_DELAY_MS, DROPPED_WRITE_MESSAGE, cachedRecord, cachedVersion, dropPendingWrites, executeWrite, flushPendingWrites, invalidateResource, pendingWriteCount, providerServesUndo, sameValue } from '../chunk-OTUTSAZD.js';
2
2
  import '../chunk-MMMC37AP.js';
3
3
  import '../chunk-AJGVLF37.js';
4
4
  import '../chunk-2IGAUXYH.js';
@@ -6,7 +6,8 @@ import '../chunk-OIZNABG4.js';
6
6
  import '../chunk-J54XXKQD.js';
7
7
  import '../chunk-4PTQYT5J.js';
8
8
  import '../chunk-AUVKRXRC.js';
9
- import '../chunk-NOPS5EIH.js';
9
+ import '../chunk-CJ5V6JES.js';
10
+ import '../chunk-LYNIHY3F.js';
10
11
  import '../chunk-HUNGCTRA.js';
11
12
  import '../chunk-RYEXWQFD.js';
12
13
  import '../chunk-WLDSIQJ2.js';
@@ -1,4 +1,4 @@
1
- import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-CiQY6hUy.js';
1
+ import { D as DataProvider, W as WriteEvent, I as InvalidationKey } from '../types-BnOCVJzm.js';
2
2
 
3
3
  /**
4
4
  * The cache keys a committed write makes stale beyond `[resource]`: the
@@ -1,6 +1,6 @@
1
1
  import { UseQueryResult } from '@tanstack/react-query';
2
- import { R as ResolveAggregateOptions } from '../aggregate-v_r-nZbH.js';
3
- import { A as AggregateParams, d as AggregateResult } from '../types-CiQY6hUy.js';
2
+ import { R as ResolveAggregateOptions } from '../aggregate-CUirs7ka.js';
3
+ import { A as AggregateParams, d as AggregateResult } from '../types-BnOCVJzm.js';
4
4
  import { LiveOptions } from './use-live.js';
5
5
 
6
6
  interface UseAggregateOptions extends ResolveAggregateOptions {
@@ -1,5 +1,5 @@
1
1
  import { QueryKey } from '@tanstack/react-query';
2
- import { D as DataProvider, a as FilterParam, S as SortParam, b as ListParams, B as BaseRecord } from '../types-CiQY6hUy.js';
2
+ import { D as DataProvider, a as FilterParam, S as SortParam, b as ListParams, B as BaseRecord } from '../types-BnOCVJzm.js';
3
3
 
4
4
  /** The column for rows whose field is empty. */
5
5
  declare const BOARD_NONE = "__genesis_none__";
@@ -1,5 +1,5 @@
1
1
  import { UseQueryResult } from '@tanstack/react-query';
2
- import { P as ProviderCapabilities } from '../types-CiQY6hUy.js';
2
+ import { P as ProviderCapabilities } from '../types-BnOCVJzm.js';
3
3
 
4
4
  /**
5
5
  * The query key for `provider`'s capabilities for `resource`. It includes
@@ -1,5 +1,5 @@
1
1
  import { UseInfiniteQueryResult, InfiniteData } from '@tanstack/react-query';
2
- import { S as SortParam, a as FilterParam, L as ListResult, b as ListParams, B as BaseRecord } from '../types-CiQY6hUy.js';
2
+ import { S as SortParam, a as FilterParam, L as ListResult, b as ListParams, B as BaseRecord } from '../types-BnOCVJzm.js';
3
3
  import { LiveOptions } from './use-live.js';
4
4
 
5
5
  interface UseInfiniteResourceOptions {
@@ -1,4 +1,4 @@
1
- import { a as FilterParam } from '../types-CiQY6hUy.js';
1
+ import { a as FilterParam } from '../types-BnOCVJzm.js';
2
2
 
3
3
  interface LinkTarget {
4
4
  /** The linked resource. */
@@ -1,6 +1,6 @@
1
- import { a as FilterParam, R as ResourceContract } from '../types-CiQY6hUy.js';
2
- import { b as ViewFilterValue, R as ResourceView } from '../types-BAhcze_-.js';
3
- import { L as ListState, S as SavedViewStore } from '../saved-views-C45lRm7i.js';
1
+ import { a as FilterParam, R as ResourceContract } from '../types-BnOCVJzm.js';
2
+ import { b as ViewFilterValue, R as ResourceView } from '../types-CBtBvGw0.js';
3
+ import { L as ListState, S as SavedViewStore } from '../saved-views-Bcox3blZ.js';
4
4
  import '../status-BXRokZD9.js';
5
5
  import '../viewer-oOk0ZZk9.js';
6
6
  import 'react';
@@ -1,9 +1,9 @@
1
- export { useListState } from '../chunk-WNOCPV4A.js';
1
+ export { useListState } from '../chunk-DTVYCATJ.js';
2
2
  import '../chunk-MZVFOTAE.js';
3
3
  import '../chunk-6JOWGO2X.js';
4
- import '../chunk-XIBQ5BTZ.js';
4
+ import '../chunk-RZVLUUMY.js';
5
5
  import '../chunk-OZYF55E3.js';
6
- import '../chunk-AQX5HQD6.js';
6
+ import '../chunk-OTUTSAZD.js';
7
7
  import '../chunk-MMMC37AP.js';
8
8
  import '../chunk-AJGVLF37.js';
9
9
  import '../chunk-2IGAUXYH.js';
@@ -13,7 +13,8 @@ import '../chunk-4PTQYT5J.js';
13
13
  import '../chunk-5ASUMG6K.js';
14
14
  import '../chunk-AUVKRXRC.js';
15
15
  import '../chunk-WXENWPWP.js';
16
- import '../chunk-NOPS5EIH.js';
16
+ import '../chunk-CJ5V6JES.js';
17
+ import '../chunk-LYNIHY3F.js';
17
18
  import '../chunk-HUNGCTRA.js';
18
19
  import '../chunk-RYEXWQFD.js';
19
20
  import '../chunk-WLDSIQJ2.js';