@ryuzaki13/react-foundation-ui 3.10.1 → 3.11.0

package/README.md

@@ -149,6 +149,17 @@ Mixin `ui-tone()` применяет те же формулы локально,
 
 `accent` больше не является отдельной экспериментальной системой `--interactive-*`: это полноценная семантическая схема с теми же четырьмя ролями. Интерактивные поверхности используют её производные роли для hover/active и базовые роли для устойчивого selected-состояния. Полная карта переименований вынесена в `COLOR_TOKENS_MIGRATION.md`.
 
+## Плавающие окна
+
+Subpath `@ryuzaki13/react-foundation-ui/floating-windows` экспортирует немодальные
+`FloatingWindows` и `FloatingWindow`. Область изолирует геометрию и порядок окон;
+приложение владеет составом окон и их содержимым. Поддерживаются pointer/keyboard
+перемещение, SSR и необязательное сохранение координат.
+
+Размер области задаётся приложением; отдельного portal и блокировки страницы нет.
+Контракт, пример подключения и границы ответственности описаны в
+[документации floating-windows](https://github.com/Ryuzaki13/react-foundation-ui/blob/master/src/floating-windows/README.md).
+
 ## Сканирование штрихкодов
 
 Subpath `@ryuzaki13/react-foundation-ui/barcode-scanner` предоставляет одноразовый модальный сканер для browser-only React-приложений. Он запрашивает камеру только после монтирования, отдаёт первый распознанный код, освобождает `MediaStream` перед закрытием и показывает локализованные ошибки с повторным запуском.

package/dist/floating-windows/FloatingWindow.d.ts

@@ -0,0 +1,19 @@
+import { type CSSProperties, type ReactNode } from "react";
+import { type FloatingWindowPosition } from "./model/floatingWindowsTypes";
+export type FloatingWindowProps = Readonly<{
+    /** Стабильный уникальный ID внутри одного FloatingWindows; не содержит пользовательских сообщений. */
+    id: string;
+    title: string;
+    children: ReactNode;
+    defaultPosition?: FloatingWindowPosition;
+    width?: CSSProperties["width"];
+    height?: CSSProperties["height"];
+    actions?: ReactNode;
+    onClose?: () => void;
+    /** Только завершённый пользователем move; resize-коррекция и восстановление cache не являются командами пользователя. */
+    onPositionChange?: (position: FloatingWindowPosition) => void;
+    className?: string;
+}>;
+/** Немодальное окно: host управляет его существованием, primitive — геометрией, движением и локальным порядком. */
+export declare function FloatingWindow({ id, title, children, defaultPosition, width, height, actions, onClose, onPositionChange, className }: FloatingWindowProps): import("react").JSX.Element;
+//# sourceMappingURL=FloatingWindow.d.ts.map

package/dist/floating-windows/FloatingWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingWindow.d.ts","sourceRoot":"","sources":["../../src/floating-windows/FloatingWindow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AAS1E,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAO3E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,sGAAsG;IACtG,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;IACpB,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yHAAyH;IACzH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,mHAAmH;AACnH,wBAAgB,cAAc,CAAC,EAC9B,EAAE,EACF,KAAK,EACL,QAAQ,EACR,eAAe,EACf,KAAW,EACX,MAAY,EACZ,OAAO,EACP,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,EAAE,mBAAmB,+BA0CrB"}

package/dist/floating-windows/FloatingWindowHeader.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+import { type FloatingWindowMoveResult } from "./model/floatingWindowMoveTypes";
+type FloatingWindowHeaderProps = Readonly<{
+    title: string;
+    titleId: string;
+    instructionId: string;
+    actions?: ReactNode;
+    onClose?: () => void;
+    move: FloatingWindowMoveResult;
+}>;
+/** Handle — самостоятельная кнопка: действия и закрытие не становятся вложенными interactive controls. */
+export declare function FloatingWindowHeader({ title, titleId, instructionId, actions, onClose, move }: FloatingWindowHeaderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=FloatingWindowHeader.d.ts.map

package/dist/floating-windows/FloatingWindowHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingWindowHeader.d.ts","sourceRoot":"","sources":["../../src/floating-windows/FloatingWindowHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,KAAK,yBAAyB,GAAG,QAAQ,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,EAAE,wBAAwB,CAAC;CAC/B,CAAC,CAAC;AAEH,0GAA0G;AAC1G,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,yBAAyB,+BA0BxH"}

package/dist/floating-windows/FloatingWindows.d.ts

@@ -0,0 +1,16 @@
+import { type CSSProperties, type ReactNode } from "react";
+export type FloatingWindowsProps = Readonly<{
+    children: ReactNode;
+    className?: string;
+    /** Размер и размещение области задаёт host: например, height для панели или position:fixed/inset для слоя страницы. */
+    style?: CSSProperties;
+    /** Отдельный ключ неавторитетных координат. Без ключа browser storage не используется. Смена ключа пересоздаёт область. */
+    storageKey?: string;
+    /** Начальный шаг каскада в CSS px; используется только при создании области. */
+    cascadeOffset?: number;
+    /** Диагностика отказа сохранения; окно продолжает работать в памяти. */
+    onStorageError?: (error: unknown) => void;
+}>;
+/** Независимая немодальная область для свободно размещаемых окон; контент не анализируется и не клонируется. */
+export declare function FloatingWindows({ children, className, style, storageKey, cascadeOffset, onStorageError }: FloatingWindowsProps): import("react").JSX.Element;
+//# sourceMappingURL=FloatingWindows.d.ts.map

package/dist/floating-windows/FloatingWindows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingWindows.d.ts","sourceRoot":"","sources":["../../src/floating-windows/FloatingWindows.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK3D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uHAAuH;IACvH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,2HAA2H;IAC3H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C,CAAC,CAAC;AAEH,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,oBAAoB,+BAS9H"}

package/dist/floating-windows/FloatingWindowsBoundary.d.ts

@@ -0,0 +1,10 @@
+import { type CSSProperties, type ReactNode } from "react";
+type FloatingWindowsBoundaryProps = Readonly<{
+    children: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}>;
+/** Измеряемый containing block не перехватывает события страницы за пределами самих окон. */
+export declare function FloatingWindowsBoundary({ children, className, style }: FloatingWindowsBoundaryProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=FloatingWindowsBoundary.d.ts.map

package/dist/floating-windows/FloatingWindowsBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingWindowsBoundary.d.ts","sourceRoot":"","sources":["../../src/floating-windows/FloatingWindowsBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ3D,KAAK,4BAA4B,GAAG,QAAQ,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAEjH,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,4BAA4B,+BAQnG"}

package/dist/floating-windows/FloatingWindowsProvider.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from "react";
+type FloatingWindowsProviderProps = Readonly<{
+    children: ReactNode;
+    cascadeOffset?: number;
+    storageKey?: string;
+    onStorageError?: (error: unknown) => void;
+}>;
+/** Один экземпляр области — один store. Провайдер компонует владельцев state/persistence, не реализуя их алгоритмы. */
+export declare function FloatingWindowsProvider({ children, cascadeOffset, storageKey, onStorageError }: FloatingWindowsProviderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=FloatingWindowsProvider.d.ts.map

package/dist/floating-windows/FloatingWindowsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingWindowsProvider.d.ts","sourceRoot":"","sources":["../../src/floating-windows/FloatingWindowsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMjD,KAAK,4BAA4B,GAAG,QAAQ,CAAC;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C,CAAC,CAAC;AAEH,uHAAuH;AACvH,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,4BAA4B,+BAI5H"}

package/dist/floating-windows/index.d.ts

@@ -0,0 +1,4 @@
+export { FloatingWindows, type FloatingWindowsProps } from "./FloatingWindows";
+export { FloatingWindow, type FloatingWindowProps } from "./FloatingWindow";
+export { type FloatingWindowPosition } from "./model/floatingWindowsTypes";
+//# sourceMappingURL=index.d.ts.map

package/dist/floating-windows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/floating-windows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}