@burojs/ui-shadcn 0.4.0 → 0.6.0

package/dist/related-rows-ea43qhhy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-rows-ea43qhhy.cjs","names":["useApp","useI18nCaps","peekLeafAllowed","peekFieldDefinition","ResolvedFieldDisplay","toDisplayText","recordDisplayName","Fragment","resolveFieldLabel","declaredText","useApp","useCtx","useCallback","ruleContextFor","resolveCapability","useFieldAccess","useViewRow","peekRow","peekLeafAllowed","RECORD_PROBE","useMemo","useItemDrawn","recordDisplayName","RelatedItem","useLinkComponent","ClaimedQuickLink","QUICK_ANCHOR_ATTRIBUTE","isPlainLeftClick"],"sources":["../src/blocks/default-item.tsx","../src/blocks/related-rows.tsx"],"sourcesContent":["'use client';\nimport { type EntityRef, resolveFieldLabel, declaredText } from '@burojs/core';\nimport { useApp, useI18nCaps } from '@burojs/react';\nimport { Fragment, type ReactElement } from 'react';\nimport { toDisplayText } from '../fields/display-value.js';\nimport { ResolvedFieldDisplay } from '../fields/resolved-field.js';\nimport {\n  type PeekFieldSource,\n  peekFieldDefinition,\n  peekLeafAllowed,\n} from '../quick/peek-filter.js';\nimport { recordDisplayName } from '../resource/record-display-name.js';\nimport { type ListRow, useRowAccess, useViewVisible } from './related-rows.js';\n\n/** What a default item reads of the target's definition. */\ninterface TargetDefinition extends PeekFieldSource {\n  readonly views?: { readonly list?: { readonly columns?: readonly string[] } };\n  readonly ref?: EntityRef;\n}\n\n/** A field the default item puts in its trailing part: a number reads best right-aligned. */\nconst isNumeric = (field: { readonly kind?: unknown } | undefined) => field?.kind === 'number';\n\n/**\n * The item of a related list that names none (P6 3.13). As a card: the row's title (weight 500),\n * its other fields as muted label / value pairs, and its numbers in a trailing part set off by a\n * rule. As a timeline entry (`variant: 'entry'`): the title and the field values on one muted\n * meta line. `row` is the projected row, so a field the viewer may not see is already `null` and\n * is not listed.\n */\nexport function DefaultItem({\n  resource,\n  row,\n  raw,\n  columns,\n  variant = 'card',\n}: {\n  readonly resource: string;\n  readonly row: Readonly<Record<string, unknown>>;\n  /** The row as the list read it: column rules resolve over it. */\n  readonly raw: ListRow;\n  readonly columns?: readonly string[] | undefined;\n  readonly variant?: 'card' | 'entry';\n}): ReactElement {\n  const app = useApp();\n  const def = app.registry.get(resource) as TargetDefinition | undefined;\n  const caps = useI18nCaps(resource);\n  const access = useRowAccess(resource)(raw);\n  const viewVisible = useViewVisible(resource);\n  const fields =\n    def === undefined\n      ? []\n      : (columns ?? def.views?.list?.columns ?? Object.keys(def.fields)).filter(\n          (name, index, names) =>\n            name !== def.displayField &&\n            names.indexOf(name) === index &&\n            peekLeafAllowed(def, name, access, viewVisible),\n        );\n  const ref = def?.ref ?? { namespace: 'default', id: resource };\n  const definition = (name: string) =>\n    peekFieldDefinition(def!, name) as { readonly label?: string; readonly kind?: unknown };\n  const value = (name: string) => (\n    <ResolvedFieldDisplay\n      resource={ref}\n      name={name}\n      field={definition(name) as never}\n      value={row[name]}\n      record={row}\n      fallback={toDisplayText(row[name]).text}\n    />\n  );\n  const title = (\n    <p className=\"truncate text-sm font-medium\">{recordDisplayName(row, def?.displayField)}</p>\n  );\n  if (variant === 'entry') {\n    const shown = fields.filter((name) => row[name] != null && row[name] !== '');\n    return (\n      <div className=\"flex min-w-0 flex-col gap-0.5\" data-buro-default-item=\"\">\n        {title}\n        {shown.length === 0 ? null : (\n          <div data-buro-item-meta=\"\" className=\"truncate text-xs text-muted-foreground\">\n            {shown.map((name, index) => (\n              <Fragment key={name}>\n                {index > 0 ? ' · ' : null}\n                {value(name)}\n              </Fragment>\n            ))}\n          </div>\n        )}\n      </div>\n    );\n  }\n  const numbers = fields.filter((name) => isNumeric(definition(name)));\n  const pairs = fields.filter((name) => !isNumeric(definition(name)));\n  return (\n    <div className=\"flex min-w-0 items-start gap-3\" data-buro-default-item=\"\">\n      <div className=\"flex min-w-0 flex-1 flex-col gap-2\">\n        {title}\n        {pairs.length === 0 ? null : (\n          <dl className=\"grid gap-1.5\">\n            {pairs.map((name) => (\n              <div key={name} className=\"flex min-w-0 items-baseline gap-2 text-sm\">\n                <dt className=\"w-24 shrink-0 truncate text-xs text-muted-foreground\">\n                  {resolveFieldLabel(caps, name, declaredText('field', definition(name), 'label'))}\n                </dt>\n                <dd className=\"min-w-0 break-words\">{value(name)}</dd>\n              </div>\n            ))}\n          </dl>\n        )}\n      </div>\n      {numbers.length === 0 ? null : (\n        <div\n          data-buro-item-trailing=\"\"\n          className=\"flex shrink-0 flex-col items-end gap-1 border-l pl-3 text-sm tabular-nums\"\n        >\n          {numbers.map((name) => (\n            <span\n              key={name}\n              title={resolveFieldLabel(\n                caps,\n                name,\n                declaredText('field', definition(name), 'label'),\n              )}\n            >\n              {value(name)}\n            </span>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\nimport { type AppContext, RECORD_PROBE, resolveCapability, ruleContextFor } from '@burojs/core';\nimport { type CapabilityResolver, useApp, useCtx, useFieldAccess, useViewRow } from '@burojs/react';\nimport { type ReactElement, type ReactNode, useCallback, useMemo } from 'react';\nimport { QUICK_ANCHOR_ATTRIBUTE } from '@burojs/react';\nimport { ClaimedQuickLink, isPlainLeftClick } from '../fields/claimed-quick-link.js';\nimport { useLinkComponent } from '../layout/link-component.js';\nimport { type PeekFieldSource, peekLeafAllowed, peekRow } from '../quick/peek-filter.js';\nimport { recordDisplayName } from '../resource/record-display-name.js';\nimport { DefaultItem } from './default-item.js';\nimport { type ItemHandle, RelatedItem, useItemDrawn } from './related-item.js';\n\nexport type ListRow = { readonly id: string } & Readonly<Record<string, unknown>>;\n\n/** What `related-list` hands a rows view: the list's rows and how a row opens. */\nexport interface RelatedRowsProps {\n  /** The target resource. */\n  readonly resource: string;\n  /** The placement's key (test ids). */\n  readonly placementKey: string;\n  readonly rows: readonly ListRow[];\n  readonly item?: ItemHandle | undefined;\n  /** The placement's `columns`, for the default item. */\n  readonly columns?: readonly string[] | undefined;\n  readonly rowQuick?: ((row: ListRow) => (() => void) | null) | undefined;\n  readonly rowHref?: ((row: ListRow) => string | undefined) | undefined;\n}\n\n/**\n * A capability resolver per row: column rules resolve over the row they hide a field of, as the\n * peek's do (P6-B review), so a rule reading the record sees this row.\n */\nexport function useRowAccess(resource: string): (row: ListRow) => CapabilityResolver {\n  const app = useApp();\n  const scope = useCtx((c: AppContext) => c.scope);\n  const user = useCtx((c: AppContext) => c.user);\n  const permissions = useCtx((c: AppContext) => c.permissions);\n  return useCallback(\n    (row) =>\n      (capability, target, defaultAllowed = true) => {\n        const rules = app.ruleSource.rules(resource);\n        if (rules.length === 0) return { allowed: defaultAllowed };\n        const ctx = ruleContextFor({\n          user,\n          scope,\n          permissions,\n          record: row,\n          mode: 'show',\n          resource,\n        });\n        return resolveCapability(rules, capability, target, ctx, defaultAllowed);\n      },\n    [app.ruleSource, resource, scope, user, permissions],\n  );\n}\n\n/**\n * Whether a field may be drawn on every row by its P5 view (P5 spec 3.6.6): a decision that is\n * not `visible` (`hidden`, `restricted`, `failed` and `pending` alike, so nothing is drawn while\n * the permission map loads) withholds it. A field the map does not decide is not withheld here. The decision\n * is the any-record one ({@link RECORD_PROBE}), so a rule reading the record counts as hiding.\n */\nexport function useViewVisible(resource: string): (field: string) => boolean {\n  const access = useFieldAccess(resource, 'every');\n  return useCallback(\n    (field) => {\n      const decision = access[field];\n      return decision === undefined || decision.view === 'visible';\n    },\n    [access],\n  );\n}\n\ninterface ProjectedRows {\n  readonly def:\n    | (PeekFieldSource & { readonly displayField?: string; readonly data?: unknown })\n    | undefined;\n  /** The row a card or an entry sees: the id and what the viewer may see; the rest read `null`. */\n  readonly project: (row: ListRow) => ListRow;\n  /** Whether the item block is drawn (decided once for the list), else the default item. */\n  readonly drawn: boolean;\n  readonly title: (row: ListRow) => string;\n}\n\n/**\n * The rows of a cards or timeline view, projected once and the item decided once per list.\n *\n * The rows arrive as the list read them (policy). A row is first projected by P5's field view\n * (`viewRow`: a field its user may not view for every row is left out) and then by the peek's\n * rule ({@link peekRow}): the id field and every field that is not `sensitive`, not withheld by\n * a field `requires.view` and not hidden by a `column` rule keep their values; every other\n * field reads `null`. It is the one place a row's fields are filtered before an item block or\n * the default item sees them (P6-66), and the timeline's axis reads the same row.\n */\nexport function useProjectedRows(\n  resource: string,\n  rows: readonly ListRow[],\n  item: ItemHandle | undefined,\n): ProjectedRows {\n  const app = useApp();\n  const def = app.registry.get(resource) as ProjectedRows['def'];\n  const accessOf = useRowAccess(resource);\n  const viewRow = useViewRow(resource);\n  const viewVisible = useViewVisible(resource);\n  const idField = (def?.data as { readonly idField?: string } | undefined)?.idField ?? 'id';\n  const project = useCallback(\n    (row: ListRow): ListRow =>\n      (def === undefined\n        ? viewRow(row)\n        : peekRow(def, viewRow(row), idField, accessOf(row), viewVisible)) as ListRow,\n    [def, idField, accessOf, viewRow, viewVisible],\n  );\n  const hidden = useCallback(\n    (field: string) =>\n      field !== idField &&\n      (def === undefined ||\n        !peekLeafAllowed(def, field, accessOf(RECORD_PROBE as ListRow), viewVisible)),\n    [def, idField, accessOf, viewVisible],\n  );\n  const probe = useMemo(\n    () => (rows[0] === undefined ? undefined : project(rows[0])),\n    [rows, project],\n  );\n  const drawn = useItemDrawn(item, hidden, probe);\n  const title = useCallback(\n    (row: ListRow) => recordDisplayName(project(row), def?.displayField),\n    [project, def],\n  );\n  return { def, project, drawn, title };\n}\n\n/** The item block (or the default item) of one row. */\nexport function RowContent({\n  resource,\n  raw,\n  row,\n  item,\n  drawn,\n  columns,\n  variant,\n}: {\n  readonly resource: string;\n  /** The row as the list read it (column rules resolve over it). */\n  readonly raw: ListRow;\n  /** The projected row. */\n  readonly row: ListRow;\n  readonly item: ItemHandle | undefined;\n  readonly drawn: boolean;\n  readonly columns?: readonly string[] | undefined;\n  /** How the default item lays the row out: a card's, or a timeline entry's. */\n  readonly variant?: 'card' | 'entry';\n}): ReactElement {\n  const fallback = (\n    <DefaultItem\n      resource={resource}\n      row={row}\n      raw={raw}\n      columns={columns}\n      {...(variant === undefined ? {} : { variant })}\n    />\n  );\n  if (item === undefined || !drawn) return fallback;\n  return <RelatedItem handle={item} row={row} fallback={fallback} />;\n}\n\n/**\n * A card's or an entry's one opener (P6-74): the row's title as the accessible name of a single\n * anchor whose `::after` covers the positioned parent. A quick row is the page anchor claimed\n * for the opener (a modified click follows the `href`), or a link-role button without a page.\n * `open: 'none'` draws nothing.\n */\nexport function RowOpener({\n  title,\n  href,\n  quick,\n}: {\n  readonly title: string;\n  readonly href: string | undefined;\n  readonly quick: (() => void) | null;\n}): ReactElement | null {\n  const RouterLink = useLinkComponent();\n  const className =\n    'outline-none after:absolute after:inset-0 after:rounded-[inherit] focus-visible:after:ring-2 focus-visible:after:ring-ring';\n  const name: ReactNode = <span className=\"sr-only\">{title}</span>;\n  if (quick !== null)\n    return href ? (\n      <ClaimedQuickLink href={href} className={className} onOpen={quick}>\n        {name}\n      </ClaimedQuickLink>\n    ) : (\n      <button\n        type=\"button\"\n        role=\"link\"\n        {...{ [QUICK_ANCHOR_ATTRIBUTE]: '' }}\n        // A button is inline-block, so even with only an `sr-only` name it took a line of the\n        // card and pushed the content down (REF-40). Zero-size and unpositioned, its `::after`\n        // still covers the card.\n        className={`${className} block size-0 p-0`}\n        onClick={(event) => {\n          if (!isPlainLeftClick(event)) return;\n          quick();\n        }}\n      >\n        {name}\n      </button>\n    );\n  if (href)\n    return (\n      <RouterLink href={href} className={className}>\n        {name}\n      </RouterLink>\n    );\n  return null;\n}\n\n/**\n * The wrapper that raises an item's interactive descendants above the opener's cover (P6-74):\n * the wrapper itself lets clicks through to the opener, its controls take them.\n */\nexport const ITEM_LAYER_CLASS =\n  'relative z-[1] pointer-events-none [&_a]:pointer-events-auto [&_button]:pointer-events-auto [&_input]:pointer-events-auto [&_select]:pointer-events-auto [&_textarea]:pointer-events-auto [&_summary]:pointer-events-auto [&_[role=button]]:pointer-events-auto [&_[role=link]]:pointer-events-auto [&_[role=checkbox]]:pointer-events-auto [&_[role=switch]]:pointer-events-auto';\n"],"mappings":";;;;;;;;AAqBA,MAAM,aAAa,UAAmD,OAAO,SAAS;AAStF,SAAgB,YAAY,EAC1B,UACA,KACA,KACA,SACA,UAAU,UAQK;CAEf,MAAM,OAAA,GADMA,cAAAA,OAAAA,CACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,QAAA,GAAOC,cAAAA,YAAAA,CAAY,QAAQ;CACjC,MAAM,SAAS,aAAa,QAAQ,CAAC,CAAC,GAAG;CACzC,MAAM,cAAc,eAAe,QAAQ;CAC3C,MAAM,SACJ,QAAQ,KAAA,IACJ,CAAC,KACA,WAAW,IAAI,OAAO,MAAM,WAAW,OAAO,KAAK,IAAI,MAAM,EAAA,CAAG,QAC9D,MAAM,OAAO,UACZ,SAAS,IAAI,gBACb,MAAM,QAAQ,IAAI,MAAM,SACxBC,mBAAAA,gBAAgB,KAAK,MAAM,QAAQ,WAAW,CAClD;CACN,MAAM,MAAM,KAAK,OAAO;EAAE,WAAW;EAAW,IAAI;CAAS;CAC7D,MAAM,cAAc,SAClBC,mBAAAA,oBAAoB,KAAM,IAAI;CAChC,MAAM,SAAS,UACb,GAAA,kBAAA,IAAA,CAACC,mBAAAA,sBAAD;EACE,UAAU;EACJ;EACN,OAAO,WAAW,IAAI;EACtB,OAAO,IAAI;EACX,QAAQ;EACR,UAAUC,mBAAAA,cAAc,IAAI,KAAK,CAAC,CAAC;CACpC,CAAA;CAEH,MAAM,SACJ,GAAA,kBAAA,IAAA,CAAC,KAAD;EAAG,WAAU;EAAgCC,UAAAA,sBAAAA,kBAAkB,KAAK,KAAK,YAAY;CAAK,CAAA;CAE5F,IAAI,YAAY,SAAS;EACvB,MAAM,QAAQ,OAAO,QAAQ,SAAS,IAAI,SAAS,QAAQ,IAAI,UAAU,EAAE;EAC3E,QACE,GAAA,kBAAA,KAAA,CAAC,OAAD;GAAK,WAAU;GAAgC,0BAAuB;GAAtE,UAAA,CACG,OACA,MAAM,WAAW,IAAI,QACpB,GAAA,kBAAA,IAAA,CAAC,OAAD;IAAK,uBAAoB;IAAG,WAAU;IACnC,UAAA,MAAM,KAAK,MAAM,WAChB,GAAA,kBAAA,KAAA,CAACC,MAAAA,UAAD,EAAA,UAAA,CACG,QAAQ,IAAI,QAAQ,MACpB,MAAM,IAAI,CACH,EAAA,GAHK,IAGL,CACX;GACE,CAAA,CAEJ;;CAET;CACA,MAAM,UAAU,OAAO,QAAQ,SAAS,UAAU,WAAW,IAAI,CAAC,CAAC;CACnE,MAAM,QAAQ,OAAO,QAAQ,SAAS,CAAC,UAAU,WAAW,IAAI,CAAC,CAAC;CAClE,QACE,GAAA,kBAAA,KAAA,CAAC,OAAD;EAAK,WAAU;EAAiC,0BAAuB;EAAvE,UAAA,EACE,GAAA,kBAAA,KAAA,CAAC,OAAD;GAAK,WAAU;GAAf,UAAA,CACG,OACA,MAAM,WAAW,IAAI,QACpB,GAAA,kBAAA,IAAA,CAAC,MAAD;IAAI,WAAU;IACX,UAAA,MAAM,KAAK,UACV,GAAA,kBAAA,KAAA,CAAC,OAAD;KAAgB,WAAU;KAA1B,UAAA,EACE,GAAA,kBAAA,IAAA,CAAC,MAAD;MAAI,WAAU;MACXC,WAAAA,GAAAA,aAAAA,kBAAAA,CAAkB,MAAM,OAAA,GAAMC,aAAAA,aAAAA,CAAa,SAAS,WAAW,IAAI,GAAG,OAAO,CAAC;KAC7E,CAAA,IACJ,GAAA,kBAAA,IAAA,CAAC,MAAD;MAAI,WAAU;MAAuB,UAAA,MAAM,IAAI;KAAM,CAAA,CAClD;IALK,GAAA,IAKL,CACN;GACC,CAAA,CAEH;EACJ,CAAA,GAAA,QAAQ,WAAW,IAAI,QACtB,GAAA,kBAAA,IAAA,CAAC,OAAD;GACE,2BAAwB;GACxB,WAAU;GAET,UAAA,QAAQ,KAAK,UACZ,GAAA,kBAAA,IAAA,CAAC,QAAD;IAEE,QAAA,GAAOD,aAAAA,kBAAAA,CACL,MACA,OAAA,GACAC,aAAAA,aAAAA,CAAa,SAAS,WAAW,IAAI,GAAG,OAAO,CACjD;IAEC,UAAA,MAAM,IAAI;GACP,GARC,IAQD,CACP;EACE,CAAA,CAEJ;;AAET;;;ACpGA,SAAgB,aAAa,UAAwD;CACnF,MAAM,OAAA,GAAMC,cAAAA,OAAAA,CAAO;CACnB,MAAM,SAAA,GAAQC,cAAAA,OAAAA,EAAQ,MAAkB,EAAE,KAAK;CAC/C,MAAM,QAAA,GAAOA,cAAAA,OAAAA,EAAQ,MAAkB,EAAE,IAAI;CAC7C,MAAM,eAAA,GAAcA,cAAAA,OAAAA,EAAQ,MAAkB,EAAE,WAAW;CAC3D,QAAA,GAAOC,MAAAA,YAAAA,EACJ,SACE,YAAY,QAAQ,iBAAiB,SAAS;EAC7C,MAAM,QAAQ,IAAI,WAAW,MAAM,QAAQ;EAC3C,IAAI,MAAM,WAAW,GAAG,OAAO,EAAE,SAAS,eAAe;EACzD,MAAM,OAAA,GAAMC,aAAAA,eAAAA,CAAe;GACzB;GACA;GACA;GACA,QAAQ;GACR,MAAM;GACN;EACF,CAAC;EACD,QAAA,GAAOC,aAAAA,kBAAAA,CAAkB,OAAO,YAAY,QAAQ,KAAK,cAAc;CACzE,GACF;EAAC,IAAI;EAAY;EAAU;EAAO;EAAM;CAAW,CACrD;AACF;AAQA,SAAgB,eAAe,UAA8C;CAC3E,MAAM,UAAA,GAASC,cAAAA,eAAAA,CAAe,UAAU,OAAO;CAC/C,QAAA,GAAOH,MAAAA,YAAAA,EACJ,UAAU;EACT,MAAM,WAAW,OAAO;EACxB,OAAO,aAAa,KAAA,KAAa,SAAS,SAAS;CACrD,GACA,CAAC,MAAM,CACT;AACF;AAuBA,SAAgB,iBACd,UACA,MACA,MACe;CAEf,MAAM,OAAA,GADMF,cAAAA,OAAAA,CACE,CAAC,CAAC,SAAS,IAAI,QAAQ;CACrC,MAAM,WAAW,aAAa,QAAQ;CACtC,MAAM,WAAA,GAAUM,cAAAA,WAAAA,CAAW,QAAQ;CACnC,MAAM,cAAc,eAAe,QAAQ;CAC3C,MAAM,WAAW,KAAK,KAAA,EAAoD,WAAW;CACrF,MAAM,WAAA,GAAUJ,MAAAA,YAAAA,EACb,QACE,QAAQ,KAAA,IACL,QAAQ,GAAG,IACXK,mBAAAA,QAAQ,KAAK,QAAQ,GAAG,GAAG,SAAS,SAAS,GAAG,GAAG,WAAW,GACpE;EAAC;EAAK;EAAS;EAAU;EAAS;CAAW,CAC/C;CACA,MAAM,UAAA,GAASL,MAAAA,YAAAA,EACZ,UACC,UAAU,YACT,QAAQ,KAAA,KACP,CAACM,mBAAAA,gBAAgB,KAAK,OAAO,SAASC,aAAAA,YAAuB,GAAG,WAAW,IAC/E;EAAC;EAAK;EAAS;EAAU;CAAW,CACtC;CACA,MAAM,SAAA,GAAQC,MAAAA,QAAAA,OACL,KAAK,OAAO,KAAA,IAAY,KAAA,IAAY,QAAQ,KAAK,EAAE,GAC1D,CAAC,MAAM,OAAO,CAChB;CAMA,OAAO;EAAE;EAAK;EAAS,OALTC,mBAAAA,aAAa,MAAM,QAAQ,KAKd;EAAG,QAAA,GAJhBT,MAAAA,YAAAA,EACX,QAAiBU,sBAAAA,kBAAkB,QAAQ,GAAG,GAAG,KAAK,YAAY,GACnE,CAAC,SAAS,GAAG,CAEmB;CAAE;AACtC;AAGA,SAAgB,WAAW,EACzB,UACA,KACA,KACA,MACA,OACA,SACA,WAYe;CACf,MAAM,YACJ,GAAA,kBAAA,IAAA,CAAC,aAAD;EACY;EACL;EACA;EACI;EACT,GAAK,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ;CAC7C,CAAA;CAEH,IAAI,SAAS,KAAA,KAAa,CAAC,OAAO,OAAO;CACzC,QAAO,GAAA,kBAAA,IAAA,CAACC,mBAAAA,aAAD;EAAa,QAAQ;EAAW;EAAe;CAAW,CAAA;AACnE;AAQA,SAAgB,UAAU,EACxB,OACA,MACA,SAKsB;CACtB,MAAM,aAAaC,gBAAAA,iBAAiB;CACpC,MAAM,YACJ;CACF,MAAM,QAAkB,GAAA,kBAAA,IAAA,CAAC,QAAD;EAAM,WAAU;EAAW,UAAA;CAAY,CAAA;CAC/D,IAAI,UAAU,MACZ,OAAO,QACL,GAAA,kBAAA,IAAA,CAACC,sBAAAA,kBAAD;EAAwB;EAAiB;EAAW,QAAQ;EACzD,UAAA;CACe,CAAA,KAElB,GAAA,kBAAA,IAAA,CAAC,UAAD;EACE,MAAK;EACL,MAAK;GACEC,cAAAA,yBAAyB;EAIhC,WAAW,GAAG,UAAU;EACxB,UAAU,UAAU;GAClB,IAAI,CAACC,sBAAAA,iBAAiB,KAAK,GAAG;GAC9B,MAAM;EACR;EAEC,UAAA;CACK,CAAA;CAEZ,IAAI,MACF,QACE,GAAA,kBAAA,IAAA,CAAC,YAAD;EAAkB;EAAiB;EAChC,UAAA;CACS,CAAA;CAEhB,OAAO;AACT;AAMA,MAAa,mBACX"}

package/dist/related-rows-o0_t-Yce.js

@@ -0,0 +1,185 @@
+import { o as useLinkComponent } from "./toaster-C02XbB9r.js";
+import { f as recordDisplayName, m as isPlainLeftClick, p as ClaimedQuickLink } from "./search-access-CPPmfuvy.js";
+import { Nt as toDisplayText, a as peekFieldDefinition, c as peekRow, ct as useItemDrawn, jt as ResolvedFieldDisplay, o as peekLeafAllowed, st as RelatedItem } from "./place-node-NraNYKPx.js";
+import { RECORD_PROBE, declaredText, resolveCapability, resolveFieldLabel, ruleContextFor } from "@burojs/core";
+import { QUICK_ANCHOR_ATTRIBUTE, useApp, useCtx, useFieldAccess, useI18nCaps, useViewRow } from "@burojs/react";
+import { Fragment, useCallback, useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/blocks/default-item.tsx
+const isNumeric = (field) => field?.kind === "number";
+function DefaultItem({ resource, row, raw, columns, variant = "card" }) {
+	const def = useApp().registry.get(resource);
+	const caps = useI18nCaps(resource);
+	const access = useRowAccess(resource)(raw);
+	const viewVisible = useViewVisible(resource);
+	const fields = def === void 0 ? [] : (columns ?? def.views?.list?.columns ?? Object.keys(def.fields)).filter((name, index, names) => name !== def.displayField && names.indexOf(name) === index && peekLeafAllowed(def, name, access, viewVisible));
+	const ref = def?.ref ?? {
+		namespace: "default",
+		id: resource
+	};
+	const definition = (name) => peekFieldDefinition(def, name);
+	const value = (name) => jsx(ResolvedFieldDisplay, {
+		resource: ref,
+		name,
+		field: definition(name),
+		value: row[name],
+		record: row,
+		fallback: toDisplayText(row[name]).text
+	});
+	const title = jsx("p", {
+		className: "truncate text-sm font-medium",
+		children: recordDisplayName(row, def?.displayField)
+	});
+	if (variant === "entry") {
+		const shown = fields.filter((name) => row[name] != null && row[name] !== "");
+		return jsxs("div", {
+			className: "flex min-w-0 flex-col gap-0.5",
+			"data-buro-default-item": "",
+			children: [title, shown.length === 0 ? null : jsx("div", {
+				"data-buro-item-meta": "",
+				className: "truncate text-xs text-muted-foreground",
+				children: shown.map((name, index) => jsxs(Fragment, { children: [index > 0 ? " · " : null, value(name)] }, name))
+			})]
+		});
+	}
+	const numbers = fields.filter((name) => isNumeric(definition(name)));
+	const pairs = fields.filter((name) => !isNumeric(definition(name)));
+	return jsxs("div", {
+		className: "flex min-w-0 items-start gap-3",
+		"data-buro-default-item": "",
+		children: [jsxs("div", {
+			className: "flex min-w-0 flex-1 flex-col gap-2",
+			children: [title, pairs.length === 0 ? null : jsx("dl", {
+				className: "grid gap-1.5",
+				children: pairs.map((name) => jsxs("div", {
+					className: "flex min-w-0 items-baseline gap-2 text-sm",
+					children: [jsx("dt", {
+						className: "w-24 shrink-0 truncate text-xs text-muted-foreground",
+						children: resolveFieldLabel(caps, name, declaredText("field", definition(name), "label"))
+					}), jsx("dd", {
+						className: "min-w-0 break-words",
+						children: value(name)
+					})]
+				}, name))
+			})]
+		}), numbers.length === 0 ? null : jsx("div", {
+			"data-buro-item-trailing": "",
+			className: "flex shrink-0 flex-col items-end gap-1 border-l pl-3 text-sm tabular-nums",
+			children: numbers.map((name) => jsx("span", {
+				title: resolveFieldLabel(caps, name, declaredText("field", definition(name), "label")),
+				children: value(name)
+			}, name))
+		})]
+	});
+}
+//#endregion
+//#region src/blocks/related-rows.tsx
+function useRowAccess(resource) {
+	const app = useApp();
+	const scope = useCtx((c) => c.scope);
+	const user = useCtx((c) => c.user);
+	const permissions = useCtx((c) => c.permissions);
+	return useCallback((row) => (capability, target, defaultAllowed = true) => {
+		const rules = app.ruleSource.rules(resource);
+		if (rules.length === 0) return { allowed: defaultAllowed };
+		const ctx = ruleContextFor({
+			user,
+			scope,
+			permissions,
+			record: row,
+			mode: "show",
+			resource
+		});
+		return resolveCapability(rules, capability, target, ctx, defaultAllowed);
+	}, [
+		app.ruleSource,
+		resource,
+		scope,
+		user,
+		permissions
+	]);
+}
+function useViewVisible(resource) {
+	const access = useFieldAccess(resource, "every");
+	return useCallback((field) => {
+		const decision = access[field];
+		return decision === void 0 || decision.view === "visible";
+	}, [access]);
+}
+function useProjectedRows(resource, rows, item) {
+	const def = useApp().registry.get(resource);
+	const accessOf = useRowAccess(resource);
+	const viewRow = useViewRow(resource);
+	const viewVisible = useViewVisible(resource);
+	const idField = (def?.data)?.idField ?? "id";
+	const project = useCallback((row) => def === void 0 ? viewRow(row) : peekRow(def, viewRow(row), idField, accessOf(row), viewVisible), [
+		def,
+		idField,
+		accessOf,
+		viewRow,
+		viewVisible
+	]);
+	const hidden = useCallback((field) => field !== idField && (def === void 0 || !peekLeafAllowed(def, field, accessOf(RECORD_PROBE), viewVisible)), [
+		def,
+		idField,
+		accessOf,
+		viewVisible
+	]);
+	const probe = useMemo(() => rows[0] === void 0 ? void 0 : project(rows[0]), [rows, project]);
+	return {
+		def,
+		project,
+		drawn: useItemDrawn(item, hidden, probe),
+		title: useCallback((row) => recordDisplayName(project(row), def?.displayField), [project, def])
+	};
+}
+function RowContent({ resource, raw, row, item, drawn, columns, variant }) {
+	const fallback = jsx(DefaultItem, {
+		resource,
+		row,
+		raw,
+		columns,
+		...variant === void 0 ? {} : { variant }
+	});
+	if (item === void 0 || !drawn) return fallback;
+	return jsx(RelatedItem, {
+		handle: item,
+		row,
+		fallback
+	});
+}
+function RowOpener({ title, href, quick }) {
+	const RouterLink = useLinkComponent();
+	const className = "outline-none after:absolute after:inset-0 after:rounded-[inherit] focus-visible:after:ring-2 focus-visible:after:ring-ring";
+	const name = jsx("span", {
+		className: "sr-only",
+		children: title
+	});
+	if (quick !== null) return href ? jsx(ClaimedQuickLink, {
+		href,
+		className,
+		onOpen: quick,
+		children: name
+	}) : jsx("button", {
+		type: "button",
+		role: "link",
+		[QUICK_ANCHOR_ATTRIBUTE]: "",
+		className: `${className} block size-0 p-0`,
+		onClick: (event) => {
+			if (!isPlainLeftClick(event)) return;
+			quick();
+		},
+		children: name
+	});
+	if (href) return jsx(RouterLink, {
+		href,
+		className,
+		children: name
+	});
+	return null;
+}
+const ITEM_LAYER_CLASS = "relative z-[1] pointer-events-none [&_a]:pointer-events-auto [&_button]:pointer-events-auto [&_input]:pointer-events-auto [&_select]:pointer-events-auto [&_textarea]:pointer-events-auto [&_summary]:pointer-events-auto [&_[role=button]]:pointer-events-auto [&_[role=link]]:pointer-events-auto [&_[role=checkbox]]:pointer-events-auto [&_[role=switch]]:pointer-events-auto";
+//#endregion
+export { useProjectedRows as i, RowContent as n, RowOpener as r, ITEM_LAYER_CLASS as t };
+
+//# sourceMappingURL=related-rows-o0_t-Yce.js.map

package/dist/related-rows-o0_t-Yce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-rows-o0_t-Yce.js","names":[],"sources":["../src/blocks/default-item.tsx","../src/blocks/related-rows.tsx"],"sourcesContent":["'use client';\nimport { type EntityRef, resolveFieldLabel, declaredText } from '@burojs/core';\nimport { useApp, useI18nCaps } from '@burojs/react';\nimport { Fragment, type ReactElement } from 'react';\nimport { toDisplayText } from '../fields/display-value.js';\nimport { ResolvedFieldDisplay } from '../fields/resolved-field.js';\nimport {\n  type PeekFieldSource,\n  peekFieldDefinition,\n  peekLeafAllowed,\n} from '../quick/peek-filter.js';\nimport { recordDisplayName } from '../resource/record-display-name.js';\nimport { type ListRow, useRowAccess, useViewVisible } from './related-rows.js';\n\n/** What a default item reads of the target's definition. */\ninterface TargetDefinition extends PeekFieldSource {\n  readonly views?: { readonly list?: { readonly columns?: readonly string[] } };\n  readonly ref?: EntityRef;\n}\n\n/** A field the default item puts in its trailing part: a number reads best right-aligned. */\nconst isNumeric = (field: { readonly kind?: unknown } | undefined) => field?.kind === 'number';\n\n/**\n * The item of a related list that names none (P6 3.13). As a card: the row's title (weight 500),\n * its other fields as muted label / value pairs, and its numbers in a trailing part set off by a\n * rule. As a timeline entry (`variant: 'entry'`): the title and the field values on one muted\n * meta line. `row` is the projected row, so a field the viewer may not see is already `null` and\n * is not listed.\n */\nexport function DefaultItem({\n  resource,\n  row,\n  raw,\n  columns,\n  variant = 'card',\n}: {\n  readonly resource: string;\n  readonly row: Readonly<Record<string, unknown>>;\n  /** The row as the list read it: column rules resolve over it. */\n  readonly raw: ListRow;\n  readonly columns?: readonly string[] | undefined;\n  readonly variant?: 'card' | 'entry';\n}): ReactElement {\n  const app = useApp();\n  const def = app.registry.get(resource) as TargetDefinition | undefined;\n  const caps = useI18nCaps(resource);\n  const access = useRowAccess(resource)(raw);\n  const viewVisible = useViewVisible(resource);\n  const fields =\n    def === undefined\n      ? []\n      : (columns ?? def.views?.list?.columns ?? Object.keys(def.fields)).filter(\n          (name, index, names) =>\n            name !== def.displayField &&\n            names.indexOf(name) === index &&\n            peekLeafAllowed(def, name, access, viewVisible),\n        );\n  const ref = def?.ref ?? { namespace: 'default', id: resource };\n  const definition = (name: string) =>\n    peekFieldDefinition(def!, name) as { readonly label?: string; readonly kind?: unknown };\n  const value = (name: string) => (\n    <ResolvedFieldDisplay\n      resource={ref}\n      name={name}\n      field={definition(name) as never}\n      value={row[name]}\n      record={row}\n      fallback={toDisplayText(row[name]).text}\n    />\n  );\n  const title = (\n    <p className=\"truncate text-sm font-medium\">{recordDisplayName(row, def?.displayField)}</p>\n  );\n  if (variant === 'entry') {\n    const shown = fields.filter((name) => row[name] != null && row[name] !== '');\n    return (\n      <div className=\"flex min-w-0 flex-col gap-0.5\" data-buro-default-item=\"\">\n        {title}\n        {shown.length === 0 ? null : (\n          <div data-buro-item-meta=\"\" className=\"truncate text-xs text-muted-foreground\">\n            {shown.map((name, index) => (\n              <Fragment key={name}>\n                {index > 0 ? ' · ' : null}\n                {value(name)}\n              </Fragment>\n            ))}\n          </div>\n        )}\n      </div>\n    );\n  }\n  const numbers = fields.filter((name) => isNumeric(definition(name)));\n  const pairs = fields.filter((name) => !isNumeric(definition(name)));\n  return (\n    <div className=\"flex min-w-0 items-start gap-3\" data-buro-default-item=\"\">\n      <div className=\"flex min-w-0 flex-1 flex-col gap-2\">\n        {title}\n        {pairs.length === 0 ? null : (\n          <dl className=\"grid gap-1.5\">\n            {pairs.map((name) => (\n              <div key={name} className=\"flex min-w-0 items-baseline gap-2 text-sm\">\n                <dt className=\"w-24 shrink-0 truncate text-xs text-muted-foreground\">\n                  {resolveFieldLabel(caps, name, declaredText('field', definition(name), 'label'))}\n                </dt>\n                <dd className=\"min-w-0 break-words\">{value(name)}</dd>\n              </div>\n            ))}\n          </dl>\n        )}\n      </div>\n      {numbers.length === 0 ? null : (\n        <div\n          data-buro-item-trailing=\"\"\n          className=\"flex shrink-0 flex-col items-end gap-1 border-l pl-3 text-sm tabular-nums\"\n        >\n          {numbers.map((name) => (\n            <span\n              key={name}\n              title={resolveFieldLabel(\n                caps,\n                name,\n                declaredText('field', definition(name), 'label'),\n              )}\n            >\n              {value(name)}\n            </span>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\nimport { type AppContext, RECORD_PROBE, resolveCapability, ruleContextFor } from '@burojs/core';\nimport { type CapabilityResolver, useApp, useCtx, useFieldAccess, useViewRow } from '@burojs/react';\nimport { type ReactElement, type ReactNode, useCallback, useMemo } from 'react';\nimport { QUICK_ANCHOR_ATTRIBUTE } from '@burojs/react';\nimport { ClaimedQuickLink, isPlainLeftClick } from '../fields/claimed-quick-link.js';\nimport { useLinkComponent } from '../layout/link-component.js';\nimport { type PeekFieldSource, peekLeafAllowed, peekRow } from '../quick/peek-filter.js';\nimport { recordDisplayName } from '../resource/record-display-name.js';\nimport { DefaultItem } from './default-item.js';\nimport { type ItemHandle, RelatedItem, useItemDrawn } from './related-item.js';\n\nexport type ListRow = { readonly id: string } & Readonly<Record<string, unknown>>;\n\n/** What `related-list` hands a rows view: the list's rows and how a row opens. */\nexport interface RelatedRowsProps {\n  /** The target resource. */\n  readonly resource: string;\n  /** The placement's key (test ids). */\n  readonly placementKey: string;\n  readonly rows: readonly ListRow[];\n  readonly item?: ItemHandle | undefined;\n  /** The placement's `columns`, for the default item. */\n  readonly columns?: readonly string[] | undefined;\n  readonly rowQuick?: ((row: ListRow) => (() => void) | null) | undefined;\n  readonly rowHref?: ((row: ListRow) => string | undefined) | undefined;\n}\n\n/**\n * A capability resolver per row: column rules resolve over the row they hide a field of, as the\n * peek's do (P6-B review), so a rule reading the record sees this row.\n */\nexport function useRowAccess(resource: string): (row: ListRow) => CapabilityResolver {\n  const app = useApp();\n  const scope = useCtx((c: AppContext) => c.scope);\n  const user = useCtx((c: AppContext) => c.user);\n  const permissions = useCtx((c: AppContext) => c.permissions);\n  return useCallback(\n    (row) =>\n      (capability, target, defaultAllowed = true) => {\n        const rules = app.ruleSource.rules(resource);\n        if (rules.length === 0) return { allowed: defaultAllowed };\n        const ctx = ruleContextFor({\n          user,\n          scope,\n          permissions,\n          record: row,\n          mode: 'show',\n          resource,\n        });\n        return resolveCapability(rules, capability, target, ctx, defaultAllowed);\n      },\n    [app.ruleSource, resource, scope, user, permissions],\n  );\n}\n\n/**\n * Whether a field may be drawn on every row by its P5 view (P5 spec 3.6.6): a decision that is\n * not `visible` (`hidden`, `restricted`, `failed` and `pending` alike, so nothing is drawn while\n * the permission map loads) withholds it. A field the map does not decide is not withheld here. The decision\n * is the any-record one ({@link RECORD_PROBE}), so a rule reading the record counts as hiding.\n */\nexport function useViewVisible(resource: string): (field: string) => boolean {\n  const access = useFieldAccess(resource, 'every');\n  return useCallback(\n    (field) => {\n      const decision = access[field];\n      return decision === undefined || decision.view === 'visible';\n    },\n    [access],\n  );\n}\n\ninterface ProjectedRows {\n  readonly def:\n    | (PeekFieldSource & { readonly displayField?: string; readonly data?: unknown })\n    | undefined;\n  /** The row a card or an entry sees: the id and what the viewer may see; the rest read `null`. */\n  readonly project: (row: ListRow) => ListRow;\n  /** Whether the item block is drawn (decided once for the list), else the default item. */\n  readonly drawn: boolean;\n  readonly title: (row: ListRow) => string;\n}\n\n/**\n * The rows of a cards or timeline view, projected once and the item decided once per list.\n *\n * The rows arrive as the list read them (policy). A row is first projected by P5's field view\n * (`viewRow`: a field its user may not view for every row is left out) and then by the peek's\n * rule ({@link peekRow}): the id field and every field that is not `sensitive`, not withheld by\n * a field `requires.view` and not hidden by a `column` rule keep their values; every other\n * field reads `null`. It is the one place a row's fields are filtered before an item block or\n * the default item sees them (P6-66), and the timeline's axis reads the same row.\n */\nexport function useProjectedRows(\n  resource: string,\n  rows: readonly ListRow[],\n  item: ItemHandle | undefined,\n): ProjectedRows {\n  const app = useApp();\n  const def = app.registry.get(resource) as ProjectedRows['def'];\n  const accessOf = useRowAccess(resource);\n  const viewRow = useViewRow(resource);\n  const viewVisible = useViewVisible(resource);\n  const idField = (def?.data as { readonly idField?: string } | undefined)?.idField ?? 'id';\n  const project = useCallback(\n    (row: ListRow): ListRow =>\n      (def === undefined\n        ? viewRow(row)\n        : peekRow(def, viewRow(row), idField, accessOf(row), viewVisible)) as ListRow,\n    [def, idField, accessOf, viewRow, viewVisible],\n  );\n  const hidden = useCallback(\n    (field: string) =>\n      field !== idField &&\n      (def === undefined ||\n        !peekLeafAllowed(def, field, accessOf(RECORD_PROBE as ListRow), viewVisible)),\n    [def, idField, accessOf, viewVisible],\n  );\n  const probe = useMemo(\n    () => (rows[0] === undefined ? undefined : project(rows[0])),\n    [rows, project],\n  );\n  const drawn = useItemDrawn(item, hidden, probe);\n  const title = useCallback(\n    (row: ListRow) => recordDisplayName(project(row), def?.displayField),\n    [project, def],\n  );\n  return { def, project, drawn, title };\n}\n\n/** The item block (or the default item) of one row. */\nexport function RowContent({\n  resource,\n  raw,\n  row,\n  item,\n  drawn,\n  columns,\n  variant,\n}: {\n  readonly resource: string;\n  /** The row as the list read it (column rules resolve over it). */\n  readonly raw: ListRow;\n  /** The projected row. */\n  readonly row: ListRow;\n  readonly item: ItemHandle | undefined;\n  readonly drawn: boolean;\n  readonly columns?: readonly string[] | undefined;\n  /** How the default item lays the row out: a card's, or a timeline entry's. */\n  readonly variant?: 'card' | 'entry';\n}): ReactElement {\n  const fallback = (\n    <DefaultItem\n      resource={resource}\n      row={row}\n      raw={raw}\n      columns={columns}\n      {...(variant === undefined ? {} : { variant })}\n    />\n  );\n  if (item === undefined || !drawn) return fallback;\n  return <RelatedItem handle={item} row={row} fallback={fallback} />;\n}\n\n/**\n * A card's or an entry's one opener (P6-74): the row's title as the accessible name of a single\n * anchor whose `::after` covers the positioned parent. A quick row is the page anchor claimed\n * for the opener (a modified click follows the `href`), or a link-role button without a page.\n * `open: 'none'` draws nothing.\n */\nexport function RowOpener({\n  title,\n  href,\n  quick,\n}: {\n  readonly title: string;\n  readonly href: string | undefined;\n  readonly quick: (() => void) | null;\n}): ReactElement | null {\n  const RouterLink = useLinkComponent();\n  const className =\n    'outline-none after:absolute after:inset-0 after:rounded-[inherit] focus-visible:after:ring-2 focus-visible:after:ring-ring';\n  const name: ReactNode = <span className=\"sr-only\">{title}</span>;\n  if (quick !== null)\n    return href ? (\n      <ClaimedQuickLink href={href} className={className} onOpen={quick}>\n        {name}\n      </ClaimedQuickLink>\n    ) : (\n      <button\n        type=\"button\"\n        role=\"link\"\n        {...{ [QUICK_ANCHOR_ATTRIBUTE]: '' }}\n        // A button is inline-block, so even with only an `sr-only` name it took a line of the\n        // card and pushed the content down (REF-40). Zero-size and unpositioned, its `::after`\n        // still covers the card.\n        className={`${className} block size-0 p-0`}\n        onClick={(event) => {\n          if (!isPlainLeftClick(event)) return;\n          quick();\n        }}\n      >\n        {name}\n      </button>\n    );\n  if (href)\n    return (\n      <RouterLink href={href} className={className}>\n        {name}\n      </RouterLink>\n    );\n  return null;\n}\n\n/**\n * The wrapper that raises an item's interactive descendants above the opener's cover (P6-74):\n * the wrapper itself lets clicks through to the opener, its controls take them.\n */\nexport const ITEM_LAYER_CLASS =\n  'relative z-[1] pointer-events-none [&_a]:pointer-events-auto [&_button]:pointer-events-auto [&_input]:pointer-events-auto [&_select]:pointer-events-auto [&_textarea]:pointer-events-auto [&_summary]:pointer-events-auto [&_[role=button]]:pointer-events-auto [&_[role=link]]:pointer-events-auto [&_[role=checkbox]]:pointer-events-auto [&_[role=switch]]:pointer-events-auto';\n"],"mappings":"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"}

package/dist/relation-create-IA40t1hi.cjs

@@ -0,0 +1,364 @@
+const require_use_theme = require("./use-theme-DFlpXils.cjs");
+const require_toaster = require("./toaster-Cr51X7bz.cjs");
+const require_button = require("./button-BxnnE28H.cjs");
+const require_search_access = require("./search-access-Dugvttlg.cjs");
+let _burojs_core = require("@burojs/core");
+let _burojs_react = require("@burojs/react");
+let _tabler_icons_react = require("@tabler/icons-react");
+let react = require("react");
+react = require_use_theme.__toESM(react, 1);
+let react_jsx_runtime = require("react/jsx-runtime");
+let sonner = require("sonner");
+//#region src/fields/relation-hand-back.tsx
+function createdOptionFilter(input) {
+	const own = createdOptionScope(input);
+	const byId = {
+		field: input.idField,
+		op: "eq",
+		value: input.id
+	};
+	return own === void 0 ? byId : { and: [own, byId] };
+}
+function createdOptionScope(input) {
+	return (0, _burojs_core.composeListFilter)({
+		fixed: (0, _burojs_core.normalizeFixedFilters)(input.fixed),
+		search: "",
+		...input.searchDecl === void 0 ? {} : { searchDecl: input.searchDecl },
+		...input.searchContext === void 0 ? {} : { searchContext: input.searchContext }
+	});
+}
+function CreatedOptionRead({ to, filter, scope, scopeField, by, idField, onSettled }) {
+	const query = (0, _burojs_react.useList)(to, {
+		filter,
+		pagination: {
+			kind: "offset",
+			page: 1,
+			pageSize: 1
+		},
+		scope,
+		...scopeField === void 0 ? {} : { scopeField },
+		retry: false
+	});
+	const settled = react.useRef(false);
+	const latest = react.useRef(onSettled);
+	latest.current = onSettled;
+	const rows = query.data?.data;
+	const answered = rows !== void 0 && query.isCurrentData && !query.isFetching;
+	const failed = query.isError && !query.isFetching;
+	react.useEffect(() => {
+		if (settled.current) return;
+		if (failed) {
+			settled.current = true;
+			latest.current({ kind: "failed" });
+			return;
+		}
+		if (!answered) return;
+		settled.current = true;
+		const value = rows[0]?.[by ?? idField];
+		latest.current(typeof value === "string" || typeof value === "number" ? {
+			kind: "fits",
+			value
+		} : { kind: "does-not-fit" });
+	}, [
+		answered,
+		failed,
+		rows,
+		by,
+		idField
+	]);
+	return null;
+}
+//#endregion
+//#region src/fields/relation-view-button.tsx
+function selectKey(value) {
+	if (typeof value === "string") return value.length === 0 ? null : value;
+	if (typeof value === "number") return Number.isFinite(value) ? String(value) : null;
+	return null;
+}
+const VIEW_CLASS = require_use_theme.cn(require_button.buttonVariants({
+	variant: "outline",
+	size: "icon"
+}), "shrink-0");
+function RelationViewButton(props) {
+	const gate = (0, _burojs_react.useEntryGate)();
+	const { to, value, by } = props;
+	const access = (0, _burojs_react.useListAccess)(to);
+	const key = selectKey(value);
+	if (key === null || props.open === "none") return null;
+	if (by !== void 0 && !(access.status === "ready" && access.fieldVisible(by))) return null;
+	if (gate(to, "show").state !== "open") return null;
+	return (0, react_jsx_runtime.jsx)(ViewButton, {
+		...props,
+		keyString: key
+	}, key);
+}
+function ViewButton({ to, by, fieldName, keyString, beforeOpen, open: openMode = "quick" }) {
+	const app = (0, _burojs_react.useApp)();
+	const t = (0, _burojs_react.useOptionalT)();
+	const tid = (0, _burojs_react.useTestIds)();
+	const quick = (0, _burojs_react.useQuick)();
+	const navigate = (0, _burojs_react.useRouteNavigate)();
+	const RouterLink = require_toaster.useLinkComponent();
+	const [asked, setAsked] = react.useState(false);
+	const requested = react.useRef(false);
+	const targetDef = app.registry.get(to);
+	const rawIdField = (targetDef?.data)?.idField;
+	const idField = typeof rawIdField === "string" && rawIdField.length > 0 ? rawIdField : "id";
+	const read = (0, _burojs_react.useList)(to, {
+		...asked && by !== void 0 ? {
+			filter: {
+				field: by,
+				op: "eq",
+				value: keyString
+			},
+			pagination: {
+				kind: "offset",
+				page: 1,
+				pageSize: 2
+			}
+		} : {},
+		scope: "none",
+		enabled: asked && by !== void 0,
+		retry: false
+	});
+	const rows = read.isCurrentData && !read.isPlaceholderData && !read.isFetching ? read.data?.data : void 0;
+	const open = react.useCallback((id) => {
+		beforeOpen();
+		if (openMode === "page") {
+			if (targetDef !== void 0 && require_search_access.linksToPage(app, targetDef)) navigate((0, _burojs_core.resourceShowHref)(app.registry, targetDef, to, id));
+			return;
+		}
+		quick.show(to, id);
+	}, [
+		beforeOpen,
+		quick,
+		to,
+		openMode,
+		navigate,
+		app,
+		targetDef
+	]);
+	react.useEffect(() => {
+		if (by === void 0 || !asked || rows === void 0 || !requested.current) return;
+		requested.current = false;
+		if (rows.length !== 1) {
+			if (rows.length > 1 && process.env.NODE_ENV !== "production") console.error(`[burojs] ${to}: more than one row has ${by} ${keyString}; "view" opened nothing.`);
+			return;
+		}
+		const id = rows[0]?.[idField];
+		const next = selectKey(id);
+		if (next !== null) open(next);
+	}, [
+		by,
+		asked,
+		rows,
+		idField,
+		keyString,
+		to,
+		open
+	]);
+	const label = t("relationPicker.view", { defaultValue: "View" });
+	const icon = (0, react_jsx_runtime.jsx)(_tabler_icons_react.IconEye, {
+		className: "h-4 w-4",
+		"aria-hidden": true
+	});
+	const testid = tid.relationView(to, fieldName);
+	if (openMode === "page" && (targetDef === void 0 || !require_search_access.linksToPage(app, targetDef))) return null;
+	if (openMode === "page" && by === void 0 && targetDef !== void 0) return (0, react_jsx_runtime.jsxs)(RouterLink, {
+		href: (0, _burojs_core.resourceShowHref)(app.registry, targetDef, to, keyString),
+		"data-testid": testid,
+		className: VIEW_CLASS,
+		onClick: () => beforeOpen(),
+		children: [icon, (0, react_jsx_runtime.jsx)("span", {
+			className: "sr-only",
+			children: label
+		})]
+	});
+	if (by === void 0 && targetDef !== void 0 && require_search_access.linksToPage(app, targetDef)) return (0, react_jsx_runtime.jsxs)(require_search_access.ClaimedQuickLink, {
+		href: (0, _burojs_core.resourceShowHref)(app.registry, targetDef, to, keyString),
+		testid,
+		className: VIEW_CLASS,
+		onOpen: () => open(keyString),
+		children: [icon, (0, react_jsx_runtime.jsx)("span", {
+			className: "sr-only",
+			children: label
+		})]
+	});
+	return (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		className: VIEW_CLASS,
+		"data-testid": testid,
+		"aria-label": label,
+		[_burojs_react.QUICK_ANCHOR_ATTRIBUTE]: "",
+		onClick: (event) => {
+			event.preventDefault();
+			event.stopPropagation();
+			if (!require_search_access.isPlainLeftClick(event)) return;
+			if (by === void 0) {
+				open(keyString);
+				return;
+			}
+			requested.current = true;
+			setAsked(true);
+			if (rows !== void 0 && rows.length === 1) {
+				const next = selectKey(rows[0]?.[idField]);
+				requested.current = false;
+				if (next !== null) open(next);
+			}
+		},
+		children: icon
+	});
+}
+//#endregion
+//#region src/fields/relation-create.tsx
+function useSelectCreate(input) {
+	const t = (0, _burojs_react.useOptionalT)();
+	const { to: target } = input;
+	const [pending, setPending] = react.useState(false);
+	const [created, setCreated] = react.useState(null);
+	const latch = react.useRef(false);
+	const mounted = react.useRef(true);
+	react.useEffect(() => {
+		mounted.current = true;
+		return () => {
+			mounted.current = false;
+		};
+	}, []);
+	const latest = react.useRef(input);
+	latest.current = input;
+	const access = (0, _burojs_react.useListAccess)(target);
+	const blocked = input.held === true || access.status !== "ready" || require_search_access.namesHiddenField(createdOptionScope({
+		fixed: input.fixedFilters,
+		searchDecl: input.searchDecl,
+		searchContext: input.searchContext
+	}), (name) => access.fieldVisible(name));
+	const blockedRef = react.useRef(blocked);
+	blockedRef.current = blocked;
+	const release = react.useCallback(() => {
+		latch.current = false;
+		if (mounted.current) {
+			setPending(false);
+			setCreated(null);
+		}
+	}, []);
+	const start = react.useCallback((open) => {
+		if (latch.current || !mounted.current || blockedRef.current) return;
+		latch.current = true;
+		setPending(true);
+		let opened;
+		try {
+			opened = open();
+		} catch (error) {
+			release();
+			throw error;
+		}
+		opened.then((row) => {
+			if (!mounted.current) {
+				latch.current = false;
+				return;
+			}
+			const id = row === null ? null : selectKey(row[latest.current.idField]) ?? selectKey(row.id);
+			if (id === null) release();
+			else setCreated({ id });
+		}, () => release());
+	}, [release]);
+	const settle = react.useCallback((result) => {
+		if (mounted.current) {
+			if (result.kind === "fits") latest.current.onValue(result.value);
+			else if (result.kind === "does-not-fit") (0, sonner.toast)(t("relationPicker.createdNotFitting", { defaultValue: "The record was created but does not fit this field" }));
+			else sonner.toast.error(t("relationPicker.createdNotSelected", { defaultValue: "The record was created but could not be selected" }));
+		}
+		release();
+	}, [release, t]);
+	return {
+		create: react.useMemo(() => ({
+			pending,
+			blocked,
+			start
+		}), [
+			pending,
+			blocked,
+			start
+		]),
+		reader: created === null || blocked ? null : (0, react_jsx_runtime.jsx)(CreatedOptionRead, {
+			to: target,
+			filter: createdOptionFilter({
+				fixed: input.fixedFilters,
+				idField: input.idField,
+				id: created.id,
+				searchDecl: input.searchDecl,
+				searchContext: input.searchContext
+			}),
+			scope: input.scope,
+			...input.scopeField === void 0 ? {} : { scopeField: input.scopeField },
+			by: input.by,
+			idField: input.idField,
+			onSettled: settle
+		}, created.id)
+	};
+}
+function plainStringField(def) {
+	if (def === null || typeof def !== "object") return false;
+	const field = def;
+	return field.kind === "string" && field.system !== true && field.opts?.system !== true && field.opts?.enum === void 0 && field.opts?.localized !== true;
+}
+function RelationCreateButton(props) {
+	const gate = (0, _burojs_react.useEntryGate)();
+	const { to } = props;
+	if (props.create.blocked || gate(to, "create").state !== "open") return null;
+	return (0, react_jsx_runtime.jsx)(CreateButton, { ...props });
+}
+function CreateButton({ to, fieldName, create, seeds, search, beforeOpen, className, testId }) {
+	const app = (0, _burojs_react.useApp)();
+	const t = (0, _burojs_react.useOptionalT)();
+	const tid = (0, _burojs_react.useTestIds)();
+	const quick = (0, _burojs_react.useQuick)();
+	const label = t("relationPicker.create", { defaultValue: "+ Create" });
+	return (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		"data-testid": testId ?? tid.relationCreate(to, fieldName),
+		disabled: create.pending,
+		className,
+		onClick: () => {
+			const text = search?.trim() ?? "";
+			const displayField = app.registry.get(to)?.displayField;
+			const fields = app.registry.get(to)?.fields;
+			const prefill = text.length > 0 && typeof displayField === "string" && fields !== void 0 && Object.hasOwn(fields, displayField) && plainStringField(fields[displayField]) ? { [displayField]: text } : void 0;
+			create.start(() => {
+				beforeOpen();
+				return quick.create(to, {
+					...seeds === void 0 || Object.keys(seeds).length === 0 ? {} : { defaults: seeds },
+					...prefill === void 0 ? {} : { input: prefill }
+				});
+			});
+		},
+		children: label
+	});
+}
+//#endregion
+Object.defineProperty(exports, "RelationCreateButton", {
+	enumerable: true,
+	get: function() {
+		return RelationCreateButton;
+	}
+});
+Object.defineProperty(exports, "RelationViewButton", {
+	enumerable: true,
+	get: function() {
+		return RelationViewButton;
+	}
+});
+Object.defineProperty(exports, "selectKey", {
+	enumerable: true,
+	get: function() {
+		return selectKey;
+	}
+});
+Object.defineProperty(exports, "useSelectCreate", {
+	enumerable: true,
+	get: function() {
+		return useSelectCreate;
+	}
+});
+
+//# sourceMappingURL=relation-create-IA40t1hi.cjs.map