@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

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

@@ -0,0 +1,118 @@
+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`,p:`p`,pre:`pre`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Contracts/Common Types`}),`
+`,(0,c.jsxs)(t.h1,{id:`общие-технические-типы-ryuzaki13react-foundation-libtypes`,children:[`Общие технические типы `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/types`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль содержит небольшие общие TypeScript-контракты для value state, ABAP boolean, базовых значений, диапазонов и строк таблицы. Единственная runtime-функция — `,(0,c.jsx)(t.code,{children:`isBaseType`}),`.`]}),`
+`,(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:`#%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:`#state`,children:(0,c.jsx)(t.code,{children:`State`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#abapboolean`,children:(0,c.jsx)(t.code,{children:`AbapBoolean`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#primitive-%D0%B8-basetype`,children:[(0,c.jsx)(t.code,{children:`Primitive`}),` и `,(0,c.jsx)(t.code,{children:`BaseType`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#isbasetype`,children:(0,c.jsx)(t.code,{children:`isBaseType`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#arraytype-objecttype-inputtype`,children:[(0,c.jsx)(t.code,{children:`ArrayType`}),`, `,(0,c.jsx)(t.code,{children:`ObjectType`}),`, `,(0,c.jsx)(t.code,{children:`InputType`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#rangetype`,children:(0,c.jsx)(t.code,{children:`RangeType`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#rowrecord`,children:(0,c.jsx)(t.code,{children:`RowRecord`})})}),`
+`,(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%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F`,children:`Ошибки проектирования`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { isBaseType } from "@ryuzaki13/react-foundation-lib/types";
+
+import type {
+	AbapBoolean,
+	ArrayType,
+	BaseType,
+	InputType,
+	ObjectType,
+	Primitive,
+	RangeType,
+	RowRecord,
+	State
+} from "@ryuzaki13/react-foundation-lib/types";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы исчезают после компиляции TypeScript. Не пытайтесь использовать `,(0,c.jsx)(t.code,{children:`State`}),` или `,(0,c.jsx)(t.code,{children:`RowRecord`}),` как runtime validator.`]}),`
+`,(0,c.jsx)(t.h2,{id:`state`,children:(0,c.jsx)(t.code,{children:`State`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type State = "" | "none" | "information" | "success" | "warning" | "error";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это общий display/value state, а не HTTP status и не состояние async request.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const state: State = "warning";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка и `,(0,c.jsx)(t.code,{children:`"none"`}),` являются разными допустимыми значениями. Не сжимайте их автоматически в `,(0,c.jsx)(t.code,{children:`undefined`}),`, если contract этого не требует.`]}),`
+`,(0,c.jsx)(t.h2,{id:`abapboolean`,children:(0,c.jsx)(t.code,{children:`AbapBoolean`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type AbapBoolean = "X" | " ";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`ABAP-style boolean использует `,(0,c.jsx)(t.code,{children:`"X"`}),` для истины и строку из одного пробела для лжи. Это не JavaScript boolean:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`Boolean(" "); // true, потому что непустая строка.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для преобразования используйте boolean formatters, а не `,(0,c.jsx)(t.code,{children:`Boolean(value)`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`primitive-и-basetype`,children:[(0,c.jsx)(t.code,{children:`Primitive`}),` и `,(0,c.jsx)(t.code,{children:`BaseType`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Primitive = string | number | boolean | null | undefined;
+type BaseType = Date | Primitive;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`BaseType`}),` добавляет `,(0,c.jsx)(t.code,{children:`Date`}),` к primitive values. Тип `,(0,c.jsx)(t.code,{children:`number`}),` статически включает `,(0,c.jsx)(t.code,{children:`NaN`}),`/`,(0,c.jsx)(t.code,{children:`Infinity`}),`, но runtime guard их отклоняет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`isbasetype`,children:(0,c.jsx)(t.code,{children:`isBaseType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isBaseType("text"); // true.
+isBaseType(10); // true.
+isBaseType(false); // true.
+isBaseType(null); // true.
+isBaseType(undefined); // true.
+isBaseType(new Date()); // true.
+
+isBaseType(Number.NaN); // false.
+isBaseType(Infinity); // false.
+isBaseType(new Date("bad")); // false.
+isBaseType([]); // false.
+isBaseType({}); // false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура является type guard:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function acceptUnknown(value: unknown) {
+	if (!isBaseType(value)) return;
+
+	// Здесь value имеет тип BaseType.
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Guard проверяет только форму базового значения, а не бизнес-ограничения строки/числа/даты.`}),`
+`,(0,c.jsxs)(t.h2,{id:`arraytype-objecttype-inputtype`,children:[(0,c.jsx)(t.code,{children:`ArrayType`}),`, `,(0,c.jsx)(t.code,{children:`ObjectType`}),`, `,(0,c.jsx)(t.code,{children:`InputType`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ArrayType = BaseType[];
+type ObjectType = Readonly<Record<string, BaseType>> | object;
+type InputType = BaseType | ArrayType | ObjectType;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ArrayType`}),` — изменяемый массив базовых значений.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ObjectType`}),` намеренно широкий: union с `,(0,c.jsx)(t.code,{children:`object`}),` допускает практически любой non-primitive object. Он не означает JSON-compatible record и не является runtime-проверкой.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`InputType`}),` объединяет базовые значения, массивы и objects для generic formatter/input contracts. Не используйте его вместо точного domain DTO.`]}),`
+`,(0,c.jsx)(t.h2,{id:`rangetype`,children:(0,c.jsx)(t.code,{children:`RangeType`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RangeType = readonly [BaseType | null, BaseType | null];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Tuple всегда имеет две позиции:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const range: RangeType = [new Date(2026, 0, 1), null];
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`индекс `,(0,c.jsx)(t.code,{children:`0`}),` — начало;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`индекс `,(0,c.jsx)(t.code,{children:`1`}),` — конец;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` обычно означает открытую/незаполненную границу;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`readonly`}),` запрещает присваивание через TypeScript, но не вызывает `,(0,c.jsx)(t.code,{children:`Object.freeze`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поскольку `,(0,c.jsx)(t.code,{children:`BaseType`}),` уже включает `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`, тип исторически широкий. Конкретный UI/domain contract должен задавать более точный `,(0,c.jsx)(t.code,{children:`readonly [T | null, T | null]`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`rowrecord`,children:(0,c.jsx)(t.code,{children:`RowRecord`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RowRecord = Record<string, unknown>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это строка таблицы с неизвестными полями. Перед использованием значения его нужно сузить:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readName(row: RowRecord): string | undefined {
+	return typeof row.name === "string" ? row.name : undefined;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если структура известна, объявляйте точный тип:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type EmployeeRow = {
+	id: string;
+	name: string;
+	salary: number;
+};
+`})}),`
+`,(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:`InputType`}),` как замену schema внешнего JSON.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`ObjectType`}),` plain object.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Приводить `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),` через `,(0,c.jsx)(t.code,{children:`Boolean()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`readonly`}),` runtime-заморозкой.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Использовать `,(0,c.jsx)(t.code,{children:`RowRecord`}),` там, где известны поля сущности.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`isBaseType`}),` проверкой диапазона, длины или разрешённых business values.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Нормализовать `,(0,c.jsx)(t.code,{children:`""`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`[]`}),` и `,(0,c.jsx)(t.code,{children:`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-BuMMG4_N.js

@@ -0,0 +1,192 @@
+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`,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/HTTP/SEO`}),`
+`,(0,c.jsx)(t.h1,{id:`seo`,children:`SEO`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/seo`}),` собирает единый набор SEO-описаний страницы:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`title и обычные meta tags;`}),`
+`,(0,c.jsx)(t.li,{children:`Open Graph;`}),`
+`,(0,c.jsx)(t.li,{children:`Twitter Card;`}),`
+`,(0,c.jsx)(t.li,{children:`canonical link;`}),`
+`,(0,c.jsx)(t.li,{children:`JSON-LD по Schema.org.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Он не меняет `,(0,c.jsx)(t.code,{children:`document.head`}),` напрямую. Результат передаётся роутеру, SSR-фреймворку или собственному renderer head-тегов.`]}),`
+`,(0,c.jsx)(t.h2,{id:`импорт`,children:`Импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createRouteHead, createSeoHead, type SeoContentType, type SeoHeadOptions } from "@ryuzaki13/react-foundation-lib/seo";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функции синхронные и не требуют DOM, поэтому подходят для server rendering.`}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const head = createSeoHead({
+	pathname: "/articles/odata-guide",
+	baseUrl: "https://example.ru",
+	caption: "Практический гайд по OData",
+	description: "Разбираем фильтры, сортировку и пагинацию OData.",
+	type: "Article",
+	keywords: ["OData", "TypeScript", "SAP"],
+	image: {
+		url: "/images/odata-guide.webp",
+		alt: "Схема OData-запроса",
+		width: 1200,
+		height: 630
+	},
+	publishedAt: "2026-08-01T10:00:00+05:00",
+	modifiedAt: "2026-08-20T12:30:00+05:00"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат имеет три массива:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	meta: (Record < string, string > []);
+	links: (Record < string, string > []);
+	scripts: Array<{
+		type: "application/ld+json";
+		children: string;
+	}>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Форма совместима с распространённым route-head подходом, но конкретное подключение зависит от фреймворка.`}),`
+`,(0,c.jsx)(t.h2,{id:`createseoheadoptions`,children:(0,c.jsx)(t.code,{children:`createSeoHead(options)`})}),`
+`,(0,c.jsx)(t.h3,{id:`параметры`,children:`Параметры`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SeoContentType = "WebSite" | "WebPage" | "Article" | "NewsArticle";
+
+type SeoHeadOptions = {
+	pathname: string;
+	caption: string;
+	description: string;
+	type: SeoContentType;
+	baseUrl?: string;
+	keywords?: string[];
+	image?: {
+		url: string;
+		alt?: string | null;
+		width?: number | null;
+		height?: number | null;
+	};
+	publishedAt?: string;
+	modifiedAt?: string;
+	noIndex?: boolean;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`caption`}),` и `,(0,c.jsx)(t.code,{children:`description`}),` обязательны даже для пустой страницы. Библиотека не подставляет название сайта и не обрезает текст под лимиты поисковых систем.`]}),`
+`,(0,c.jsx)(t.h3,{id:`canonical-url`,children:`Canonical URL`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`pathname`}),` уже абсолютный URL, он нормализуется через `,(0,c.jsx)(t.code,{children:`new URL()`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createSeoHead({
+	pathname: "https://example.ru/catalog",
+	// baseUrl не нужен
+	caption: "Каталог",
+	description: "Каталог товаров",
+	type: "WebPage"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для относительного пути рекомендуется обязательно передавать абсолютный `,(0,c.jsx)(t.code,{children:`baseUrl`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`pathname: "/catalog",
+baseUrl: "https://example.ru",
+// canonical: https://example.ru/catalog
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Без `,(0,c.jsx)(t.code,{children:`baseUrl`}),` относительный путь сохраняется как есть. Это может быть приемлемо для некоторых head-renderer, но canonical URL по стандартной практике должен быть абсолютным.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Неверный `,(0,c.jsx)(t.code,{children:`baseUrl`}),` вместе с относительным `,(0,c.jsx)(t.code,{children:`pathname`}),` приводит к исключению `,(0,c.jsx)(t.code,{children:`new URL`}),`. Проверяйте конфигурацию origin при старте приложения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`meta-tags`,children:`Meta tags`}),`
+`,(0,c.jsx)(t.p,{children:`Всегда создаются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`{ title: caption }`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`description;`}),`
+`,(0,c.jsx)(t.li,{children:`robots;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`og:type`}),`, `,(0,c.jsx)(t.code,{children:`og:title`}),`, `,(0,c.jsx)(t.code,{children:`og:description`}),`, `,(0,c.jsx)(t.code,{children:`og:url`}),`, `,(0,c.jsx)(t.code,{children:`og:locale`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`twitter:card`}),`, `,(0,c.jsx)(t.code,{children:`twitter:title`}),`, `,(0,c.jsx)(t.code,{children:`twitter:description`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Article`}),` и `,(0,c.jsx)(t.code,{children:`NewsArticle`}),` получают Open Graph type `,(0,c.jsx)(t.code,{children:`article`}),`. `,(0,c.jsx)(t.code,{children:`WebSite`}),` и `,(0,c.jsx)(t.code,{children:`WebPage`}),` получают `,(0,c.jsx)(t.code,{children:`website`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Локаль фиксирована как `,(0,c.jsx)(t.code,{children:`ru_RU`}),` для Open Graph и `,(0,c.jsx)(t.code,{children:`ru-RU`}),` для JSON-LD.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если есть изображение, Twitter Card становится `,(0,c.jsx)(t.code,{children:`summary_large_image`}),`; без изображения — `,(0,c.jsx)(t.code,{children:`summary`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`индексация`,children:`Индексация`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`noIndex: true;
+// robots: "noindex, nofollow"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию используется `,(0,c.jsx)(t.code,{children:`index, follow`}),`. `,(0,c.jsx)(t.code,{children:`noIndex`}),` формирует meta-инструкцию, но не заменяет серверные заголовки, robots.txt, авторизацию и запрет выдачи приватных страниц.`]}),`
+`,(0,c.jsx)(t.h3,{id:`keywords`,children:`Keywords`}),`
+`,(0,c.jsxs)(t.p,{children:[`Непустой массив соединяется через `,(0,c.jsx)(t.code,{children:`", "`}),` и добавляется одновременно в обычный meta keywords и JSON-LD.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`keywords: ["React", "TypeScript"];
+// "React, TypeScript"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустые строки внутри массива не удаляются автоматически.`}),`
+`,(0,c.jsx)(t.h3,{id:`изображение`,children:`Изображение`}),`
+`,(0,c.jsxs)(t.p,{children:[`Относительный `,(0,c.jsx)(t.code,{children:`image.url`}),` преобразуется с тем же `,(0,c.jsx)(t.code,{children:`baseUrl`}),`. Создаются `,(0,c.jsx)(t.code,{children:`og:image`}),` и `,(0,c.jsx)(t.code,{children:`twitter:image`}),`; при наличии `,(0,c.jsx)(t.code,{children:`alt`}),` дополнительно создаётся `,(0,c.jsx)(t.code,{children:`og:image:alt`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В JSON-LD формируется `,(0,c.jsx)(t.code,{children:`ImageObject`}),`. Неуказанные `,(0,c.jsx)(t.code,{children:`width`}),`, `,(0,c.jsx)(t.code,{children:`height`}),` и `,(0,c.jsx)(t.code,{children:`alt`}),` остаются `,(0,c.jsx)(t.code,{children:`undefined`}),` либо `,(0,c.jsx)(t.code,{children:`null`}),` согласно исходным данным и поведению `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`даты`,children:`Даты`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`publishedAt`}),` и `,(0,c.jsx)(t.code,{children:`modifiedAt`}),` разбираются через стандартный `,(0,c.jsx)(t.code,{children:`Date`}),` и записываются в ISO UTC:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`publishedAt: "2026-08-01T10:00:00+05:00";
+// datePublished: "2026-08-01T05:00:00.000Z"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустая или неверная дата молча не добавляется. Для предсказуемости передавайте ISO 8601 со временной зоной.`}),`
+`,(0,c.jsx)(t.h2,{id:`json-ld`,children:`JSON-LD`}),`
+`,(0,c.jsx)(t.p,{children:`Каждый вызов создаёт один script descriptor:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+  type: "application/ld+json",
+  children: JSON.stringify({
+    "@context": "https://schema.org",
+    "@type": type,
+    mainEntityOfPage: { "@type": "WebPage", "@id": canonicalUrl },
+    headline: caption,
+    description,
+    url: canonicalUrl,
+    inLanguage: "ru-RU",
+  }),
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Библиотека возвращает строку, а не готовый React-элемент. Следуйте API head-renderer. Если вручную вставляете строку в HTML script, учитывайте XSS-границу: SEO-текст должен быть доверенным или безопасно экранированным renderer. Простого `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),` недостаточно для произвольного пользовательского текста, содержащего последовательности вроде закрывающего `,(0,c.jsx)(t.code,{children:`script`}),`-тега.`]}),`
+`,(0,c.jsx)(t.h2,{id:`createrouteheadtype-path-params`,children:(0,c.jsx)(t.code,{children:`createRouteHead(type, path, params)`})}),`
+`,(0,c.jsx)(t.p,{children:`Упрощённый адаптер для данных route loader/CMS:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type SeoHeadParams = {
+	caption: string;
+	description: string;
+	previewImage: string | null;
+	previewImageAlt: string | null;
+	created: string;
+	updated: string;
+};
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const head = createRouteHead("NewsArticle", "/news/42", loaderData?.seo);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Адаптер:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`передаёт `,(0,c.jsx)(t.code,{children:`path`}),` как `,(0,c.jsx)(t.code,{children:`pathname`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`при `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` params подставляет пустые `,(0,c.jsx)(t.code,{children:`caption`}),` и `,(0,c.jsx)(t.code,{children:`description`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`превращает `,(0,c.jsx)(t.code,{children:`previewImage`}),` в `,(0,c.jsx)(t.code,{children:`image`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`сопоставляет `,(0,c.jsx)(t.code,{children:`created`}),` с `,(0,c.jsx)(t.code,{children:`publishedAt`}),`, `,(0,c.jsx)(t.code,{children:`updated`}),` с `,(0,c.jsx)(t.code,{children:`modifiedAt`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не передаёт `,(0,c.jsx)(t.code,{children:`baseUrl`}),`, keywords или `,(0,c.jsx)(t.code,{children:`noIndex`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому URL результата останется относительным, если `,(0,c.jsx)(t.code,{children:`path`}),` относительный. Когда нужен абсолютный canonical, используйте полный `,(0,c.jsx)(t.code,{children:`createSeoHead`}),` либо передавайте абсолютный `,(0,c.jsx)(t.code,{children:`path`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`пример-с-tanstack-router`,children:`Пример с TanStack Router`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`export const Route = createFileRoute("/articles/$slug")({
+	loader: loadArticle,
+	head: ({ loaderData, params }) =>
+		createSeoHead({
+			pathname: \`/articles/\${params.slug}\`,
+			baseUrl: "https://example.ru",
+			caption: loaderData.title,
+			description: loaderData.description,
+			type: "Article",
+			image: loaderData.image ? { url: loaderData.image, alt: loaderData.title } : undefined
+		})
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверьте точную форму `,(0,c.jsx)(t.code,{children:`head`}),` вашей версии роутера: библиотека возвращает структурные данные, но не связывается с router напрямую.`]}),`
+`,(0,c.jsx)(t.h2,{id:`проверка-результата`,children:`Проверка результата`}),`
+`,(0,c.jsx)(t.p,{children:`Для каждой важной страницы проверьте:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`canonical абсолютный и соответствует публичному URL;`}),`
+`,(0,c.jsx)(t.li,{children:`title и description не пусты;`}),`
+`,(0,c.jsx)(t.li,{children:`Open Graph image доступно без авторизации;`}),`
+`,(0,c.jsx)(t.li,{children:`JSON-LD проходит validator Schema.org/поисковой системы;`}),`
+`,(0,c.jsx)(t.li,{children:`preview SSR HTML содержит теги до выполнения JavaScript;`}),`
+`,(0,c.jsx)(t.li,{children:`приватные страницы имеют правильную политику индексации.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`передавать-относительный-путь-без-baseurl`,children:[`Передавать относительный путь без `,(0,c.jsx)(t.code,{children:`baseUrl`})]}),`
+`,(0,c.jsx)(t.p,{children:`Функция не знает публичный origin приложения и оставит URL относительным.`}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-createroutehead-полным-аналогом-createseohead`,children:[`Считать `,(0,c.jsx)(t.code,{children:`createRouteHead`}),` полным аналогом `,(0,c.jsx)(t.code,{children:`createSeoHead`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Адаптер специально узкий и не принимает base URL, keywords, размеры image и `,(0,c.jsx)(t.code,{children:`noIndex`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`передавать-локальную-дату-без-timezone`,children:`Передавать локальную дату без timezone`}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат стандартного `,(0,c.jsx)(t.code,{children:`Date`}),` может зависеть от окружения. Используйте полный ISO 8601.`]}),`
+`,(0,c.jsx)(t.h3,{id:`генерировать-seo-только-после-client-fetch`,children:`Генерировать SEO только после client fetch`}),`
+`,(0,c.jsx)(t.p,{children:`Для надёжной индексации head должен появляться в SSR/pre-render HTML, если архитектура приложения это поддерживает.`}),`
+`,(0,c.jsx)(t.h3,{id:`передавать-недоверенный-текст-напрямую-в-json-ld-script`,children:`Передавать недоверенный текст напрямую в JSON-LD script`}),`
+`,(0,c.jsx)(t.p,{children:`Используйте безопасный renderer и контролируйте источник SEO-полей.`}),`
+`,(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:`Экспорт`}),(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:`createSeoHead(options)`})}),(0,c.jsx)(t.td,{children:`Собрать полный meta/link/JSON-LD набор`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createRouteHead(type, path, params)`})}),(0,c.jsx)(t.td,{children:`Адаптировать типичные route SEO-поля`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SeoContentType`})}),(0,c.jsx)(t.td,{children:`Допустимый Schema.org content type`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SeoHeadOptions`})}),(0,c.jsx)(t.td,{children:`Полная конфигурация страницы`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SeoHeadParams`})}),(0,c.jsx)(t.td,{children:`Входные данные упрощённого route adapter`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SeoImage`})}),(0,c.jsx)(t.td,{children:`URL и описательные размеры preview-изображения`})]})]})]})]})}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-BxjYCoYA.js

@@ -0,0 +1,186 @@
+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/Data/Bounded Copy Stack`}),`
+`,(0,c.jsxs)(t.h1,{id:`ограниченный-стек-копий-через-ryuzaki13react-foundation-libbounded-copy-stack`,children:[`Ограниченный стек копий через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/bounded-copy-stack`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль хранит небольшой список последних скопированных сущностей. Новый элемент помещается в начало, повтор по `,(0,c.jsx)(t.code,{children:`fingerprint`}),` обновляет существующую запись, а старые записи удаляются при превышении лимита.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Документ рассчитан на разработчика без доступа к исходникам пакета. Ниже объясняются структура элемента, различие `,(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`fingerprint`}),`, порядок записей, ссылки на payload и все граничные случаи.`]}),`
+`,(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%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,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%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F`,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:`#pushboundedcopystackitem`,children:(0,c.jsx)(t.code,{children:`pushBoundedCopyStackItem`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#getboundedcopystackcandidates`,children:(0,c.jsx)(t.code,{children:`getBoundedCopyStackCandidates`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D1%81%D1%8B%D0%BB%D0%BA%D0%B8-%D1%85%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D1%81%D0%B5%D1%80%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%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.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B8%D0%BF%D0%B8%D1%87%D0%BD%D1%8B%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Типичные ошибки`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.p,{children:`Типичный сценарий — показать пользователю несколько последних вариантов для повторной вставки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`копирование A ──► [A]
+копирование B ──► [B, A]
+повтор A       ──► [новая A, B]
+копирование C  ──► [C, новая A, B]
+копирование D  ──► [D, C, новая A]  при maxSize = 3
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не использует системный clipboard;`}),`
+`,(0,c.jsx)(t.li,{children:`не сохраняет список в storage;`}),`
+`,(0,c.jsx)(t.li,{children:`не создаёт React state или Zustand store;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не клонирует `,(0,c.jsx)(t.code,{children:`payload`}),` и `,(0,c.jsx)(t.code,{children:`meta`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не сравнивает payload глубоко;`}),`
+`,(0,c.jsx)(t.li,{children:`не нормализует данные;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет вставку выбранного кандидата.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Clipboard helpers находятся в `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`}),`. Владелец state/storage находится в host-приложении.`]}),`
+`,(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
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	DEFAULT_BOUNDED_COPY_STACK_SIZE,
+	getBoundedCopyStackCandidates,
+	pushBoundedCopyStackItem
+} from "@ryuzaki13/react-foundation-lib/bounded-copy-stack";
+
+import type {
+	BoundedCopyStackItem,
+	BoundedCopyStackOptions,
+	BoundedCopyStackPushInput,
+	BoundedCopyStackPushResult
+} from "@ryuzaki13/react-foundation-lib/bounded-copy-stack";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой и глубокий импорты не поддерживаются. Модуль ESM, не зависит от React и browser APIs.`}),`
+`,(0,c.jsx)(t.h2,{id:`основные-понятия`,children:`Основные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`элемент-стека`,children:`Элемент стека`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BoundedCopyStackItem<TPayload, TMeta = undefined> = {
+	id: string;
+	fingerprint: string;
+	payload: TPayload;
+	meta: TMeta;
+	copiedAt: number;
+};
+`})}),`
+`,(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:`id`})}),(0,c.jsx)(t.td,{children:`Идентификатор конкретной записи/операции копирования`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fingerprint`})}),(0,c.jsx)(t.td,{children:`Идентичность содержимого для удаления повторов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`payload`})}),(0,c.jsx)(t.td,{children:`Данные, которые host затем сможет вставить`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`meta`})}),(0,c.jsx)(t.td,{children:`Подпись, тип, источник или другая информация для UI`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`copiedAt`})}),(0,c.jsx)(t.td,{children:`Время копирования в миллисекундах Unix; функция не сортирует по этому полю`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`id`}),` и `,(0,c.jsx)(t.code,{children:`fingerprint`}),` решают разные задачи. При повторном копировании содержимого `,(0,c.jsx)(t.code,{children:`fingerprint`}),` остаётся прежним, а `,(0,c.jsx)(t.code,{children:`id`}),`, `,(0,c.jsx)(t.code,{children:`payload`}),`, `,(0,c.jsx)(t.code,{children:`meta`}),` и `,(0,c.jsx)(t.code,{children:`copiedAt`}),` могут стать новыми.`]}),`
+`,(0,c.jsx)(t.h3,{id:`порядок`,children:`Порядок`}),`
+`,(0,c.jsxs)(t.p,{children:[`Индекс `,(0,c.jsx)(t.code,{children:`0`}),` всегда содержит элемент последней операции `,(0,c.jsx)(t.code,{children:`push`}),`. Функция доверяет входному порядку и не сортирует список по `,(0,c.jsx)(t.code,{children:`copiedAt`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ColumnCopy = {
+	columnId: string;
+	width: number;
+};
+
+type ColumnCopyMeta = {
+	label: string;
+};
+
+let stack: BoundedCopyStackItem<ColumnCopy, ColumnCopyMeta>[] = [];
+
+const result = pushBoundedCopyStackItem(stack, {
+	id: crypto.randomUUID(),
+	fingerprint: "column:amount:width:120",
+	payload: { columnId: "amount", width: 120 },
+	meta: { label: "Сумма — ширина 120" }
+});
+
+stack = result.items;
+console.log(result.updatedExisting); // false.
+console.log(result.addedItem.copiedAt); // Date.now() на момент вызова.
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`pushboundedcopystackitem`,children:(0,c.jsx)(t.code,{children:`pushBoundedCopyStackItem`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = pushBoundedCopyStackItem(items, input, { maxSize: 3 });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Создаёт новый элемент из `,(0,c.jsx)(t.code,{children:`input`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`copiedAt`}),` отсутствует, подставляет `,(0,c.jsx)(t.code,{children:`Date.now()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Ищет любой элемент с точно равным `,(0,c.jsx)(t.code,{children:`fingerprint`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Удаляет из старого списка все элементы с таким fingerprint.`}),`
+`,(0,c.jsx)(t.li,{children:`Помещает новый элемент в начало.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Обрезает результат до `,(0,c.jsx)(t.code,{children:`maxSize`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Входной массив не изменяется. Возвращается новый массив.`}),`
+`,(0,c.jsx)(t.h3,{id:`повторный-fingerprint`,children:`Повторный fingerprint`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const oldItems = [
+	{
+		id: "old",
+		fingerprint: "same-content",
+		payload: { value: 1 },
+		meta: undefined,
+		copiedAt: 1
+	}
+];
+
+const result = pushBoundedCopyStackItem(oldItems, {
+	id: "new",
+	fingerprint: "same-content",
+	payload: { value: 2 },
+	meta: undefined,
+	copiedAt: 2
+});
+
+console.log(result.items.length); // 1.
+console.log(result.items[0].id); // "new".
+console.log(result.updatedExisting); // true.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сравнение fingerprint регистрозависимое и использует `,(0,c.jsx)(t.code,{children:`===`}),`. Строки `,(0,c.jsx)(t.code,{children:`"A"`}),` и `,(0,c.jsx)(t.code,{children:`"a"`}),` различны.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нормализация-maxsize`,children:[`Нормализация `,(0,c.jsx)(t.code,{children:`maxSize`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Default `,(0,c.jsx)(t.code,{children:`DEFAULT_BOUNDED_COPY_STACK_SIZE`}),` равен `,(0,c.jsx)(t.code,{children:`3`}),`.`]}),`
+`,(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,{style:{textAlign:`right`},children:`Фактический лимит`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`, `,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`})]}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`3`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`5.9`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`5`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`1`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`0`}),`, отрицательное конечное значение`]}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Полностью отключить хранение через `,(0,c.jsx)(t.code,{children:`maxSize: 0`}),` нельзя. Если список не нужен, host должен не вызывать push или хранить пустой state самостоятельно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`результат`,children:`Результат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type BoundedCopyStackPushResult<TPayload, TMeta> = {
+	items: BoundedCopyStackItem<TPayload, TMeta>[];
+	addedItem: BoundedCopyStackItem<TPayload, TMeta>;
+	updatedExisting: boolean;
+};
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`items`}),` — итоговый ограниченный список;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`addedItem`}),` — созданная запись, даже если из-за будущей логики host её не сохранит;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`updatedExisting`}),` — был ли во входном списке такой fingerprint.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`getboundedcopystackcandidates`,children:(0,c.jsx)(t.code,{children:`getBoundedCopyStackCandidates`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция фильтрует записи предикатом и сохраняет исходный порядок:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const tableCandidates = getBoundedCopyStackCandidates(stack, (item) => item.meta.kind === "table-column");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Она эквивалентна типизированному `,(0,c.jsx)(t.code,{children:`items.filter(predicate)`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`возвращает новый массив;`}),`
+`,(0,c.jsx)(t.li,{children:`не клонирует элементы;`}),`
+`,(0,c.jsx)(t.li,{children:`не изменяет исходный массив;`}),`
+`,(0,c.jsx)(t.li,{children:`не ограничивает количество дополнительно;`}),`
+`,(0,c.jsx)(t.li,{children:`исключение из predicate пробрасывается вызывающему коду.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`ссылки-хранение-и-сериализация`,children:`Ссылки, хранение и сериализация`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`payload`}),` и `,(0,c.jsx)(t.code,{children:`meta`}),` переносятся по ссылке:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const payload = { nested: { value: 1 } };
+const result = pushBoundedCopyStackItem([], {
+	id: "1",
+	fingerprint: "one",
+	payload,
+	meta: undefined
+});
+
+console.log(result.addedItem.payload === payload); // true.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужна независимая data-only копия, создайте её через `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),` из `,(0,c.jsx)(t.code,{children:`/utils`}),` до push. Clone не должен нормализовать данные.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`localStorage`}),`/`,(0,c.jsx)(t.code,{children:`sessionStorage`}),` host самостоятельно отвечает за:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`JSON-compatible payload/meta;`}),`
+`,(0,c.jsx)(t.li,{children:`версию persisted schema;`}),`
+`,(0,c.jsx)(t.li,{children:`runtime-проверку восстановленных данных;`}),`
+`,(0,c.jsx)(t.li,{children:`удаление устаревших записей;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствие секретов и персональных данных.`}),`
+`]}),`
+`,(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:`DEFAULT_BOUNDED_COPY_STACK_SIZE`})}),(0,c.jsxs)(t.td,{children:[`Default-лимит `,(0,c.jsx)(t.code,{children:`3`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pushBoundedCopyStackItem`})}),(0,c.jsx)(t.td,{children:`Добавляет/обновляет запись и ограничивает список`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getBoundedCopyStackCandidates`})}),(0,c.jsx)(t.td,{children:`Фильтрует кандидатов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BoundedCopyStackItem`})}),(0,c.jsx)(t.td,{children:`Полная сохранённая запись`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BoundedCopyStackPushInput`})}),(0,c.jsxs)(t.td,{children:[`Вход push; `,(0,c.jsx)(t.code,{children:`copiedAt`}),` optional`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BoundedCopyStackOptions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ maxSize?: number }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`BoundedCopyStackPushResult`})}),(0,c.jsx)(t.td,{children:`Итоговый список и сведения об операции`})]})]})]}),`
+`,(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:`id`}),` как fingerprint: дубликаты содержимого никогда не объединятся.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Ожидать сортировку по `,(0,c.jsx)(t.code,{children:`copiedAt`}),`: порядок определяется вызовами push.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Мутировать `,(0,c.jsx)(t.code,{children:`payload`}),` после push и ожидать snapshot: ссылка общая.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Передавать `,(0,c.jsx)(t.code,{children:`maxSize: 0`}),` для отключения: получится лимит `,(0,c.jsx)(t.code,{children:`1`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Хранить callback/DOM node в persisted stack: модуль не делает данные сериализуемыми.`}),`
+`,(0,c.jsx)(t.li,{children:`Вызывать helper вместо clipboard API: стек ничего не копирует в ОС.`}),`
+`]})]})}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-MzcO5Z_P.js → README-ByALXSEH.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`,h4:`h4`,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/DOM`}),`
+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`,h4:`h4`,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/DOM`}),`
 `,(0,c.jsxs)(t.h1,{id:`browser-dom-и-focus-helpers-через-ryuzaki13react-foundation-libdom`,children:[`Browser DOM и focus helpers через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/dom`})]}),`
 `,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`dom`}),` содержит небольшие browser helpers и React hooks для типовых инфраструктурных задач:`]}),`
 `,(0,c.jsxs)(t.ul,{children:[`