@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

package/storybook-static/assets/{Popover.stories-CUOFA_Xf.js → Popover.stories-CIyDUtlz.js}

@@ -1,4 +1,4 @@
-import{n as e,r as t}from"./rolldown-runtime-DkW27tQK.js";import{t as n}from"./react-BZJXY1be.js";import{n as r}from"./iframe-Sr0umHM6.js";import{n as i,t as a}from"./Popover-NJwt_vZZ.js";import{n as o,t as s}from"./Button-CrTHXWYk.js";import{n as c,t as l}from"./createControlledStoryRender-BouhvX-R.js";import{l as u,t as d}from"./Input-op4j7Beh.js";var f=t({AnchorPlacement:()=>w,Controlled:()=>C,Default:()=>S,WithInteractiveContent:()=>T,__namedExportsOrder:()=>E,default:()=>x});function p({args:e,updateArgs:t,trigger:n,children:r}){return(0,_.jsxs)(a,{placement:e.placement,open:e.open,defaultOpen:e.defaultOpen,onOpenChange:n=>{e.onOpenChange?.(n),t({open:n})},children:[(0,_.jsx)(a.Trigger,{passive:e.passive,children:n(e.open===!0)}),(0,_.jsx)(a.Content,{onClose:()=>e.onClose?.(),closeOnOutside:e.closeOnOutside,closeOnEscape:e.closeOnEscape,disableOutsideClick:e.disableOutsideClick,background:e.background,children:r})]})}function m(e,t){return l((n,r)=>(0,_.jsx)(p,{args:n,updateArgs:r,trigger:e,children:t}))}function h({args:e,updateArgs:t}){let[n,r]=(0,g.useState)(``);return(0,_.jsx)(p,{args:e,updateArgs:t,trigger:()=>(0,_.jsx)(`button`,{type:`button`,children:`Форма`}),children:e=>(0,_.jsxs)(`form`,{onSubmit:t=>{t.preventDefault(),e.setClose()},style:{display:`flex`,flexDirection:`column`,gap:8,padding:12,width:180},children:[(0,_.jsx)(d,{label:`Имя`,placeholder:`Введите имя`,value:n,onChange:r}),(0,_.jsx)(s,{children:`Отправить`})]})})}var g,_,v,y,b,x,S,C,w,T,E;function D(){return(D=e((()=>{g=n(),o(),c(),u(),i(),_=r(),{useArgs:v}=__STORYBOOK_MODULE_PREVIEW_API__,{fn:y}=__STORYBOOK_MODULE_TEST__,b=[`top`,`top-start`,`top-end`,`right`,`right-start`,`right-end`,`bottom`,`bottom-start`,`bottom-end`,`left`,`left-start`,`left-end`],x={title:`Shared/UI/Popover`,component:a,args:{children:null,placement:`bottom`,open:!1,defaultOpen:!1,onOpenChange:y(),onClose:y(),closeOnOutside:!0,closeOnEscape:!0,disableOutsideClick:!1,background:`secondary`},parameters:{atomicCanvas:!0,layout:`centered`},argTypes:{children:{description:"Композиция из `Popover.Trigger` и `Popover.Content`.",control:!1},placement:{description:`Предпочтительное положение панели относительно trigger.`,control:`select`,options:b},open:{description:`Контролируемая видимость popover.`,control:`boolean`},defaultOpen:{description:`Начальная видимость в uncontrolled-режиме.`,control:`boolean`},onOpenChange:{description:`Вызывается при открытии и закрытии popover.`,control:!1},passive:{description:`Оставляет trigger пассивным: он получает reference, но не переключает popover по клику.`,control:`boolean`},onClose:{description:"Вызывается после закрытия Content через Escape, клик снаружи или `setClose`.",control:!1},closeOnOutside:{description:`Закрывает Content по клику снаружи.`,control:`boolean`},closeOnEscape:{description:`Закрывает Content по клавише Escape.`,control:`boolean`},disableOutsideClick:{description:`Игнорирует клики снаружи Content.`,control:`boolean`},background:{description:`Тема фона Content.`,control:`inline-radio`,options:[`primary`,`secondary`]}}},S={render:m(()=>(0,_.jsx)(`button`,{type:`button`,children:`Открыть`}),e=>(0,_.jsxs)(`div`,{style:{padding:12,maxWidth:160},children:[(0,_.jsx)(`p`,{children:`Пример простого поповера`}),(0,_.jsx)(`button`,{type:`button`,onClick:e.setClose,children:`Закрыть`})]}))},C={render:m(e=>(0,_.jsx)(`button`,{type:`button`,children:e?`Закрыть`:`Открыть`}),(0,_.jsx)(`div`,{style:{padding:12},children:`Контролируемый режим`}))},w={render:function(){let[e,t]=v(),n=(n,r)=>{e.onOpenChange?.(n),t(n?{open:!0,placement:r}:{open:!1})};return(0,_.jsx)(`div`,{style:{display:`flex`,gap:32,flexWrap:`wrap`,justifyContent:`center`},children:b.map(t=>(0,_.jsxs)(a,{placement:t,open:e.open===!0&&e.placement===t,defaultOpen:e.defaultOpen,onOpenChange:e=>n(e,t),children:[(0,_.jsx)(a.Trigger,{passive:e.passive,children:(0,_.jsx)(`button`,{type:`button`,children:t})}),(0,_.jsx)(a.Content,{onClose:()=>e.onClose?.(),closeOnOutside:e.closeOnOutside,closeOnEscape:e.closeOnEscape,disableOutsideClick:e.disableOutsideClick,background:e.background,children:(0,_.jsx)(`div`,{style:{padding:8},children:t})})]},t))})}},T={render:l((e,t)=>(0,_.jsx)(h,{args:e,updateArgs:t}))},S.parameters={...S.parameters,docs:{...S.parameters?.docs,source:{originalSource:`{
+import{n as e,r as t}from"./rolldown-runtime-DkW27tQK.js";import{t as n}from"./react-BZJXY1be.js";import{n as r}from"./iframe-FSp_AjJa.js";import{n as i,t as a}from"./Popover-C0NebUMz.js";import{n as o,t as s}from"./Button-DkDgfpHL.js";import{n as c,t as l}from"./createControlledStoryRender-BouhvX-R.js";import{l as u,t as d}from"./Input-CIPgijvW.js";var f=t({AnchorPlacement:()=>w,Controlled:()=>C,Default:()=>S,WithInteractiveContent:()=>T,__namedExportsOrder:()=>E,default:()=>x});function p({args:e,updateArgs:t,trigger:n,children:r}){return(0,_.jsxs)(a,{placement:e.placement,open:e.open,defaultOpen:e.defaultOpen,onOpenChange:n=>{e.onOpenChange?.(n),t({open:n})},children:[(0,_.jsx)(a.Trigger,{passive:e.passive,children:n(e.open===!0)}),(0,_.jsx)(a.Content,{onClose:()=>e.onClose?.(),closeOnOutside:e.closeOnOutside,closeOnEscape:e.closeOnEscape,disableOutsideClick:e.disableOutsideClick,background:e.background,children:r})]})}function m(e,t){return l((n,r)=>(0,_.jsx)(p,{args:n,updateArgs:r,trigger:e,children:t}))}function h({args:e,updateArgs:t}){let[n,r]=(0,g.useState)(``);return(0,_.jsx)(p,{args:e,updateArgs:t,trigger:()=>(0,_.jsx)(`button`,{type:`button`,children:`Форма`}),children:e=>(0,_.jsxs)(`form`,{onSubmit:t=>{t.preventDefault(),e.setClose()},style:{display:`flex`,flexDirection:`column`,gap:8,padding:12,width:180},children:[(0,_.jsx)(d,{label:`Имя`,placeholder:`Введите имя`,value:n,onChange:r}),(0,_.jsx)(s,{children:`Отправить`})]})})}var g,_,v,y,b,x,S,C,w,T,E;function D(){return(D=e((()=>{g=n(),o(),c(),u(),i(),_=r(),{useArgs:v}=__STORYBOOK_MODULE_PREVIEW_API__,{fn:y}=__STORYBOOK_MODULE_TEST__,b=[`top`,`top-start`,`top-end`,`right`,`right-start`,`right-end`,`bottom`,`bottom-start`,`bottom-end`,`left`,`left-start`,`left-end`],x={title:`Shared/UI/Popover`,component:a,args:{children:null,placement:`bottom`,open:!1,defaultOpen:!1,onOpenChange:y(),onClose:y(),closeOnOutside:!0,closeOnEscape:!0,disableOutsideClick:!1,background:`secondary`},parameters:{atomicCanvas:!0,layout:`centered`},argTypes:{children:{description:"Композиция из `Popover.Trigger` и `Popover.Content`.",control:!1},placement:{description:`Предпочтительное положение панели относительно trigger.`,control:`select`,options:b},open:{description:`Контролируемая видимость popover.`,control:`boolean`},defaultOpen:{description:`Начальная видимость в uncontrolled-режиме.`,control:`boolean`},onOpenChange:{description:`Вызывается при открытии и закрытии popover.`,control:!1},passive:{description:`Оставляет trigger пассивным: он получает reference, но не переключает popover по клику.`,control:`boolean`},onClose:{description:"Вызывается после закрытия Content через Escape, клик снаружи или `setClose`.",control:!1},closeOnOutside:{description:`Закрывает Content по клику снаружи.`,control:`boolean`},closeOnEscape:{description:`Закрывает Content по клавише Escape.`,control:`boolean`},disableOutsideClick:{description:`Игнорирует клики снаружи Content.`,control:`boolean`},background:{description:`Тема фона Content.`,control:`inline-radio`,options:[`primary`,`secondary`]}}},S={render:m(()=>(0,_.jsx)(`button`,{type:`button`,children:`Открыть`}),e=>(0,_.jsxs)(`div`,{style:{padding:12,maxWidth:160},children:[(0,_.jsx)(`p`,{children:`Пример простого поповера`}),(0,_.jsx)(`button`,{type:`button`,onClick:e.setClose,children:`Закрыть`})]}))},C={render:m(e=>(0,_.jsx)(`button`,{type:`button`,children:e?`Закрыть`:`Открыть`}),(0,_.jsx)(`div`,{style:{padding:12},children:`Контролируемый режим`}))},w={render:function(){let[e,t]=v(),n=(n,r)=>{e.onOpenChange?.(n),t(n?{open:!0,placement:r}:{open:!1})};return(0,_.jsx)(`div`,{style:{display:`flex`,gap:32,flexWrap:`wrap`,justifyContent:`center`},children:b.map(t=>(0,_.jsxs)(a,{placement:t,open:e.open===!0&&e.placement===t,defaultOpen:e.defaultOpen,onOpenChange:e=>n(e,t),children:[(0,_.jsx)(a.Trigger,{passive:e.passive,children:(0,_.jsx)(`button`,{type:`button`,children:t})}),(0,_.jsx)(a.Content,{onClose:()=>e.onClose?.(),closeOnOutside:e.closeOnOutside,closeOnEscape:e.closeOnEscape,disableOutsideClick:e.disableOutsideClick,background:e.background,children:(0,_.jsx)(`div`,{style:{padding:8},children:t})})]},t))})}},T={render:l((e,t)=>(0,_.jsx)(h,{args:e,updateArgs:t}))},S.parameters={...S.parameters,docs:{...S.parameters?.docs,source:{originalSource:`{
   render: createPopoverStoryRender(() => <button type="button">Открыть</button>, ctx => <div style={{
     padding: 12,
     maxWidth: 160

package/storybook-static/assets/{PresetRangeDateInput-DyOpbkON.js → PresetRangeDateInput-BsgzPwCV.js}

@@ -1 +1 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{t}from"./react-BZJXY1be.js";import{n}from"./iframe-Sr0umHM6.js";import{n as r,t as i}from"./FlexContainer-BWyPlTMB.js";import{r as a,t as o}from"./DateInput-05Iy69_a.js";import{a as s,c,l,n as u,o as d,r as f,s as p,t as m}from"./DateRangePresetSelect-CAJzxaq0.js";function h(e){return e??`__empty__`}function g({value:e,onChange:t,presetId:n,onPresetIdChange:r,referenceDate:a,presetIds:s,presetOptions:u,presetLabel:g,presetDescription:y,presetPlaceholder:b=`Выберите пресет диапазона`,presetDisabled:x,...S}){let[C]=(0,_.useState)(()=>new Date),w=a??C,T=(0,_.useMemo)(()=>u??c(d(s,f)),[s,u]),E=e??null,D=(0,_.useMemo)(()=>p(E,w,T),[E,T,w]),O=n??D??void 0,k=(0,_.useRef)(``),A=(0,_.useCallback)(e=>{if(!r)return;let t=h(e);t!==k.current&&(k.current=t,r(e))},[r]),j=e=>{let n=l(e,w,T);if(!n){A(null);return}A(n.id),t(n.range)},M=e=>{t(e),A(p(e,w,T))};return(0,v.jsxs)(i,{gap:`sm`,align:`end`,children:[(0,v.jsx)(m,{size:S.size,label:g,description:y,placeholder:b,disabled:x??S.disabled,value:O,onChange:j,options:T,referenceDate:w}),(0,v.jsx)(o,{...S,value:E,onChange:M})]})}var _,v;function y(){return(y=e((()=>{_=t(),a(),u(),s(),r(),v=n(),g.__docgenInfo={description:`Составной компонент выбора диапазона дат через пресет или ручной ввод.`,methods:[],displayName:`PresetRangeDateInput`,props:{presetId:{required:!1,tsType:{name:`union`,raw:`DateRangePresetOption["id"] | null`,elements:[{name:`DateRangePresetOption["id"]`,raw:`DateRangePresetOption["id"]`},{name:`null`}]},description:``},onPresetIdChange:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(presetId: DateRangePresetOption["id"] | null) => void`,signature:{arguments:[{type:{name:`union`,raw:`DateRangePresetOption["id"] | null`,elements:[{name:`DateRangePresetOption["id"]`,raw:`DateRangePresetOption["id"]`},{name:`null`}]},name:`presetId`}],return:{name:`void`}}},description:``},referenceDate:{required:!1,tsType:{name:`Date`},description:``},presetIds:{required:!1,tsType:{name:`unknown`},description:``},presetOptions:{required:!1,tsType:{name:`unknown`},description:``},presetLabel:{required:!1,tsType:{name:`ReactNode`},description:``},presetDescription:{required:!1,tsType:{name:`string`},description:``},presetPlaceholder:{required:!1,tsType:{name:`string`},description:``,defaultValue:{value:`"Выберите пресет диапазона"`,computed:!1}},presetDisabled:{required:!1,tsType:{name:`boolean`},description:``}},composes:[`Omit`]}})))()}export{y as n,g as t};
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{t}from"./react-BZJXY1be.js";import{n}from"./iframe-FSp_AjJa.js";import{n as r,t as i}from"./FlexContainer-BWyPlTMB.js";import{r as a,t as o}from"./DateInput-BiUFIihm.js";import{a as s,c,l,n as u,o as d,r as f,s as p,t as m}from"./DateRangePresetSelect-RIyqNBk9.js";function h(e){return e??`__empty__`}function g({value:e,onChange:t,presetId:n,onPresetIdChange:r,referenceDate:a,presetIds:s,presetOptions:u,presetLabel:g,presetDescription:y,presetPlaceholder:b=`Выберите пресет диапазона`,presetDisabled:x,...S}){let[C]=(0,_.useState)(()=>new Date),w=a??C,T=(0,_.useMemo)(()=>u??c(d(s,f)),[s,u]),E=e??null,D=(0,_.useMemo)(()=>p(E,w,T),[E,T,w]),O=n??D??void 0,k=(0,_.useRef)(``),A=(0,_.useCallback)(e=>{if(!r)return;let t=h(e);t!==k.current&&(k.current=t,r(e))},[r]),j=e=>{let n=l(e,w,T);if(!n){A(null);return}A(n.id),t(n.range)},M=e=>{t(e),A(p(e,w,T))};return(0,v.jsxs)(i,{gap:`sm`,align:`end`,children:[(0,v.jsx)(m,{size:S.size,label:g,description:y,placeholder:b,disabled:x??S.disabled,value:O,onChange:j,options:T,referenceDate:w}),(0,v.jsx)(o,{...S,value:E,onChange:M})]})}var _,v;function y(){return(y=e((()=>{_=t(),a(),u(),s(),r(),v=n(),g.__docgenInfo={description:`Составной компонент выбора диапазона дат через пресет или ручной ввод.`,methods:[],displayName:`PresetRangeDateInput`,props:{presetId:{required:!1,tsType:{name:`union`,raw:`DateRangePresetOption["id"] | null`,elements:[{name:`DateRangePresetOption["id"]`,raw:`DateRangePresetOption["id"]`},{name:`null`}]},description:``},onPresetIdChange:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(presetId: DateRangePresetOption["id"] | null) => void`,signature:{arguments:[{type:{name:`union`,raw:`DateRangePresetOption["id"] | null`,elements:[{name:`DateRangePresetOption["id"]`,raw:`DateRangePresetOption["id"]`},{name:`null`}]},name:`presetId`}],return:{name:`void`}}},description:``},referenceDate:{required:!1,tsType:{name:`Date`},description:``},presetIds:{required:!1,tsType:{name:`unknown`},description:``},presetOptions:{required:!1,tsType:{name:`unknown`},description:``},presetLabel:{required:!1,tsType:{name:`ReactNode`},description:``},presetDescription:{required:!1,tsType:{name:`string`},description:``},presetPlaceholder:{required:!1,tsType:{name:`string`},description:``,defaultValue:{value:`"Выберите пресет диапазона"`,computed:!1}},presetDisabled:{required:!1,tsType:{name:`boolean`},description:``}},composes:[`Omit`]}})))()}export{y as n,g as t};

package/storybook-static/assets/{PresetRangeDateInput-Xk0bOy3S.js → PresetRangeDateInput-htbxc3ni.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{a as i,d as a,f as o,l as s,m as c,n as l,p as u,r as d,u as f}from"./blocks-DndFRxxW.js";import{n as p,r as m,t as h}from"./PresetRangeDateInput.stories-CwjUlXj0.js";function g(e){let t={code:`code`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,v.jsxs)(v.Fragment,{children:[(0,v.jsx)(s,{of:p,parameters:{docs:{toc:!0}}}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{a as i,d as a,f as o,l as s,m as c,n as l,p as u,r as d,u as f}from"./blocks-B5YBxaaS.js";import{n as p,r as m,t as h}from"./PresetRangeDateInput.stories-ClHM5Kah.js";function g(e){let t={code:`code`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,v.jsxs)(v.Fragment,{children:[(0,v.jsx)(s,{of:p,parameters:{docs:{toc:!0}}}),`
 `,(0,v.jsx)(u,{children:`PresetRangeDateInput`}),`
 `,(0,v.jsx)(o,{children:`Составной контрол диапазона дат с синхронизацией ручного ввода и готовых пресетов`}),`
 `,(0,v.jsx)(t.p,{children:`PresetRangeDateInput уже имеет живые stories, а эта страница собирает их в структурированную документацию с краткими рекомендациями, примерами подключения и API.

package/storybook-static/assets/{PresetRangeDateInput.stories-CwjUlXj0.js → PresetRangeDateInput.stories-ClHM5Kah.js}

@@ -1,3 +1,3 @@
-import{n as e,r as t}from"./rolldown-runtime-DkW27tQK.js";import{a as n,i as r,r as i}from"./CalendarView-Dp0zus1o.js";import{n as a}from"./iframe-Sr0umHM6.js";import{n as o,t as s}from"./Text-DK4jN26J.js";import{n as c,t as l}from"./FlexContainer-BWyPlTMB.js";import{n as u,t as d}from"./createControlledStoryRender-BouhvX-R.js";import{a as f,r as p}from"./DateRangePresetSelect-CAJzxaq0.js";import{n as m,t as h}from"./PresetRangeDateInput-DyOpbkON.js";var g=t({Default:()=>x,__namedExportsOrder:()=>S,default:()=>y}),_,v,y,b,x,S;function C(){return(C=e((()=>{n(),f(),u(),c(),o(),m(),_=a(),{fn:v}=__STORYBOOK_MODULE_TEST__,y={title:`Shared/UI/PresetRangeDateInput`,component:h,args:{label:`Диапазон дат`,placeholder:`дд.мм.гггг - дд.мм.гггг`,value:[new Date(2026,2,10,0,0,0),new Date(2026,2,10,23,59,59)],onChange:v(),presetId:`today`,onPresetIdChange:v(),referenceDate:new Date(2026,2,10,12,0,0),presetLabel:`Быстрый диапазон`,size:`md`},parameters:{atomicCanvas:!0,layout:`padded`},argTypes:{presetId:{description:"Контролируемый ID выбранного быстрого пресета. `null` снимает внешний выбор.",control:`select`,options:[...p,null]},onPresetIdChange:{description:`Вызывается, когда выбор пресета меняется из-за preset или ручного диапазона.`,control:!1},referenceDate:{description:`Опорная дата для вычисления встроенных быстрых диапазонов.`,control:`date`},presetIds:{description:"Разрешённые встроенные ID пресетов, если не передан `presetOptions`.",control:`check`,options:p},presetOptions:{description:`Кастомный каталог быстрых диапазонов с функциями вычисления.`,control:!1},presetLabel:{description:`Заголовок поля быстрого выбора.`,control:`text`},presetDescription:{description:`Описание под полем быстрого выбора.`,control:`text`},presetPlaceholder:{description:`Текст до выбора быстрого диапазона.`,control:`text`},presetDisabled:{description:`Блокирует только выбор быстрого пресета.`,control:`boolean`},label:{description:`Заголовок ручного поля диапазона.`,control:`text`},description:{description:`Описание ручного поля диапазона.`,control:`text`},placeholder:{description:`Текст до выбора ручного диапазона.`,control:`text`},value:{description:`Текущий ручной диапазон дат.`,control:!1},onChange:{description:`Вызывается при изменении ручного диапазона или выборе пресета.`,control:!1},error:{description:`Текст внешней ошибки ручного поля.`,control:`text`},onClearError:{description:`Сбрасывает внешнюю ошибку после ввода или выбора.`,control:!1},minDate:{description:`Минимально доступная дата ручного диапазона.`,control:`date`},maxDate:{description:`Максимально доступная дата ручного диапазона.`,control:`date`},datePreset:{description:`Пресет форматирования выбранного ручного диапазона.`,control:`text`},datePickerLevel:{description:`Минимальный уровень навигации календаря ручного поля.`,control:`select`,options:[`day`,`month`,`year`]},selectionMode:{description:`Размер периода, который выбирает ручное поле.`,control:`select`,options:i},weekEndDay:{description:`Последний включённый день недели в режиме week.`,control:`select`,options:r},allowSelectionModeChange:{description:`Показывает runtime-переключатель размера периода.`,control:`boolean`},selectionModeOptions:{description:`Ограничивает доступные режимы в runtime-переключателе.`,control:`check`,options:i},onSelectionModeChange:{description:`Вызывается при runtime-смене размера периода.`,control:!1},disabled:{description:"Блокирует ручное поле и, если `presetDisabled` не задан, быстрый выбор.",control:`boolean`},size:{description:`Размер обоих полей.`,control:`select`,options:[`xs`,`sm`,`md`,`lg`,`xl`]}}},b=d((e,t)=>(0,_.jsxs)(_.Fragment,{children:[(0,_.jsx)(l,{gap:`sm`,align:`end`,children:(0,_.jsx)(h,{...e,value:e.value??null,onChange:n=>{e.onChange(n),t({value:n})},onPresetIdChange:n=>{e.onPresetIdChange?.(n),t({presetId:n})},onSelectionModeChange:n=>{e.onSelectionModeChange?.(n),t({selectionMode:n})},onClearError:()=>{e.onClearError?.(),t({error:void 0})}})}),(0,_.jsxs)(s,{as:`p`,className:`marginBlockSm`,children:[`Активный presetId: `,(0,_.jsx)(s,{as:`code`,children:e.presetId??`null`})]})]})),x={render:b},x.parameters={...x.parameters,docs:{...x.parameters?.docs,source:{originalSource:`{
+import{n as e,r as t}from"./rolldown-runtime-DkW27tQK.js";import{a as n,i as r,r as i}from"./CalendarView-CEqcrblx.js";import{n as a}from"./iframe-FSp_AjJa.js";import{n as o,t as s}from"./Text-ClnbDqRk.js";import{n as c,t as l}from"./FlexContainer-BWyPlTMB.js";import{n as u,t as d}from"./createControlledStoryRender-BouhvX-R.js";import{a as f,r as p}from"./DateRangePresetSelect-RIyqNBk9.js";import{n as m,t as h}from"./PresetRangeDateInput-BsgzPwCV.js";var g=t({Default:()=>x,__namedExportsOrder:()=>S,default:()=>y}),_,v,y,b,x,S;function C(){return(C=e((()=>{n(),f(),u(),c(),o(),m(),_=a(),{fn:v}=__STORYBOOK_MODULE_TEST__,y={title:`Shared/UI/PresetRangeDateInput`,component:h,args:{label:`Диапазон дат`,placeholder:`дд.мм.гггг - дд.мм.гггг`,value:[new Date(2026,2,10,0,0,0),new Date(2026,2,10,23,59,59)],onChange:v(),presetId:`today`,onPresetIdChange:v(),referenceDate:new Date(2026,2,10,12,0,0),presetLabel:`Быстрый диапазон`,size:`md`},parameters:{atomicCanvas:!0,layout:`padded`},argTypes:{presetId:{description:"Контролируемый ID выбранного быстрого пресета. `null` снимает внешний выбор.",control:`select`,options:[...p,null]},onPresetIdChange:{description:`Вызывается, когда выбор пресета меняется из-за preset или ручного диапазона.`,control:!1},referenceDate:{description:`Опорная дата для вычисления встроенных быстрых диапазонов.`,control:`date`},presetIds:{description:"Разрешённые встроенные ID пресетов, если не передан `presetOptions`.",control:`check`,options:p},presetOptions:{description:`Кастомный каталог быстрых диапазонов с функциями вычисления.`,control:!1},presetLabel:{description:`Заголовок поля быстрого выбора.`,control:`text`},presetDescription:{description:`Описание под полем быстрого выбора.`,control:`text`},presetPlaceholder:{description:`Текст до выбора быстрого диапазона.`,control:`text`},presetDisabled:{description:`Блокирует только выбор быстрого пресета.`,control:`boolean`},label:{description:`Заголовок ручного поля диапазона.`,control:`text`},description:{description:`Описание ручного поля диапазона.`,control:`text`},placeholder:{description:`Текст до выбора ручного диапазона.`,control:`text`},value:{description:`Текущий ручной диапазон дат.`,control:!1},onChange:{description:`Вызывается при изменении ручного диапазона или выборе пресета.`,control:!1},error:{description:`Текст внешней ошибки ручного поля.`,control:`text`},onClearError:{description:`Сбрасывает внешнюю ошибку после ввода или выбора.`,control:!1},minDate:{description:`Минимально доступная дата ручного диапазона.`,control:`date`},maxDate:{description:`Максимально доступная дата ручного диапазона.`,control:`date`},datePreset:{description:`Пресет форматирования выбранного ручного диапазона.`,control:`text`},datePickerLevel:{description:`Минимальный уровень навигации календаря ручного поля.`,control:`select`,options:[`day`,`month`,`year`]},selectionMode:{description:`Размер периода, который выбирает ручное поле.`,control:`select`,options:i},weekEndDay:{description:`Последний включённый день недели в режиме week.`,control:`select`,options:r},allowSelectionModeChange:{description:`Показывает runtime-переключатель размера периода.`,control:`boolean`},selectionModeOptions:{description:`Ограничивает доступные режимы в runtime-переключателе.`,control:`check`,options:i},onSelectionModeChange:{description:`Вызывается при runtime-смене размера периода.`,control:!1},disabled:{description:"Блокирует ручное поле и, если `presetDisabled` не задан, быстрый выбор.",control:`boolean`},size:{description:`Размер обоих полей.`,control:`select`,options:[`xs`,`sm`,`md`,`lg`,`xl`]}}},b=d((e,t)=>(0,_.jsxs)(_.Fragment,{children:[(0,_.jsx)(l,{gap:`sm`,align:`end`,children:(0,_.jsx)(h,{...e,value:e.value??null,onChange:n=>{e.onChange(n),t({value:n})},onPresetIdChange:n=>{e.onPresetIdChange?.(n),t({presetId:n})},onSelectionModeChange:n=>{e.onSelectionModeChange?.(n),t({selectionMode:n})},onClearError:()=>{e.onClearError?.(),t({error:void 0})}})}),(0,_.jsxs)(s,{as:`p`,className:`marginBlockSm`,children:[`Активный presetId: `,(0,_.jsx)(s,{as:`code`,children:e.presetId??`null`})]})]})),x={render:b},x.parameters={...x.parameters,docs:{...x.parameters?.docs,source:{originalSource:`{
   render: renderPresetRangeDateInputStory
 }`,...x.parameters?.docs?.source},description:{story:`Демонстрирует совместную работу пресета и ручного диапазона.`,...x.parameters?.docs?.description}}},S=[`Default`]})))()}export{g as n,C as r,x as t};

package/storybook-static/assets/{PresetSelect-Ddmr0niY.js → PresetSelect-Dcx0BOTx.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{n,t as r}from"./Select-Bwc0bEpt.js";function i(e,t,n=[]){if(!Array.isArray(e))return[...n];let r=[];for(let n of e)!t(n)||r.includes(n)||r.push(n);return r}function a(e,t){let n=new Map(t.map(e=>[e.id,e])),r=[],i=new Set;for(let t of e){if(i.has(t))continue;let e=n.get(t);e&&(r.push(e),i.add(t))}return r}function o(e,t){return e?t.find(t=>t.id===e)??null:null}function s(){return(s=e((()=>{})))()}function c({options:e,value:t,onChange:n,getOptionDisabled:i,getOptionCode:a,getOptionAriaLabel:s,renderOption:c,renderValue:u,className:d,buttonClassName:f,optionsClassName:p,clearable:m,...h}){let g=o(t,e)??void 0;return(0,l.jsx)(r,{...h,options:e,value:g,onChange:e=>n(e?.id),getOptionKey:e=>e.id,getOptionLabel:e=>e.label,getOptionCode:a,getOptionDisabled:i,getOptionAriaLabel:s,renderOption:c,renderValue:u,className:d,buttonClassName:f,optionsClassName:p,clearable:m})}var l;function u(){return(u=e((()=>{n(),l=t(),c.__docgenInfo={description:"Базовый Select для пресетов с контрактом `id/label`.",methods:[],displayName:`PresetSelect`,props:{label:{required:!1,tsType:{name:`ReactNode`},description:``},description:{required:!1,tsType:{name:`string`},description:``},placeholder:{required:!1,tsType:{name:`string`},description:``},disabled:{required:!1,tsType:{name:`boolean`},description:``},size:{required:!1,tsType:{name:`union`,raw:`"xs" | "sm" | "md" | "lg" | "xl"`,elements:[{name:`literal`,value:`"xs"`},{name:`literal`,value:`"sm"`},{name:`literal`,value:`"md"`},{name:`literal`,value:`"lg"`},{name:`literal`,value:`"xl"`}]},description:``},value:{required:!0,tsType:{name:`V`},description:"Если начальное состояние может быть `null | undefined`\nзначит `onChange` тоже должен ументь сбрасывать.\nПоэтому такой контрол явно должен передавать `UiBaseProps<AnyType | undefined>`"},onChange:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(value: T) => void`,signature:{arguments:[{type:{name:`C`},name:`value`}],return:{name:`void`}}},description:``},options:{required:!0,tsType:{name:`unknown`},description:``},getOptionDisabled:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => boolean`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`boolean`}}},description:``},getOptionCode:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => string`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`string`}}},description:``},getOptionAriaLabel:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => string`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`string`}}},description:``},renderOption:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption, state: SelectOptionState) => ReactNode`,signature:{arguments:[{type:{name:`TOption`},name:`option`},{type:{name:`signature`,type:`object`,raw:`{
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{n,t as r}from"./Select-CGCxJjL9.js";function i(e,t,n=[]){if(!Array.isArray(e))return[...n];let r=[];for(let n of e)!t(n)||r.includes(n)||r.push(n);return r}function a(e,t){let n=new Map(t.map(e=>[e.id,e])),r=[],i=new Set;for(let t of e){if(i.has(t))continue;let e=n.get(t);e&&(r.push(e),i.add(t))}return r}function o(e,t){return e?t.find(t=>t.id===e)??null:null}function s(){return(s=e((()=>{})))()}function c({options:e,value:t,onChange:n,getOptionDisabled:i,getOptionCode:a,getOptionAriaLabel:s,renderOption:c,renderValue:u,className:d,buttonClassName:f,optionsClassName:p,clearable:m,...h}){let g=o(t,e)??void 0;return(0,l.jsx)(r,{...h,options:e,value:g,onChange:e=>n(e?.id),getOptionKey:e=>e.id,getOptionLabel:e=>e.label,getOptionCode:a,getOptionDisabled:i,getOptionAriaLabel:s,renderOption:c,renderValue:u,className:d,buttonClassName:f,optionsClassName:p,clearable:m})}var l;function u(){return(u=e((()=>{n(),l=t(),c.__docgenInfo={description:"Базовый Select для пресетов с контрактом `id/label`.",methods:[],displayName:`PresetSelect`,props:{label:{required:!1,tsType:{name:`ReactNode`},description:``},description:{required:!1,tsType:{name:`string`},description:``},placeholder:{required:!1,tsType:{name:`string`},description:``},disabled:{required:!1,tsType:{name:`boolean`},description:``},size:{required:!1,tsType:{name:`union`,raw:`"xs" | "sm" | "md" | "lg" | "xl"`,elements:[{name:`literal`,value:`"xs"`},{name:`literal`,value:`"sm"`},{name:`literal`,value:`"md"`},{name:`literal`,value:`"lg"`},{name:`literal`,value:`"xl"`}]},description:``},value:{required:!0,tsType:{name:`V`},description:"Если начальное состояние может быть `null | undefined`\nзначит `onChange` тоже должен ументь сбрасывать.\nПоэтому такой контрол явно должен передавать `UiBaseProps<AnyType | undefined>`"},onChange:{required:!0,tsType:{name:`signature`,type:`function`,raw:`(value: T) => void`,signature:{arguments:[{type:{name:`C`},name:`value`}],return:{name:`void`}}},description:``},options:{required:!0,tsType:{name:`unknown`},description:``},getOptionDisabled:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => boolean`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`boolean`}}},description:``},getOptionCode:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => string`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`string`}}},description:``},getOptionAriaLabel:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption) => string`,signature:{arguments:[{type:{name:`TOption`},name:`option`}],return:{name:`string`}}},description:``},renderOption:{required:!1,tsType:{name:`signature`,type:`function`,raw:`(option: TOption, state: SelectOptionState) => ReactNode`,signature:{arguments:[{type:{name:`TOption`},name:`option`},{type:{name:`signature`,type:`object`,raw:`{
 	active: boolean;
 	selected: boolean;
 	disabled: boolean;

package/storybook-static/assets/README--LCKbep-.js

@@ -0,0 +1,110 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation API/SAP/ADT Transports`}),`
+`,(0,c.jsxs)(t.h1,{id:`sap-adt-transports-через-ryuzaki13react-foundation-apiadt`,children:[`SAP ADT transports через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/adt`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль получает transport requests текущего пользователя из SAP ADT endpoint и преобразует XML в простой массив объектов.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%B3%D0%B4%D0%B0-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D1%8C`,children:`Когда использовать`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#fetchusertransports`,children:(0,c.jsx)(t.code,{children:`fetchUserTransports`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#parseusertransportsxml`,children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%D0%B0`,children:`Формат результата`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-%D0%B8-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F`,children:`Ошибки и ограничения`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-api`,children:`Полный API`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`adt`}),`, если backend доступен по `,(0,c.jsx)(t.code,{children:`/sap/bc/adt/cts/transports`}),` и возвращает ADT XML. Если нужны отдельные UI2 списки workbench/customizing в JSON, используйте `,(0,c.jsx)(t.a,{href:`../transport/README.mdx`,children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-api/transport`})}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`SAP ADT XML
+    │
+    ▼
+parseUserTransportsXml
+    │
+    ▼
+UserTransport[]
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-api @ryuzaki13/react-foundation-lib fast-xml-parser
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { fetchUserTransports, parseUserTransportsXml } from "@ryuzaki13/react-foundation-api/adt";
+
+import type { UserTransport } from "@ryuzaki13/react-foundation-api/adt";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function loadTransports() {
+	try {
+		const transports = await fetchUserTransports();
+		return transports;
+	} catch (error) {
+		console.error("Не удалось получить transports", error);
+		return [];
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetchUserTransports`}),` возвращает Promise. Пока он выполняется, данных ещё нет; ошибку нужно обработать через `,(0,c.jsx)(t.code,{children:`try/catch`}),`, TanStack Query или error boundary владельца сценария.`]}),`
+`,(0,c.jsx)(t.h2,{id:`fetchusertransports`,children:(0,c.jsx)(t.code,{children:`fetchUserTransports`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция выполняет GET:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`/sap/bc/adt/cts/transports?_action=FIND&trfunction=K
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Запрос отправляется через SAP/OData transport пакета с:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Accept: application/xml, text/xml, */*`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`cookies через `,(0,c.jsx)(t.code,{children:`credentials: include`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`SAP language/client и SSO policy общего OData transport;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустым base URL, потому что ADT endpoint уже содержит `,(0,c.jsx)(t.code,{children:`/sap/...`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Ответ читается как text и передаётся `,(0,c.jsx)(t.code,{children:`parseUserTransportsXml`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если сервер вместо XML вернул HTML login/error page, функция выбросит ошибку. Это защищает UI от ситуации, когда HTML ошибочно принимается за пустой список transports.`}),`
+`,(0,c.jsx)(t.h2,{id:`parseusertransportsxml`,children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})}),`
+`,(0,c.jsx)(t.p,{children:`Parser можно использовать отдельно, например в тесте или при получении XML другим transport:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const xml = \`
+<root>
+	<CTS_REQ_HEADER>
+		<TRKORR>DEVK900001</TRKORR>
+		<AS4TEXT>Исправление отчёта</AS4TEXT>
+		<AS4USER>IVANOV</AS4USER>
+		<TARSYSTEM>QAS</TARSYSTEM>
+		<TRFUNCTION>K</TRFUNCTION>
+		<TRSTATUS>D</TRSTATUS>
+	</CTS_REQ_HEADER>
+</root>\`;
+
+const transports = parseUserTransportsXml(xml);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Пустая или состоящая из пробелов строка превращается в `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`XML разбирается `,(0,c.jsx)(t.code,{children:`fast-xml-parser`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Во вложенной структуре рекурсивно ищутся узлы `,(0,c.jsx)(t.code,{children:`CTS_REQ_HEADER`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Поля преобразуются в `,(0,c.jsx)(t.code,{children:`UserTransport`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Записи без непустого `,(0,c.jsx)(t.code,{children:`TRKORR`}),` отбрасываются.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Дубликаты `,(0,c.jsx)(t.code,{children:`transportNo`}),` удаляются; сохраняется первая запись.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если header-узлы не найдены, parser ищет вложенные `,(0,c.jsx)(t.code,{children:`TRKORR`}),` и создаёт минимальные записи.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Parser делает `,(0,c.jsx)(t.code,{children:`trim`}),` строковых полей, но не декодирует бизнес-значения статуса/function и не проверяет их по справочнику SAP.`]}),`
+`,(0,c.jsx)(t.p,{children:`Некорректный XML может привести к исключению parser-а. Функция не заменяет его пустым массивом: повреждённый ответ должен быть виден как ошибка.`}),`
+`,(0,c.jsx)(t.h2,{id:`формат-результата`,children:`Формат результата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface UserTransport {
+	transportNo: string;
+	description?: string;
+	owner?: string;
+	targetSystem?: string;
+	function?: string;
+	status?: string;
+	parentTransportNo?: string;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Соответствие XML:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`XML`}),(0,c.jsx)(t.th,{children:`Поле`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TRKORR`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`transportNo`})}),(0,c.jsx)(t.td,{children:`Обязательный номер transport`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AS4TEXT`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`description`})}),(0,c.jsx)(t.td,{children:`Описание`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AS4USER`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`owner`})}),(0,c.jsx)(t.td,{children:`Владелец`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TARSYSTEM`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`targetSystem`})}),(0,c.jsx)(t.td,{children:`Целевая система`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TRFUNCTION`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`function`})}),(0,c.jsx)(t.td,{children:`SAP transport function`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TRSTATUS`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`status`})}),(0,c.jsx)(t.td,{children:`SAP status`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`STRKORR`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parentTransportNo`})}),(0,c.jsx)(t.td,{children:`Родительский request/task`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Optional-поле может быть `,(0,c.jsx)(t.code,{children:`undefined`}),`. Проверяйте его перед отображением:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"const label = transport.description\n	? `${transport.transportNo} — ${transport.description}`\n	: transport.transportNo;\n"})}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-ограничения`,children:`Ошибки и ограничения`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`fast-xml-parser`}),` должен быть установлен в host, использующем этот entrypoint.`]}),`
+`,(0,c.jsx)(t.li,{children:`Это не generic ADT client: endpoint и query parameters зафиксированы.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция не создаёт/не освобождает transport и не проверяет authorization.`}),`
+`,(0,c.jsxs)(t.li,{children:[`SSO/cookies требуют browser/proxy окружения SAP. На server runtime поведение зависит от переданного глобального `,(0,c.jsx)(t.code,{children:`fetch`}),` и cookie boundary.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`HTML-response, HTTP error и XML parse error не превращаются в `,(0,c.jsx)(t.code,{children:`[]`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Дедупликация выполняется только по `,(0,c.jsx)(t.code,{children:`transportNo`}),` и сохраняет первую найденную запись.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`полный-api`,children:`Полный API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchUserTransports`})}),(0,c.jsx)(t.td,{children:`Загружает и разбирает ADT XML`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseUserTransportsXml`})}),(0,c.jsx)(t.td,{children:`Преобразует XML string в массив`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`UserTransport`})}),(0,c.jsx)(t.td,{children:`Контракт результата`})]})]})]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

package/storybook-static/assets/{README-DRnlD7y8.js → README-5M8ajrJp.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/File`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/File`}),`
 `,(0,c.jsxs)(t.h1,{id:`работа-с-пользовательскими-файлами-через-ryuzaki13react-foundation-libfile`,children:[`Работа с пользовательскими файлами через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/file`})]}),`
 `,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`file`}),` содержит browser helpers для четырёх связанных задач:`]}),`
 `,(0,c.jsxs)(t.ul,{children:[`

package/storybook-static/assets/README-5NhzH8VL.js

@@ -0,0 +1,95 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Data/Presets`}),`
+`,(0,c.jsxs)(t.h1,{id:`общие-preset-helpers-через-ryuzaki13react-foundation-libpresets`,children:[`Общие preset helpers через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/presets`})]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль проверяет восстановленные preset ids, сопоставляет их с option objects и ищет одну option по id.`}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { getPresetOption, normalizePresetIds, resolvePresetOptionsByIds } from "@ryuzaki13/react-foundation-lib/presets";
+
+import type { PresetOption } from "@ryuzaki13/react-foundation-lib/presets";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не зависит от React/browser APIs.`}),`
+`,(0,c.jsx)(t.h2,{id:`базовый-контракт`,children:`Базовый контракт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type PresetOption<TId extends string = string> = {
+	id: TId;
+	label: string;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ваш тип может добавлять поля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReportPreset = PresetOption<"daily" | "monthly"> & {
+	icon: string;
+};
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`normalizepresetids`,children:(0,c.jsx)(t.code,{children:`normalizePresetIds`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция предназначена для явной boundary восстановления сохранённого `,(0,c.jsx)(t.code,{children:`unknown`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type PresetId = "first" | "second" | "third";
+
+function isPresetId(value: unknown): value is PresetId {
+	return value === "first" || value === "second" || value === "third";
+}
+
+normalizePresetIds(["second", "unknown", "second", "first"], isPresetId);
+// ["second", "first"].
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`если `,(0,c.jsx)(t.code,{children:`value`}),` не массив — возвращается копия `,(0,c.jsx)(t.code,{children:`fallbackIds`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`если это массив — fallback не используется, даже для пустого массива;`}),`
+`,(0,c.jsx)(t.li,{children:`элементы проверяются переданным type guard;`}),`
+`,(0,c.jsx)(t.li,{children:`invalid ids пропускаются;`}),`
+`,(0,c.jsx)(t.li,{children:`дубликаты удаляются;`}),`
+`,(0,c.jsx)(t.li,{children:`сохраняется порядок первого допустимого вхождения.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizePresetIds(undefined, isPresetId, ["third"]); // ["third"].
+normalizePresetIds([], isPresetId, ["third"]); // [].
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это normalizer сохранённого payload. Не вызывайте его внутри обычного input/store setter, если пользовательский draft должен храниться буквально.`}),`
+`,(0,c.jsx)(t.h2,{id:`resolvepresetoptionsbyids`,children:(0,c.jsx)(t.code,{children:`resolvePresetOptionsByIds`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = [
+	{ id: "first", label: "Первый" },
+	{ id: "second", label: "Второй" },
+	{ id: "third", label: "Третий" }
+] as const;
+
+const selected = resolvePresetOptionsByIds(["third", "first", "third", "missing"], options);
+// objects third, first.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`порядок берётся из `,(0,c.jsx)(t.code,{children:`presetIds`}),`, а не из `,(0,c.jsx)(t.code,{children:`options`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`повторные ids добавляются один раз;`}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствующие в `,(0,c.jsx)(t.code,{children:`options`}),` ids пропускаются;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращается новый массив;`}),`
+`,(0,c.jsx)(t.li,{children:`сами option objects не клонируются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`если в `,(0,c.jsx)(t.code,{children:`options`}),` повторяется id, `,(0,c.jsx)(t.code,{children:`Map`}),` оставляет последнюю option с этим id.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`getpresetoption`,children:(0,c.jsx)(t.code,{children:`getPresetOption`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getPresetOption("second", options);
+// { id: "second", label: "Второй" }.
+
+getPresetOption("missing", options); // null.
+getPresetOption(undefined, options); // null.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция использует первое совпадение `,(0,c.jsx)(t.code,{children:`options.find`}),`. Пустой id `,(0,c.jsx)(t.code,{children:`""`}),` считается отсутствующим и возвращает `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`saverestore-recipe`,children:`Save/restore recipe`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function restorePresetIds(value: unknown): PresetId[] {
+	return normalizePresetIds(value, isPresetId, ["daily"]);
+}
+
+function buildPresetView(ids: readonly PresetId[]) {
+	return resolvePresetOptionsByIds(ids, PRESET_OPTIONS);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Разделяйте:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`unknown persisted payload ── normalizePresetIds ──► canonical ids
+literal UI draft           ── clone only          ──► literal copy
+canonical ids              ── resolve...          ──► option objects for UI
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`api-и-ошибки`,children:`API и ошибки`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`PresetOption`})}),(0,c.jsxs)(t.td,{children:[`Минимальный `,(0,c.jsx)(t.code,{children:`{ id, label }`}),` contract`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizePresetIds`})}),(0,c.jsx)(t.td,{children:`Проверенные уникальные ids`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolvePresetOptionsByIds`})}),(0,c.jsx)(t.td,{children:`Options в порядке ids`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getPresetOption`})}),(0,c.jsxs)(t.td,{children:[`Option или `,(0,c.jsx)(t.code,{children:`null`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Типичные ошибки:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Ожидать fallback для пустого массива.`}),`
+`,(0,c.jsx)(t.li,{children:`Считать result options глубокими копиями.`}),`
+`,(0,c.jsx)(t.li,{children:`Использовать normalizer во время пользовательского ввода.`}),`
+`,(0,c.jsx)(t.li,{children:`Передавать type guard, который делает unsafe cast вместо runtime-проверки.`}),`
+`,(0,c.jsx)(t.li,{children:`Ожидать, что неизвестный id будет создан автоматически.`}),`
+`]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

package/storybook-static/assets/README-Am6Fa6-b.js

@@ -0,0 +1,69 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Browser/Client Fingerprint`}),`
+`,(0,c.jsxs)(t.h1,{id:`client-fingerprint-через-ryuzaki13react-foundation-libfingerprint`,children:[`Client fingerprint через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/fingerprint`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getClientFingerprint`}),` лениво загружает FingerprintJS, получает `,(0,c.jsx)(t.code,{children:`visitorId`}),` и кеширует Promise на всё время жизни JavaScript-модуля.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib @fingerprintjs/fingerprintjs
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { getClientFingerprint } from "@ryuzaki13/react-foundation-lib/fingerprint";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Host должен разрешить peer dependency `,(0,c.jsx)(t.code,{children:`@fingerprintjs/fingerprintjs >=5 <6`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`использование`,children:`Использование`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const fingerprint = await getClientFingerprint();
+
+if (fingerprint) {
+	attachAnonymousDiagnosticId(fingerprint);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат `,(0,c.jsx)(t.code,{children:`Promise<string | null>`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`непустой trimmed `,(0,c.jsx)(t.code,{children:`visitorId`}),`, если библиотека успешно отработала;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` вне browser;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, если load/get завершились ошибкой;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, если visitorId пустой после trim.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`кеширование`,children:`Кеширование`}),`
+`,(0,c.jsx)(t.p,{children:`Первый browser-вызов создаёт одну Promise:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`первый вызов ──► load FingerprintJS ──► fp.get() ──► string/null
+     │
+следующие вызовы ─────────────────────► та же Promise
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Преимущества:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`параллельные consumers не запускают повторное вычисление;`}),`
+`,(0,c.jsx)(t.li,{children:`после успеха возвращается то же значение;`}),`
+`,(0,c.jsxs)(t.li,{children:[`после ошибки `,(0,c.jsx)(t.code,{children:`null`}),` также кешируется и автоматического retry нет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Публичного reset/retry API нет. Reload страницы создаёт новый module runtime.`}),`
+`,(0,c.jsxs)(t.p,{children:[`SSR-вызов возвращает `,(0,c.jsx)(t.code,{children:`null`}),` сразу и не заполняет browser promise cache. Поэтому последующий client runtime может выполнить настоящее вычисление.`]}),`
+`,(0,c.jsx)(t.h2,{id:`правильная-react-boundary`,children:`Правильная React boundary`}),`
+`,(0,c.jsx)(t.p,{children:`Не вызывайте async функцию во время render:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`useEffect(() => {
+	let active = true;
+
+	void getClientFingerprint().then((value) => {
+		if (active) setFingerprint(value);
+	});
+
+	return () => {
+		active = false;
+	};
+}, []);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если fingerprint нужен backend request, предпочтительнее интегрировать его в app/API boundary, а не дублировать state по компонентам.`}),`
+`,(0,c.jsx)(t.h2,{id:`privacy-и-security`,children:`Privacy и security`}),`
+`,(0,c.jsx)(t.p,{children:`Fingerprint:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не является authentication token;`}),`
+`,(0,c.jsx)(t.li,{children:`не доказывает личность пользователя;`}),`
+`,(0,c.jsx)(t.li,{children:`может меняться после обновления browser/device/settings;`}),`
+`,(0,c.jsx)(t.li,{children:`может совпасть у разных клиентов;`}),`
+`,(0,c.jsx)(t.li,{children:`не заменяет server session;`}),`
+`,(0,c.jsx)(t.li,{children:`требует правового/продуктового решения о consent и retention;`}),`
+`,(0,c.jsx)(t.li,{children:`не должен использоваться для скрытого tracking вопреки пользовательской политике.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не помещайте fingerprint в публичный URL, DOM или logs без необходимости. При передаче на backend используйте HTTPS и установленную privacy policy.`}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-тестирование`,children:`Ошибки и тестирование`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция намеренно поглощает ошибки FingerprintJS и возвращает `,(0,c.jsx)(t.code,{children:`null`}),`. Это graceful optional capability; если fingerprint обязателен для business flow, host должен явно обработать `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Module-level cache усложняет повторные тесты. Используйте module reset (`,(0,c.jsx)(t.code,{children:`vi.resetModules`}),`) перед сценарием, которому нужен чистый первый вызов.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getClientFingerprint(): Promise<string | null>;
+`})})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

package/storybook-static/assets/README-B3bFglqG.js

@@ -0,0 +1,82 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Browser/Session Storage ID`}),`
+`,(0,c.jsxs)(t.h1,{id:`идентификатор-вкладочной-сессии-через-ryuzaki13react-foundation-libsession-storage`,children:[`Идентификатор вкладочной сессии через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/session-storage`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getSessionStorageId`}),` возвращает стабильный id в пределах одной browser-вкладки. При первом вызове id создаётся и сохраняется в `,(0,c.jsx)(t.code,{children:`sessionStorage`}),`, при следующих — читается по тому же ключу.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { getSessionStorageId } from "@ryuzaki13/react-foundation-lib/session-storage";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Default generator — `,(0,c.jsx)(t.code,{children:`uuidv4`}),` из `,(0,c.jsx)(t.code,{children:`/crypto`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`базовый-пример`,children:`Базовый пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sessionId = getSessionStorageId("sales-app.error-report.session.v1");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Повторный вызов в той же вкладке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = getSessionStorageId("sales-app.session.v1");
+const second = getSessionStorageId("sales-app.session.v1");
+
+console.log(first === second); // true, если storage доступен.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Другая вкладка имеет отдельный `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` и обычно получит другой id.`]}),`
+`,(0,c.jsx)(t.h2,{id:`алгоритм`,children:`Алгоритм`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sessionStorage недоступен ──► createId() без сохранения
+          │
+          ▼
+getItem(key)
+  ├─ непустая строка ──────► вернуть её
+  └─ нет значения ─────────► createId() → setItem → вернуть id
+
+ошибка getItem/setItem ─────► fallback createId()
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = getSessionStorageId("demo.session", () => "known-id");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Второй аргумент удобен для теста или другого генератора.`}),`
+`,(0,c.jsx)(t.h2,{id:`граница-стабильности`,children:`Граница стабильности`}),`
+`,(0,c.jsx)(t.p,{children:`Идентификатор стабилен только при успешном storage:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`reload той же вкладки обычно сохраняет значение;`}),`
+`,(0,c.jsx)(t.li,{children:`новая вкладка получает своё storage;`}),`
+`,(0,c.jsx)(t.li,{children:`закрытие вкладки удаляет session storage по правилам браузера;`}),`
+`,(0,c.jsx)(t.li,{children:`privacy policy, sandbox iframe или переполнение могут запретить доступ;`}),`
+`,(0,c.jsx)(t.li,{children:`если storage недоступен, каждый вызов может создать новый fallback id.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция ловит ошибки чтения/записи и не ломает основной пользовательский сценарий.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`setItem`}),` выбросил ошибку после первого вызова generator, fallback generator может быть вызван повторно. Не используйте `,(0,c.jsx)(t.code,{children:`createId`}),` с внешними необратимыми side effects.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ключ-storage`,children:`Ключ storage`}),`
+`,(0,c.jsx)(t.p,{children:`Ключ полностью задаёт host. Рекомендуемый формат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`<app-id>.<purpose>.v<schema-version>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`sales-app.error-report.session.v1
+warehouse.telemetry.tab-session.v2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте один ключ для несвязанных подсистем. При изменении семантики меняйте версию.`}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-и-безопасность`,children:`SSR и безопасность`}),`
+`,(0,c.jsxs)(t.p,{children:[`Вне browser `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` отсутствует, поэтому функция просто возвращает новый id generator-а. Она не пытается создать server session.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = getSessionStorageId("demo", () => "server-fallback");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Идентификатор:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не является authentication token;`}),`
+`,(0,c.jsx)(t.li,{children:`не подтверждает пользователя;`}),`
+`,(0,c.jsx)(t.li,{children:`не должен давать доступ к данным;`}),`
+`,(0,c.jsx)(t.li,{children:`не является cross-tab device id;`}),`
+`,(0,c.jsx)(t.li,{children:`не должен включать персональные данные.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для долговременного client fingerprint используйте отдельный `,(0,c.jsx)(t.code,{children:`/fingerprint`}),`, понимая его privacy-границы.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`sessionStorage.clear();
+
+const createId = vi.fn(() => "session-1");
+
+expect(getSessionStorageId("test.session", createId)).toBe("session-1");
+expect(getSessionStorageId("test.session", () => "session-2")).toBe("session-1");
+expect(createId).toHaveBeenCalledOnce();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Очищайте `,(0,c.jsx)(t.code,{children:`sessionStorage`}),` между тестами.`]}),`
+`,(0,c.jsx)(t.h2,{id:`api-и-ошибки`,children:`API и ошибки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getSessionStorageId(key: string, createId?: () => string): string;
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Пустой сохранённый string считается отсутствующим и заменяется.`}),`
+`,(0,c.jsx)(t.li,{children:`Ключ и результат generator не валидируются.`}),`
+`,(0,c.jsx)(t.li,{children:`Исключение самого fallback generator может быть проброшено.`}),`
+`,(0,c.jsx)(t.li,{children:`Функция ничего не удаляет из storage.`}),`
+`]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

package/storybook-static/assets/README-B45Cwj2a.js

@@ -0,0 +1,95 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/React/Virtualizer Pagination`}),`
+`,(0,c.jsxs)(t.h1,{id:`дозагрузка-virtualized-списка-через-ryuzaki13react-foundation-libvirtualizer`,children:[`Дозагрузка virtualized списка через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/virtualizer`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useFetchNextPageEffect`}),` вызывает `,(0,c.jsx)(t.code,{children:`fetchNextPage`}),`, когда последняя отрендеренная virtual item достигает конца уже загруженного списка.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install react @tanstack/react-virtual @ryuzaki13/react-foundation-lib
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { useFetchNextPageEffect } from "@ryuzaki13/react-foundation-lib/virtualizer";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Host должен использовать совместимые peer dependencies React `,(0,c.jsx)(t.code,{children:`>=19.2 <20`}),` и `,(0,c.jsx)(t.code,{children:`@tanstack/react-virtual >=3.14 <4`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`virtualItems (видимый диапазон)
+currentItemsCount (сколько уже загружено)
+hasNextPage
+          │
+последний virtual index >= currentItemsCount - 1
+          │
+          ▼
+fetchNextPage() один раз до завершения Promise
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Hook не создаёт virtualizer, не хранит backend data, не строит query key и не решает server pagination. TanStack Query должен оставаться владельцем server snapshot.`}),`
+`,(0,c.jsx)(t.h2,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`useFetchNextPageEffect({
+	virtualItems,
+	currentItemsCount,
+	fetchNextPage,
+	hasNextPage
+});
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Поле`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`virtualItems`})}),(0,c.jsxs)(t.td,{children:[`Текущий массив `,(0,c.jsx)(t.code,{children:`VirtualItem[]`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`currentItemsCount`})}),(0,c.jsx)(t.td,{children:`Число реально загруженных data items`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hasNextPage`})}),(0,c.jsx)(t.td,{children:`Есть ли следующая server page`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fetchNextPage`})}),(0,c.jsx)(t.td,{children:`Stable функция, возвращающая Promise`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Hook ничего не возвращает.`}),`
+`,(0,c.jsx)(t.h2,{id:`пример-с-tanstack-queryvirtual`,children:`Пример с TanStack Query/Virtual`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const rows = query.data?.pages.flatMap((page) => page.rows) ?? [];
+const virtualItems = virtualizer.getVirtualItems();
+
+useFetchNextPageEffect({
+	virtualItems,
+	currentItemsCount: rows.length,
+	hasNextPage: query.hasNextPage,
+	fetchNextPage: async () => {
+		await query.fetchNextPage();
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте количество загруженных строк, а не virtual total с loader row, group headers или estimated backend count.`}),`
+`,(0,c.jsx)(t.h2,{id:`точный-trigger`,children:`Точный trigger`}),`
+`,(0,c.jsx)(t.p,{children:`Fetch не запускается, если:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`virtualItems`}),` пуст;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`currentItemsCount`}),` равен `,(0,c.jsx)(t.code,{children:`0`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`последняя virtual item ещё не достигла `,(0,c.jsx)(t.code,{children:`currentItemsCount - 1`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`hasNextPage === false`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`предыдущий вызов ещё не завершился.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Trigger происходит строго на последнем загруженном индексе. Preload threshold «за N строк до конца» в API отсутствует.`}),`
+`,(0,c.jsx)(t.h2,{id:`защита-от-параллельного-fetch`,children:`Защита от параллельного fetch`}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутренний `,(0,c.jsx)(t.code,{children:`useRef(false)`}),` устанавливается до вызова и сбрасывается в `,(0,c.jsx)(t.code,{children:`.finally()`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`idle ── trigger ──► fetchingRef=true
+                       │
+                 Promise pending
+                       │
+             resolve или reject
+                       ▼
+                 fetchingRef=false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Защита действует только внутри одного mounted hook instance. TanStack Query также должен владеть дедупликацией/network state.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`fetchNextPage`}),` отклоняет Promise, hook не добавляет `,(0,c.jsx)(t.code,{children:`.catch`}),`; rejection может стать unhandled. Передавайте функцию с принятой error policy или wrapper, который корректно обрабатывает ожидаемую ошибку.`]}),`
+`,(0,c.jsx)(t.h2,{id:`referential-stability`,children:`Referential stability`}),`
+`,(0,c.jsxs)(t.p,{children:[`Effect зависит от `,(0,c.jsx)(t.code,{children:`virtualItems`}),`, `,(0,c.jsx)(t.code,{children:`currentItemsCount`}),`, `,(0,c.jsx)(t.code,{children:`hasNextPage`}),`, `,(0,c.jsx)(t.code,{children:`fetchNextPage`}),`.`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Используйте значение virtualizer как предусмотрено его API.`}),`
+`,(0,c.jsx)(t.li,{children:`Не создавайте лишний async callback с новой identity без причины.`}),`
+`,(0,c.jsx)(t.li,{children:`React Compiler не отменяет необходимость stable external contract.`}),`
+`,(0,c.jsxs)(t.li,{children:[`После увеличения `,(0,c.jsx)(t.code,{children:`currentItemsCount`}),` новый fetch произойдёт только когда virtual range достигнет нового конца.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`browser-ssr-и-lifecycle`,children:`Browser, SSR и lifecycle`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сам hook не читает `,(0,c.jsx)(t.code,{children:`window`}),`, но является React effect и не выполняет fetch во время server render. В browser effect запускается после commit.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При unmount Promise не отменяется. Abort/cancel должен быть реализован query/transport owner. `,(0,c.jsx)(t.code,{children:`fetchingRef`}),` больше не влияет после удаления hook instance.`]}),`
+`,(0,c.jsx)(t.h2,{id:`типичные-ошибки`,children:`Типичные ошибки`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Передать total backend rows вместо количества загруженного массива.`}),`
+`,(0,c.jsx)(t.li,{children:`Включить client-side sorting/filtering одной страницы при server-side модели.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Добавить фиктивный loader row в `,(0,c.jsx)(t.code,{children:`currentItemsCount`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Ожидать preload заранее — trigger находится на самом конце.`}),`
+`,(0,c.jsx)(t.li,{children:`Передать rejecting Promise без error handling.`}),`
+`,(0,c.jsx)(t.li,{children:`Выполнять fetch прямо в row render вместо effect.`}),`
+`,(0,c.jsx)(t.li,{children:`Использовать изменяемый index как domain identity строки.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`api`,children:`API`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function useFetchNextPageEffect(args: {
+	virtualItems: VirtualItem[];
+	currentItemsCount: number;
+	hasNextPage: boolean;
+	fetchNextPage: () => Promise<unknown>;
+}): void;
+`})})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};