@fragmentsx/fragments-client 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @fragmentsx/fragments-client
+
+Клиентское ядро Fragments: загрузка и кеширование областей (area), фрагментов
+и css-чанков, метрики. Транспортный слой, на котором строится
+`@fragmentsx/runtime-react` — сам по себе фреймворк-агностичен и не зависит
+от React.
+
+## Что это решает
+
+Публичный API площадки (Fragments) отдаёт документ области и связанные с ней
+ресурсы по сети. `fragments-client` инкапсулирует:
+
+- разрешение области (`areaPlugin`) с версионированием формата ответа;
+- кеширование фрагментов (`fragmentsCachePlugin`) и css-чанков
+  (`createCssChunksCachePlugin`) поверх `@graph-state/core`;
+- отправку метрик (`globalMetricsPlugin`);
+- типизированные ошибки (`FragmentsAreaError`, `FragmentsApiVersionError`,
+  `FragmentsLoadError`) для явной обработки сбоев сети/версии на стороне
+  потребителя.
+
+## Установка
+
+```bash
+pnpm add @fragmentsx/fragments-client
+```
+
+## Использование
+
+```ts
+import { createFragmentsClient } from '@fragmentsx/fragments-client';
+
+const client = createFragmentsClient({
+  apiUrl: 'https://api.fragments.example.com',
+  projectId: 'my-project',
+});
+
+const area = await client.$area.resolve('home');
+```
+
+## Пара с runtime-react
+
+`@fragmentsx/runtime-react` — React-обвязка над этим пакетом
+(`FragmentsProvider`, `Area`, хуки `useFragmentComponent`, `useArea` и
+другие). `fragments-client` используется напрямую только при интеграции с
+другим UI-слоем или для написания собственного рантайма.

package/dist/$area/index.d.ts

@@ -0,0 +1,69 @@
+import { Plugin } from '@graph-state/core';
+import { ResolvedValue } from '../types';
+/**
+ * Тип resolved value из $area.resolve — subset manifest без fragment refs.
+ * useArea (Plan 07) потребляет именно этот контракт.
+ */
+export interface AreaResolveResult {
+    rootFragmentId: number;
+    /**
+     * Phase 73, B-02/B-06: готовые значения props корневого артефакта — привязки
+     * `{$ref:{scope,name}}` из `Variant.props` уже разрешены сервером. Автоподстановки
+     * по имени (`_id`-канал) больше нет — B-13. Всегда объект: редукция нормализует
+     * отсутствие поля у backend'а в `{}`, а не в `undefined`, чтобы потребитель
+     * (useArea) не делал двойную optional-проверку.
+     */
+    props: Record<string, ResolvedValue>;
+    /**
+     * Phase 72 D-72-01/D-72-02: словарь project-переменных площадки (ключ — `name`,
+     * значение — голое). Значение всегда объект: редукция ниже нормализует
+     * отсутствие поля у backend'а в `{}`, поэтому потребитель (useArea) не делает
+     * повторную optional-проверку — тот же приём, что применён к полю `props` выше.
+     */
+    projectProperties: Record<string, ResolvedValue>;
+    /**
+     * URL к глобальному baseline reset CSS (см. AreaResolveResponse.globalCssUrl).
+     * `null` — backend не отдаёт global reset.
+     */
+    globalCssUrl: string | null;
+}
+/**
+ * Публичный тип $area namespace.
+ */
+export interface AreaNamespace {
+    /**
+     * Resolves area по коду: HTTP GET /api/area/<code>/compiled → populate caches.
+     *
+     * - Cache hit → возвращает sync (Promise resolved immediately).
+     * - Miss → вызывает state.$fetch.get(), populate side-effects.
+     * - Concurrent calls для того же code → dedup через in-flight Map.
+     *
+     * @param code - area code
+     * @param opts.timeout - таймаут в мс (AbortSignal.timeout — через fetchPlugin)
+     */
+    resolve: (code: string, opts?: {
+        timeout?: number;
+    }) => Promise<AreaResolveResult>;
+    /**
+     * Synchronous Suspense-throw protocol:
+     * - cache hit → sync return
+     * - pending in-flight → throw Promise
+     * - miss → throw FragmentsAreaError("AREA_NOT_RESOLVED")
+     */
+    read: (code: string) => AreaResolveResult;
+    /**
+     * Проверяет наличие terminal entry в кэше (resolved ИЛИ rejected).
+     * Не учитывает in-flight — для in-flight используйте `$area.resolve`, который
+     * dedup'ит через inflightMap. Семантика «has terminal state» нужна для
+     * auto-resolve хелперов: они не должны перезапускать fetch на rejected,
+     * иначе образуется retry-storm (см. runtime-react useArea.ts).
+     */
+    has: (code: string) => boolean;
+}
+/**
+ * areaPlugin — подключает $area namespace к GraphState.
+ *
+ * Все cache Map'ы per-state (closure-scoped) → per-request SSR isolation natural (D-13).
+ */
+export declare const areaPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/$area/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/$area/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,UAAU,CAAC;AAYnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjD;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnF;;;;;OAKG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC1C;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAChC;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAmIxB,CAAC"}

package/dist/$area/index.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Тесты для areaPlugin — $area namespace.
+ *
+ * Адаптированы для fragments-client: $area.resolve идёт через state.$fetch.get
+ * (compiled fetchPlugin), а не через direct globalThis.fetch (как в client-core аналоге).
+ *
+ * Проверяет D-03 HTTP path, typed errors (Req #6), populate side-effects (Req #2),
+ * cache hit dedup, и Phase 73 форму поля `props` (B-02/B-06) — готовые значения,
+ * разрешённые сервером, без автоподстановки по имени.
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/$area/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/$area/index.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/$cssChunks/index.d.ts

@@ -0,0 +1,27 @@
+import { Plugin } from '@graph-state/core';
+/**
+ * Тип функции injection — принимает URL и ключ, возвращает cleanup callback.
+ * Реализуется через `injectStylesheet` из `@fragmentsx/runtime-react`.
+ * В SSR (isBrowser = false) — injectStylesheet сам возвращает noop.
+ */
+type InjectFn = (href: string, key: string) => () => void;
+/**
+ * Опции factory.
+ */
+interface CreateCssChunksCachePluginOptions {
+    /**
+     * Функция DOM injection — `injectStylesheet` из `@fragmentsx/runtime-react`.
+     * В SSR сам возвращает noop (isBrowser guard внутри).
+     * В тестах может быть заменён spy-функцией.
+     */
+    inject: InjectFn;
+}
+/**
+ * Factory function — создаёт Plugin для cache namespace `$cssChunks`.
+ *
+ * @param opts.inject - DOM injector callback (factory injection, BLOCKER-4)
+ * @returns Plugin function для передачи в createState plugins array
+ */
+export declare function createCssChunksCachePlugin(opts: CreateCssChunksCachePluginOptions): Plugin;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/$cssChunks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/$cssChunks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;GAIG;AACH,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;AAE1D;;GAEG;AACH,UAAU,iCAAiC;IACzC;;;;OAIG;IACH,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iCAAiC,GAAG,MAAM,CAwB1F"}

package/dist/$cssChunks/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/$cssChunks/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/$cssChunks/index.test.ts"],"names":[],"mappings":""}

package/dist/$fragments/index.d.ts

@@ -0,0 +1,113 @@
+import { Plugin } from '@graph-state/core';
+import { FragmentRef } from '../types';
+/**
+ * DI importer seam — signature для production и тестового importer'а.
+ * Default: `(url) => import(url)` (native dynamic import).
+ * Test: `vi.fn().mockResolvedValue({ default: TestComponent })`.
+ *
+ * Index signature допускает произвольные named exports модуля (Phase 68 D-10) —
+ * в частности `schema` рукописного TSX-артефакта — без приведения через `any`
+ * в месте использования.
+ */
+type Importer = (moduleUrl: string) => Promise<{
+    default: unknown;
+    [key: string]: unknown;
+}>;
+/**
+ * Опции фабрики плагина.
+ */
+export interface CreateFragmentsCachePluginOpts {
+    /**
+     * Optional importer DI seam.
+     * Default — native dynamic `import(url)` (production).
+     * Передайте `vi.fn()` mock в тестах (WARNING-2 resolution).
+     */
+    importer?: Importer;
+}
+/**
+ * Публичный тип $fragments namespace — используется downstream (runtime-react).
+ * Typed augmentation GraphState.$fragments в src/declarations.d.ts (D-05).
+ */
+export interface FragmentsCacheNamespace {
+    /** Проверяет наличие id в кэше (любой status). */
+    has: (id: number) => boolean;
+    /**
+     * Suspense protocol read:
+     * - cache hit "success" → sync ComponentType
+     * - "pending" → throws inflight Promise
+     * - "error" → throws FragmentsLoadError
+     * - id отсутствует → throws FragmentsLoadError("not populated")
+     */
+    read: (id: number) => unknown;
+    /**
+     * Populate кэша параллельными `import(moduleUrl)` вызовами.
+     * Idempotent: уже cached id → skip.
+     * Cross-area dedup natural — один import() per unique id.
+     */
+    populate: (refs: Record<number, FragmentRef>) => void;
+    /**
+     * Sync getter для FragmentRef metadata (cssUrl, fontsUrl и т.д.).
+     * Используется Area composition для FragmentStylesheet preamble injection
+     * (BLOCKER-1 resolution — SPEC AC #11/#12).
+     *
+     * @param id - fragment id
+     * @returns FragmentRef если id populate'ен, undefined если нет
+     */
+    getRef: (id: number) => FragmentRef | undefined;
+    /**
+     * Sync getter для named export `schema` уже загруженного модуля.
+     *
+     * D-10: артефакт — единственный источник истины. `schema` не сериализуется
+     * отдельно в манифест (это завело бы второй источник истины) — единственное
+     * место, где она реально известна, это уже загруженный JS-модуль, то есть
+     * этот кэш.
+     *
+     * @param id - fragment id
+     * @returns schema если модуль populate'ен, загружен успешно и содержит named
+     *  export `schema`; undefined во всех остальных случаях (id не в кэше,
+     *  status "pending"/"error", либо модуль без `schema`)
+     */
+    getSchema: (id: number) => unknown | undefined;
+    /**
+     * Sync getter для named export `scopeClass` уже загруженного модуля
+     * (quick-260830-kyg, задача 2) — зеркально `getSchema`.
+     *
+     * Артефакт — единственный источник истины: класс дописывает компилятор
+     * (`appendScopeClassExport`, `@fragmentsx/fragment-compiler`), поле не
+     * сериализуется в манифест — это завело бы второй источник истины и класс
+     * ошибок «поле есть, путь его не наполняет» (quick-260828-khw).
+     *
+     * @param id - fragment id
+     * @returns scopeClass если модуль populate'ен, загружен успешно и содержит
+     *  named export `scopeClass` строкового типа; undefined во всех остальных
+     *  случаях (id не в кэше, status "pending"/"error", модуль без
+     *  `scopeClass` либо экспорт не-строкой)
+     */
+    getScopeClass: (id: number) => string | undefined;
+}
+/**
+ * Фабрика плагина `client.$fragments`.
+ *
+ * Принимает optional importer DI seam для тестирования (WARNING-2 resolution).
+ * Default value = native dynamic import wrapper.
+ *
+ * @example
+ * // Production (createFragmentsClient):
+ * createFragmentsClient({ plugins: [createFragmentsCachePlugin()] })
+ *
+ * // В тестах:
+ * const spy = vi.fn().mockResolvedValue({ default: TestComponent });
+ * const plugin = createFragmentsCachePlugin({ importer: spy });
+ */
+export declare function createFragmentsCachePlugin(opts?: CreateFragmentsCachePluginOpts): Plugin;
+/**
+ * Pre-baked instance с default native importer.
+ * Backwards-compat export для callers которые не нуждаются в DI.
+ *
+ * @example
+ * // Простое использование без DI:
+ * createFragmentsClient({ plugins: [fragmentsCachePlugin] })
+ */
+export declare const fragmentsCachePlugin: Plugin;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/$fragments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/$fragments/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;GAQG;AACH,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAgCD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;IACtD;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAChD;;;;;;;;;;;;OAYG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAC/C;;;;;;;;;;;;;;OAcG;IACH,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,CAAC,EAAE,8BAA8B,GACpC,MAAM,CA8GR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAqC,CAAC"}

package/dist/$fragments/index.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Тесты для $fragments cache namespace (Req #10 + D-08).
+ * Verifies Suspense protocol, idempotency, cross-area dedup через DI importer (WARNING-2 resolution).
+ * Test 8 — real-import smoke без DI для validation factory wiring.
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/$fragments/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/$fragments/index.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/createFragmentsClient.d.ts

@@ -0,0 +1,36 @@
+import { Plugin } from '@graph-state/core';
+/**
+ * Тип inject функции — DOM injection callback.
+ * Production: `injectStylesheet` из `@fragmentsx/runtime-react`.
+ * Default: noop (для SSR и node/test environments).
+ */
+type InjectFn = (href: string, key: string) => () => void;
+/**
+ * Options для createFragmentsClient.
+ *
+ * Поле inject для BLOCKER-4 wiring — пробрасывается в createCssChunksCachePlugin.
+ */
+export interface Options {
+    apiToken: string;
+    projectId?: number;
+    referer?: string;
+    backendEndpoint?: string;
+    timeout?: number;
+    plugins?: Plugin[];
+    /**
+     * DOM injection callback (BLOCKER-4 wiring).
+     * Default — noop: `() => () => {}` (no-op для SSR/test).
+     * Production: `inject = injectStylesheet` из `@fragmentsx/runtime-react`.
+     */
+    inject?: InjectFn;
+}
+/**
+ * Создаёт compiled-only GraphState client.
+ *
+ * @example
+ * import { createFragmentsClient } from '@fragmentsx/fragments-client';
+ * const client = createFragmentsClient({ apiToken: 'your-token' });
+ */
+export declare const createFragmentsClient: (options: Options) => import('@graph-state/core').GraphState<import('@graph-state/core').SystemFields, "GlobalManager">;
+export {};
+//# sourceMappingURL=createFragmentsClient.d.ts.map

package/dist/createFragmentsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFragmentsClient.d.ts","sourceRoot":"","sources":["../src/createFragmentsClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAkB7D;;;;GAIG;AACH,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,OAAO,sGA4CrD,CAAC"}

package/dist/createFragmentsClient.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Тесты для createFragmentsClient factory.
+ *
+ * Проверяет:
+ * - Наличие всех namespace'ов: $fetch, $metrics, $area, $fragments, $cssChunks
+ * - Отсутствие legacy JIT plugins: $fonts, $properties, $globalStylesheet (Req #1)
+ * - BLOCKER-4: opts.inject пробрасывается в createCssChunksCachePlugin
+ * - Default noop inject — не крашит на populate
+ * - backendEndpoint default
+ * - $project при projectId
+ */
+export {};
+//# sourceMappingURL=createFragmentsClient.test.d.ts.map

package/dist/createFragmentsClient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFragmentsClient.test.d.ts","sourceRoot":"","sources":["../src/createFragmentsClient.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/errors/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Typed error classes для compiled fragments клиентского слоя.
+ *
+ * Каждый класс вызывает setPrototypeOf(this, X.prototype) после super() —
+ * критично для корректного instanceof в ESM build (Vite + TypeScript).
+ *
+ * Ref: Req #6 / D-04 (05.2-SPEC.md)
+ */
+/**
+ * Обёртка над backend `AreaResolveError` JSON shape.
+ * Бросается при HTTP error responses от `/api/area/<code>/compiled` endpoint.
+ */
+export declare class FragmentsAreaError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    status?: number | undefined;
+    constructor(code: string, message: string, details?: unknown | undefined, status?: number | undefined);
+}
+/**
+ * Бросается при несовпадении manifest `apiVersion` с ожидаемой клиентом версией.
+ * Forward-incompat strict equality (D-14).
+ */
+export declare class FragmentsApiVersionError extends Error {
+    expected: number;
+    received: number;
+    constructor(expected: number, received: number);
+}
+/**
+ * Бросается когда `import(moduleUrl)` reject'ится (CDN 404, network, parse error).
+ * Или когда фрагмент не был populate'ен перед вызовом read().
+ */
+export declare class FragmentsLoadError extends Error {
+    fragmentId: number;
+    moduleUrl: string;
+    cause: unknown;
+    constructor(fragmentId: number, moduleUrl: string, cause: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAElC,IAAI,EAAE,MAAM;IAEZ,OAAO,CAAC,EAAE,OAAO;IACjB,MAAM,CAAC,EAAE,MAAM;gBAHf,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,MAAM,CAAC,EAAE,MAAM,YAAA;CAMzB;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAExC,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;gBADhB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAQ1B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAElC,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,OAAO;gBAFd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO;CAMxB"}

package/dist/errors/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/errors/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/errors/index.test.ts"],"names":[],"mappings":""}

package/dist/fetch/__tests__/beacon.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Регрессионные тесты для fetchBeacon (beacon.ts).
+ *
+ * CR-01 fix: sendBeacon пропускает url+body в navigator.sendBeacon напрямую,
+ * hardcoded "/graphql" устранён.
+ *
+ * Тесты:
+ * 1. sendBeacon(url) → navigator.sendBeacon вызван с [url, undefined], не с ["/graphql", "test"]
+ * 2. sendBeacon(url, body) → navigator.sendBeacon вызван с [url, body]
+ * 3. нет navigator (non-browser env) → возвращает false без throw
+ * 4. Пустая строка url → возвращает false, navigator.sendBeacon не вызван
+ * 5. navigator.sendBeacon throws → catch, console.error, return false (не null)
+ * 6. При absolute pixelUrl baseUrl параметр fetchBeacon(baseUrl) НЕ префиксуется
+ */
+export {};
+//# sourceMappingURL=beacon.test.d.ts.map

package/dist/fetch/__tests__/beacon.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.test.d.ts","sourceRoot":"","sources":["../../../src/fetch/__tests__/beacon.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/fetch/beacon.d.ts

@@ -0,0 +1,22 @@
+/**
+ * fetchBeacon — sendBeacon transport для ad pixel / метрик.
+ *
+ * CR-01 fix: sendBeacon пропускает абсолютный pixelUrl напрямую в navigator.sendBeacon.
+ * Старая реализация hardcode'ила sender("/graphql", "test") — паразитный запрос устранён.
+ *
+ * Сигнатура: sendBeacon(url: string, body?: BodyInit | null) => boolean
+ * - В браузере (typeof navigator?.sendBeacon === "function"): делегирует в navigator.sendBeacon.
+ *   Проверяется в момент вызова (не при создании замыкания), чтобы правильно работать в тест-среде.
+ * - В non-browser env (SSR/Node): всегда возвращает false без исключений.
+ *
+ * Параметр _baseUrl у fetchBeacon(_baseUrl) сохранён для совместимости с callsite в fetch/index.ts:
+ *   const beaconFetcher = fetchBeacon(url)
+ * Но НЕ применяется к url пикселя — ad pixel приходит абсолютным URL из trackAdPixel.
+ * Зарезервирован для будущих relative-URL сценариев.
+ *
+ * D-03 / CR-01 / T-35-04-01
+ */
+export declare const fetchBeacon: (_baseUrl: string) => {
+    sendBeacon: (url: string, body?: BodyInit | null) => boolean;
+};
+//# sourceMappingURL=beacon.d.ts.map

package/dist/fetch/beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../src/fetch/beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,WAAW,GAEtB,UAAU,MAAM;sBAaS,MAAM,SAAS,QAAQ,GAAG,IAAI,KAAG,OAAO;CAuBlE,CAAC"}

package/dist/fetch/index.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '@graph-state/core';
+export declare const fetchPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetch/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,eAAO,MAAM,WAAW,EAAE,MAgEzB,CAAC"}

package/dist/fetch/restFetcher.d.ts

@@ -0,0 +1,48 @@
+/**
+ * createRestFetcher — HTTP GET транспорт для compiled fetchPlugin.
+ *
+ * Расширен относительно аналога packages/client-core/src/plugins/fetch/restFetcher.ts:
+ * - get<T>() возвращает { ok, data, errorBody, status } вместо raw Promise<T> —
+ *   это позволяет $area.resolve строить typed-error mapping (FragmentsAreaError/
+ *   FragmentsApiVersionError) с доступом к response body при HTTP ошибке.
+ * - legacy restFetcher бросал plain Error на not-ok без тела (строки :51-54) —
+ *   это лишало $area доступа к body.error.{code,message,details}.
+ *
+ * Сохранены verbatim:
+ * - in-flight dedup через Map (предотвращает дублирующие запросы при concurrent read)
+ * - AbortSignal.timeout — T-35-05 mitigation (DoS через hung request)
+ * - BASE_HEADERS: Content-Type: application/json
+ *
+ * D-03 / D-04 / T-35-05
+ */
+export interface FetcherOptions {
+    /** Таймаут в миллисекундах. Если не задан — запрос без AbortSignal. */
+    timeout?: number;
+}
+/** Поддержка статичных headers или ленивой функции, вычисляемой на каждый запрос. */
+export type DefaultHeaders = HeadersInit | (() => HeadersInit);
+/**
+ * Результат get() — discriminated union для typed-error mapping в $area.
+ * ok: true → data содержит ответ
+ * ok: false → errorBody и status позволяют построить FragmentsAreaError
+ */
+export type RestResult<T, E = {
+    error?: {
+        code?: string;
+        message?: string;
+        details?: unknown;
+    };
+}> = {
+    ok: true;
+    data: T;
+    status: number;
+} | {
+    ok: false;
+    errorBody: E;
+    status: number;
+};
+export declare const createRestFetcher: (baseUrl: string, defaultHeaders?: DefaultHeaders, options?: FetcherOptions) => {
+    get: <T>(url: string, opts?: FetcherOptions) => Promise<RestResult<T>>;
+    getAbsolute: (url: string) => void;
+};
+//# sourceMappingURL=restFetcher.d.ts.map

package/dist/fetch/restFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restFetcher.d.ts","sourceRoot":"","sources":["../../src/fetch/restFetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qFAAqF;AACrF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,IAC5F;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,iBAAgB,cAAmB,EACnC,UAAS,cAAmB;UAYf,CAAC,OAAO,MAAM,SAAQ,cAAc,KAAQ,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;uBAiErD,MAAM,KAAG,IAAI;CAYxC,CAAC"}

package/dist/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Ze=require("@graph-state/core"),et=require("@graph-state/checkers");class q extends Error{constructor(r,t,a,u){super(t),this.code=r,this.details=a,this.status=u,this.name="FragmentsAreaError",Object.setPrototypeOf(this,q.prototype)}}class X extends Error{constructor(r,t){super(`Manifest apiVersion mismatch: expected ${r}, received ${t}`),this.expected=r,this.received=t,this.name="FragmentsApiVersionError",Object.setPrototypeOf(this,X.prototype)}}class W extends Error{constructor(r,t,a){super(`Failed to load fragment ${r} from ${t}`),this.fragmentId=r,this.moduleUrl=t,this.cause=a,this.name="FragmentsLoadError",Object.setPrototypeOf(this,W.prototype)}}const j=(...e)=>e.reduce((r,t)=>(r[t]=t,r),{}),O=j("Fragment","FragmentInstance","Instance","Collection","ArrayItem","Breakpoint","Frame","Image","Text","SolidPaintStyle","CssLink","Variable","ComputedValue","TransformValue","StopColor","LinearGradient","CssChunk","Border","Paint","Link","Interaction","Classname","GoalEvent","MutateEvent","TextHighlight","TextStyleMark","ImagePaint"),H=j("auto","fill"),ne=j("None","Solid","Dashed","Dotted"),tt=j("_blank","none"),ae=j("None","Solid","LinearGradient","RadialGradient","ConicGradient","Image"),le=j("Auto","Contain","Cover"),rt=j("Min","Center","Max","Stretch","Scale"),ie=j("absolute","relative"),V=j("Fixed","Hug","Fill","Relative"),se=j("none","flex"),oe=j("vertical","horizontal"),ce=j("start","center","end"),ue=j("start","center","end","space-between","space-around"),Ee=j("none","uppercase","lowercase","capitalize"),J=j("none","underline","line-through"),nt=j("loop","appear","hover","tap"),at=j("fade","slide","bounce","wiggle","increase"),g=j("Event","String","Link","Boolean","Array","Color","ComponentInstance","Date","Enum","Number","Image","Object","Goal"),fe=j("normal","nowrap","pre","pre-wrap","pre-line","break-spaces"),pe=j("visible","hidden","scroll"),lt=j("convert","exists","equals","startWith","endWith","contains","dateBefore","dateAfter","dateBetween","feature","notFeature","gt","gte","lt","lte","convertFromBoolean","negative"),it=j("canvas","document"),st=j("viewport","parent","fixed"),Ce=j("click","mouseover","appear"),he=j("goal","mutate","callback","tracker"),ot=j("AreaScope","InstanceScope","FragmentScope","CollectionScope","CollectionItemScope"),ct=j("Global","Fragment"),Oe=3,ut=Object.freeze(Object.defineProperty({__proto__:null,MAX_SCHEMA_DEPTH:Oe,borderType:ne,constrain:rt,createConstants:j,cssChunkScopeTypes:ct,effectName:at,effectType:nt,eventMode:he,fragmentGrowingMode:H,imagePaintScaleModes:le,interactions:Ce,layerAlign:ce,layerDirection:oe,layerDistribute:ue,layerMode:se,linkTarget:tt,nodes:O,overflow:pe,paintMode:ae,positionType:ie,renderMode:st,renderTarget:it,scopeTypes:ot,sizing:V,textDecorations:J,textTransform:Ee,variableTransforms:lt,variableType:g,whiteSpace:fe},Symbol.toStringTag,{value:"Module"}));function ft(e){return{lang:(e==null?void 0:e.lang)??void 0,message:e==null?void 0:e.message,abortEarly:(e==null?void 0:e.abortEarly)??void 0,abortPipeEarly:(e==null?void 0:e.abortPipeEarly)??void 0}}function pt(e,r){var t;return(t=void 0)==null?void 0:t.get(r)}function L(e){var r,t;const a=typeof e;return a==="string"?`"${e}"`:a==="number"||a==="bigint"||a==="boolean"?`${e}`:a==="object"||a==="function"?(e&&((t=(r=Object.getPrototypeOf(e))==null?void 0:r.constructor)==null?void 0:t.name))??"null":a}function w(e,r,t,a,u){const c=u&&"input"in u?u.input:t.value,o=(u==null?void 0:u.expected)??e.expects??null,i=(u==null?void 0:u.received)??L(c),f={kind:e.kind,type:e.type,input:c,expected:o,received:i,message:`Invalid ${r}: ${o?`Expected ${o} but r`:"R"}eceived ${i}`,requirement:e.requirement,path:u==null?void 0:u.path,issues:u==null?void 0:u.issues,lang:a.lang,abortEarly:a.abortEarly,abortPipeEarly:a.abortPipeEarly},m=e.kind==="schema",p=(u==null?void 0:u.message)??e.message??pt(e.reference,f.lang)??(m?(f.lang,void 0):null)??a.message??(f.lang,void 0);p!==void 0&&(f.message=typeof p=="function"?p(f):p),m&&(t.typed=!1),t.issues?t.issues.push(f):t.issues=[f]}function P(e){return{version:1,vendor:"valibot",validate(r){return e["~run"]({value:r},ft())}}}function Te(e,r){return Object.hasOwn(e,r)&&r!=="__proto__"&&r!=="prototype"&&r!=="constructor"}function K(e,r){const t=[...new Set(e)];return t.length>1?`(${t.join(` ${r} `)})`:t[0]??"never"}function we(e,r){return{kind:"validation",type:"check",reference:we,async:!1,expects:null,requirement:e,message:r,"~run"(t,a){return t.typed&&!this.requirement(t.value)&&w(this,"input",t,a),t}}}function be(e,r){return{kind:"validation",type:"max_value",reference:be,async:!1,expects:`<=${e instanceof Date?e.toJSON():L(e)}`,requirement:e,message:r,"~run"(t,a){return t.typed&&!(t.value<=this.requirement)&&w(this,"value",t,a,{received:t.value instanceof Date?t.value.toJSON():L(t.value)}),t}}}function Pe(e){return{kind:"metadata",type:"metadata",reference:Pe,metadata:e}}function B(e,r){return{kind:"validation",type:"min_value",reference:B,async:!1,expects:`>=${e instanceof Date?e.toJSON():L(e)}`,requirement:e,message:r,"~run"(t,a){return t.typed&&!(t.value>=this.requirement)&&w(this,"value",t,a,{received:t.value instanceof Date?t.value.toJSON():L(t.value)}),t}}}function Fe(e){return{kind:"transformation",type:"transform",reference:Fe,async:!1,operation:e,"~run"(r){return r.value=this.operation(r.value),r}}}function Ie(e,r,t){return typeof e.fallback=="function"?e.fallback(r,t):e.fallback}function U(e,r,t){return typeof e.default=="function"?e.default(r,t):e.default}function ye(){return{kind:"schema",type:"any",reference:ye,expects:"any",async:!1,get"~standard"(){return P(this)},"~run"(e){return e.typed=!0,e}}}function M(e,r){return{kind:"schema",type:"array",reference:M,expects:"Array",async:!1,item:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){var u;const c=t.value;if(Array.isArray(c)){t.typed=!0,t.value=[];for(let o=0;o<c.length;o++){const i=c[o],f=this.item["~run"]({value:i},a);if(f.issues){const m={type:"array",origin:"value",input:c,key:o,value:i};for(const p of f.issues)p.path?p.path.unshift(m):p.path=[m],(u=t.issues)==null||u.push(p);if(t.issues||(t.issues=f.issues),a.abortEarly){t.typed=!1;break}}f.typed||(t.typed=!1),t.value.push(f.value)}}else w(this,"type",t,a);return t}}}function v(e){return{kind:"schema",type:"boolean",reference:v,expects:"boolean",async:!1,message:e,get"~standard"(){return P(this)},"~run"(r,t){return typeof r.value=="boolean"?r.typed=!0:w(this,"type",r,t),r}}}function R(e,r){const t=[];for(const a in e)(`${+a}`!==a||typeof e[a]!="string"||!Object.is(e[e[a]],+a))&&t.push(e[a]);return{kind:"schema",type:"enum",reference:R,expects:K(t.map(L),"|"),async:!1,enum:e,options:t,message:r,get"~standard"(){return P(this)},"~run"(a,u){return this.options.includes(a.value)?a.typed=!0:w(this,"type",a,u),a}}}function Y(e){return{kind:"schema",type:"lazy",reference:Y,expects:"unknown",async:!1,getter:e,get"~standard"(){return P(this)},"~run"(r,t){return this.getter(r.value)["~run"](r,t)}}}function F(e,r){return{kind:"schema",type:"literal",reference:F,expects:L(e),async:!1,literal:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){return t.value===this.literal?t.typed=!0:w(this,"type",t,a),t}}}function de(e,r){return{kind:"schema",type:"loose_object",reference:de,expects:"Object",async:!1,entries:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){var u;const c=t.value;if(c&&typeof c=="object"){t.typed=!0,t.value={};for(const o in this.entries){const i=this.entries[o];if(o in c||(i.type==="exact_optional"||i.type==="optional"||i.type==="nullish")&&i.default!==void 0){const f=o in c?c[o]:U(i),m=i["~run"]({value:f},a);if(m.issues){const p={type:"object",origin:"value",input:c,key:o,value:f};for(const h of m.issues)h.path?h.path.unshift(p):h.path=[p],(u=t.issues)==null||u.push(h);if(t.issues||(t.issues=m.issues),a.abortEarly){t.typed=!1;break}}m.typed||(t.typed=!1),t.value[o]=m.value}else if(i.fallback!==void 0)t.value[o]=Ie(i);else if(i.type!=="exact_optional"&&i.type!=="optional"&&i.type!=="nullish"&&(w(this,"key",t,a,{input:void 0,expected:`"${o}"`,path:[{type:"object",origin:"key",input:c,key:o,value:c[o]}]}),a.abortEarly))break}if(!t.issues||!a.abortEarly)for(const o in c)Te(c,o)&&!(o in this.entries)&&(t.value[o]=c[o])}else w(this,"type",t,a);return t}}}function Ae(e){return{kind:"schema",type:"never",reference:Ae,expects:"never",async:!1,message:e,get"~standard"(){return P(this)},"~run"(r,t){return w(this,"type",r,t),r}}}function S(e,r){return{kind:"schema",type:"nullable",reference:S,expects:`(${e.expects} | null)`,async:!1,wrapped:e,default:r,get"~standard"(){return P(this)},"~run"(t,a){return t.value===null&&(this.default!==void 0&&(t.value=U(this,t,a)),t.value===null)?(t.typed=!0,t):this.wrapped["~run"](t,a)}}}function y(e){return{kind:"schema",type:"number",reference:y,expects:"number",async:!1,message:e,get"~standard"(){return P(this)},"~run"(r,t){return typeof r.value=="number"&&!isNaN(r.value)?r.typed=!0:w(this,"type",r,t),r}}}function b(e,r){return{kind:"schema",type:"object",reference:b,expects:"Object",async:!1,entries:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){var u;const c=t.value;if(c&&typeof c=="object"){t.typed=!0,t.value={};for(const o in this.entries){const i=this.entries[o];if(o in c||(i.type==="exact_optional"||i.type==="optional"||i.type==="nullish")&&i.default!==void 0){const f=o in c?c[o]:U(i),m=i["~run"]({value:f},a);if(m.issues){const p={type:"object",origin:"value",input:c,key:o,value:f};for(const h of m.issues)h.path?h.path.unshift(p):h.path=[p],(u=t.issues)==null||u.push(h);if(t.issues||(t.issues=m.issues),a.abortEarly){t.typed=!1;break}}m.typed||(t.typed=!1),t.value[o]=m.value}else if(i.fallback!==void 0)t.value[o]=Ie(i);else if(i.type!=="exact_optional"&&i.type!=="optional"&&i.type!=="nullish"&&(w(this,"key",t,a,{input:void 0,expected:`"${o}"`,path:[{type:"object",origin:"key",input:c,key:o,value:c[o]}]}),a.abortEarly))break}}else w(this,"type",t,a);return t}}}function s(e,r){return{kind:"schema",type:"optional",reference:s,expects:`(${e.expects} | undefined)`,async:!1,wrapped:e,default:r,get"~standard"(){return P(this)},"~run"(t,a){return t.value===void 0&&(this.default!==void 0&&(t.value=U(this,t,a)),t.value===void 0)?(t.typed=!0,t):this.wrapped["~run"](t,a)}}}function T(e,r){return{kind:"schema",type:"picklist",reference:T,expects:K(e.map(L),"|"),async:!1,options:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){return this.options.includes(t.value)?t.typed=!0:w(this,"type",t,a),t}}}function z(e,r,t){return{kind:"schema",type:"record",reference:z,expects:"Object",async:!1,key:e,value:r,message:t,get"~standard"(){return P(this)},"~run"(a,u){var c,o;const i=a.value;if(i&&typeof i=="object"){a.typed=!0,a.value={};for(const f in i)if(Te(i,f)){const m=i[f],p=this.key["~run"]({value:f},u);if(p.issues){const d={type:"object",origin:"key",input:i,key:f,value:m};for(const k of p.issues)k.path=[d],(c=a.issues)==null||c.push(k);if(a.issues||(a.issues=p.issues),u.abortEarly){a.typed=!1;break}}const h=this.value["~run"]({value:m},u);if(h.issues){const d={type:"object",origin:"value",input:i,key:f,value:m};for(const k of h.issues)k.path?k.path.unshift(d):k.path=[d],(o=a.issues)==null||o.push(k);if(a.issues||(a.issues=h.issues),u.abortEarly){a.typed=!1;break}}(!p.typed||!h.typed)&&(a.typed=!1),p.typed&&(a.value[p.value]=h.value)}}else w(this,"type",a,u);return a}}}function l(e){return{kind:"schema",type:"string",reference:l,expects:"string",async:!1,message:e,get"~standard"(){return P(this)},"~run"(r,t){return typeof r.value=="string"?r.typed=!0:w(this,"type",r,t),r}}}function Se(e){let r;if(e)for(const t of e)r?r.push(...t.issues):r=t.issues;return r}function $(e,r){return{kind:"schema",type:"union",reference:$,expects:K(e.map(t=>t.expects),"|"),async:!1,options:e,message:r,get"~standard"(){return P(this)},"~run"(t,a){let u,c,o;for(const i of this.options){const f=i["~run"]({value:t.value},a);if(f.typed)if(f.issues)c?c.push(f):c=[f];else{u=f;break}else o?o.push(f):o=[f]}if(u)return u;if(c){if(c.length===1)return c[0];w(this,"type",t,a,{issues:Se(c)}),t.typed=!0}else{if((o==null?void 0:o.length)===1)return o[0];w(this,"type",t,a,{issues:Se(o)})}return t}}}function Q(){return{kind:"schema",type:"unknown",reference:Q,expects:"unknown",async:!1,get"~standard"(){return P(this)},"~run"(e){return e.typed=!0,e}}}function Me(e,r,t){return{kind:"schema",type:"variant",reference:Me,expects:"Object",async:!1,key:e,options:r,message:t,get"~standard"(){return P(this)},"~run"(a,u){const c=a.value;if(c&&typeof c=="object"){let o,i=0,f=this.key,m=[];const p=(h,d)=>{for(const k of h.options){if(k.type==="variant")p(k,new Set(d).add(k.key));else{let E=!0,A=0;for(const x of d){const G=k.entries[x];if(x in c?G["~run"]({typed:!1,value:c[x]},u).issues:G.type!=="exact_optional"&&G.type!=="optional"&&G.type!=="nullish"){E=!1,f!==x&&(i<A||i===A&&x in c&&!(f in c))&&(i=A,f=x,m=[]),f===x&&m.push(k.entries[x].expects);break}A++}if(E){const x=k["~run"]({value:c},u);(!o||!o.typed&&x.typed)&&(o=x)}}if(o&&!o.issues)break}};if(p(this,new Set([this.key])),o)return o;w(this,"type",a,u,{input:c[f],expected:K(m,"|"),path:[{type:"object",origin:"value",input:c,key:f,value:c[f]}]})}else w(this,"type",a,u);return a}}}function _(...e){return{...e[0],pipe:e,get"~standard"(){return P(this)},"~run"(r,t){for(const a of e)if(a.kind!=="metadata"){if(r.issues&&(a.kind==="schema"||a.kind==="transformation")){r.typed=!1;break}(!r.issues||!t.abortEarly&&!t.abortPipeEarly)&&(r=a["~run"](r,t))}return r}}}const _e=we(e=>e.split(":").length===2),me=e=>{const r=t=>typeof t=="number"?`${t}px`:t;return n($([y(),l()]),{...e,fallback:e==null?void 0:e.fallback,transform:r})},C=_(l(),_e),n=(e,r)=>{const t=(r==null?void 0:r.overridable)??!0,a=(r==null?void 0:r.variable)??!1,u=[e];return a&&u.push(_(l(),_e)),t&&u.push(ye()),_(s($(u)),Fe((r==null?void 0:r.transform)??(c=>c)),Pe(r??{}))},ve=b({children:n(M(l()),{fallback:[],overridable:!1})}),I=b({_id:$([l(),y()]),_type:T(Object.keys(O))}),D=b({overrides:n(M(l()),{overridable:!1}),overrideFrom:n(S(l()),{overridable:!1})}),Z=b({position:n(R(Object.keys(ie)),{fallback:ie.absolute}),top:n(S(y()),{fallback:null,transform:e=>typeof e=="number"?Math.ceil(e):e}),left:n(S(y()),{fallback:null,transform:e=>typeof e=="number"?Math.ceil(e):e}),right:n(S(y()),{fallback:null,transform:e=>typeof e=="number"?Math.ceil(e):e}),bottom:n(S(y()),{fallback:null,transform:e=>typeof e=="number"?Math.ceil(e):e}),centerAnchorX:n(y(),{fallback:.5}),centerAnchorY:n(y(),{fallback:.5})}),ee=b({opacity:n(_(y(),B(0),be(1)),{fallback:1,variable:!0}),visible:n(v(),{fallback:!0,variable:!0}),rotate:n(y(),{fallback:null}),zIndex:n(y(),{fallback:null}),classnames:n(M(C),{fallback:[]})}),te=b({widthType:n(T(Object.keys(V)),{fallback:V.Fixed}),heightType:n(T(Object.keys(V)),{fallback:V.Fixed}),width:n(_(y(),B(0)),{fallback:0,transform:Math.ceil}),height:n(_(y(),B(0)),{fallback:0,transform:Math.ceil}),aspectRatio:n(y(),{fallback:-1}),minWidth:n(S(_(y(),B(-1))),{fallback:-1,transform:Math.ceil}),minWidthType:n(T(Object.keys(V)),{fallback:V.Fixed}),maxWidth:n(S(_(y(),B(-1))),{fallback:-1,transform:Math.ceil}),maxWidthType:n(T(Object.keys(V)),{fallback:V.Fixed}),minHeight:n(S(_(y(),B(-1))),{fallback:-1,transform:Math.ceil}),minHeightType:n(T(Object.keys(V)),{fallback:V.Fixed}),maxHeight:n(S(_(y(),B(-1))),{fallback:-1,transform:Math.ceil}),maxHeightType:n(T(Object.keys(V)),{fallback:V.Fixed})}),$e=b({layerMode:n(T(Object.keys(se)),{fallback:se.none}),layerAlign:n(T(Object.keys(ce)),{fallback:ce.start}),layerDirection:n(T(Object.keys(oe)),{fallback:oe.horizontal}),layerDistribute:n(T(Object.keys(ue)),{fallback:ue.start}),layerWrap:n(v(),{fallback:!1}),layerGap:n(_(y(),B(0)),{fallback:0}),padding:me({fallback:"0px"})}),ht=n(T(Object.keys(pe)),{fallback:pe.hidden}),bt=me({fallback:"0px"}),re=b({interactions:n(M(C),{fallback:[]})}),ke=b({cssOverride:n(l(),{fallback:""})}),yt=_(b({name:n(l(),{fallback:"Frame",overridable:!1}),isBreakpoint:n(v(),{fallback:!1,overridable:!1}),isPrimary:n(v(),{fallback:!1,overridable:!1}),border:n(C),paint:n(C),link:n(C),...ve.entries,...I.entries,...D.entries,parent:n(S(l()),{overridable:!1}),...Z.entries,...ee.entries,...te.entries,...$e.entries,...re.entries,...ke.entries,overflow:ht,borderRadius:bt})),dt=b({type:F("text"),text:l(),marks:s(M(b({rangeKey:l()})))}),mt=b({type:F("mention"),ref:l(),fallback:s(l())}),vt=b({type:F("hardBreak")}),kt=$([dt,mt,vt]),gt=b({type:F("paragraph"),content:M(kt)}),St=b({type:F("doc"),content:M(gt)}),xt=b({name:n(l(),{fallback:"Text",overridable:!1}),content:n(l(),{fallback:""}),doc:n(St,{fallback:{type:"doc",content:[]}}),styleRanges:n(M(C),{fallback:[]}),whiteSpace:n(R(Object.keys(fe)),{fallback:fe.pre}),textAlign:n(l(),{fallback:"left"}),fontSize:n(y(),{fallback:null,variable:!0}),fontWeight:n($([l(),y()]),{fallback:null,variable:!0}),fontFamily:n(l(),{fallback:null,variable:!0}),color:n(l(),{fallback:null,variable:!0}),lineHeight:n(y(),{fallback:null,variable:!0}),letterSpacing:n(y(),{fallback:null,variable:!0}),textDecoration:n(T(Object.keys(J)),{fallback:null}),textTransform:n(T(Object.keys(Ee)),{fallback:null}),parent:n(S(l()),{overridable:!1}),link:n(C),highlight:n(C),contentBinding:n(C),...I.entries,...D.entries,...ke.entries,...Z.entries,...ee.entries,...te.entries,...re.entries}),jt=b({name:n(l(),{fallback:"Fragment",overridable:!1}),parent:n(S(l()),{overridable:!1}),horizontalGrow:n(R(Object.keys(H)),{fallback:H.fill,overridable:!1}),verticalGrow:n(R(Object.keys(H)),{fallback:H.auto,overridable:!1}),properties:n(M(l()),{fallback:[],overridable:!1}),propsObject:n(S(C),{fallback:null,overridable:!1}),cssChunks:n(M(C),{fallback:[],overridable:!1}),...I.entries,...ve.entries}),Et=b({name:n(l(),{fallback:"Instance",overridable:!1}),fragment:n(y()),parent:n(S(l()),{overridable:!1}),props:n($([C,z(l(),$([l(),y(),v(),b({code:l(),name:l()})]))]),{fallback:{}}),link:n(C),...I.entries,...D.entries,...Z.entries,...te.entries,...ee.entries,...re.entries}),Ct=_(b({name:n(l(),{fallback:"Collection",overridable:!1}),parent:n(S(l()),{overridable:!1}),source:n(C,{}),border:n(C),paint:n(C),link:n(C),...ve.entries,...I.entries,...D.entries,...Z.entries,...ee.entries,...te.entries,...$e.entries,...re.entries,...ke.entries})),Ot=b({...D.entries,parent:n(S(l()),{overridable:!1}),position:n(_(y(),be(1),B(0)),{fallback:0}),value:n(l(),{fallback:"#000",variable:!0}),...I.entries}),Tt=b({...D.entries,parent:n(S(l()),{overridable:!1}),angle:n(y(),{fallback:0}),stops:n(M(C),{fallback:[]}),...I.entries}),wt=b({parent:n(S(l()),{overridable:!1}),chunkId:n(y()),enabled:n(v(),{fallback:!0,variable:!0}),...I.entries}),Pt=b({...D.entries,parent:n(S(l()),{overridable:!1}),type:n(T(Object.keys(ne)),{fallback:ne.None}),width:me({fallback:"1px"}),paint:n(C),...I.entries}),Ft=b({...D.entries,parent:n(S(l()),{overridable:!1}),type:n(T(Object.keys(ae)),{fallback:ae.None}),solid:n(l(),{fallback:"#fff"}),linearGradient:n(C),image:n(C),...I.entries}),It=b({...I.entries,...D.entries,parent:n(S(l()),{overridable:!1}),src:n(l()),scale:n(T(Object.keys(le)),{fallback:le.Auto})}),At=b({...D.entries,...I.entries,parent:n(S(l()),{overridable:!1}),href:n(l(),{fallback:null}),isNewTab:n(v(),{fallback:!0})}),Mt=b({parent:n(S(l()),{overridable:!1}),...I.entries,on:R(Object.keys(Ce)),event:n(C)}),_t=b({parent:n(S(l()),{overridable:!1}),value:n(l(),{fallback:""}),enabled:n(v(),{fallback:!0,variable:!0}),...I.entries}),$t=b({parent:n(S(l()),{overridable:!1}),goalId:n(y(),{overridable:!1}),...I.entries}),Vt=b({parent:n(S(l()),{overridable:!1}),target:n(C),value:n(ye()),...I.entries}),Dt=b({color:n(l(),{fallback:null}),lineHeight:n(y(),{fallback:null}),fontSize:n(y(),{fallback:null}),fontWeight:n($([l(),y()]),{fallback:400}),fontFamily:n(l(),{fallback:null}),textDecoration:n(T(Object.keys(J)),{fallback:null}),parent:n(S(l()),{overridable:!1}),...I.entries}),Gt=b({...D.entries,parent:n(S(l()),{overridable:!1}),color:n(l(),{fallback:null,variable:!0}),fontSize:n(y(),{fallback:null,variable:!0}),fontWeight:n($([l(),y()]),{fallback:400,variable:!0}),fontFamily:n(l(),{fallback:null,variable:!0}),lineHeight:n(y(),{fallback:null,variable:!0}),letterSpacing:n(y(),{fallback:null,variable:!0}),textDecoration:n(T(Object.keys(J)),{fallback:null,variable:!0}),...I.entries}),Ve=b({name:s(l(),"Number"),type:s(F(g.Number),g.Number),defaultValue:s(y(),0),required:s(v(),!1),editable:s(v(),!0),min:s(y(),1),max:s(y(),100),step:s(y(),1),displayStepper:s(v(),!0)}),De=b({name:s(l(),"Boolean"),type:s(F(g.Boolean),g.Boolean),defaultValue:s(v(),!1),required:s(v(),!1),editable:s(v(),!0)}),Ge=b({name:s(l(),"String"),type:s(F(g.String),g.String),defaultValue:s(l(),""),required:s(v(),!1),editable:s(v(),!0),placeholder:s(l(),""),isTextarea:s(v(),!1),isRich:s(v(),!1)}),Be=b({name:s(l(),"String"),type:s(F(g.Color),g.Color),defaultValue:s(l(),"#000"),required:s(v(),!1),editable:s(v(),!0)}),Bt=b({name:s(l(),"Event"),type:s(F(g.Event),g.Event),mode:s(T(Object.keys(he)),he.callback),defaultValue:s(Q(),null),required:s(v(),!1),editable:s(v(),!0)}),Ne=b({name:s(l(),"Link"),type:s(F(g.Link),g.Link),defaultValue:s(l(),""),required:s(v(),!1),editable:s(v(),!0)}),Le=b({name:s(l(),"Option"),type:s(F(g.Enum),g.Enum),defaultValue:s(l(),""),required:s(v(),!1),editable:s(v(),!0),cases:s(M(b({id:l(),name:l()})),[])}),Re=b({name:s(l(),"Image"),type:s(F(g.Image),g.Image),defaultValue:s(S(l()),null),required:s(v(),!1),editable:s(v(),!0)});function He(e){return b({name:s(l(),"Object"),type:s(F(g.Object),g.Object),defaultValue:s(z(l(),Q()),{}),fields:s(z(l(),Y(()=>We(e+1))),{}),required:s(v(),!1),editable:s(v(),!0)})}function qe(e){return b({name:s(l(),"Collection"),type:s(F(g.Array),g.Array),defaultValue:s(M(Q()),[]),definition:s(S(Y(()=>We(e+1))),null),required:s(v(),!1),editable:s(v(),!0)})}function We(e){return e>Oe?Ae():Me("type",[Ge,Ve,De,Be,Le,Ne,Re,He(e),qe(e)])}const Nt=He(0),Lt=qe(0),Rt=b({name:s(l(),"Goal"),type:s(F(g.Goal),g.Goal),defaultValue:s(S(y()),null),required:s(v(),!1),editable:s(v(),!0)});g.Number+"",g.Boolean+"",g.String+"",g.Color+"",g.Event+"",g.Link+"",g.Enum+"",g.Object+"",g.Image+"",g.Array+"",g.Goal+"";O.Frame+"",O.Text+"",O.Fragment+"",O.Instance+"",O.Collection+"",O.StopColor+"",O.LinearGradient+"",O.CssChunk+"",O.Border+"",O.Paint+"",O.ImagePaint+"",O.Link+"",O.Interaction+"",O.Classname+"",O.GoalEvent+"",O.MutateEvent+"",O.TextHighlight+"",O.TextStyleMark+"";const ze=Y(()=>de({_type:l(),_id:$([l(),y()]),children:s(M($([l(),ze])))}));O.Fragment;const Xe=(...e)=>e.reduce((r,t)=>(r[t]=t,r),{}),Ht={"Content-Type":"application/json"},qt=(e,r={},t={})=>{const{timeout:a}=t,u=new Map;return{get:(i,f={})=>{const m=`${e}${i}`;if(u.has(m))return u.get(m);const p=f.timeout??a,h=p!=null?AbortSignal.timeout(p):void 0,d=typeof r=="function"?r():r,k=fetch(m,{method:"GET",headers:{...Ht,...d},signal:h}).then(async E=>{if(!E.ok){let x={};try{x=await E.json()}catch{x={error:{code:"UNKNOWN",message:E.statusText}}}return{ok:!1,errorBody:x,status:E.status}}let A;try{A=await E.json()}catch{A=null}return{ok:!0,data:A,status:E.status}}).finally(()=>{u.delete(m)});return u.set(m,k),k},getAbsolute:i=>{fetch(i,{method:"GET",mode:"no-cors",credentials:"omit",keepalive:!0}).catch(f=>{console.error(f)})}}},Wt=e=>({sendBeacon:(t,a)=>{if(!t||typeof navigator>"u"||typeof(navigator==null?void 0:navigator.sendBeacon)!="function")return!1;try{return navigator.sendBeacon.bind(navigator)(t,a)}catch(u){return console.error(u),!1}}}),zt=e=>{var f,m,p,h;const r=(f=e==null?void 0:e.env)==null?void 0:f.backendEndpoint,t=(m=e==null?void 0:e.env)==null?void 0:m.apiToken,a=(p=e==null?void 0:e.env)==null?void 0:p.referer;if(!r)return;const u=()=>{var E,A,x;const d=(E=e==null?void 0:e.env)==null?void 0:E.filterOverrides,k={};return t&&(k["X-Api-Key"]=t),a&&(k.Referer=a),d!=null&&d.deviceType&&(k["X-Filter-Device-Type"]=d.deviceType),d!=null&&d.osType&&(k["X-Filter-OS-Type"]=d.osType),d!=null&&d.page&&(k["X-Filter-Page"]=d.page),(A=d==null?void 0:d.geo)!=null&&A.code?k["X-Filter-Geo"]=d.geo.code:d!=null&&d.ip&&(k["X-Filter-IP"]=d.ip),(x=e==null?void 0:e.env)!=null&&x.debug&&(k["X-Debug"]="true"),k},c=(h=e==null?void 0:e.env)==null?void 0:h.timeout,o=qt(r,u,{timeout:c}),i=Wt();e.$fetch={get:o.get,sendBeacon:i.sendBeacon,getAbsolute:o.getAbsolute}},Xt=typeof window<"u",xe=new Set,Jt=e=>{try{const r=new Image;r.referrerPolicy="no-referrer";const t=()=>{r.removeEventListener("load",t),r.removeEventListener("error",t),xe.delete(r)};r.addEventListener("load",t,{once:!0}),r.addEventListener("error",t,{once:!0}),xe.add(r),r.src=e}catch{}},Kt=(e,r)=>{if(typeof r!="function")return!1;try{return r(e),!0}catch{return!1}},Ut=e=>{if(typeof navigator>"u"||typeof navigator.sendBeacon!="function")return!1;try{return navigator.sendBeacon(e)}catch{return!1}},Yt=(e,r,t)=>{if(!Xt)return;const a=e==null?void 0:e.trim();if(a){if(typeof r=="function")try{if(r(a)===!0)return}catch{}Ut(a)||Kt(a,t)||Jt(a)}},je=Xe("INIT_SESSION","RELEASE_SESSION","REACH_PROJECT_GOAL"),Je=e=>{const r=(u,c)=>{var i;if(u!==je.REACH_PROJECT_GOAL||!c)return;const o=new URLSearchParams({goal_id:String(c.goalId),variant_id:String(c.variantId),area_id:String(c.areaId),campaign_id:String(c.campaignId)});(i=e.$fetch)==null||i.get(`/api/metric/goal?${o}`).catch(()=>{})},t=u=>{r(je.REACH_PROJECT_GOAL,u)},a=u=>{var o,i;const c=((o=e.$fetch)==null?void 0:o.getAbsolute)!=null?f=>e.$fetch.getAbsolute(f):void 0;Yt(u,(i=e==null?void 0:e.$fetch)==null?void 0:i.sendBeacon,c)};e.$metrics={reachGoal:t,trackAdPixel:a}},Ke=e=>{const r=new Map,t=new Map,a=new Map,u=(i,f)=>{if(r.has(i))return Promise.resolve(r.get(i));if(t.has(i))return t.get(i);a.delete(i);const m=`/api/area/${i}/compiled`,p=(async()=>{var E,A,x,G,ge;const h=await e.$fetch.get(m);if(!h.ok){const N=h.errorBody;throw new q(((E=N==null?void 0:N.error)==null?void 0:E.code)??"UNKNOWN",((A=N==null?void 0:N.error)==null?void 0:A.message)??String(h.status),(x=N==null?void 0:N.error)==null?void 0:x.details,h.status)}const d=h.data;if(d.apiVersion!==1)throw new X(1,d.apiVersion);(G=e.$fragments)==null||G.populate(d.fragments??{}),(ge=e.$cssChunks)==null||ge.populate(d.cssChunks??{});const k={rootFragmentId:d.rootFragmentId,props:d.props??{},projectProperties:d.projectProperties??{},globalCssUrl:d.globalCssUrl??null};return r.set(i,k),k})();return t.set(i,p),p.catch(h=>{a.set(i,h)}).finally(()=>{t.delete(i)}),p},c=i=>{if(r.has(i))return r.get(i);throw t.has(i)?t.get(i):a.has(i)?a.get(i):new q("AREA_NOT_RESOLVED",`Area ${i} not resolved — call $area.resolve(code) before read()`)},o=i=>r.has(i)||a.has(i);e.$area={resolve:u,read:c,has:o}};function Ue(e){const r=(e==null?void 0:e.importer)??(t=>import(t));return t=>{const a=new Map,u=p=>a.has(p),c=p=>{var h;return(h=a.get(p))==null?void 0:h.ref},o=p=>{var h;return(h=a.get(p))==null?void 0:h.schema},i=p=>{var h;return(h=a.get(p))==null?void 0:h.scopeClass},f=p=>{const h=a.get(p);if(h===void 0)throw new W(p,"",new Error(`Fragment ${p} not populated — call populate() before read()`));if(h.status==="pending")throw h.promise;if(h.status==="error")throw h.error;return h.component},m=p=>{Object.entries(p).forEach(([h,d])=>{const k=Number(h);if(a.has(k))return;const E={status:"pending",promise:Promise.resolve(),ref:d},A=r(d.moduleUrl).then(x=>(E.status="success",E.component=x.default,E.schema=x.schema,E.scopeClass=typeof x.scopeClass=="string"?x.scopeClass:void 0,x.default),x=>{const G=new W(k,d.moduleUrl,x);throw E.status="error",E.error=G,G});E.promise=A,a.set(k,E),A.catch(()=>{})})};t.$fragments={has:u,read:f,populate:m,getRef:c,getSchema:o,getScopeClass:i}}}const Ye=Ue();function Qe(e){return r=>{const t=new Map;r.$cssChunks={has:a=>t.has(a),populate:a=>{for(const[u,c]of Object.entries(a)){const o=Number(u);if(t.has(o))continue;const i=e.inject(c.cssUrl,`chunk:${o}`);t.set(o,{ref:c,cleanup:i})}}}}}const Qt=Xe("GlobalManager"),Zt=e=>{const r=()=>()=>{};return Ze.createState({_type:"GlobalManager",initialState:{},skip:[et.allowTypes([...Object.keys(ut.nodes),...Object.keys(Qt)])],plugins:[t=>{t.env={backendEndpoint:(e==null?void 0:e.backendEndpoint)??"https://client-api.fragmentsx.com",apiToken:e==null?void 0:e.apiToken,referer:e==null?void 0:e.referer,timeout:e==null?void 0:e.timeout}},t=>{(e==null?void 0:e.projectId)!=null&&(t.$project={projectId:e.projectId})},...(e==null?void 0:e.plugins)??[],zt,Je,Ke,Ye,Qe({inject:(e==null?void 0:e.inject)??r})]})};exports.FragmentsApiVersionError=X;exports.FragmentsAreaError=q;exports.FragmentsLoadError=W;exports.areaPlugin=Ke;exports.createCssChunksCachePlugin=Qe;exports.createFragmentsCachePlugin=Ue;exports.createFragmentsClient=Zt;exports.fragmentsCachePlugin=Ye;exports.globalMetricsPlugin=Je;

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Public barrel @fragmentsx/fragments-client — полный public API (Plan 02).
+ *
+ * Экспортирует: types, errors, createFragmentsClient, $area, $fragments, $cssChunks, metrics.
+ *
+ * Трёхслэшевая директива гарантирует, что declarations.d.ts (ambient module augmentation
+ * GraphState) попадает в граф компиляции при любом импорте через path-mapping из внешних
+ * пакетов (runtime-react, playgrounds и т.д.).
+ */
+export type { AreaResolveResponse, FragmentRef, CssChunkRef, ResolvedValue, FieldId, } from './types';
+export { FragmentsAreaError, FragmentsApiVersionError, FragmentsLoadError, } from './errors';
+export { createFragmentsClient } from './createFragmentsClient';
+export type { Options as CreateFragmentsClientOptions } from './createFragmentsClient';
+export { fragmentsCachePlugin, createFragmentsCachePlugin } from './$fragments';
+export type { FragmentsCacheNamespace, CreateFragmentsCachePluginOpts } from './$fragments';
+export { createCssChunksCachePlugin } from './$cssChunks';
+export { areaPlugin } from './$area';
+export type { AreaResolveResult } from './$area';
+export { globalMetricsPlugin } from './metrics/globalMetrics';
+//# sourceMappingURL=index.d.ts.map