@nan0web/ui-payload 3.3.0 → 3.3.1

package/package.json

@@ -1,19 +1,55 @@
 {
   "name": "@nan0web/ui-payload",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "NaN0Web Universal Payload CMS UI Components Package (ImageCell, MapCell, BooleanCell, richtext)",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "./src/index.js",
+  "types": "./types/index.d.ts",
+  "files": [
+    "src/**/*.js",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "!src/**/*.spec.js",
+    "!src/**/*.spec.tsx",
+    "types/**/*.d.ts"
+  ],
   "exports": {
-    ".": "./src/index.ts",
-    "./ui/payload": "./src/index.ts",
-    "./components/*": "./src/components/*",
-    "./templates": "./src/templates/PayloadCollectionTemplate.js",
-    "./templates/*": "./src/templates/*",
-    "./richtext": "./src/richtext/index.js",
-    "./richtext/client": "./src/richtext/client/index.js",
-    "./richtext/*": "./src/richtext/*"
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./ui/payload": {
+      "types": "./types/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./components/*": {
+      "types": "./types/components/*.d.ts",
+      "import": "./src/components/*.js"
+    },
+    "./templates": {
+      "types": "./types/templates/PayloadCollectionTemplate.d.ts",
+      "import": "./src/templates/PayloadCollectionTemplate.js"
+    },
+    "./templates/*": {
+      "types": "./types/templates/*.d.ts",
+      "import": "./src/templates/*.js"
+    },
+    "./richtext": {
+      "types": "./types/richtext/index.d.ts",
+      "import": "./src/richtext/index.js"
+    },
+    "./richtext/client": {
+      "types": "./types/richtext/client/index.d.ts",
+      "import": "./src/richtext/client/index.js"
+    },
+    "./richtext/Nan0HTMLFeature.js": {
+      "types": "./types/richtext/Nan0HTMLFeature.d.ts",
+      "import": "./src/richtext/Nan0HTMLFeature.js"
+    },
+    "./richtext/*": {
+      "types": "./types/richtext/*.d.ts",
+      "import": "./src/richtext/*.js"
+    }
   },
   "dependencies": {
     "@payloadcms/richtext-lexical": "3.86.0",
@@ -25,8 +61,20 @@
     "@payloadcms/ui": "^3.0.0",
     "react": "^19.0.0"
   },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
   "license": "MIT",
   "scripts": {
-    "test": "node --test src/test/*.spec.tsx src/templates/*.spec.js"
+    "prebuild": "rm -rf types/",
+    "build": "tsc",
+    "clean": "rm -rf .cache/ && rm -rf dist/",
+    "clean:modules": "rm -rf node_modules",
+    "test": "node --test \"src/**/*.test.js\"",
+    "test:release": "node --test \"src/test/releases/**/*.test.js\"",
+    "release:spec": "node --test \"releases/**/*.spec.js\"",
+    "knip": "knip --production || true",
+    "audit": "pnpm audit --prod || true",
+    "test:all": "npm run test && npm run build && npm run test:release && npm run knip && npm run audit"
   }
 }

package/src/{index.ts → index.js}

@@ -2,16 +2,9 @@ export { ImageCell } from './components/ImageCell.js'
 export { BooleanCell } from './components/BooleanCell.js'
 export { MapCell } from './components/MapCell.js'
 
-
-// richtext — pure functions only (node classes require 'lexical' context)
+// richtext — pure functions only & Nan0HTMLFeature
 export { fromNan0Html, inventoryNan0Html, FORMAT } from './richtext/fromNan0Html.js'
+export { Nan0HTMLFeature } from './richtext/Nan0HTMLFeature.js'
 
 // access control helpers
 export { accessFor, publicAccess } from './access.js'
-
-
-
-
-
-
-

package/src/templates/{PayloadCollectionTemplate.spec.js → PayloadCollectionTemplate.test.js}

@@ -21,6 +21,5 @@ describe('PayloadCollectionTemplate', () => {
 		assert.ok(output.includes("const useAsTitle = 'name'"))
 		assert.ok(output.includes('"uk": "Картка"'))
 		assert.ok(output.includes('"name": "id"'))
-
 	})
 })

package/types/access.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Access control helpers for Payload CMS collections.
+ */
+/**
+ * Creates a Payload access control function checking user presence and optional role(s).
+ *
+ * @example
+ * // Requires any authenticated user
+ * create: accessFor()
+ *
+ * // Requires specific role(s)
+ * update: accessFor('admin', 'editor')
+ * // or
+ * delete: accessFor(['admin'])
+ *
+ * @param {...(string | string[])} roles - Allowed role(s). If none specified, checks for any authenticated user.
+ * @returns {import('payload').Access} Payload Access control function
+ */
+export function accessFor(...roles: (string | string[])[]): import("payload").Access;
+/**
+ * Shortcut alias for public read access.
+ * @type {() => boolean}
+ */
+export const publicAccess: () => boolean;

package/types/components/BooleanCell.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @typedef {Object} BooleanCellProps
+ * @property {boolean} [cellData]
+ * @property {boolean} [value]
+ * @property {any} [field]
+ */
+/**
+ * Custom BooleanCell renderer for Payload CMS admin tables.
+ * @param {BooleanCellProps} props
+ * @returns {React.JSX.Element}
+ */
+export function BooleanCell({ cellData, value, field }: BooleanCellProps): React.JSX.Element;
+export default BooleanCell;
+export type BooleanCellProps = {
+    cellData?: boolean | undefined;
+    value?: boolean | undefined;
+    field?: any;
+};
+import React from 'react';

package/types/components/ImageCell.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @typedef {Object} ImageCellProps
+ * @property {string | { url?: string; thumbnailURL?: string }} [cellData]
+ * @property {string | { url?: string; thumbnailURL?: string }} [value]
+ */
+/**
+ * Image preview cell for Payload CMS admin tables.
+ * @param {ImageCellProps} props
+ * @returns {React.JSX.Element | null}
+ */
+export function ImageCell(props: ImageCellProps): React.JSX.Element | null;
+export default ImageCell;
+export type ImageCellProps = {
+    cellData?: string | {
+        url?: string;
+        thumbnailURL?: string;
+    } | undefined;
+    value?: string | {
+        url?: string;
+        thumbnailURL?: string;
+    } | undefined;
+};
+import React from 'react';

package/types/components/MapCell.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @typedef {Object} MapCellProps
+ * @property {any} [cellData]
+ * @property {any} [value]
+ * @property {any} [rowData]
+ */
+/**
+ * Map preview cell for Payload CMS admin tables with OpenStreetMap link.
+ * @param {MapCellProps} props
+ * @returns {React.JSX.Element}
+ */
+export function MapCell({ rowData }: MapCellProps): React.JSX.Element;
+export default MapCell;
+export type MapCellProps = {
+    cellData?: any;
+    value?: any;
+    rowData?: any;
+};
+import React from 'react';

package/types/domain/PayloadApp.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @typedef {Object} AppOptions
+ * @property {import('payload').Payload} [payload]
+ * @property {any} [config]
+ */
+/** @typedef {import('@nan0web/ui').ModelAsAppOptions & AppOptions} PayloadAppOptions */
+/**
+ * PayloadApp
+ * Base application class for Payload CMS subcommands (SeedModel, TransformModel, etc.)
+ * @extends {ModelAsApp}
+ */
+export class PayloadApp extends ModelAsApp {
+    /**
+     * @param {Partial<ModelAsApp> | Record<string, any>} [data={}]
+     * @param {Partial<PayloadAppOptions>} [options={}]
+     */
+    constructor(data?: Partial<ModelAsApp> | Record<string, any>, options?: Partial<PayloadAppOptions>);
+    _: {
+        payload: import("payload").BasePayload | null;
+        config: any;
+        adapter: import("@nan0web/ui").InputAdapter;
+        parentPath: string;
+        _isExplicit: boolean;
+        db: import("@nan0web/db").default | null | undefined;
+        plugins: Record<string, any>;
+        t: import("@nan0web/types/src/utils/TFunction").TFunction;
+    };
+    /**
+     * Lazily initializes and returns the Payload Local API instance.
+     * @returns {Promise<import('payload').Payload>}
+     */
+    getPayloadInstance(): Promise<import("payload").Payload>;
+}
+export type AppOptions = {
+    payload?: import("payload").BasePayload | undefined;
+    config?: any;
+};
+export type PayloadAppOptions = import("@nan0web/ui").ModelAsAppOptions & AppOptions;
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/SeedModel.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SeedModel - Universal Subcommand to seed DB-FS data into Payload CMS
+ * @extends {PayloadApp}
+ */
+export class SeedModel extends PayloadApp {
+    static alias: string;
+    static UI: {
+        title: string;
+        start: string;
+        scanning: string;
+        loading: string;
+        seeded: string;
+        done: string;
+        errorDb: string;
+    };
+    static dataDir: {
+        help: string;
+        default: string;
+        positional: boolean;
+    };
+    static output: {
+        help: string;
+        default: string;
+        alias: string;
+    };
+    /**
+     * @param {Partial<SeedModel>} [data={}]
+     * @param {Partial<import('./PayloadApp.js').PayloadAppOptions>} [options={}]
+     */
+    constructor(data?: Partial<SeedModel>, options?: Partial<import("./PayloadApp.js").PayloadAppOptions>);
+    /** @type {string} Target directory containing SSOT data files */ dataDir: string;
+    /** @type {string} Output path */ output: string;
+    /**
+     * Reads seed files via DB instance.
+     * @param {string} target
+     * @returns {Promise<string[]>}
+     */
+    readSeedFiles(target: string): Promise<string[]>;
+    /**
+     * Dynamically resolves collection slug from document metadata or URI structure.
+     * @param {string} uri
+     * @param {any} [doc]
+     * @returns {string}
+     */
+    resolveCollectionSlug(uri: string, doc?: any): string;
+    /**
+     * Base default normalization for DB-FS records.
+     * Can be overridden by domain-specific SeedModels (e.g. CardSeedModel, BankSeedModel).
+     * @param {any} rawRecord
+     * @returns {Object}
+     */
+    normalizeRecord(rawRecord: any): any;
+    /**
+     * @returns {AsyncGenerator<import('@nan0web/ui/core').Intent, import('@nan0web/ui/core').ResultIntent, any>}
+     */
+    run(): AsyncGenerator<import("@nan0web/ui/core").Intent, import("@nan0web/ui/core").ResultIntent, any>;
+}
+import { PayloadApp } from './PayloadApp.js';

package/types/index.d.ts

@@ -0,0 +1,6 @@
+export { ImageCell } from "./components/ImageCell.js";
+export { BooleanCell } from "./components/BooleanCell.js";
+export { MapCell } from "./components/MapCell.js";
+export { Nan0HTMLFeature } from "./richtext/Nan0HTMLFeature.js";
+export { fromNan0Html, inventoryNan0Html, FORMAT } from "./richtext/fromNan0Html.js";
+export { accessFor, publicAccess } from "./access.js";

package/types/richtext/Nan0ComponentNode.d.ts

@@ -0,0 +1,29 @@
+export function $createNan0ComponentNode({ component, props }: {
+    component: any;
+    props?: {} | undefined;
+}): Nan0ComponentNode;
+export function $isNan0ComponentNode(node: any): node is Nan0ComponentNode;
+export class Nan0ComponentNode extends DecoratorNode<any> {
+    static clone(node: any): Nan0ComponentNode;
+    static importJSON(serializedNode: any): Nan0ComponentNode;
+    constructor({ component, props, key }: {
+        component: any;
+        props?: {} | undefined;
+        key: any;
+    });
+    /** @type {string} */ __component: string;
+    /** @type {Record<string, any>} */ __props: Record<string, any>;
+    exportJSON(): {
+        type: string;
+        version: number;
+        component: string;
+        props: Record<string, any>;
+        $?: Record<string, unknown>;
+    };
+    getComponent(): string;
+    getProps(): Record<string, any>;
+    createDOM(): HTMLDivElement;
+    updateDOM(): boolean;
+    decorate(): null;
+}
+import { DecoratorNode } from 'lexical';

package/types/richtext/Nan0ElementNode.d.ts

@@ -0,0 +1,34 @@
+export function $createNan0ElementNode({ tag, attributes }: {
+    tag: any;
+    attributes?: {} | undefined;
+}): Nan0ElementNode;
+export function $isNan0ElementNode(node: any): node is Nan0ElementNode;
+export class Nan0ElementNode extends ElementNode {
+    static clone(node: any): Nan0ElementNode;
+    static importJSON(serializedNode: any): Nan0ElementNode;
+    constructor({ tag, attributes, key }: {
+        tag: any;
+        attributes?: {} | undefined;
+        key: any;
+    });
+    /** @type {string} */ __tag: string;
+    /** @type {Record<string, any>} */ __attributes: Record<string, any>;
+    exportJSON(): {
+        type: string;
+        version: number;
+        tag: string;
+        attributes: Record<string, any>;
+        $?: Record<string, unknown> | undefined;
+        children: import("lexical").SerializedLexicalNode[];
+        direction: "ltr" | "rtl" | null;
+        format: import("lexical").ElementFormatType;
+        indent: number;
+        textFormat?: number;
+        textStyle?: string;
+    };
+    getTag(): string;
+    getAttributes(): Record<string, any>;
+    createDOM(config: any): HTMLElement;
+    updateDOM(): boolean;
+}
+import { ElementNode } from 'lexical';

package/types/richtext/Nan0HTMLFeature.d.ts

@@ -0,0 +1,2 @@
+export const Nan0HTMLFeature: import("@payloadcms/richtext-lexical").FeatureProviderProviderServer<undefined, undefined, undefined>;
+export default Nan0HTMLFeature;

package/types/richtext/Nan0RawNode.d.ts

@@ -0,0 +1,41 @@
+export function $createNan0RawNode({ source }: {
+    source: any;
+}): Nan0RawNode;
+export function $isNan0RawNode(node: any): node is Nan0RawNode;
+export class Nan0RawNode extends ElementNode {
+    static clone(node: any): Nan0RawNode;
+    static importJSON(serializedNode: any): Nan0RawNode;
+    constructor({ source, key }: {
+        source: any;
+        key: any;
+    });
+    /** @type {{ tag: string, attributes: Record<string, any>, children: any[] }} */ __source: {
+        tag: string;
+        attributes: Record<string, any>;
+        children: any[];
+    };
+    exportJSON(): {
+        type: string;
+        version: number;
+        source: {
+            tag: string;
+            attributes: Record<string, any>;
+            children: any[];
+        };
+        $?: Record<string, unknown> | undefined;
+        children: import("lexical").SerializedLexicalNode[];
+        direction: "ltr" | "rtl" | null;
+        format: import("lexical").ElementFormatType;
+        indent: number;
+        textFormat?: number;
+        textStyle?: string;
+    };
+    getSource(): {
+        tag: string;
+        attributes: Record<string, any>;
+        children: any[];
+    };
+    createDOM(config: any): HTMLDivElement;
+    updateDOM(): boolean;
+}
+import { ElementNode } from 'lexical';

package/types/richtext/client/index.d.ts

@@ -0,0 +1,11 @@
+export function Nan0HTMLFeatureClient(props?: {}): {
+    clientFeatureProps: {};
+    feature: () => {
+        nodes: (typeof Nan0ElementNode | typeof Nan0RawNode | typeof Nan0ComponentNode)[];
+        sanitizedClientFeatureProps: {};
+    };
+};
+export default Nan0HTMLFeatureClient;
+import { Nan0ElementNode } from '../Nan0ElementNode.js';
+import { Nan0RawNode } from '../Nan0RawNode.js';
+import { Nan0ComponentNode } from '../Nan0ComponentNode.js';

package/types/richtext/fromNan0Html.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Recursively walk the NaN0HTML AST and collect unknown constructs.
+ * @param {any} node
+ * @param {Array<{tag: string, attributes: Object, parent: string}>} out
+ * @param {string} parent
+ */
+export function inventoryNan0Html(node: any, out?: Array<{
+    tag: string;
+    attributes: any;
+    parent: string;
+}>, parent?: string): {
+    tag: string;
+    attributes: any;
+    parent: string;
+}[];
+/**
+ * Convert a NaN0HTML AST into a Payload Lexical root state.
+ * @param {any} content NaN0HTML AST (array of blocks, or a single block)
+ * @returns {{ root: { type: string, version: number, children: any[] } }}
+ */
+export function fromNan0Html(content: any): {
+    root: {
+        type: string;
+        version: number;
+        children: any[];
+    };
+};
+/**
+ * fromNan0Html
+ * Converts a NaN0HTML AST (page.content / content) into a Payload Lexical state JSON.
+ *
+ * NaN0HTML AST shape:
+ *   - array       → sequence of blocks
+ *   - string      → text content
+ *   - object      → element with keys: `$attr` for attributes, lowercase tag keys for
+ *                   child elements, `Uppercase.With.Dot` keys for NaN0 components
+ *   - `tag: true` → void element (e.g. `br`, `hr`)
+ *
+ * Strategy:
+ *   - Clean elements (no attributes) map to native Lexical nodes where possible.
+ *   - Elements carrying any `$`-attribute are preserved losslessly as a `nan0-element`
+ *     node (tag + attributes + children) so round-trip back to NaN0HTML is lossless.
+ *   - Unknown tags fall back to a `nan0-raw` node and are recorded in the inventory.
+ *   - NaN0 components (`App.Header`, `Card.Details`, ...) become `nan0-component` nodes.
+ *
+ * The converter returns a plain structure; localization is handled at the Payload
+ * collection level, not here.
+ */
+export const FORMAT: Readonly<{
+    bold: number;
+    italic: number;
+    underline: number;
+    strikethrough: number;
+}>;
+export default fromNan0Html;

package/types/richtext/index.d.ts

@@ -0,0 +1,2 @@
+export { default as toNan0Html } from "./toNan0Html.js";
+export { default as fromNan0Html, inventoryNan0Html, FORMAT } from "./fromNan0Html.js";

package/types/richtext/toNan0Html.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convert Payload Lexical state (or root node) back into a NaN0HTML AST.
+ * @param {Object} lexicalState Lexical state object `{ root: { children: [...] } }` or node object
+ * @returns {any} NaN0HTML AST structure (Array, Object, or String)
+ */
+export function toNan0Html(lexicalState: any): any;
+export default toNan0Html;

package/types/templates/PayloadCollectionTemplate.d.ts

@@ -0,0 +1,58 @@
+/** @typedef {Object} Field */
+/**
+ * PayloadCollectionTemplate - Model to generate Payload CMS CollectionConfig using CodeTemplate.
+ */
+export class PayloadCollectionTemplate extends Model {
+    static alias: string;
+    static collectionSlug: {
+        help: string;
+        default: string;
+    };
+    static useAsTitle: {
+        help: string;
+        default: string;
+    };
+    static labels: {
+        help: string;
+        default: {
+            singular: string;
+            plural: string;
+        };
+    };
+    static group: {
+        help: string;
+        type: string;
+        default: string;
+    };
+    static fields: {
+        help: string;
+        default: never[];
+    };
+    static template: {
+        help: string;
+        default: string;
+    };
+    /**
+     * @param {Partial<PayloadCollectionTemplate>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<PayloadCollectionTemplate>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} Collection slug */ collectionSlug: string;
+    /** @type {string} Label/title field name */ useAsTitle: string;
+    /** @type {Object} Labels object */ labels: any;
+    /** @type {Object|string} Group object or string */ group: any | string;
+    /** @type {Array<Field>} Collection fields */ fields: Array<Field>;
+    /** @type {Object} Custom replace snippets */ snippets: any;
+    /**
+     * Compiles the CollectionConfig template using native CodeTemplate replace blocks.
+     * @returns {Promise<string>} Generated TS code for the collection
+     */
+    compile(): Promise<string>;
+    /**
+     * Synchronously compiles the CollectionConfig template.
+     * @returns {string} Generated TS code for the collection
+     */
+    compileSync(): string;
+}
+export type Field = any;
+import { Model } from '@nan0web/types';

package/types/uiPayloadRegistry.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Polymorphic Registry for Payload CMS UI block views.
+ */
+export const uiPayloadRegistry: Map<any, any>;

package/releases/3/3/v3.3.0/task.md

@@ -1,64 +0,0 @@
----
-version: 3.3.0
-type: feature
-status: active
-locale: uk
-models: ["MarkdownBlockView", "MediaBlockView"]
----
-
-# 🚀 Mission: Payload CMS UI Адаптери та Блок-Компоненти у @nan0web/ui-payload (v3.3.0)
-
-## 🏁 Overview (Огляд)
-Реалізація універсальних UI компонентів та адаптерів Payload CMS для `MarkdownBlock`, `MediaBlock` та надання поліморфного `uiPayloadRegistry`.
-
-## 👥 User Stories (Сценарії)
-- Як розробник, я хочу відображати блоки `MarkdownBlock` через готові React/Payload UI елементи з підтримкою вкладеного графіків/калькуляторів.
-- Як розробник, я хочу реєструвати Payload UI блоки через `uiPayloadRegistry`, щоб OLMUI рендеринг працював без ручних процедурних розгалужень.
-
-## 🏗 Data-Driven Architecture (Моделювання)
-- `uiPayloadRegistry`:
-  - `Map<ModelConstructor, PayloadBlockViewComponent>`
-- `MarkdownBlockView`:
-  - Компонент для `type: 'text/markdown'`
-- `MediaBlockView`:
-  - Компонент для `static $upload = true`
-
-## 🎯 Scope (Задачі)
-- [ ] Створити `uiPayloadRegistry` для прив'язки моделей до Payload/React UI View класів.
-- [ ] Створити універсальний компонент `MarkdownBlockView`.
-- [ ] Створити універсальний компонент `MediaBlockView`.
-
-## ✅ Acceptance Criteria (DoD)
-- [ ] Контрактні тести (`task.spec.js`) написані і успішно проходять (Green).
-- [ ] OLMUI рендеринг: 0% процедурних `switch/case` в елементах рендерингу.
-
-## 📌 Context Checkpoint (2026-08-07)
-
-### Implemented
-- Added `fromNan0Html()` and `inventoryNan0Html()` conversion helpers.
-- Added Lexical custom nodes: `Nan0ElementNode`, `Nan0RawNode`, and `Nan0ComponentNode`.
-- Added `Nan0HTMLFeature()` with server-side HTML converters and client import-map entry.
-- Added Payload Lexical dependencies and public richtext exports.
-- Added `ImageCell` preview with fixed `192x108` dimensions.
-- Added Payload 3.86-compatible client feature provider in `src/richtext/client/index.js`.
-
-### Verification
-- `pnpm --prefix packages/ui-payload test` passes.
-- Root commit hook passed 43 tests.
-- Industrial Bank seed and Payload admin integration were exercised.
-
-### Current State
-- Changes are intentionally uncommitted after removing the last agent-created commit.
-- They are staged in `packages/ui-payload` and must be committed by the user.
-- Other repository changes are unrelated and must not be included.
-- Industrial Bank CMS import map uses `@nan0web/ui-payload#ImageCell`.
-- CMS image paths `/img/...` and `/images/...` are mounted from `bank/public`.
-
-### Next Steps
-1. Commit only the staged `packages/ui-payload` changes.
-2. Run the Industrial Bank CMS build and fix remaining unrelated TypeScript blockers, starting with `src/test-read.ts` using obsolete `DB({ rootDir })`.
-3. Verify `/admin/collections/cards/<id>` editing and `ImageCell` rendering.
-4. Add focused contract tests for Nan0HTML/Lexical conversion and custom nodes.
-
-### New Chat Bootstrap
-Start from branch `feature/payload-cms`, base `070afe7`, with staged changes in `packages/ui-payload`. Do not reset, clean, commit, or push without explicit user instruction.

package/releases/3/3/v3.3.0/task.spec.js

@@ -1,13 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-import { uiPayloadRegistry } from '../../../../src/uiPayloadRegistry.js'
-
-describe('Release v3.3.0: @nan0web/ui-payload Contract', () => {
-	it('uiPayloadRegistry provides polymorphic lookup for block views', () => {
-		class MockModel {}
-		class MockView {}
-		uiPayloadRegistry.set(MockModel, MockView)
-
-		assert.equal(uiPayloadRegistry.get(MockModel), MockView)
-	})
-})

package/src/components/BooleanCell.js

@@ -1,8 +0,0 @@
-import React from 'react'
-
-export function BooleanCell(props) {
-	const val = Boolean(props.cellData ?? props.value)
-	return React.createElement('span', {
-		style: { color: val ? '#22c55e' : '#ef4444', fontWeight: 600 },
-	}, val ? '✓' : '✗')
-}

package/src/components/BooleanCell.tsx

@@ -1,50 +0,0 @@
-'use client'
-
-import React from 'react'
-import { useTranslation } from '@payloadcms/ui'
-
-export const BooleanCell: React.FC<{ cellData: boolean; field: any }> = ({ cellData, field }) => {
-  const { i18n } = useTranslation()
-  const lang = i18n?.language?.toLowerCase().startsWith('en') ? 'en' : 'uk'
-  const val = Boolean(cellData)
-
-  const isHiddenField = field?.name?.toLowerCase() === 'hidden'
-  const customLabels = field?.admin?.custom?.labels
-
-  const defaultLabels = isHiddenField
-    ? { true: { uk: '🙈 Приховано', en: '🙈 Hidden' }, false: { uk: '🌐 Активно', en: '🌐 Active' } }
-    : { true: { uk: '✅ Так', en: '✅ Yes' }, false: { uk: '❌ Ні', en: '❌ No' } }
-
-  const labels = customLabels || defaultLabels
-  const text = labels[val ? 'true' : 'false']?.[lang] || (val ? 'Yes' : 'No')
-
-  const isWarning = isHiddenField ? val : !val
-  const variant = isWarning ? 'warning' : 'success'
-
-  return (
-    <span
-      className={`badge bg-${variant}-subtle text-${variant}-emphasis border border-${variant}-subtle`}
-      style={{
-        display: 'inline-flex',
-        alignItems: 'center',
-        gap: '4px',
-        padding: '3px 8px',
-        borderRadius: '12px',
-        fontSize: '11px',
-        fontWeight: 600,
-        backgroundColor: isWarning
-          ? 'var(--bs-warning-bg-subtle, rgba(255, 193, 7, 0.15))'
-          : 'var(--bs-success-bg-subtle, rgba(25, 135, 84, 0.15))',
-        color: isWarning
-          ? 'var(--bs-warning-text-emphasis, #664d03)'
-          : 'var(--bs-success-text-emphasis, #0a3622)',
-        borderColor: isWarning
-          ? 'var(--bs-warning-border-subtle, rgba(255, 193, 7, 0.3))'
-          : 'var(--bs-success-border-subtle, rgba(25, 135, 84, 0.3))',
-      }}
-      suppressHydrationWarning
-    >
-      {text}
-    </span>
-  )
-}

package/src/components/ImageCell.js

@@ -1,26 +0,0 @@
-import React from 'react'
-
-export function ImageCell(props) {
-	const value = props.cellData || props.value
-	if (!value) return null
-
-	const srcValue = typeof value === 'object' ? value.url || value.thumbnailURL : value
-	if (!srcValue) return null
-	const src = srcValue.startsWith('http') || srcValue.startsWith('/') ? srcValue : `/${srcValue}`
-
-	return React.createElement('img', {
-		src,
-		alt: 'Thumbnail',
-		width: 192,
-		height: 108,
-		style: {
-			width: 192,
-			minWidth: 192,
-			height: 108,
-			minHeight: 108,
-			objectFit: 'cover',
-			borderRadius: 6,
-			display: 'block',
-		},
-	})
-}

package/src/components/ImageCell.tsx

@@ -1,54 +0,0 @@
-'use client'
-
-import React, { useState } from 'react'
-
-export const ImageCell: React.FC<{ cellData: string }> = ({ cellData }) => {
-  const [hasError, setHasError] = useState(false)
-
-  if (!cellData || typeof cellData !== 'string' || hasError) {
-    return (
-      <div
-        style={{
-          display: 'inline-flex',
-          alignItems: 'center',
-          justifyContent: 'center',
-          width: '192px',
-          height: '108px',
-          borderRadius: '6px',
-          background: 'rgba(255, 255, 255, 0.05)',
-          border: '1px solid rgba(255, 255, 255, 0.1)',
-          fontSize: '12px',
-          color: '#888',
-        }}
-        suppressHydrationWarning
-      >
-        <span>🖼️ Без фото</span>
-      </div>
-    )
-  }
-
-  const src = cellData.startsWith('http') || cellData.startsWith('/') ? cellData : `/${cellData}`
-
-  return (
-    <div style={{ display: 'inline-flex', alignItems: 'center' }} suppressHydrationWarning>
-      <img
-        src={src}
-        alt="Preview"
-        style={{
-          width: '192px',
-          minWidth: '192px',
-          height: '108px',
-          minHeight: '108px',
-          display: 'block',
-          objectFit: 'cover',
-          borderRadius: '6px',
-          border: '1px solid rgba(255, 255, 255, 0.25)',
-          background: '#111',
-          boxShadow: '0 2px 8px rgba(0, 0, 0, 0.4)',
-        }}
-        onError={() => setHasError(true)}
-        suppressHydrationWarning
-      />
-    </div>
-  )
-}

package/src/components/MapCell.js

@@ -1,6 +0,0 @@
-import React from 'react'
-
-export function MapCell(props) {
-	const val = props.cellData || props.value
-	return React.createElement('span', null, String(val || ''))
-}

package/src/components/MapCell.tsx

@@ -1,59 +0,0 @@
-'use client'
-
-import React from 'react'
-
-export const MapCell: React.FC<{ rowData: any }> = ({ rowData }) => {
-  const lat = rowData?.lat || rowData?.latitude || '50.4501'
-  const lon = rowData?.lng || rowData?.longitude || '30.5234'
-  const address = rowData?.address || rowData?.title || 'Відділення'
-
-  const zoom = 15
-  const latNum = parseFloat(String(lat)) || 50.4501
-  const lonNum = parseFloat(String(lon)) || 30.5234
-
-  const x = Math.floor(((lonNum + 180) / 360) * Math.pow(2, zoom))
-  const y = Math.floor(
-    ((1 - Math.log(Math.tan((latNum * Math.PI) / 180) + 1 / Math.cos((latNum * Math.PI) / 180)) / Math.PI) / 2) *
-      Math.pow(2, zoom)
-  )
-
-  const osmTileUrl = `https://tile.openstreetmap.org/${zoom}/${x}/${y}.png`
-  const osmMapUrl = `https://www.openstreetmap.org/?mlat=${latNum}&mlon=${lonNum}#map=16/${latNum}/${lonNum}`
-
-  return (
-    <a
-      href={osmMapUrl}
-      target="_blank"
-      rel="noopener noreferrer"
-      style={{
-        display: 'inline-flex',
-        alignItems: 'center',
-        gap: '8px',
-        textDecoration: 'none',
-        color: 'inherit',
-      }}
-      suppressHydrationWarning
-    >
-      <img
-        src={osmTileUrl}
-        alt="OpenStreetMap"
-        style={{
-          width: '100px',
-          height: '56px',
-          objectFit: 'cover',
-          borderRadius: '4px',
-          border: '1px solid rgba(255, 255, 255, 0.2)',
-          background: '#222',
-        }}
-        onError={(e) => {
-          ;(e.target as HTMLElement).style.display = 'none'
-        }}
-        suppressHydrationWarning
-      />
-      <div style={{ display: 'flex', flexDirection: 'column', gap: '2px' }}>
-        <span style={{ fontSize: '12px', fontWeight: 600 }}>📍 {address}</span>
-        <span style={{ fontSize: '10px', color: '#1471d1' }}>🗺️ OpenStreetMap ({latNum.toFixed(4)}, {lonNum.toFixed(4)})</span>
-      </div>
-    </a>
-  )
-}

package/src/richtext/nan0html-converter.spec.js

@@ -1,63 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import { fromNan0Html } from './fromNan0Html.js'
-import { toNan0Html } from './toNan0Html.js'
-
-describe('NaN0HTML ↔ Lexical Converter Round-trip', () => {
-	it('converts basic paragraphs and text formats', () => {
-		const ast = { p: [{ strong: 'Bold text' }, ' and ', { em: 'italic text' }] }
-		const lexical = fromNan0Html(ast)
-		expect(lexical.root.type).toBe('root')
-		expect(lexical.root.children.length).toBe(1)
-		expect(lexical.root.children[0].type).toBe('paragraph')
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual(ast)
-	})
-
-	it('converts headings correctly', () => {
-		const ast = { h2: 'Title Heading' }
-		const lexical = fromNan0Html(ast)
-		expect(lexical.root.children[0].type).toBe('heading')
-		expect(lexical.root.children[0].tag).toBe('h2')
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual(ast)
-	})
-
-	it('converts lists and items', () => {
-		const ast = { ul: [{ li: 'Item 1' }, { li: 'Item 2' }] }
-		const lexical = fromNan0Html(ast)
-		expect(lexical.root.children[0].type).toBe('list')
-		expect(lexical.root.children[0].listType).toBe('bullet')
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual(ast)
-	})
-
-	it('converts links with attributes', () => {
-		const ast = { a: 'Click here', $href: 'https://example.com', $target: '_blank' }
-		const lexical = fromNan0Html(ast)
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual({ a: 'Click here', $href: 'https://example.com', $target: '_blank' })
-	})
-
-	it('preserves nan0-component losslessly', () => {
-		const ast = { 'Card.Details': { card: '$' } }
-		const lexical = fromNan0Html(ast)
-		expect(lexical.root.children[0].type).toBe('nan0-component')
-		expect(lexical.root.children[0].component).toBe('Card.Details')
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual(ast)
-	})
-
-	it('preserves unknown tags as nan0-raw', () => {
-		const ast = { 'custom-widget': 'Widget content', $mode: 'test' }
-		const lexical = fromNan0Html(ast)
-		expect(lexical.root.children[0].type).toBe('nan0-raw')
-
-		const backToAst = toNan0Html(lexical)
-		expect(backToAst).toEqual({ 'custom-widget': 'Widget content', $mode: 'test' })
-	})
-})