@ryuzaki13/react-foundation-ui 1.2.13 → 1.2.15

package/storybook-static/assets/{odataStoryFixtures-C_NsAWws.js → odataStoryFixtures-DRl-0jvY.js}

@@ -1,4 +1,4 @@
-import{c as e,i as t}from"./preload-helper-B45gAKPr.js";import{pn as n,t as r}from"./iframe-8yiaZsxV.js";import{D as i,E as a,T as o,w as s}from"./odata-Beh7LPwF.js";var c,l,u=t((()=>{c=[{code:`R01`,text:`Северный регион`,branches:[{code:`B0101`,text:`Подразделение Альфа`,teams:[{code:`T0101`,text:`Команда поддержки`,owners:[{code:`P0001`,text:`Ответственный 1`},{code:`P0002`,text:`Ответственный 2`},{code:`P0003`,text:`Ответственный 3`}]},{code:`T0102`,text:`Команда внедрения`,owners:[{code:`P0004`,text:`Ответственный 4`},{code:`P0005`,text:`Ответственный 5`}]}]},{code:`B0102`,text:`Подразделение Бета`,teams:[{code:`T0201`,text:`Команда аналитики`,owners:[{code:`P0006`,text:`Ответственный 6`},{code:`P0007`,text:`Ответственный 7`}]}]}]},{code:`R02`,text:`Южный регион`,branches:[{code:`B0201`,text:`Подразделение Гамма`,teams:[{code:`T0301`,text:`Команда сопровождения`,owners:[{code:`P0008`,text:`Ответственный 8`},{code:`P0009`,text:`Ответственный 9`}]}]}]},{code:`R03`,text:`Восточный регион`,branches:[{code:`B0301`,text:`Подразделение Дельта`,teams:[{code:`T0401`,text:`Команда развития`,owners:[{code:`P0010`,text:`Ответственный 10`},{code:`P0011`,text:`Ответственный 11`}]}]},{code:`B0302`,text:`Подразделение Омега`,teams:[{code:`T0501`,text:`Команда качества`,owners:[{code:`P0012`,text:`Ответственный 12`},{code:`P0013`,text:`Ответственный 13`}]}]}]}],l=c.flatMap(e=>e.branches.flatMap(t=>t.teams.flatMap(n=>n.owners.map(r=>({REGION:e.code,REGION_Text:e.text,BRANCH:t.code,BRANCH_Text:t.text,TEAM:n.code,TEAM_Text:n.text,OWNER:r.code,OWNER_Text:r.text})))))}));function d(e,t,n=200){return new Response(e,{status:n,headers:{"Content-Type":t}})}function f(e){return new Promise(t=>{setTimeout(t,e)})}var p,m,h,g,_,v,y,b,x,S,C,w=t((()=>{p=e(n(),1),o(),a(),u(),m=r(),h=`DEMO_REFERENCE_SRV`,g=`DemoReferenceItems`,_=`<?xml version="1.0" encoding="utf-8"?>
+import{c as e,i as t}from"./preload-helper-B45gAKPr.js";import{pn as n,t as r}from"./iframe-BTDZjw05.js";import{D as i,E as a,T as o,w as s}from"./odata-DtsLX2ND.js";var c,l,u=t((()=>{c=[{code:`R01`,text:`Северный регион`,branches:[{code:`B0101`,text:`Подразделение Альфа`,teams:[{code:`T0101`,text:`Команда поддержки`,owners:[{code:`P0001`,text:`Ответственный 1`},{code:`P0002`,text:`Ответственный 2`},{code:`P0003`,text:`Ответственный 3`}]},{code:`T0102`,text:`Команда внедрения`,owners:[{code:`P0004`,text:`Ответственный 4`},{code:`P0005`,text:`Ответственный 5`}]}]},{code:`B0102`,text:`Подразделение Бета`,teams:[{code:`T0201`,text:`Команда аналитики`,owners:[{code:`P0006`,text:`Ответственный 6`},{code:`P0007`,text:`Ответственный 7`}]}]}]},{code:`R02`,text:`Южный регион`,branches:[{code:`B0201`,text:`Подразделение Гамма`,teams:[{code:`T0301`,text:`Команда сопровождения`,owners:[{code:`P0008`,text:`Ответственный 8`},{code:`P0009`,text:`Ответственный 9`}]}]}]},{code:`R03`,text:`Восточный регион`,branches:[{code:`B0301`,text:`Подразделение Дельта`,teams:[{code:`T0401`,text:`Команда развития`,owners:[{code:`P0010`,text:`Ответственный 10`},{code:`P0011`,text:`Ответственный 11`}]}]},{code:`B0302`,text:`Подразделение Омега`,teams:[{code:`T0501`,text:`Команда качества`,owners:[{code:`P0012`,text:`Ответственный 12`},{code:`P0013`,text:`Ответственный 13`}]}]}]}],l=c.flatMap(e=>e.branches.flatMap(t=>t.teams.flatMap(n=>n.owners.map(r=>({REGION:e.code,REGION_Text:e.text,BRANCH:t.code,BRANCH_Text:t.text,TEAM:n.code,TEAM_Text:n.text,OWNER:r.code,OWNER_Text:r.text})))))}));function d(e,t,n=200){return new Response(e,{status:n,headers:{"Content-Type":t}})}function f(e){return new Promise(t=>{setTimeout(t,e)})}var p,m,h,g,_,v,y,b,x,S,C,w=t((()=>{p=e(n(),1),o(),a(),u(),m=r(),h=`DEMO_REFERENCE_SRV`,g=`DemoReferenceItems`,_=`<?xml version="1.0" encoding="utf-8"?>
 <edmx:Edmx xmlns:edmx="http://schemas.microsoft.com/ado/2007/06/edmx">
 	<edmx:DataServices xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" m:DataServiceVersion="2.0">
 		<Schema Namespace="DEMO_REFERENCE_SRV" xmlns="http://schemas.microsoft.com/ado/2008/09/edm" xmlns:sap="http://www.sap.com/Protocols/SAPData">

package/storybook-static/assets/persisted-DBno8ICw.js

@@ -0,0 +1,600 @@
+import{i as e}from"./preload-helper-B45gAKPr.js";import{t}from"./iframe-BTDZjw05.js";import{E as n,c as r,l as i,m as a}from"./blocks-DxtpVRwM.js";import{t as o}from"./mdx-react-shim-CMkpiwEc.js";var s,c=e((()=>{s=`# persisted
+
+Внутренний infrastructural-модуль для переиспользуемой работы с сохранёнными записями: \`variant\`, \`view-config\`, \`preset\` и похожими сущностями.
+
+## Зачем нужен модуль
+
+До выноса общей логики разные доменные API независимо решали один и тот же набор задач:
+
+- строили \`queryKey\`;
+- нормализовали \`scope\`;
+- разбирали JSON payload;
+- подключали \`useQuery\` и \`useMutation\`;
+- инвалидировали кэш после сохранения;
+- оборачивали транспортные детали OData, REST или TanStack Start serverFn.
+
+\`persisted\` собирает этот повтор в один слой, но не пытается унифицировать доменную бизнес-логику.
+
+Модуль специально не знает, что такое variant, view-config или preset. Он знает только:
+
+- у ресурса есть \`scope\`;
+- ресурс может поддерживать часть стандартных операций;
+- операции могут быть реализованы через разный transport;
+- после мутаций нужно применить переиспользуемую cache policy.
+
+## Главная идея
+
+Архитектура строится вокруг descriptor ресурса.
+
+Descriptor описывает:
+
+- идентичность ресурса в кэше;
+- политику нормализации \`scope\`;
+- проверку, что \`scope\` вообще пригоден для выполнения операции;
+- набор capability: \`list\`, \`latest\`, \`history\`, \`save\`, \`create\`, \`delete\`;
+- transport-specific реализацию каждой capability.
+
+Из descriptor затем строятся:
+
+- \`usePersistedListQuery\`
+- \`usePersistedLatestQuery\`
+- \`usePersistedHistoryQuery\`
+- \`usePersistedSaveMutation\`
+- \`usePersistedCreateMutation\`
+- \`usePersistedDeleteMutation\`
+- \`getPersistedListData\`
+- \`getPersistedLatestData\`
+- \`getPersistedHistoryData\`
+
+## Слои модуля
+
+### \`payload.ts\`
+
+Содержит безопасный JSON codec:
+
+- \`parsePersistedJson<T>\`
+- \`stringifyPersistedJson<T>\`
+- \`createPersistedJsonCodec<T>\`
+
+Это deliberate-ограничение: parser принимает только строку или \`null/undefined\`, чтобы нельзя было случайно передать туда весь record.
+
+### \`keys.ts\`
+
+Содержит фабрику \`createPersistedRecordKeys\`.
+
+Она строит ключи по схеме:
+
+\`namespace -> resource -> normalizedScope -> operation -> optionalArgs\`
+
+Нормализация нужна, чтобы:
+
+- trim-ить строки;
+- стабилизировать объекты через сортировку ключей;
+- не плодить разные ключи для эквивалентных scope.
+
+### \`cache.ts\`
+
+Содержит стандартные cache strategy:
+
+- \`createInvalidatePersistedScopeCacheStrategy\`
+- \`createSetPersistedQueryDataCacheStrategy\`
+- \`composePersistedCacheStrategies\`
+
+### \`odata.ts\`
+
+Содержит адаптеры для OData:
+
+- \`createPersistedODataQueryOperation\`
+- \`createPersistedODataMutationOperation\`
+
+### \`rest.ts\`
+
+Содержит адаптеры для обычного REST:
+
+- \`createPersistedRestQueryOperation\`
+- \`createPersistedRestMutationOperation\`
+
+### \`resource.ts\`
+
+Главный orchestration-слой.
+
+Тут живут:
+
+- \`createPersistedResourceDescriptor\`
+- query hooks
+- mutation hooks
+- imperative preload helpers
+
+Именно этот слой связывает:
+
+- descriptor;
+- transport capability;
+- react-query;
+- проверку scope;
+- cache strategy.
+
+### \`../server-fn\`
+
+Соседний слой \`shared/api/server-fn\` содержит переносимые адаптеры для
+TanStack Start server functions:
+
+- \`createServerFnQueryOperation\`
+- \`createServerFnMutationOperation\`
+
+Адаптер не импортирует \`@tanstack/react-start\`. Он знает только публичную
+форму вызова serverFn: \`{ data } -> Promise<response>\`. Благодаря этому общий
+shared-слой можно синхронизировать между SAP/OData SPA и SSR-проектом, а
+конкретный проект выбирает transport на уровне descriptor-а ресурса.
+
+## Capability model
+
+Модуль принципиально не требует полный CRUD.
+
+Ресурс может поддерживать только нужные операции.
+
+Примеры:
+
+- \`viewConfig\` использует \`latest\`, \`history\`, \`save\`
+- \`targetNodePreset\` использует \`list\`, \`save\`
+- \`variantApi\` использует \`list\`, \`save\`, \`create\`, \`delete\`
+
+Если попытаться вызвать хук для capability, которой у descriptor нет, общий слой даст раннюю ошибку.
+
+## Что оставляем вне общего слоя
+
+В \`persisted\` нельзя складывать доменную бизнес-логику.
+
+Снаружи должны оставаться:
+
+- выбор default variant;
+- нормализация конкретного snapshot;
+- пользовательские уведомления;
+- специфичные мутации, например \`setDefault\`;
+- валидация бизнес-правил;
+- подготовка payload, зависящая от доменной модели.
+
+Хорошее правило:
+
+Если код можно описать как «это одинаково для любого ресурса, который хранит записи», его место здесь.
+
+Если код можно описать как «это знание именно про variant/view-config/preset», его место в доменном модуле.
+
+## Быстрый рецепт подключения нового ресурса
+
+1. Определить \`scope\`.
+2. Определить, какие capability реально нужны.
+3. Подобрать transport adapter: OData/REST из \`shared/api/persisted\` или serverFn из \`shared/api/server-fn\`.
+4. Создать descriptor через \`createPersistedResourceDescriptor\`.
+5. Экспортировать доменные хуки-обёртки поверх generic-хуков.
+6. Оставить domain-specific transform, notify и validation вне shared-слоя.
+
+## Пример 1. OData ресурс с \`latest\` и \`save\`
+
+Ниже упрощённый пример в стиле \`viewConfig\`.
+
+\`\`\`ts
+import type { QueryClient } from "@tanstack/react-query";
+
+import { BaseURLType } from "@/shared/api";
+import {
+  createInvalidatePersistedScopeCacheStrategy,
+  createPersistedODataMutationOperation,
+  createPersistedODataQueryOperation,
+  createPersistedResourceDescriptor,
+  getPersistedLatestData,
+  parsePersistedJson,
+  stringifyPersistedJson,
+  usePersistedLatestQuery,
+  usePersistedSaveMutation
+} from "@/shared/api/persisted";
+import { createFilterEqual } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+type ViewConfigScope = {
+  appId: string;
+  viewId: string;
+};
+
+type ViewConfigPayload = {
+  title: string;
+  columns: string[];
+};
+
+type ViewConfigRaw = {
+  id: string;
+  appId: string;
+  viewId: string;
+  payload: string;
+};
+
+type SaveViewConfigInput = {
+  payload: ViewConfigPayload;
+  transportRequest: string;
+};
+
+const SERVICE = "TEXT_CONFIG_SRV";
+const ENTITY = "CONFIG";
+const ENTITY_LATEST = "TEXT_CONFIG_LATEST";
+const SERVICE_BASE_URL: BaseURLType | undefined = __DEV__ ? "odataDp0" : undefined;
+
+const viewConfigResource = createPersistedResourceDescriptor({
+  namespace: "viewConfig",
+  resource: "view",
+  normalizeScope: (scope: ViewConfigScope | null | undefined) => ({
+    appId: scope?.appId?.trim() ?? "",
+    viewId: scope?.viewId?.trim() ?? ""
+  }),
+  isEnabled: (scope) => Boolean(scope?.appId && scope?.viewId),
+  getScopeError: () => "Не удалось выполнить операцию с конфигурацией: scope appId/viewId не задан.",
+  transport: {
+    latest: createPersistedODataQueryOperation<ViewConfigScope, void, ViewConfigRaw[], ViewConfigPayload | null>({
+      odata: { service: SERVICE, target: ENTITY_LATEST },
+      baseUrl: SERVICE_BASE_URL,
+      staleTime: Infinity,
+      gcTime: 1000 * 60 * 60 * 24,
+      buildOptions: (scope) => ({
+        expression: {
+          and: true,
+          filters: [
+            createFilterEqual("appId", scope.appId),
+            createFilterEqual("viewId", scope.viewId)
+          ]
+        }
+      }),
+      transform: (rows) => parsePersistedJson<ViewConfigPayload>(rows[0]?.payload)
+    }),
+    save: createPersistedODataMutationOperation<ViewConfigScope, SaveViewConfigInput, unknown, unknown>({
+      odata: { service: SERVICE, target: ENTITY },
+      baseUrl: SERVICE_BASE_URL,
+      method: "POST",
+      bodyMapper: (scope, input) => ({
+        id: "",
+        appId: scope.appId,
+        viewId: scope.viewId,
+        payload: stringifyPersistedJson(input.payload),
+        transportRequest: input.transportRequest
+      }),
+      cacheStrategy: createInvalidatePersistedScopeCacheStrategy()
+    })
+  }
+});
+
+export function useViewConfigLatestQuery(scope: ViewConfigScope) {
+  return usePersistedLatestQuery<ViewConfigScope, ViewConfigPayload | null>(viewConfigResource, scope);
+}
+
+export function useSaveViewConfigMutation(scope: ViewConfigScope) {
+  return usePersistedSaveMutation<ViewConfigScope, SaveViewConfigInput, unknown>(viewConfigResource, scope);
+}
+
+export async function getViewConfigLatestData(scope: ViewConfigScope, queryClient: QueryClient) {
+  return await getPersistedLatestData<ViewConfigScope, ViewConfigPayload | null>(viewConfigResource, scope, queryClient);
+}
+\`\`\`
+
+### Что здесь важно
+
+- descriptor ничего не знает про UI;
+- payload-parsing остаётся доменным;
+- \`latest\` возвращает уже доменную модель, а не transport envelope;
+- cache strategy задаётся один раз на уровне ресурса.
+
+## Пример 2. SSR ресурс поверх TanStack Start serverFn
+
+Ниже упрощённый вариант для проекта с TanStack Start: descriptor остаётся тем же
+generic-слоем, но transport подключается через serverFn вместо OData.
+
+\`\`\`ts
+import type { QueryClient } from "@tanstack/react-query";
+
+import {
+  createInvalidatePersistedScopeCacheStrategy,
+  createPersistedResourceDescriptor,
+  getPersistedLatestData,
+  usePersistedLatestQuery,
+  usePersistedSaveMutation
+} from "@/shared/api/persisted";
+import {
+  createServerFnMutationOperation,
+  createServerFnQueryOperation
+} from "@/shared/api/server-fn";
+import { getViewConfigServerFn, saveViewConfigServerFn } from "@/server/serverFns";
+
+type ViewConfigScope = {
+  appId: string;
+  viewId: string;
+};
+
+type ViewConfigPayload = {
+  title: string;
+  columns: string[];
+};
+
+type SaveViewConfigInput = {
+  payload: ViewConfigPayload;
+};
+
+const viewConfigResource = createPersistedResourceDescriptor({
+  namespace: "viewConfig",
+  resource: "view",
+  normalizeScope: (scope: ViewConfigScope | null | undefined) => ({
+    appId: scope?.appId?.trim() ?? "",
+    viewId: scope?.viewId?.trim() ?? ""
+  }),
+  isEnabled: (scope) => Boolean(scope?.appId && scope?.viewId),
+  getScopeError: () => "Не удалось выполнить операцию с конфигурацией: scope appId/viewId не задан.",
+  transport: {
+    latest: createServerFnQueryOperation({
+      serverFn: getViewConfigServerFn,
+      buildData: (scope) => scope
+    }),
+    save: createServerFnMutationOperation({
+      serverFn: saveViewConfigServerFn,
+      buildData: (scope, input) => ({
+        ...scope,
+        payload: input.payload
+      }),
+      cacheStrategy: createInvalidatePersistedScopeCacheStrategy()
+    })
+  }
+});
+
+export function useViewConfigLatestQuery(scope: ViewConfigScope) {
+  return usePersistedLatestQuery<ViewConfigScope, ViewConfigPayload | null>(viewConfigResource, scope);
+}
+
+export function useSaveViewConfigMutation(scope: ViewConfigScope) {
+  return usePersistedSaveMutation<ViewConfigScope, SaveViewConfigInput, void>(viewConfigResource, scope);
+}
+
+export async function getViewConfigLatestData(scope: ViewConfigScope, queryClient: QueryClient) {
+  return await getPersistedLatestData<ViewConfigScope, ViewConfigPayload | null>(viewConfigResource, scope, queryClient);
+}
+\`\`\`
+
+### Что здесь важно
+
+- shared API не импортирует \`@tanstack/react-start\`;
+- \`{ data }\` собирается в \`buildData\`, а не размазывается по UI/hooks;
+- cache strategy остаётся общей для OData и SSR transport.
+
+## Пример 3. REST ресурс с \`list\` и \`save\`
+
+Ниже упрощённый пример в стиле \`targetNodePreset\`.
+
+\`\`\`ts
+import {
+  createInvalidatePersistedScopeCacheStrategy,
+  createPersistedResourceDescriptor,
+  createPersistedRestMutationOperation,
+  createPersistedRestQueryOperation,
+  parsePersistedJson,
+  usePersistedListQuery,
+  usePersistedSaveMutation
+} from "@/shared/api/persisted";
+
+type ConfigPresetScope = {
+  userId: string;
+};
+
+type TargetNodePayload = {
+  name: string;
+  description: string;
+  type: string;
+  config: unknown;
+};
+
+type ConfigPresetRecord = {
+  recId: string;
+  cfgType: string;
+  userId: string;
+  payload: string;
+  crtUtc: string;
+};
+
+type ConfigPresetsResponse = {
+  data: ConfigPresetRecord[] | null;
+  meta: {
+    limit: number;
+    offset: number;
+  };
+};
+
+type TargetNodePreset = {
+  recId: string;
+  cfgType: "target_node_preset";
+  userId: string;
+  payload: TargetNodePayload;
+  crtUtc: string;
+};
+
+type TargetNodePresetInput = {
+  payload: TargetNodePayload;
+};
+
+const BASE = "/api/config-presets";
+const CFG_TYPE = "target_node_preset" as const;
+
+const targetNodePresetResource = createPersistedResourceDescriptor({
+  namespace: "view-config",
+  resource: CFG_TYPE,
+  normalizeScope: (scope: ConfigPresetScope | null | undefined) => ({
+    userId: scope?.userId?.trim() ?? ""
+  }),
+  isEnabled: (scope) => Boolean(scope?.userId?.trim()),
+  getScopeError: () => "Не удалось выполнить операцию с пресетом узла: userId не задан.",
+  transport: {
+    list: createPersistedRestQueryOperation<
+      ConfigPresetScope,
+      void,
+      ConfigPresetsResponse,
+      TargetNodePreset[]
+    >({
+      buildUrl: (scope) => \`\${BASE}/list?cfgType=\${CFG_TYPE}&userId=\${scope.userId}\`,
+      transform: (response) =>
+        (response.data ?? []).flatMap((record) => {
+          const payload = parsePersistedJson<TargetNodePayload>(record.payload);
+          return payload
+            ? [{
+                ...record,
+                cfgType: CFG_TYPE,
+                payload
+              }]
+            : [];
+        })
+    }),
+    save: createPersistedRestMutationOperation<
+      ConfigPresetScope,
+      TargetNodePresetInput,
+      { data: ConfigPresetRecord | null },
+      ConfigPresetRecord | null
+    >({
+      buildUrl: () => BASE,
+      method: "PUT",
+      bodyMapper: (scope, input) => ({
+        cfgType: CFG_TYPE,
+        userId: scope.userId,
+        payload: input.payload
+      }),
+      transform: (response) => response.data,
+      cacheStrategy: createInvalidatePersistedScopeCacheStrategy()
+    })
+  }
+});
+
+export function useTargetNodePresetsQuery(scope: ConfigPresetScope | null | undefined) {
+  return usePersistedListQuery<ConfigPresetScope, TargetNodePreset[]>(targetNodePresetResource, scope);
+}
+
+export function useTargetNodePresetMutation(scope: ConfigPresetScope | null | undefined) {
+  return usePersistedSaveMutation<ConfigPresetScope, TargetNodePresetInput, ConfigPresetRecord | null>(
+    targetNodePresetResource,
+    scope
+  );
+}
+\`\`\`
+
+### Что здесь важно
+
+- один и тот же orchestration-слой работает и для REST, и для OData;
+- \`scope.userId\` участвует и в query key, и в \`enabled\`, и в request body;
+- invalidation остаётся общей политикой, а не копипастой по модулям.
+
+## Когда использовать \`invalidate\`, а когда \`setQueryData\`
+
+### Выбирать \`createInvalidatePersistedScopeCacheStrategy\`, если:
+
+- мутация влияет на несколько query одного scope;
+- backend не возвращает достаточно данных для точного обновления;
+- важнее надёжность, чем микрооптимизация.
+
+### Выбирать \`createSetPersistedQueryDataCacheStrategy\`, если:
+
+- нужно быстро обновить один конкретный query;
+- мутация возвращает уже готовую доменную модель;
+- есть уверенность, что не появится рассинхронизация с другими query.
+
+### Выбирать \`composePersistedCacheStrategies\`, если:
+
+- нужно совместить адресное обновление и более широкую инвалидацию;
+- ресурс одновременно обновляет \`latest\` и \`history\`.
+
+## Scope policy
+
+Для каждого ресурса важно отдельно определить:
+
+- как нормализуется scope;
+- когда scope считается валидным;
+- какое сообщение вернуть при невалидном scope.
+
+Рекомендуемый подход:
+
+\`\`\`ts
+normalizeScope: (scope) => ({
+  appId: scope?.appId?.trim() ?? "",
+  viewId: scope?.viewId?.trim() ?? ""
+}),
+isEnabled: (scope) => Boolean(scope?.appId && scope?.viewId),
+getScopeError: () => "Не удалось выполнить операцию: scope appId/viewId не задан."
+\`\`\`
+
+Это даёт сразу три выигрыша:
+
+- одинаковые query key для эквивалентных scope;
+- отсутствие сетевых запросов при неполном scope;
+- понятную ошибку, если мутация всё же была вызвана.
+
+## Рекомендации по проектированию
+
+### Делайте \`transform\` доменным
+
+Хорошо:
+
+- \`transform: (rows) => parsePersistedJson<ViewConfigPayload>(rows[0]?.payload)\`
+- \`transform: (rows) => rows.map(mapVariantRecord)\`
+
+Плохо:
+
+- переносить в shared-слой знание о \`variantId\`, \`isDefault\`, \`cfgType\`, \`transportRequest\`
+
+### Не выносите отдельные бизнес-операции в общий CRUD
+
+Например:
+
+- \`setDefaultVariant\`
+- \`publishVariant\`
+- \`duplicatePreset\`
+
+Если операция не является обычным \`save/create/delete\`, лучше оставить её доменной мутацией, но при желании переиспользовать \`descriptor.keys.scope(...)\` и общие cache strategy.
+
+### Не заставляйте ресурс поддерживать лишние capability
+
+Если backend умеет только \`latest\` и \`save\`, так и описывайте.
+
+Capability-based модель нужна именно для того, чтобы не строить фальшивый универсальный CRUD.
+
+## Тестирование
+
+Модуль рассчитан на два уровня тестов:
+
+### 1. Тесты shared-слоя
+
+Проверяют:
+
+- codec;
+- key generation;
+- transport adapters;
+- cache strategies.
+
+### 2. Тесты доменного подключения
+
+Проверяют:
+
+- корректный raw -> domain mapping;
+- защиту от битого payload;
+- специфичные scope policy;
+- контракт возвращаемых данных доменного API.
+
+Именно такое разделение сейчас используется в репозитории.
+
+## Ограничения модуля
+
+- модуль не заменяет domain layer;
+- модуль не решает transport-specific business rules backend;
+- модуль не хранит схемы payload и не валидирует их содержимое;
+- модуль не синтезирует сложные optimistic update сам по себе.
+
+Если ресурсу нужна сложная бизнес-валидация или нестандартная синхронизация, это должно остаться в доменном коде поверх shared-слоя.
+
+## Чек-лист для нового ресурса
+
+- Есть ли у ресурса стабильный \`scope\`?
+- Нужно ли нормализовать строки и идентификаторы?
+- Какие capability действительно нужны?
+- Подходит OData adapter или пока нужен REST adapter?
+- Можно ли после мутации ограничиться \`invalidate(scope)\`?
+- Возвращает ли query уже доменную модель без transport envelope?
+- Вынесена ли доменная бизнес-логика за пределы \`persisted\`?
+
+Если на все вопросы есть понятный ответ, ресурс почти наверняка хорошо ложится на этот модуль.
+`}));function l(e){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(i,{title:`Документация/shared/api/persisted`}),`
+`,(0,d.jsx)(r,{children:s})]})}function u(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,d.jsx)(t,{...e,children:(0,d.jsx)(l,{...e})}):l(e)}var d;e((()=>{d=t(),o(),a(),c()}))();export{u as default};

package/storybook-static/assets/{picker-BF69i-Xf.js → picker-BekQHdO_.js}

@@ -1,2 +1,2 @@
-import{c as e,i as t}from"./preload-helper-B45gAKPr.js";import{Ct as n,n as r,pn as i,t as a}from"./iframe-8yiaZsxV.js";import{a as o,i as s}from"./utils-CecGsBKu.js";import{et as c,t as l}from"./formatters-DR4SipYU.js";import{n as u,r as d,t as f}from"./floating-ui.react-Cgv_gdpO.js";import{n as p,t as m}from"./ui.module-wFHXkJzp.js";import{a as ee,n as te,t as ne}from"./react-v2wz2Yxr.js";import{l as re,o as h,r as g,u as _}from"./Input-DQV1VhD-.js";import{t as v}from"./input-BDfX2ZJN.js";import{t as y}from"./Grid-9nPVBakE.js";import{t as ie}from"./grid-Clv9wted.js";import{r as b,t as x}from"./hooks-CksDwali.js";function S({id:e,label:t,description:n,disabled:r,size:i,className:a,error:o,children:s}){let{controlId:c,labelId:l,descriptionId:u,errorId:d,describedBy:f}=_({id:e,hasLabel:t!=null,hasDescription:!!n,hasError:!!o});return(0,ae.jsx)(h,{label:t,description:n,disabled:r,size:i,className:a,error:o,controlId:c,labelId:l,descriptionId:u,errorId:d,children:s({controlId:c,labelId:l,descriptionId:u,errorId:d,describedBy:f})})}var ae,oe=t((()=>{v(),re(),ae=a(),S.__docgenInfo={description:``,methods:[],displayName:`PickerField`,props:{id:{required:!1,tsType:{name:`string`},description:``},className:{required:!1,tsType:{name:`string`},description:``},error:{required:!1,tsType:{name:`string`},description:``},children:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(context: PickerFieldContext) => ReactNode`,signature:{arguments:[{type:{name:`PickerFieldContext`},name:`context`}],return:{name:`ReactNode`}}},description:``}},composes:[`Omit`]}})),se,C,ce=t((()=>{se=e(i(),1),C=({as:e,children:t,...n})=>(0,se.createElement)(e||`div`,{...n},t),C.__docgenInfo={description:``,methods:[],displayName:`PolymorphicComponent`,props:{as:{required:!1,tsType:{name:`E`},description:``}}}})),le=t((()=>{ce()})),w,T,E=t((()=>{i(),s(),le(),w=a(),T=({as:e,orientation:t=`horizontal`,className:n,...r})=>(0,w.jsx)(C,{as:e,"aria-orientation":t,className:o(n,t===`horizontal`?`separator`:`separatorVertical`),...r}),T.__docgenInfo={description:``,methods:[],displayName:`Separator`,props:{as:{required:!1,tsType:{name:`E`},description:``},orientation:{required:!1,tsType:{name:`union`,raw:`"horizontal" | "vertical"`,elements:[{name:`literal`,value:`"horizontal"`},{name:`literal`,value:`"vertical"`}]},description:``,defaultValue:{value:`"horizontal"`,computed:!1}},className:{required:!1,tsType:{name:`string`},description:``}}}})),D=t((()=>{E()})),O,k,A,j,M,N,P,F=t((()=>{O=`DRJ4hy`,k=`U4CULi`,A=`bupTWA`,j=`GkeyGF`,M=`_8F667e`,N=`OGMk6I`,P={popupLayout:O,popupBody:k,status:A,statusError:j,triggerContainer:M,selectionActionButton:N}}));function ue(e){e.stopPropagation()}function I({open:e,context:t,floatingStyles:n,listId:r,labelId:i,popupAriaLabel:a,descriptionId:s,activeOptionId:c,ariaMultiselectable:l,popupRole:d=`listbox`,setFloating:p,getFloatingProps:m,onKeyDown:ne,initialFocus:re=-1,returnFocus:h=!1,tabIndex:g=0,className:_,maxWidth:v,layoutClassName:y,headerClassName:ie,bodyClassName:b,header:x,children:S}){return(0,L.jsx)(ee,{children:e&&(0,L.jsx)(u,{children:(0,L.jsx)(f,{context:t,modal:!1,initialFocus:re,returnFocus:h,children:(0,L.jsx)(te.div,{ref:p,style:{...n,maxWidth:v},initial:{opacity:0,scale:.95},animate:{opacity:1,scale:1},exit:{opacity:0,scale:.95},...m({id:r,role:d,tabIndex:g,"aria-labelledby":i,"aria-label":i?void 0:a,"aria-describedby":s,"aria-activedescendant":c,"aria-multiselectable":l||void 0,onMouseDown:ue,onKeyDown:ne,className:_}),children:(0,L.jsxs)(`div`,{className:o(P.popupLayout,y),children:[x?(0,L.jsxs)(`div`,{className:ie,children:[x,(0,L.jsx)(T,{className:`marginBlockSm`})]}):(0,L.jsx)(`div`,{}),(0,L.jsx)(`div`,{className:o(P.popupBody,b),children:S})]})})})})})}var L,R=t((()=>{d(),s(),ne(),D(),F(),L=a(),I.__docgenInfo={description:``,methods:[],displayName:`PickerPopup`,props:{open:{required:!0,tsType:{name:`boolean`},description:``},context:{required:!0,tsType:{name:`FloatingContext`},description:``},floatingStyles:{required:!0,tsType:{name:`CSSProperties`},description:``},listId:{required:!0,tsType:{name:`string`},description:``},labelId:{required:!1,tsType:{name:`string`},description:``},popupAriaLabel:{required:!1,tsType:{name:`string`},description:``},descriptionId:{required:!1,tsType:{name:`string`},description:``},activeOptionId:{required:!1,tsType:{name:`string`},description:``},ariaMultiselectable:{required:!1,tsType:{name:`boolean`},description:``},popupRole:{required:!1,tsType:{name:`union`,raw:`"listbox" | "dialog"`,elements:[{name:`literal`,value:`"listbox"`},{name:`literal`,value:`"dialog"`}]},description:``,defaultValue:{value:`"listbox"`,computed:!1}},setFloating:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(node: HTMLElement | null) => void`,signature:{arguments:[{type:{name:`union`,raw:`HTMLElement | null`,elements:[{name:`HTMLElement`},{name:`null`}]},name:`node`}],return:{name:`void`}}},description:``},getFloatingProps:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(userProps?: Record<string, unknown>) => Record<string, unknown>`,signature:{arguments:[{type:{name:`Record`,elements:[{name:`string`},{name:`unknown`}],raw:`Record<string, unknown>`},name:`userProps`}],return:{name:`Record`,elements:[{name:`string`},{name:`unknown`}],raw:`Record<string, unknown>`}}},description:``},onKeyDown:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(event: KeyboardEvent<HTMLElement>) => void`,signature:{arguments:[{type:{name:`KeyboardEvent`,elements:[{name:`HTMLElement`}],raw:`KeyboardEvent<HTMLElement>`},name:`event`}],return:{name:`void`}}},description:``},initialFocus:{required:!1,tsType:{name:`number`},description:``,defaultValue:{value:`-1`,computed:!1}},returnFocus:{required:!1,tsType:{name:`boolean`},description:``,defaultValue:{value:`false`,computed:!1}},tabIndex:{required:!1,tsType:{name:`number`},description:``,defaultValue:{value:`0`,computed:!1}},className:{required:!1,tsType:{name:`string`},description:``},maxWidth:{required:!1,tsType:{name:`CSSProperties["maxWidth"]`,raw:`CSSProperties["maxWidth"]`},description:``},layoutClassName:{required:!1,tsType:{name:`string`},description:``},headerClassName:{required:!1,tsType:{name:`string`},description:``},bodyClassName:{required:!1,tsType:{name:`string`},description:``},header:{required:!1,tsType:{name:`ReactNode`},description:``},children:{required:!0,tsType:{name:`ReactNode`},description:``}}}}));function z({onSelectAll:e,onDeselectAll:t,selectAllButtonRef:n}){return(0,B.jsxs)(y.Container,{gap:`xs`,templateColumns:`1fr 1fr`,children:[(0,B.jsx)(`button`,{ref:n,type:`button`,className:P.selectionActionButton,onClick:e,"data-ui":`picker-select-all`,"data-action":`select-all`,children:`Выбрать все`}),(0,B.jsx)(`button`,{type:`button`,className:P.selectionActionButton,onClick:t,"data-ui":`picker-deselect-all`,"data-action":`deselect-all`,children:`Снять выбор`})]})}var B,V=t((()=>{ie(),F(),B=a(),z.__docgenInfo={description:`Общая панель массовых действий для picker-компонентов с множественным выбором.
+import{c as e,i as t}from"./preload-helper-B45gAKPr.js";import{Ct as n,n as r,pn as i,t as a}from"./iframe-BTDZjw05.js";import{a as o,i as s}from"./utils-C8AvFbMG.js";import{et as c,t as l}from"./formatters-BsP6CA0a.js";import{n as u,r as d,t as f}from"./floating-ui.react-C3rg5XLp.js";import{n as p,t as m}from"./ui.module-wFHXkJzp.js";import{a as ee,n as te,t as ne}from"./react-_DDQf-KJ.js";import{l as re,o as h,r as g,u as _}from"./Input-B0WWnS8-.js";import{t as v}from"./input-DD29rPF2.js";import{t as y}from"./Grid-BNqNouvQ.js";import{t as ie}from"./grid-nZIniTeh.js";import{r as b,t as x}from"./hooks-CVLEDvfo.js";function S({id:e,label:t,description:n,disabled:r,size:i,className:a,error:o,children:s}){let{controlId:c,labelId:l,descriptionId:u,errorId:d,describedBy:f}=_({id:e,hasLabel:t!=null,hasDescription:!!n,hasError:!!o});return(0,ae.jsx)(h,{label:t,description:n,disabled:r,size:i,className:a,error:o,controlId:c,labelId:l,descriptionId:u,errorId:d,children:s({controlId:c,labelId:l,descriptionId:u,errorId:d,describedBy:f})})}var ae,oe=t((()=>{v(),re(),ae=a(),S.__docgenInfo={description:``,methods:[],displayName:`PickerField`,props:{id:{required:!1,tsType:{name:`string`},description:``},className:{required:!1,tsType:{name:`string`},description:``},error:{required:!1,tsType:{name:`string`},description:``},children:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(context: PickerFieldContext) => ReactNode`,signature:{arguments:[{type:{name:`PickerFieldContext`},name:`context`}],return:{name:`ReactNode`}}},description:``}},composes:[`Omit`]}})),se,C,ce=t((()=>{se=e(i(),1),C=({as:e,children:t,...n})=>(0,se.createElement)(e||`div`,{...n},t),C.__docgenInfo={description:``,methods:[],displayName:`PolymorphicComponent`,props:{as:{required:!1,tsType:{name:`E`},description:``}}}})),le=t((()=>{ce()})),w,T,E=t((()=>{i(),s(),le(),w=a(),T=({as:e,orientation:t=`horizontal`,className:n,...r})=>(0,w.jsx)(C,{as:e,"aria-orientation":t,className:o(n,t===`horizontal`?`separator`:`separatorVertical`),...r}),T.__docgenInfo={description:``,methods:[],displayName:`Separator`,props:{as:{required:!1,tsType:{name:`E`},description:``},orientation:{required:!1,tsType:{name:`union`,raw:`"horizontal" | "vertical"`,elements:[{name:`literal`,value:`"horizontal"`},{name:`literal`,value:`"vertical"`}]},description:``,defaultValue:{value:`"horizontal"`,computed:!1}},className:{required:!1,tsType:{name:`string`},description:``}}}})),D=t((()=>{E()})),O,k,A,j,M,N,P,F=t((()=>{O=`DRJ4hy`,k=`U4CULi`,A=`bupTWA`,j=`GkeyGF`,M=`_8F667e`,N=`OGMk6I`,P={popupLayout:O,popupBody:k,status:A,statusError:j,triggerContainer:M,selectionActionButton:N}}));function ue(e){e.stopPropagation()}function I({open:e,context:t,floatingStyles:n,listId:r,labelId:i,popupAriaLabel:a,descriptionId:s,activeOptionId:c,ariaMultiselectable:l,popupRole:d=`listbox`,setFloating:p,getFloatingProps:m,onKeyDown:ne,initialFocus:re=-1,returnFocus:h=!1,tabIndex:g=0,className:_,maxWidth:v,layoutClassName:y,headerClassName:ie,bodyClassName:b,header:x,children:S}){return(0,L.jsx)(ee,{children:e&&(0,L.jsx)(u,{children:(0,L.jsx)(f,{context:t,modal:!1,initialFocus:re,returnFocus:h,children:(0,L.jsx)(te.div,{ref:p,style:{...n,maxWidth:v},initial:{opacity:0,scale:.95},animate:{opacity:1,scale:1},exit:{opacity:0,scale:.95},...m({id:r,role:d,tabIndex:g,"aria-labelledby":i,"aria-label":i?void 0:a,"aria-describedby":s,"aria-activedescendant":c,"aria-multiselectable":l||void 0,onMouseDown:ue,onKeyDown:ne,className:_}),children:(0,L.jsxs)(`div`,{className:o(P.popupLayout,y),children:[x?(0,L.jsxs)(`div`,{className:ie,children:[x,(0,L.jsx)(T,{className:`marginBlockSm`})]}):(0,L.jsx)(`div`,{}),(0,L.jsx)(`div`,{className:o(P.popupBody,b),children:S})]})})})})})}var L,R=t((()=>{d(),s(),ne(),D(),F(),L=a(),I.__docgenInfo={description:``,methods:[],displayName:`PickerPopup`,props:{open:{required:!0,tsType:{name:`boolean`},description:``},context:{required:!0,tsType:{name:`FloatingContext`},description:``},floatingStyles:{required:!0,tsType:{name:`CSSProperties`},description:``},listId:{required:!0,tsType:{name:`string`},description:``},labelId:{required:!1,tsType:{name:`string`},description:``},popupAriaLabel:{required:!1,tsType:{name:`string`},description:``},descriptionId:{required:!1,tsType:{name:`string`},description:``},activeOptionId:{required:!1,tsType:{name:`string`},description:``},ariaMultiselectable:{required:!1,tsType:{name:`boolean`},description:``},popupRole:{required:!1,tsType:{name:`union`,raw:`"listbox" | "dialog"`,elements:[{name:`literal`,value:`"listbox"`},{name:`literal`,value:`"dialog"`}]},description:``,defaultValue:{value:`"listbox"`,computed:!1}},setFloating:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(node: HTMLElement | null) => void`,signature:{arguments:[{type:{name:`union`,raw:`HTMLElement | null`,elements:[{name:`HTMLElement`},{name:`null`}]},name:`node`}],return:{name:`void`}}},description:``},getFloatingProps:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(userProps?: Record<string, unknown>) => Record<string, unknown>`,signature:{arguments:[{type:{name:`Record`,elements:[{name:`string`},{name:`unknown`}],raw:`Record<string, unknown>`},name:`userProps`}],return:{name:`Record`,elements:[{name:`string`},{name:`unknown`}],raw:`Record<string, unknown>`}}},description:``},onKeyDown:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(event: KeyboardEvent<HTMLElement>) => void`,signature:{arguments:[{type:{name:`KeyboardEvent`,elements:[{name:`HTMLElement`}],raw:`KeyboardEvent<HTMLElement>`},name:`event`}],return:{name:`void`}}},description:``},initialFocus:{required:!1,tsType:{name:`number`},description:``,defaultValue:{value:`-1`,computed:!1}},returnFocus:{required:!1,tsType:{name:`boolean`},description:``,defaultValue:{value:`false`,computed:!1}},tabIndex:{required:!1,tsType:{name:`number`},description:``,defaultValue:{value:`0`,computed:!1}},className:{required:!1,tsType:{name:`string`},description:``},maxWidth:{required:!1,tsType:{name:`CSSProperties["maxWidth"]`,raw:`CSSProperties["maxWidth"]`},description:``},layoutClassName:{required:!1,tsType:{name:`string`},description:``},headerClassName:{required:!1,tsType:{name:`string`},description:``},bodyClassName:{required:!1,tsType:{name:`string`},description:``},header:{required:!1,tsType:{name:`ReactNode`},description:``},children:{required:!0,tsType:{name:`ReactNode`},description:``}}}}));function z({onSelectAll:e,onDeselectAll:t,selectAllButtonRef:n}){return(0,B.jsxs)(y.Container,{gap:`xs`,templateColumns:`1fr 1fr`,children:[(0,B.jsx)(`button`,{ref:n,type:`button`,className:P.selectionActionButton,onClick:e,"data-ui":`picker-select-all`,"data-action":`select-all`,children:`Выбрать все`}),(0,B.jsx)(`button`,{type:`button`,className:P.selectionActionButton,onClick:t,"data-ui":`picker-deselect-all`,"data-action":`deselect-all`,children:`Снять выбор`})]})}var B,V=t((()=>{ie(),F(),B=a(),z.__docgenInfo={description:`Общая панель массовых действий для picker-компонентов с множественным выбором.
 Компонент не знает формат значения и делегирует изменение владельцу selection-модели.`,methods:[],displayName:`PickerSelectionToolbar`,props:{onSelectAll:{required:!0,tsType:{name:`signature`,type:`function`,raw:`() => void`,signature:{arguments:[],return:{name:`void`}}},description:``},onDeselectAll:{required:!0,tsType:{name:`signature`,type:`function`,raw:`() => void`,signature:{arguments:[],return:{name:`void`}}},description:``},selectAllButtonRef:{required:!1,tsType:{name:`Ref`,elements:[{name:`HTMLButtonElement`}],raw:`Ref<HTMLButtonElement>`},description:``}}}}));function H({emptyState:e,loadingState:t,errorState:n}){let r=n??t??e;return r==null?null:(0,U.jsx)(`div`,{className:o(p.uiPopupOption,P.status,n!==void 0&&P.statusError),"aria-disabled":!0,children:r})}var U,W=t((()=>{s(),m(),F(),U=a(),H.__docgenInfo={description:``,methods:[],displayName:`PickerStatus`,props:{emptyState:{required:!1,tsType:{name:`ReactNode`},description:``},loadingState:{required:!1,tsType:{name:`ReactNode`},description:``},errorState:{required:!1,tsType:{name:`ReactNode`},description:``}}}}));function G({open:e,disabled:t,children:r,onToggleMouseDown:i,onToggleClick:a,openAriaLabel:s=`Открыть список`,closeAriaLabel:c=`Закрыть список`}){return(0,K.jsxs)(`div`,{className:p.uiToggleButtonContainer,"data-disabled":t||void 0,children:[r,(0,K.jsx)(`div`,{className:p.uiButtonSeparator}),(0,K.jsx)(`button`,{type:`button`,"aria-label":e?c:s,className:p.uiToggleButton,onMouseDown:i,onClick:a,children:(0,K.jsx)(n,{className:o(p.uiToggleIcon,e&&p.uiToggleIconOpen)})})]})}var K,de=t((()=>{s(),r(),m(),K=a(),G.__docgenInfo={description:``,methods:[],displayName:`PickerTriggerActions`,props:{open:{required:!0,tsType:{name:`boolean`},description:``},disabled:{required:!1,tsType:{name:`boolean`},description:``},children:{required:!1,tsType:{name:`ReactNode`},description:``},onToggleMouseDown:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(event: MouseEvent<HTMLButtonElement>) => void`,signature:{arguments:[{type:{name:`MouseEvent`,elements:[{name:`HTMLButtonElement`}],raw:`MouseEvent<HTMLButtonElement>`},name:`event`}],return:{name:`void`}}},description:``},onToggleClick:{required:!0,tsType:{name:`signature`,type:`function`,raw:`() => void`,signature:{arguments:[],return:{name:`void`}}},description:``},openAriaLabel:{required:!1,tsType:{name:`string`},description:``,defaultValue:{value:`"Открыть список"`,computed:!1}},closeAriaLabel:{required:!1,tsType:{name:`string`},description:``,defaultValue:{value:`"Закрыть список"`,computed:!1}}}}})),fe,q,J,pe=t((()=>{fe=e(i(),1),s(),v(),m(),F(),q=a(),J=(0,fe.forwardRef)(({rootRef:e,endAdornment:t,overlay:n,rootClassName:r,inputClassName:i,...a},s)=>(0,q.jsxs)(`div`,{ref:e,className:o(p.uiInputContainer,P.triggerContainer,r),children:[(0,q.jsx)(g,{endAdornment:t,children:({controlClassName:e})=>(0,q.jsx)(`input`,{...a,ref:s,className:o(p.uiInputWithToggle,e,i)})}),n]})),J.displayName=`PickerTriggerInput`,J.__docgenInfo={description:``,methods:[],displayName:`PickerTriggerInput`,props:{rootRef:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(node: HTMLDivElement | null) => void`,signature:{arguments:[{type:{name:`union`,raw:`HTMLDivElement | null`,elements:[{name:`HTMLDivElement`},{name:`null`}]},name:`node`}],return:{name:`void`}}},description:``},endAdornment:{required:!1,tsType:{name:`ReactNode`},description:``},overlay:{required:!1,tsType:{name:`ReactNode`},description:``},rootClassName:{required:!1,tsType:{name:`string`},description:``},inputClassName:{required:!1,tsType:{name:`string`},description:``}},composes:[`Omit`]}})),me=t((()=>{}));function Y(e){switch(e){case`search-single`:return{focusFloatingOnOpen:!1,restoreFocusOnClose:!1,resetQueryOnClose:!0,shouldOpenOnTriggerClick:()=>!1,shouldOpenOnInputChange:e=>!e,shouldFocusReferenceOnToggle:e=>!e,shouldSelectTriggerTextOnFocus:({open:e,currentQuery:t,hasDisplayValue:n})=>!e&&t.length===0&&n};case`search-multi`:return{focusFloatingOnOpen:!1,restoreFocusOnClose:!1,resetQueryOnClose:!0,shouldOpenOnTriggerClick:()=>!1,shouldOpenOnInputChange:e=>!e,shouldFocusReferenceOnToggle:e=>!e,shouldSelectTriggerTextOnFocus:()=>!1};default:return{focusFloatingOnOpen:!0,restoreFocusOnClose:!0,resetQueryOnClose:!1,shouldOpenOnTriggerClick:e=>!e,shouldOpenOnInputChange:()=>!1,shouldFocusReferenceOnToggle:()=>!1,shouldSelectTriggerTextOnFocus:()=>!1}}}var X=t((()=>{}));function he(e){if(typeof e==`string`||typeof e==`number`)return String(e);if(Array.isArray(e)){let t=e.map(he).filter(e=>!!e);return t.length?t.join(` `):void 0}}var ge=t((()=>{}));function _e(e){return c((Array.isArray(e)?e:[e]).filter(Boolean).join(` `))}function ve({options:e,query:t,enabled:n=!0,getSearchText:r}){let i=c(t);return(0,ye.useMemo)(()=>!n||!i?[...e]:e.filter(e=>_e(r(e)).includes(i)),[n,r,i,e])}var ye,be=t((()=>{ye=e(i(),1),l()}));function xe(e){let t=e.triggerMode?Y(e.triggerMode):void 0;return x({...e,focusFloatingOnOpen:e.focusFloatingOnOpen??t?.focusFloatingOnOpen,restoreFocusOnClose:e.restoreFocusOnClose??t?.restoreFocusOnClose})}var Se=t((()=>{b(),X()}));function Ce({open:e,query:t,defaultQuery:n,onQuery:r,resetOnClose:i,triggerMode:a}){let o=(0,Z.useRef)(!1),s=t!==void 0,[c,l]=(0,Z.useState)(n??``),u=s?t??``:c,d=(0,Z.useEffectEvent)(()=>l(``)),f=i??(a?Y(a).resetQueryOnClose:!0);(0,Z.useEffect)(()=>{o.current&&!e&&f&&(s||d(),r?.(``)),o.current=e},[s,r,e,f]);let p=e=>{s||l(e),r?.(e)};return{query:u,setQuery:p,clearQuery:()=>p(``)}}var Z,we=t((()=>{Z=e(i(),1),X()}));function Te({value:e,open:t,onCommit:n,onOpen:r,onClose:i,isEqual:a}){let o=(0,Q.useRef)(!1),[s,c]=(0,Q.useState)(e),l=(0,Q.useEffectEvent)(e=>c(e));return(0,Q.useEffect)(()=>{t||l(e)},[t,e]),(0,Q.useEffect)(()=>{o.current&&!t&&(a(s,e)||n(s),i?.(s)),o.current=t},[s,a,i,n,t,e]),{draftValue:s,setDraftValue:c,prepareOpen:()=>{c(e),r?.()}}}var Q,Ee=t((()=>{Q=e(i(),1)}));function De(e){requestAnimationFrame(()=>{e.current?.focus()})}function Oe({mode:e,open:t,currentQuery:n,hasDisplayValue:r,inputRef:i,setQuery:a,openList:o,close:s,toggleOpen:c,onBeforeOpen:l}){let u=Y(e),d=()=>{if(l?.(),o){o();return}c?.()},f=()=>{if(s){s();return}c?.()},p=()=>{t?f():d(),u.shouldFocusReferenceOnToggle(t)&&De(i)};return{policy:u,handleTriggerInputChange:e=>{a?.(e),u.shouldOpenOnInputChange(t)&&d()},handleTriggerClick:()=>{u.shouldOpenOnTriggerClick(t)&&d()},handleTriggerFocus:e=>{u.shouldSelectTriggerTextOnFocus({open:t,currentQuery:n,hasDisplayValue:r})&&requestAnimationFrame(()=>{e.select()})},handleToggleMouseDown:e=>{e.preventDefault()},handleToggleClick:()=>{p()},handleTriggerKeyDown:({event:e,onActivateWhenOpen:n,enableSpaceActivation:r=!1,enableClosedArrowDownOpen:i=!1,suppressClosedArrowUp:a=!1})=>{if(!t&&a&&e.key===`ArrowUp`){e.preventDefault();return}if(!t&&i&&e.key===`ArrowDown`){e.preventDefault(),p();return}if(e.key===`Enter`){e.preventDefault(),t?n?.():p();return}r&&e.key===` `&&(e.preventDefault(),t?n?.():p())},toggleTrigger:p}}var $=t((()=>{X()})),ke=t((()=>{X(),ge(),be(),Se(),we(),Ee(),$()})),Ae=t((()=>{oe(),R(),V(),W(),de(),pe(),me(),ke()}));export{R as C,S as D,E,oe as O,I as S,T,de as _,Te as a,z as b,Se as c,ve as d,he as f,G as g,pe as h,Ee as i,xe as l,J as m,$ as n,we as o,ge as p,Oe as r,Ce as s,Ae as t,be as u,H as v,D as w,V as x,W as y};