@burojs/ui-shadcn 0.8.0 → 0.9.0

package/dist/{use-dialog-filter-state-B_MqzHaT.js → use-dialog-filter-state-CJoeY-1j.js}

@@ -1,4 +1,4 @@
-import { a as namesHiddenField, o as narrowSearchDecl } from "./relation-create-C43cdPQt.js";
+import { a as namesHiddenField, o as narrowSearchDecl } from "./relation-create-6WicROWA.js";
 import { EMPTY_FILTER_GROUP, composeListFilter, routeResourceKey } from "@burojs/core";
 import { useApp, useFilterFields, useListAccess } from "@burojs/react";
 import { useCallback, useMemo, useState } from "react";
@@ -85,4 +85,4 @@ function useDialogFilterState(resourceInput, options) {
 //#endregion
 export { useDialogFilterState as t };
 
-//# sourceMappingURL=use-dialog-filter-state-B_MqzHaT.js.map
+//# sourceMappingURL=use-dialog-filter-state-CJoeY-1j.js.map

package/dist/{use-dialog-filter-state-B_MqzHaT.js.map → use-dialog-filter-state-CJoeY-1j.js.map}

@@ -1 +1 @@
-{"version":3,"file":"use-dialog-filter-state-B_MqzHaT.js","names":[],"sources":["../src/fields/use-dialog-filter-state.ts"],"sourcesContent":["import {\n  EMPTY_FILTER_GROUP,\n  composeListFilter,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FilterGroup,\n  type FixedFilterInput,\n  type ResolvedFixedFilter,\n  type SearchDecl,\n  routeResourceKey,\n  type ResourceNameOrRef,\n} from '@burojs/core';\nimport { useApp, useFilterFields, useListAccess, type FilterFieldSpec } from '@burojs/react';\nimport { namesHiddenField, narrowSearchDecl } from './search-access.js';\nimport { useCallback, useMemo, useState } from 'react';\n\n/** The portable erased AST — the only shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/** Options for {@link useDialogFilterState}. */\nexport interface UseDialogFilterStateOptions {\n  /** Call-site narrowing (e.g. scope the target list to a product group). */\n  readonly fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * Fallback search field, used ONLY when the target resource declares no\n   * `views.list.search`. Wrapped into a single-field `SearchFieldsDecl`\n   * (`{ fields: [searchField] }`, implicit `contains` — same degenerate form\n   * `searchToFilter` already gives a bare field-name string) so the override\n   * goes through the exact same `composeListFilter` → `searchToFilter` path\n   * as a real declaration, rather than a second hand-built predicate at the\n   * call site. The target's own declaration always wins when present — this\n   * is a fallback, not an override of a declared search.\n   */\n  readonly searchField?: string;\n  /**\n   * Gates the field-derivation walk (`useFilterFields`'s `categorizeField`\n   * pass over every field of the resource). Defaults to `true`. A caller\n   * whose UI isn't visible yet (e.g. `RelationPickerDialog` before it's\n   * opened) should pass `false` to skip that work on every mount /\n   * `fixedFilters`-identity change; the derivation recomputes in full the\n   * next render where this flips back to `true`.\n   */\n  readonly enabled?: boolean;\n}\n\n/** Return shape of {@link useDialogFilterState}. */\nexport interface DialogFilterState {\n  readonly group: FilterGroup;\n  readonly setGroup: (next: FilterGroup) => void;\n  readonly search: string;\n  readonly setSearch: (next: string) => void;\n  readonly page: number;\n  readonly setPage: (page: number) => void;\n  readonly available: readonly FilterFieldSpec[];\n  readonly fixed: readonly ResolvedFixedFilter[];\n  /** The single expression to hand the data provider. */\n  readonly filter: ErasedExpression | undefined;\n  /** Whether the target has a search for this user (no field left means no search box). */\n  readonly searchEnabled: boolean;\n  /** The read must not be sent: undecided access, or a filter naming a field the user may not view. */\n  readonly blocked: boolean;\n  readonly reset: () => void;\n}\n\n/**\n * Local (non-URL) filter state for the relation-picker's advanced-search\n * dialog.\n *\n * `useResourceList` cannot serve this: it unconditionally calls\n * `useResourceUrlState`, which throws without a `RouterAdapterProvider` and,\n * when one IS present, writes to `?<resource>.*`. A picker dialog mounted\n * inside a form for resource A, searching TARGET resource B, would then\n * write B's list state into the URL — clobbering a real B list page open on\n * another tab of the same app, and reading back whatever that page last\n * wrote on open. So this hook keeps `group`/`search`/`page` in plain\n * `useState` and reuses the SAME composition core's list controller uses\n * (`composeListFilter`) so the two never drift on what a filter means.\n *\n * No `pinned` slot: pinned controls are a list-PAGE affordance (permanent\n * screen real estate for a couple of always-visible facets); a modal has no\n * spare real estate to spend on them.\n */\nexport function useDialogFilterState<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\n  const app = useApp();\n  const def = app.registry.get(resource);\n  const { available, fixed } = useFilterFields(resource, {\n    fixedFilters: options.fixedFilters,\n    enabled: options.enabled,\n  });\n\n  const [group, setGroupState] = useState<FilterGroup>(EMPTY_FILTER_GROUP);\n  const [search, setSearchState] = useState('');\n  const [page, setPage] = useState(1);\n\n  // Any change to WHAT is filtered invalidates the current page — the same\n  // rule `useResourceList`'s URL-state controller applies to its own\n  // group/search setters.\n  const setGroup = useCallback((next: FilterGroup) => {\n    setGroupState(next);\n    setPage(1);\n  }, []);\n\n  const setSearch = useCallback((next: string) => {\n    setSearchState(next);\n    setPage(1);\n  }, []);\n\n  const reset = useCallback(() => {\n    setGroupState(EMPTY_FILTER_GROUP);\n    setSearchState('');\n    setPage(1);\n  }, []);\n\n  // The target's own declaration always wins; `options.searchField` only\n  // fills in when the target declares no search at all. Memoized so an\n  // omitted declaration doesn't hand `composeListFilter`'s `filter` memo a\n  // fresh `{ fields: [...] }` literal (and therefore a spurious recompute)\n  // on every render — see `UseDialogFilterStateOptions.searchField`'s doc.\n  const { searchField } = options;\n  const access = useListAccess(resource);\n  const accessReady = access.status === 'ready';\n  const searchDecl = useMemo<SearchDecl | undefined>(() => {\n    const declared = def?.views?.list?.search;\n    const base =\n      declared !== undefined\n        ? declared\n        : searchField === undefined\n          ? undefined\n          : { fields: [searchField] };\n    return narrowSearchDecl(base, (field) => access.fieldVisible(field));\n  }, [def, searchField, access]);\n  const searchContext = useMemo(() => ({ resource, def }), [resource, def]);\n\n  const filter = useMemo<ErasedExpression | undefined>(\n    () => composeListFilter({ fixed, group, search, searchDecl, searchContext }),\n    [fixed, group, search, searchDecl, searchContext],\n  );\n\n  // A read whose composed filter names a field the user may not view is forbidden (an author\n  // predicate, or a function search's output); an undecided access sends nothing yet.\n  const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));\n\n  return useMemo<DialogFilterState>(\n    () => ({\n      searchEnabled: searchDecl !== undefined,\n      blocked,\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      setPage,\n      available,\n      fixed,\n      filter,\n      reset,\n    }),\n    [\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      available,\n      fixed,\n      filter,\n      reset,\n      searchDecl,\n      blocked,\n    ],\n  );\n}\n"],"mappings":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,WAAW,iBAAiB,aAAa;CAE/C,MAAM,MADM,OACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,UAAU,gBAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,iBAAiB,SAAsB,kBAAkB;CACvE,MAAM,CAAC,QAAQ,kBAAkB,SAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,WAAW,SAAS,CAAC;CAKlC,MAAM,WAAW,aAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,YAAY,aAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,kBAAkB;EAC9B,cAAc,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,SAAS,cAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,aAAa,cAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAO,iBALL,aAAa,KAAA,IACT,WACA,gBAAgB,KAAA,IACd,KAAA,IACA,EAAE,QAAQ,CAAC,WAAW,EAAE,IACD,UAAU,OAAO,aAAa,KAAK,CAAC;CACrE,GAAG;EAAC;EAAK;EAAa;CAAM,CAAC;CAC7B,MAAM,gBAAgB,eAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,SAAS,cACP,kBAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAe,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,OAAO,eACE;EACL,eAAe,eAAe,KAAA;EAC9B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}
+{"version":3,"file":"use-dialog-filter-state-CJoeY-1j.js","names":[],"sources":["../src/fields/use-dialog-filter-state.ts"],"sourcesContent":["import {\n  EMPTY_FILTER_GROUP,\n  composeListFilter,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FilterGroup,\n  type FixedFilterInput,\n  type ResolvedFixedFilter,\n  type SearchDecl,\n  routeResourceKey,\n  type ResourceNameOrRef,\n} from '@burojs/core';\nimport { useApp, useFilterFields, useListAccess, type FilterFieldSpec } from '@burojs/react';\nimport { namesHiddenField, narrowSearchDecl } from './search-access.js';\nimport { useCallback, useMemo, useState } from 'react';\n\n/** The portable erased AST — the only shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/** Options for {@link useDialogFilterState}. */\nexport interface UseDialogFilterStateOptions {\n  /** Call-site narrowing (e.g. scope the target list to a product group). */\n  readonly fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * Fallback search field, used ONLY when the target resource declares no\n   * `views.list.search`. Wrapped into a single-field `SearchFieldsDecl`\n   * (`{ fields: [searchField] }`, implicit `contains` — same degenerate form\n   * `searchToFilter` already gives a bare field-name string) so the override\n   * goes through the exact same `composeListFilter` → `searchToFilter` path\n   * as a real declaration, rather than a second hand-built predicate at the\n   * call site. The target's own declaration always wins when present — this\n   * is a fallback, not an override of a declared search.\n   */\n  readonly searchField?: string;\n  /**\n   * Gates the field-derivation walk (`useFilterFields`'s `categorizeField`\n   * pass over every field of the resource). Defaults to `true`. A caller\n   * whose UI isn't visible yet (e.g. `RelationPickerDialog` before it's\n   * opened) should pass `false` to skip that work on every mount /\n   * `fixedFilters`-identity change; the derivation recomputes in full the\n   * next render where this flips back to `true`.\n   */\n  readonly enabled?: boolean;\n}\n\n/** Return shape of {@link useDialogFilterState}. */\nexport interface DialogFilterState {\n  readonly group: FilterGroup;\n  readonly setGroup: (next: FilterGroup) => void;\n  readonly search: string;\n  readonly setSearch: (next: string) => void;\n  readonly page: number;\n  readonly setPage: (page: number) => void;\n  readonly available: readonly FilterFieldSpec[];\n  readonly fixed: readonly ResolvedFixedFilter[];\n  /** The single expression to hand the data provider. */\n  readonly filter: ErasedExpression | undefined;\n  /** Whether the target has a search for this user (no field left means no search box). */\n  readonly searchEnabled: boolean;\n  /** The read must not be sent: undecided access, or a filter naming a field the user may not view. */\n  readonly blocked: boolean;\n  readonly reset: () => void;\n}\n\n/**\n * Local (non-URL) filter state for the relation-picker's advanced-search\n * dialog.\n *\n * `useResourceList` cannot serve this: it unconditionally calls\n * `useResourceUrlState`, which throws without a `RouterAdapterProvider` and,\n * when one IS present, writes to `?<resource>.*`. A picker dialog mounted\n * inside a form for resource A, searching TARGET resource B, would then\n * write B's list state into the URL — clobbering a real B list page open on\n * another tab of the same app, and reading back whatever that page last\n * wrote on open. So this hook keeps `group`/`search`/`page` in plain\n * `useState` and reuses the SAME composition core's list controller uses\n * (`composeListFilter`) so the two never drift on what a filter means.\n *\n * No `pinned` slot: pinned controls are a list-PAGE affordance (permanent\n * screen real estate for a couple of always-visible facets); a modal has no\n * spare real estate to spend on them.\n */\nexport function useDialogFilterState<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\n  const app = useApp();\n  const def = app.registry.get(resource);\n  const { available, fixed } = useFilterFields(resource, {\n    fixedFilters: options.fixedFilters,\n    enabled: options.enabled,\n  });\n\n  const [group, setGroupState] = useState<FilterGroup>(EMPTY_FILTER_GROUP);\n  const [search, setSearchState] = useState('');\n  const [page, setPage] = useState(1);\n\n  // Any change to WHAT is filtered invalidates the current page — the same\n  // rule `useResourceList`'s URL-state controller applies to its own\n  // group/search setters.\n  const setGroup = useCallback((next: FilterGroup) => {\n    setGroupState(next);\n    setPage(1);\n  }, []);\n\n  const setSearch = useCallback((next: string) => {\n    setSearchState(next);\n    setPage(1);\n  }, []);\n\n  const reset = useCallback(() => {\n    setGroupState(EMPTY_FILTER_GROUP);\n    setSearchState('');\n    setPage(1);\n  }, []);\n\n  // The target's own declaration always wins; `options.searchField` only\n  // fills in when the target declares no search at all. Memoized so an\n  // omitted declaration doesn't hand `composeListFilter`'s `filter` memo a\n  // fresh `{ fields: [...] }` literal (and therefore a spurious recompute)\n  // on every render — see `UseDialogFilterStateOptions.searchField`'s doc.\n  const { searchField } = options;\n  const access = useListAccess(resource);\n  const accessReady = access.status === 'ready';\n  const searchDecl = useMemo<SearchDecl | undefined>(() => {\n    const declared = def?.views?.list?.search;\n    const base =\n      declared !== undefined\n        ? declared\n        : searchField === undefined\n          ? undefined\n          : { fields: [searchField] };\n    return narrowSearchDecl(base, (field) => access.fieldVisible(field));\n  }, [def, searchField, access]);\n  const searchContext = useMemo(() => ({ resource, def }), [resource, def]);\n\n  const filter = useMemo<ErasedExpression | undefined>(\n    () => composeListFilter({ fixed, group, search, searchDecl, searchContext }),\n    [fixed, group, search, searchDecl, searchContext],\n  );\n\n  // A read whose composed filter names a field the user may not view is forbidden (an author\n  // predicate, or a function search's output); an undecided access sends nothing yet.\n  const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));\n\n  return useMemo<DialogFilterState>(\n    () => ({\n      searchEnabled: searchDecl !== undefined,\n      blocked,\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      setPage,\n      available,\n      fixed,\n      filter,\n      reset,\n    }),\n    [\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      available,\n      fixed,\n      filter,\n      reset,\n      searchDecl,\n      blocked,\n    ],\n  );\n}\n"],"mappings":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,WAAW,iBAAiB,aAAa;CAE/C,MAAM,MADM,OACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,UAAU,gBAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,iBAAiB,SAAsB,kBAAkB;CACvE,MAAM,CAAC,QAAQ,kBAAkB,SAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,WAAW,SAAS,CAAC;CAKlC,MAAM,WAAW,aAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,YAAY,aAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,QAAQ,kBAAkB;EAC9B,cAAc,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,SAAS,cAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,aAAa,cAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAO,iBALL,aAAa,KAAA,IACT,WACA,gBAAgB,KAAA,IACd,KAAA,IACA,EAAE,QAAQ,CAAC,WAAW,EAAE,IACD,UAAU,OAAO,aAAa,KAAK,CAAC;CACrE,GAAG;EAAC;EAAK;EAAa;CAAM,CAAC;CAC7B,MAAM,gBAAgB,eAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,SAAS,cACP,kBAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAe,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,OAAO,eACE;EACL,eAAe,eAAe,KAAA;EAC9B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}

package/dist/{use-dialog-filter-state-tNvqAAjh.cjs → use-dialog-filter-state-lsTJxrB4.cjs}

@@ -1,4 +1,4 @@
-const require_relation_create = require("./relation-create-DDEYcKfw.cjs");
+const require_relation_create = require("./relation-create-_SFuPQGM.cjs");
 let _burojs_core = require("@burojs/core");
 let _burojs_react = require("@burojs/react");
 let react = require("react");
@@ -90,4 +90,4 @@ Object.defineProperty(exports, "useDialogFilterState", {
 	}
 });
 
-//# sourceMappingURL=use-dialog-filter-state-tNvqAAjh.cjs.map
+//# sourceMappingURL=use-dialog-filter-state-lsTJxrB4.cjs.map

package/dist/{use-dialog-filter-state-tNvqAAjh.cjs.map → use-dialog-filter-state-lsTJxrB4.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"use-dialog-filter-state-tNvqAAjh.cjs","names":["routeResourceKey","useApp","useFilterFields","useState","EMPTY_FILTER_GROUP","useCallback","useListAccess","useMemo","narrowSearchDecl","composeListFilter","namesHiddenField"],"sources":["../src/fields/use-dialog-filter-state.ts"],"sourcesContent":["import {\n  EMPTY_FILTER_GROUP,\n  composeListFilter,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FilterGroup,\n  type FixedFilterInput,\n  type ResolvedFixedFilter,\n  type SearchDecl,\n  routeResourceKey,\n  type ResourceNameOrRef,\n} from '@burojs/core';\nimport { useApp, useFilterFields, useListAccess, type FilterFieldSpec } from '@burojs/react';\nimport { namesHiddenField, narrowSearchDecl } from './search-access.js';\nimport { useCallback, useMemo, useState } from 'react';\n\n/** The portable erased AST — the only shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/** Options for {@link useDialogFilterState}. */\nexport interface UseDialogFilterStateOptions {\n  /** Call-site narrowing (e.g. scope the target list to a product group). */\n  readonly fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * Fallback search field, used ONLY when the target resource declares no\n   * `views.list.search`. Wrapped into a single-field `SearchFieldsDecl`\n   * (`{ fields: [searchField] }`, implicit `contains` — same degenerate form\n   * `searchToFilter` already gives a bare field-name string) so the override\n   * goes through the exact same `composeListFilter` → `searchToFilter` path\n   * as a real declaration, rather than a second hand-built predicate at the\n   * call site. The target's own declaration always wins when present — this\n   * is a fallback, not an override of a declared search.\n   */\n  readonly searchField?: string;\n  /**\n   * Gates the field-derivation walk (`useFilterFields`'s `categorizeField`\n   * pass over every field of the resource). Defaults to `true`. A caller\n   * whose UI isn't visible yet (e.g. `RelationPickerDialog` before it's\n   * opened) should pass `false` to skip that work on every mount /\n   * `fixedFilters`-identity change; the derivation recomputes in full the\n   * next render where this flips back to `true`.\n   */\n  readonly enabled?: boolean;\n}\n\n/** Return shape of {@link useDialogFilterState}. */\nexport interface DialogFilterState {\n  readonly group: FilterGroup;\n  readonly setGroup: (next: FilterGroup) => void;\n  readonly search: string;\n  readonly setSearch: (next: string) => void;\n  readonly page: number;\n  readonly setPage: (page: number) => void;\n  readonly available: readonly FilterFieldSpec[];\n  readonly fixed: readonly ResolvedFixedFilter[];\n  /** The single expression to hand the data provider. */\n  readonly filter: ErasedExpression | undefined;\n  /** Whether the target has a search for this user (no field left means no search box). */\n  readonly searchEnabled: boolean;\n  /** The read must not be sent: undecided access, or a filter naming a field the user may not view. */\n  readonly blocked: boolean;\n  readonly reset: () => void;\n}\n\n/**\n * Local (non-URL) filter state for the relation-picker's advanced-search\n * dialog.\n *\n * `useResourceList` cannot serve this: it unconditionally calls\n * `useResourceUrlState`, which throws without a `RouterAdapterProvider` and,\n * when one IS present, writes to `?<resource>.*`. A picker dialog mounted\n * inside a form for resource A, searching TARGET resource B, would then\n * write B's list state into the URL — clobbering a real B list page open on\n * another tab of the same app, and reading back whatever that page last\n * wrote on open. So this hook keeps `group`/`search`/`page` in plain\n * `useState` and reuses the SAME composition core's list controller uses\n * (`composeListFilter`) so the two never drift on what a filter means.\n *\n * No `pinned` slot: pinned controls are a list-PAGE affordance (permanent\n * screen real estate for a couple of always-visible facets); a modal has no\n * spare real estate to spend on them.\n */\nexport function useDialogFilterState<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\n  const app = useApp();\n  const def = app.registry.get(resource);\n  const { available, fixed } = useFilterFields(resource, {\n    fixedFilters: options.fixedFilters,\n    enabled: options.enabled,\n  });\n\n  const [group, setGroupState] = useState<FilterGroup>(EMPTY_FILTER_GROUP);\n  const [search, setSearchState] = useState('');\n  const [page, setPage] = useState(1);\n\n  // Any change to WHAT is filtered invalidates the current page — the same\n  // rule `useResourceList`'s URL-state controller applies to its own\n  // group/search setters.\n  const setGroup = useCallback((next: FilterGroup) => {\n    setGroupState(next);\n    setPage(1);\n  }, []);\n\n  const setSearch = useCallback((next: string) => {\n    setSearchState(next);\n    setPage(1);\n  }, []);\n\n  const reset = useCallback(() => {\n    setGroupState(EMPTY_FILTER_GROUP);\n    setSearchState('');\n    setPage(1);\n  }, []);\n\n  // The target's own declaration always wins; `options.searchField` only\n  // fills in when the target declares no search at all. Memoized so an\n  // omitted declaration doesn't hand `composeListFilter`'s `filter` memo a\n  // fresh `{ fields: [...] }` literal (and therefore a spurious recompute)\n  // on every render — see `UseDialogFilterStateOptions.searchField`'s doc.\n  const { searchField } = options;\n  const access = useListAccess(resource);\n  const accessReady = access.status === 'ready';\n  const searchDecl = useMemo<SearchDecl | undefined>(() => {\n    const declared = def?.views?.list?.search;\n    const base =\n      declared !== undefined\n        ? declared\n        : searchField === undefined\n          ? undefined\n          : { fields: [searchField] };\n    return narrowSearchDecl(base, (field) => access.fieldVisible(field));\n  }, [def, searchField, access]);\n  const searchContext = useMemo(() => ({ resource, def }), [resource, def]);\n\n  const filter = useMemo<ErasedExpression | undefined>(\n    () => composeListFilter({ fixed, group, search, searchDecl, searchContext }),\n    [fixed, group, search, searchDecl, searchContext],\n  );\n\n  // A read whose composed filter names a field the user may not view is forbidden (an author\n  // predicate, or a function search's output); an undecided access sends nothing yet.\n  const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));\n\n  return useMemo<DialogFilterState>(\n    () => ({\n      searchEnabled: searchDecl !== undefined,\n      blocked,\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      setPage,\n      available,\n      fixed,\n      filter,\n      reset,\n    }),\n    [\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      available,\n      fixed,\n      filter,\n      reset,\n      searchDecl,\n      blocked,\n    ],\n  );\n}\n"],"mappings":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,YAAA,GAAWA,aAAAA,iBAAAA,CAAiB,aAAa;CAE/C,MAAM,OAAA,GADMC,cAAAA,OAAAA,CACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,WAAA,GAAUC,cAAAA,gBAAAA,CAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,kBAAA,GAAiBC,MAAAA,SAAAA,CAAsBC,aAAAA,kBAAkB;CACvE,MAAM,CAAC,QAAQ,mBAAA,GAAkBD,MAAAA,SAAAA,CAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,YAAA,GAAWA,MAAAA,SAAAA,CAAS,CAAC;CAKlC,MAAM,YAAA,GAAWE,MAAAA,YAAAA,EAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,aAAA,GAAYA,MAAAA,YAAAA,EAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,SAAA,GAAQA,MAAAA,YAAAA,OAAkB;EAC9B,cAAcD,aAAAA,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,UAAA,GAASE,cAAAA,cAAAA,CAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,cAAA,GAAaC,MAAAA,QAAAA,OAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAOC,wBAAAA,iBALL,aAAa,KAAA,IACT,WACA,gBAAgB,KAAA,IACd,KAAA,IACA,EAAE,QAAQ,CAAC,WAAW,EAAE,IACD,UAAU,OAAO,aAAa,KAAK,CAAC;CACrE,GAAG;EAAC;EAAK;EAAa;CAAM,CAAC;CAC7B,MAAM,iBAAA,GAAgBD,MAAAA,QAAAA,QAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,UAAA,GAASA,MAAAA,QAAAA,QAAAA,GACPE,aAAAA,kBAAAA,CAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAeC,wBAAAA,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,QAAA,GAAOH,MAAAA,QAAAA,QACE;EACL,eAAe,eAAe,KAAA;EAC9B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}
+{"version":3,"file":"use-dialog-filter-state-lsTJxrB4.cjs","names":["routeResourceKey","useApp","useFilterFields","useState","EMPTY_FILTER_GROUP","useCallback","useListAccess","useMemo","narrowSearchDecl","composeListFilter","namesHiddenField"],"sources":["../src/fields/use-dialog-filter-state.ts"],"sourcesContent":["import {\n  EMPTY_FILTER_GROUP,\n  composeListFilter,\n  type ErasedResourceHandle,\n  type FilterExpression,\n  type FilterGroup,\n  type FixedFilterInput,\n  type ResolvedFixedFilter,\n  type SearchDecl,\n  routeResourceKey,\n  type ResourceNameOrRef,\n} from '@burojs/core';\nimport { useApp, useFilterFields, useListAccess, type FilterFieldSpec } from '@burojs/react';\nimport { namesHiddenField, narrowSearchDecl } from './search-access.js';\nimport { useCallback, useMemo, useState } from 'react';\n\n/** The portable erased AST — the only shape this module deals in. */\ntype ErasedExpression = FilterExpression<ErasedResourceHandle>;\n\n/** Options for {@link useDialogFilterState}. */\nexport interface UseDialogFilterStateOptions {\n  /** Call-site narrowing (e.g. scope the target list to a product group). */\n  readonly fixedFilters?: readonly FixedFilterInput[];\n  /**\n   * Fallback search field, used ONLY when the target resource declares no\n   * `views.list.search`. Wrapped into a single-field `SearchFieldsDecl`\n   * (`{ fields: [searchField] }`, implicit `contains` — same degenerate form\n   * `searchToFilter` already gives a bare field-name string) so the override\n   * goes through the exact same `composeListFilter` → `searchToFilter` path\n   * as a real declaration, rather than a second hand-built predicate at the\n   * call site. The target's own declaration always wins when present — this\n   * is a fallback, not an override of a declared search.\n   */\n  readonly searchField?: string;\n  /**\n   * Gates the field-derivation walk (`useFilterFields`'s `categorizeField`\n   * pass over every field of the resource). Defaults to `true`. A caller\n   * whose UI isn't visible yet (e.g. `RelationPickerDialog` before it's\n   * opened) should pass `false` to skip that work on every mount /\n   * `fixedFilters`-identity change; the derivation recomputes in full the\n   * next render where this flips back to `true`.\n   */\n  readonly enabled?: boolean;\n}\n\n/** Return shape of {@link useDialogFilterState}. */\nexport interface DialogFilterState {\n  readonly group: FilterGroup;\n  readonly setGroup: (next: FilterGroup) => void;\n  readonly search: string;\n  readonly setSearch: (next: string) => void;\n  readonly page: number;\n  readonly setPage: (page: number) => void;\n  readonly available: readonly FilterFieldSpec[];\n  readonly fixed: readonly ResolvedFixedFilter[];\n  /** The single expression to hand the data provider. */\n  readonly filter: ErasedExpression | undefined;\n  /** Whether the target has a search for this user (no field left means no search box). */\n  readonly searchEnabled: boolean;\n  /** The read must not be sent: undecided access, or a filter naming a field the user may not view. */\n  readonly blocked: boolean;\n  readonly reset: () => void;\n}\n\n/**\n * Local (non-URL) filter state for the relation-picker's advanced-search\n * dialog.\n *\n * `useResourceList` cannot serve this: it unconditionally calls\n * `useResourceUrlState`, which throws without a `RouterAdapterProvider` and,\n * when one IS present, writes to `?<resource>.*`. A picker dialog mounted\n * inside a form for resource A, searching TARGET resource B, would then\n * write B's list state into the URL — clobbering a real B list page open on\n * another tab of the same app, and reading back whatever that page last\n * wrote on open. So this hook keeps `group`/`search`/`page` in plain\n * `useState` and reuses the SAME composition core's list controller uses\n * (`composeListFilter`) so the two never drift on what a filter means.\n *\n * No `pinned` slot: pinned controls are a list-PAGE affordance (permanent\n * screen real estate for a couple of always-visible facets); a modal has no\n * spare real estate to spend on them.\n */\nexport function useDialogFilterState<const N extends string = string>(\n  resourceInput: ResourceNameOrRef<N>,\n  options: UseDialogFilterStateOptions,\n): DialogFilterState {\n  const resource = routeResourceKey(resourceInput);\n  const app = useApp();\n  const def = app.registry.get(resource);\n  const { available, fixed } = useFilterFields(resource, {\n    fixedFilters: options.fixedFilters,\n    enabled: options.enabled,\n  });\n\n  const [group, setGroupState] = useState<FilterGroup>(EMPTY_FILTER_GROUP);\n  const [search, setSearchState] = useState('');\n  const [page, setPage] = useState(1);\n\n  // Any change to WHAT is filtered invalidates the current page — the same\n  // rule `useResourceList`'s URL-state controller applies to its own\n  // group/search setters.\n  const setGroup = useCallback((next: FilterGroup) => {\n    setGroupState(next);\n    setPage(1);\n  }, []);\n\n  const setSearch = useCallback((next: string) => {\n    setSearchState(next);\n    setPage(1);\n  }, []);\n\n  const reset = useCallback(() => {\n    setGroupState(EMPTY_FILTER_GROUP);\n    setSearchState('');\n    setPage(1);\n  }, []);\n\n  // The target's own declaration always wins; `options.searchField` only\n  // fills in when the target declares no search at all. Memoized so an\n  // omitted declaration doesn't hand `composeListFilter`'s `filter` memo a\n  // fresh `{ fields: [...] }` literal (and therefore a spurious recompute)\n  // on every render — see `UseDialogFilterStateOptions.searchField`'s doc.\n  const { searchField } = options;\n  const access = useListAccess(resource);\n  const accessReady = access.status === 'ready';\n  const searchDecl = useMemo<SearchDecl | undefined>(() => {\n    const declared = def?.views?.list?.search;\n    const base =\n      declared !== undefined\n        ? declared\n        : searchField === undefined\n          ? undefined\n          : { fields: [searchField] };\n    return narrowSearchDecl(base, (field) => access.fieldVisible(field));\n  }, [def, searchField, access]);\n  const searchContext = useMemo(() => ({ resource, def }), [resource, def]);\n\n  const filter = useMemo<ErasedExpression | undefined>(\n    () => composeListFilter({ fixed, group, search, searchDecl, searchContext }),\n    [fixed, group, search, searchDecl, searchContext],\n  );\n\n  // A read whose composed filter names a field the user may not view is forbidden (an author\n  // predicate, or a function search's output); an undecided access sends nothing yet.\n  const blocked = !accessReady || namesHiddenField(filter, (field) => access.fieldVisible(field));\n\n  return useMemo<DialogFilterState>(\n    () => ({\n      searchEnabled: searchDecl !== undefined,\n      blocked,\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      setPage,\n      available,\n      fixed,\n      filter,\n      reset,\n    }),\n    [\n      group,\n      setGroup,\n      search,\n      setSearch,\n      page,\n      available,\n      fixed,\n      filter,\n      reset,\n      searchDecl,\n      blocked,\n    ],\n  );\n}\n"],"mappings":";;;;;AAkFA,SAAgB,qBACd,eACA,SACmB;CACnB,MAAM,YAAA,GAAWA,aAAAA,iBAAAA,CAAiB,aAAa;CAE/C,MAAM,OAAA,GADMC,cAAAA,OAAAA,CACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,EAAE,WAAW,WAAA,GAAUC,cAAAA,gBAAAA,CAAgB,UAAU;EACrD,cAAc,QAAQ;EACtB,SAAS,QAAQ;CACnB,CAAC;CAED,MAAM,CAAC,OAAO,kBAAA,GAAiBC,MAAAA,SAAAA,CAAsBC,aAAAA,kBAAkB;CACvE,MAAM,CAAC,QAAQ,mBAAA,GAAkBD,MAAAA,SAAAA,CAAS,EAAE;CAC5C,MAAM,CAAC,MAAM,YAAA,GAAWA,MAAAA,SAAAA,CAAS,CAAC;CAKlC,MAAM,YAAA,GAAWE,MAAAA,YAAAA,EAAa,SAAsB;EAClD,cAAc,IAAI;EAClB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,aAAA,GAAYA,MAAAA,YAAAA,EAAa,SAAiB;EAC9C,eAAe,IAAI;EACnB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAEL,MAAM,SAAA,GAAQA,MAAAA,YAAAA,OAAkB;EAC9B,cAAcD,aAAAA,kBAAkB;EAChC,eAAe,EAAE;EACjB,QAAQ,CAAC;CACX,GAAG,CAAC,CAAC;CAOL,MAAM,EAAE,gBAAgB;CACxB,MAAM,UAAA,GAASE,cAAAA,cAAAA,CAAc,QAAQ;CACrC,MAAM,cAAc,OAAO,WAAW;CACtC,MAAM,cAAA,GAAaC,MAAAA,QAAAA,OAAsC;EACvD,MAAM,WAAW,KAAK,OAAO,MAAM;EAOnC,OAAOC,wBAAAA,iBALL,aAAa,KAAA,IACT,WACA,gBAAgB,KAAA,IACd,KAAA,IACA,EAAE,QAAQ,CAAC,WAAW,EAAE,IACD,UAAU,OAAO,aAAa,KAAK,CAAC;CACrE,GAAG;EAAC;EAAK;EAAa;CAAM,CAAC;CAC7B,MAAM,iBAAA,GAAgBD,MAAAA,QAAAA,QAAe;EAAE;EAAU;CAAI,IAAI,CAAC,UAAU,GAAG,CAAC;CAExE,MAAM,UAAA,GAASA,MAAAA,QAAAA,QAAAA,GACPE,aAAAA,kBAAAA,CAAkB;EAAE;EAAO;EAAO;EAAQ;EAAY;CAAc,CAAC,GAC3E;EAAC;EAAO;EAAO;EAAQ;EAAY;CAAa,CAClD;CAIA,MAAM,UAAU,CAAC,eAAeC,wBAAAA,iBAAiB,SAAS,UAAU,OAAO,aAAa,KAAK,CAAC;CAE9F,QAAA,GAAOH,MAAAA,QAAAA,QACE;EACL,eAAe,eAAe,KAAA;EAC9B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,IACA;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CACF;AACF"}

package/dist/{use-record-subtitle-bfwIoUme.cjs → use-record-subtitle-BJ9rnj6F.cjs}

@@ -1,3 +1,4 @@
+const require_relation_create = require("./relation-create-_SFuPQGM.cjs");
 let _burojs_core = require("@burojs/core");
 let _burojs_react = require("@burojs/react");
 let react = require("react");
@@ -29,13 +30,9 @@ function useRowSubtitle(target, override) {
 	const resolve = useRecordSubtitle(target, override);
 	const declares = override !== void 0 || def?.recordSubtitle !== void 0;
 	return (0, react.useCallback)((row) => {
-		if (!declares || access.status !== "ready") return void 0;
-		const declaredId = (def?.data)?.idField;
-		const idField = typeof declaredId === "string" && declaredId !== "" ? declaredId : "id";
-		const visible = {};
-		for (const name of Object.keys(def?.fields ?? {})) if (Object.hasOwn(row, name) && access.fieldVisible(name)) visible[name] = row[name];
-		if (Object.hasOwn(row, idField)) visible[idField] = row[idField];
-		return resolve(visible);
+		if (!declares) return void 0;
+		const visible = require_relation_create.visibleRow(def, access, row);
+		return visible === void 0 ? void 0 : resolve(visible);
 	}, [
 		declares,
 		access,
@@ -67,4 +64,4 @@ Object.defineProperty(exports, "useRowSubtitle", {
 	}
 });
 
-//# sourceMappingURL=use-record-subtitle-bfwIoUme.cjs.map
+//# sourceMappingURL=use-record-subtitle-BJ9rnj6F.cjs.map

package/dist/use-record-subtitle-BJ9rnj6F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-record-subtitle-BJ9rnj6F.cjs","names":["useApp","useI18nCaps","useCallback","resolveEnumLabel","useListAccess","visibleRow"],"sources":["../src/resource/use-record-subtitle.ts"],"sourcesContent":["'use client';\nimport { type RecordTitleContext, resolveEnumLabel } from '@burojs/core';\nimport { useApp, useI18nCaps, useListAccess } from '@burojs/react';\nimport { useCallback } from 'react';\nimport { visibleRow } from './visible-row.js';\n\n/**\n * A record's second line as code declares it (REF-136): the resource's `recordSubtitle`, or a\n * relation field's `optionSubtitle` for that field's options. A string is the line, `null` says\n * there is none, `undefined` (or a blank string) leaves it to the surface.\n */\nexport type RecordSubtitleFn = (\n  record: Readonly<Record<string, unknown>>,\n  ctx?: RecordTitleContext,\n) => string | null | undefined;\n\n/** The first of `fns` that decides: a non-blank string, or `null`; else `undefined`. */\nfunction declaredSubtitle(\n  fns: readonly (RecordSubtitleFn | undefined)[],\n  record: Readonly<Record<string, unknown>>,\n  ctx: RecordTitleContext,\n): string | null | undefined {\n  for (const fn of fns) {\n    const out = fn?.(record, ctx);\n    if (out === null) return null;\n    if (typeof out === 'string' && out.trim() !== '') return out;\n  }\n  return undefined;\n}\n\n/**\n * The declared subtitle of one of `resource`'s records: `override` first, then the resource's\n * `recordSubtitle`. Hand it a record as its viewer may read it (projected in record reach); a row of\n * a list goes through {@link useRowSubtitle}. Like `recordTitle`, the hooks are called with an i18n\n * context bound to the resource, so an enum label in the line follows the active locale.\n */\nexport function useRecordSubtitle(\n  resource: string,\n  override?: RecordSubtitleFn,\n): (record: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const caps = useI18nCaps(resource);\n  const own: RecordSubtitleFn | undefined = app.registry.get(resource)?.recordSubtitle;\n  return useCallback(\n    (record) => {\n      if (override === undefined && own === undefined) return undefined;\n      return declaredSubtitle([override, own], record, {\n        resolveEnum: (namespace, value, inlineDefault) =>\n          resolveEnumLabel(caps, namespace, value, inlineDefault),\n      });\n    },\n    [override, own, caps],\n  );\n}\n\n/**\n * The declared subtitle of a row a list surface shows (picker options, palette results): the hooks\n * see only the row's declared fields its user may view in any-record reach, and its id (P5 spec\n * 3.6, as a list title reads only a visible display field). Undecided access declares nothing.\n */\nexport function useRowSubtitle(\n  target: string,\n  override?: RecordSubtitleFn,\n): (row: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const access = useListAccess(target);\n  const def = app.registry.get(target);\n  const resolve = useRecordSubtitle(target, override);\n  const declares = override !== undefined || def?.recordSubtitle !== undefined;\n  return useCallback(\n    (row) => {\n      if (!declares) return undefined;\n      const visible = visibleRow(def, access, row);\n      return visible === undefined ? undefined : resolve(visible);\n    },\n    [declares, access, def, resolve],\n  );\n}\n\n/**\n * A picker option's second line: the declared subtitle, else the option's `#<id>` — not drawn when\n * the label already is the id, which would print it twice (REF-40). `null`: none.\n */\nexport function optionSubtitle(\n  declared: string | null | undefined,\n  label: string,\n  id: string,\n): string | null {\n  if (declared !== undefined) return declared;\n  return label === id ? null : `#${id}`;\n}\n"],"mappings":";;;;;AAiBA,SAAS,iBACP,KACA,QACA,KAC2B;CAC3B,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,MAAM,KAAK,QAAQ,GAAG;EAC5B,IAAI,QAAQ,MAAM,OAAO;EACzB,IAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,MAAM,IAAI,OAAO;CAC3D;AAEF;AAQA,SAAgB,kBACd,UACA,UAC0E;CAC1E,MAAM,OAAA,GAAMA,cAAAA,OAAAA,CAAO;CACnB,MAAM,QAAA,GAAOC,cAAAA,YAAAA,CAAY,QAAQ;CACjC,MAAM,MAAoC,IAAI,SAAS,IAAI,QAAQ,CAAC,EAAE;CACtE,QAAA,GAAOC,MAAAA,YAAAA,EACJ,WAAW;EACV,IAAI,aAAa,KAAA,KAAa,QAAQ,KAAA,GAAW,OAAO,KAAA;EACxD,OAAO,iBAAiB,CAAC,UAAU,GAAG,GAAG,QAAQ,EAC/C,cAAc,WAAW,OAAO,mBAAA,GAC9BC,aAAAA,iBAAAA,CAAiB,MAAM,WAAW,OAAO,aAAa,EAC1D,CAAC;CACH,GACA;EAAC;EAAU;EAAK;CAAI,CACtB;AACF;AAOA,SAAgB,eACd,QACA,UACuE;CACvE,MAAM,OAAA,GAAMH,cAAAA,OAAAA,CAAO;CACnB,MAAM,UAAA,GAASI,cAAAA,cAAAA,CAAc,MAAM;CACnC,MAAM,MAAM,IAAI,SAAS,IAAI,MAAM;CACnC,MAAM,UAAU,kBAAkB,QAAQ,QAAQ;CAClD,MAAM,WAAW,aAAa,KAAA,KAAa,KAAK,mBAAmB,KAAA;CACnE,QAAA,GAAOF,MAAAA,YAAAA,EACJ,QAAQ;EACP,IAAI,CAAC,UAAU,OAAO,KAAA;EACtB,MAAM,UAAUG,wBAAAA,WAAW,KAAK,QAAQ,GAAG;EAC3C,OAAO,YAAY,KAAA,IAAY,KAAA,IAAY,QAAQ,OAAO;CAC5D,GACA;EAAC;EAAU;EAAQ;EAAK;CAAO,CACjC;AACF;AAMA,SAAgB,eACd,UACA,OACA,IACe;CACf,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO,UAAU,KAAK,OAAO,IAAI;AACnC"}

package/dist/{use-record-subtitle-gIaCGgbI.js → use-record-subtitle-w3ZhXNlf.js}

@@ -1,3 +1,4 @@
+import { h as visibleRow } from "./relation-create-6WicROWA.js";
 import { resolveEnumLabel } from "@burojs/core";
 import { useApp, useI18nCaps, useListAccess } from "@burojs/react";
 import { useCallback } from "react";
@@ -29,13 +30,9 @@ function useRowSubtitle(target, override) {
 	const resolve = useRecordSubtitle(target, override);
 	const declares = override !== void 0 || def?.recordSubtitle !== void 0;
 	return useCallback((row) => {
-		if (!declares || access.status !== "ready") return void 0;
-		const declaredId = (def?.data)?.idField;
-		const idField = typeof declaredId === "string" && declaredId !== "" ? declaredId : "id";
-		const visible = {};
-		for (const name of Object.keys(def?.fields ?? {})) if (Object.hasOwn(row, name) && access.fieldVisible(name)) visible[name] = row[name];
-		if (Object.hasOwn(row, idField)) visible[idField] = row[idField];
-		return resolve(visible);
+		if (!declares) return void 0;
+		const visible = visibleRow(def, access, row);
+		return visible === void 0 ? void 0 : resolve(visible);
 	}, [
 		declares,
 		access,
@@ -50,4 +47,4 @@ function optionSubtitle(declared, label, id) {
 //#endregion
 export { useRecordSubtitle as n, useRowSubtitle as r, optionSubtitle as t };
 
-//# sourceMappingURL=use-record-subtitle-gIaCGgbI.js.map
+//# sourceMappingURL=use-record-subtitle-w3ZhXNlf.js.map

package/dist/use-record-subtitle-w3ZhXNlf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-record-subtitle-w3ZhXNlf.js","names":[],"sources":["../src/resource/use-record-subtitle.ts"],"sourcesContent":["'use client';\nimport { type RecordTitleContext, resolveEnumLabel } from '@burojs/core';\nimport { useApp, useI18nCaps, useListAccess } from '@burojs/react';\nimport { useCallback } from 'react';\nimport { visibleRow } from './visible-row.js';\n\n/**\n * A record's second line as code declares it (REF-136): the resource's `recordSubtitle`, or a\n * relation field's `optionSubtitle` for that field's options. A string is the line, `null` says\n * there is none, `undefined` (or a blank string) leaves it to the surface.\n */\nexport type RecordSubtitleFn = (\n  record: Readonly<Record<string, unknown>>,\n  ctx?: RecordTitleContext,\n) => string | null | undefined;\n\n/** The first of `fns` that decides: a non-blank string, or `null`; else `undefined`. */\nfunction declaredSubtitle(\n  fns: readonly (RecordSubtitleFn | undefined)[],\n  record: Readonly<Record<string, unknown>>,\n  ctx: RecordTitleContext,\n): string | null | undefined {\n  for (const fn of fns) {\n    const out = fn?.(record, ctx);\n    if (out === null) return null;\n    if (typeof out === 'string' && out.trim() !== '') return out;\n  }\n  return undefined;\n}\n\n/**\n * The declared subtitle of one of `resource`'s records: `override` first, then the resource's\n * `recordSubtitle`. Hand it a record as its viewer may read it (projected in record reach); a row of\n * a list goes through {@link useRowSubtitle}. Like `recordTitle`, the hooks are called with an i18n\n * context bound to the resource, so an enum label in the line follows the active locale.\n */\nexport function useRecordSubtitle(\n  resource: string,\n  override?: RecordSubtitleFn,\n): (record: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const caps = useI18nCaps(resource);\n  const own: RecordSubtitleFn | undefined = app.registry.get(resource)?.recordSubtitle;\n  return useCallback(\n    (record) => {\n      if (override === undefined && own === undefined) return undefined;\n      return declaredSubtitle([override, own], record, {\n        resolveEnum: (namespace, value, inlineDefault) =>\n          resolveEnumLabel(caps, namespace, value, inlineDefault),\n      });\n    },\n    [override, own, caps],\n  );\n}\n\n/**\n * The declared subtitle of a row a list surface shows (picker options, palette results): the hooks\n * see only the row's declared fields its user may view in any-record reach, and its id (P5 spec\n * 3.6, as a list title reads only a visible display field). Undecided access declares nothing.\n */\nexport function useRowSubtitle(\n  target: string,\n  override?: RecordSubtitleFn,\n): (row: Readonly<Record<string, unknown>>) => string | null | undefined {\n  const app = useApp();\n  const access = useListAccess(target);\n  const def = app.registry.get(target);\n  const resolve = useRecordSubtitle(target, override);\n  const declares = override !== undefined || def?.recordSubtitle !== undefined;\n  return useCallback(\n    (row) => {\n      if (!declares) return undefined;\n      const visible = visibleRow(def, access, row);\n      return visible === undefined ? undefined : resolve(visible);\n    },\n    [declares, access, def, resolve],\n  );\n}\n\n/**\n * A picker option's second line: the declared subtitle, else the option's `#<id>` — not drawn when\n * the label already is the id, which would print it twice (REF-40). `null`: none.\n */\nexport function optionSubtitle(\n  declared: string | null | undefined,\n  label: string,\n  id: string,\n): string | null {\n  if (declared !== undefined) return declared;\n  return label === id ? null : `#${id}`;\n}\n"],"mappings":";;;;;AAiBA,SAAS,iBACP,KACA,QACA,KAC2B;CAC3B,KAAK,MAAM,MAAM,KAAK;EACpB,MAAM,MAAM,KAAK,QAAQ,GAAG;EAC5B,IAAI,QAAQ,MAAM,OAAO;EACzB,IAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,MAAM,IAAI,OAAO;CAC3D;AAEF;AAQA,SAAgB,kBACd,UACA,UAC0E;CAC1E,MAAM,MAAM,OAAO;CACnB,MAAM,OAAO,YAAY,QAAQ;CACjC,MAAM,MAAoC,IAAI,SAAS,IAAI,QAAQ,CAAC,EAAE;CACtE,OAAO,aACJ,WAAW;EACV,IAAI,aAAa,KAAA,KAAa,QAAQ,KAAA,GAAW,OAAO,KAAA;EACxD,OAAO,iBAAiB,CAAC,UAAU,GAAG,GAAG,QAAQ,EAC/C,cAAc,WAAW,OAAO,kBAC9B,iBAAiB,MAAM,WAAW,OAAO,aAAa,EAC1D,CAAC;CACH,GACA;EAAC;EAAU;EAAK;CAAI,CACtB;AACF;AAOA,SAAgB,eACd,QACA,UACuE;CACvE,MAAM,MAAM,OAAO;CACnB,MAAM,SAAS,cAAc,MAAM;CACnC,MAAM,MAAM,IAAI,SAAS,IAAI,MAAM;CACnC,MAAM,UAAU,kBAAkB,QAAQ,QAAQ;CAClD,MAAM,WAAW,aAAa,KAAA,KAAa,KAAK,mBAAmB,KAAA;CACnE,OAAO,aACJ,QAAQ;EACP,IAAI,CAAC,UAAU,OAAO,KAAA;EACtB,MAAM,UAAU,WAAW,KAAK,QAAQ,GAAG;EAC3C,OAAO,YAAY,KAAA,IAAY,KAAA,IAAY,QAAQ,OAAO;CAC5D,GACA;EAAC;EAAU;EAAQ;EAAK;CAAO,CACjC;AACF;AAMA,SAAgB,eACd,UACA,OACA,IACe;CACf,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO,UAAU,KAAK,OAAO,IAAI;AACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burojs/ui-shadcn",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "license": "MIT",
   "description": "Buro: default shadcn+Tailwind UI kit with required testid attributes",
   "type": "module",
@@ -120,11 +120,11 @@
     "tw-animate-css": "^1.4.0",
     "unist-util-visit": "^5",
     "zod": "^3.24.0",
-    "@burojs/core": "0.8.0",
-    "@burojs/field-types": "0.8.0",
-    "@burojs/file-storage": "0.8.0",
-    "@burojs/i18n-core": "0.8.0",
-    "@burojs/react": "0.8.0"
+    "@burojs/core": "0.9.0",
+    "@burojs/field-types": "0.9.0",
+    "@burojs/file-storage": "0.9.0",
+    "@burojs/i18n-core": "0.9.0",
+    "@burojs/react": "0.9.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -147,9 +147,9 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.5.0",
     "vitest": "^4.0.0",
-    "@burojs/context": "0.8.0",
-    "@burojs/export": "0.8.0",
-    "@burojs/testing": "0.8.0",
+    "@burojs/context": "0.9.0",
+    "@burojs/export": "0.9.0",
+    "@burojs/testing": "0.9.0",
     "@burojs/tooling-eslint": "0.0.0",
     "@burojs/tooling-globals": "0.0.0",
     "@burojs/tooling-tsconfig": "0.0.0"