@fecommunity/reactpress-toolkit 3.0.0 → 3.1.0

package/dist/utils/index.js

@@ -1,59 +1,39 @@
 "use strict";
-// Utility functions for ReactPress Toolkit
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiError = exports.isApiError = exports.deepClone = exports.formatDate = void 0;
-/**
- * Format a date to the specified format
- * @param date - Date to format
- * @param format - Format string (default: YYYY-MM-DD)
- * @returns Formatted date string
- */
-function formatDate(date, format = 'YYYY-MM-DD') {
-    const year = date.getFullYear();
-    const month = String(date.getMonth() + 1).padStart(2, '0');
-    const day = String(date.getDate()).padStart(2, '0');
-    return format
-        .replace('YYYY', String(year))
-        .replace('MM', month)
-        .replace('DD', day);
-}
-exports.formatDate = formatDate;
-/**
- * Deep clone an object
- * @param obj - Object to clone
- * @returns Cloned object
- */
-function deepClone(obj) {
-    return JSON.parse(JSON.stringify(obj));
-}
-exports.deepClone = deepClone;
-/**
- * Check if an error is an API error
- * @param error - Error to check
- * @returns True if it's an API error
- */
-function isApiError(error) {
-    return error && error.response && error.response.data;
-}
-exports.isApiError = isApiError;
-/**
- * API Error class
- */
-class ApiError extends Error {
-    constructor(message, code = 500, details = null) {
-        super(message);
-        this.name = 'ApiError';
-        this.code = code;
-        this.details = details;
-    }
-    /**
-     * Check if an object is an instance of ApiError
-     * @param error - Error to check
-     * @returns True if it's an ApiError instance
-     */
-    static isInstance(error) {
-        return error instanceof ApiError ||
-            (error && error.name === 'ApiError' && error.code !== undefined);
-    }
-}
-exports.ApiError = ApiError;
+exports.resolveImageUrl = exports.copyToClipboard = exports.truncateWords = exports.stripHtml = exports.pickSiteSettings = exports.setByPath = exports.getNestedLocaleValue = exports.getNestedLocaleString = exports.getByPath = exports.deepMerge = exports.deepClone = exports.safeJsonParse = exports.jsonp = exports.isApiError = exports.ApiError = exports.isValidCommentEmail = exports.COMMENT_EMAIL_REGEXP = exports.formatPublishDateShort = exports.formatPublishDate = exports.formatDate = exports.readRequestCookie = exports.unpackPaginated = exports.unpackOne = exports.unpackList = void 0;
+var api_envelope_1 = require("./api-envelope");
+Object.defineProperty(exports, "unpackList", { enumerable: true, get: function () { return api_envelope_1.unpackList; } });
+Object.defineProperty(exports, "unpackOne", { enumerable: true, get: function () { return api_envelope_1.unpackOne; } });
+Object.defineProperty(exports, "unpackPaginated", { enumerable: true, get: function () { return api_envelope_1.unpackPaginated; } });
+var cookie_1 = require("./cookie");
+Object.defineProperty(exports, "readRequestCookie", { enumerable: true, get: function () { return cookie_1.readRequestCookie; } });
+var date_1 = require("./date");
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return date_1.formatDate; } });
+Object.defineProperty(exports, "formatPublishDate", { enumerable: true, get: function () { return date_1.formatPublishDate; } });
+Object.defineProperty(exports, "formatPublishDateShort", { enumerable: true, get: function () { return date_1.formatPublishDateShort; } });
+var email_1 = require("./email");
+Object.defineProperty(exports, "COMMENT_EMAIL_REGEXP", { enumerable: true, get: function () { return email_1.COMMENT_EMAIL_REGEXP; } });
+Object.defineProperty(exports, "isValidCommentEmail", { enumerable: true, get: function () { return email_1.isValidCommentEmail; } });
+var error_1 = require("./error");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return error_1.ApiError; } });
+Object.defineProperty(exports, "isApiError", { enumerable: true, get: function () { return error_1.isApiError; } });
+var jsonp_1 = require("./jsonp");
+Object.defineProperty(exports, "jsonp", { enumerable: true, get: function () { return jsonp_1.jsonp; } });
+var json_1 = require("./json");
+Object.defineProperty(exports, "safeJsonParse", { enumerable: true, get: function () { return json_1.safeJsonParse; } });
+var object_1 = require("./object");
+Object.defineProperty(exports, "deepClone", { enumerable: true, get: function () { return object_1.deepClone; } });
+Object.defineProperty(exports, "deepMerge", { enumerable: true, get: function () { return object_1.deepMerge; } });
+Object.defineProperty(exports, "getByPath", { enumerable: true, get: function () { return object_1.getByPath; } });
+Object.defineProperty(exports, "getNestedLocaleString", { enumerable: true, get: function () { return object_1.getNestedLocaleString; } });
+Object.defineProperty(exports, "getNestedLocaleValue", { enumerable: true, get: function () { return object_1.getNestedLocaleValue; } });
+Object.defineProperty(exports, "setByPath", { enumerable: true, get: function () { return object_1.setByPath; } });
+var setting_1 = require("./setting");
+Object.defineProperty(exports, "pickSiteSettings", { enumerable: true, get: function () { return setting_1.pickSiteSettings; } });
+var string_1 = require("./string");
+Object.defineProperty(exports, "stripHtml", { enumerable: true, get: function () { return string_1.stripHtml; } });
+Object.defineProperty(exports, "truncateWords", { enumerable: true, get: function () { return string_1.truncateWords; } });
+var clipboard_1 = require("./clipboard");
+Object.defineProperty(exports, "copyToClipboard", { enumerable: true, get: function () { return clipboard_1.copyToClipboard; } });
+var image_1 = require("./image");
+Object.defineProperty(exports, "resolveImageUrl", { enumerable: true, get: function () { return image_1.resolveImageUrl; } });

package/dist/utils/json.d.ts

@@ -0,0 +1,2 @@
+/** Parse JSON string or pass through objects; return fallback on failure. */
+export declare function safeJsonParse<T>(raw: unknown, fallback: T): T;

package/dist/utils/json.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeJsonParse = safeJsonParse;
+/** Parse JSON string or pass through objects; return fallback on failure. */
+function safeJsonParse(raw, fallback) {
+    if (raw == null || raw === '')
+        return fallback;
+    if (typeof raw === 'object')
+        return raw;
+    if (typeof raw !== 'string')
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}

package/dist/utils/jsonp.d.ts

@@ -0,0 +1,8 @@
+type JsonpCallback = (data: unknown) => void;
+declare global {
+    interface Window {
+        [key: string]: JsonpCallback | unknown;
+    }
+}
+export declare function jsonp(url: string, params: Record<string, string>, callback: JsonpCallback): void;
+export {};

package/dist/utils/jsonp.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonp = jsonp;
+function jsonp(url, params, callback) {
+    const callbackName = `jsonp_callback_${Date.now()}`;
+    const queryParams = { ...params, cb: callbackName };
+    const queryString = Object.keys(queryParams)
+        .map((key) => `${encodeURIComponent(key)}=${encodeURIComponent(queryParams[key])}`)
+        .join('&');
+    const script = document.createElement('script');
+    script.src = `${url}?${queryString}`;
+    window[callbackName] = (data) => {
+        callback(data);
+        delete window[callbackName];
+        document.head.removeChild(script);
+    };
+    script.onerror = () => {
+        callback(new Error('JSONP request failed'));
+        if (window[callbackName]) {
+            delete window[callbackName];
+        }
+        if (document.head.contains(script)) {
+            document.head.removeChild(script);
+        }
+    };
+    document.head.appendChild(script);
+}

package/dist/utils/object.d.ts

@@ -0,0 +1,7 @@
+/** Deep get for dot-separated paths (`a.b.c`). */
+export declare function getByPath(obj: unknown, path: string): unknown;
+export declare function getNestedLocaleValue(obj: unknown, dotPath: string): unknown;
+export declare function getNestedLocaleString(obj: unknown, dotPath: string): string | undefined;
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Record<string, unknown>): T;
+export declare function deepClone<T>(obj: T): T;

package/dist/utils/object.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getByPath = getByPath;
+exports.getNestedLocaleValue = getNestedLocaleValue;
+exports.getNestedLocaleString = getNestedLocaleString;
+exports.setByPath = setByPath;
+exports.deepMerge = deepMerge;
+exports.deepClone = deepClone;
+/** Deep get for dot-separated paths (`a.b.c`). */
+function getByPath(obj, path) {
+    if (!path)
+        return obj;
+    const parts = path.split('.').filter(Boolean);
+    let cur = obj;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function getNestedLocaleValue(obj, dotPath) {
+    return getByPath(obj, dotPath);
+}
+function getNestedLocaleString(obj, dotPath) {
+    const value = getByPath(obj, dotPath);
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function setByPath(obj, path, value) {
+    const parts = path.split('.').filter(Boolean);
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const next = cur[key];
+        if (next == null || typeof next !== 'object' || Array.isArray(next)) {
+            cur[key] = {};
+        }
+        cur = cur[key];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+function deepMerge(target, source) {
+    const out = { ...target };
+    for (const key of Object.keys(source)) {
+        const sv = source[key];
+        const tv = out[key];
+        if (sv &&
+            typeof sv === 'object' &&
+            !Array.isArray(sv) &&
+            tv &&
+            typeof tv === 'object' &&
+            !Array.isArray(tv)) {
+            out[key] = deepMerge(tv, sv);
+        }
+        else if (sv !== undefined) {
+            out[key] = sv;
+        }
+    }
+    return out;
+}
+function deepClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}

package/dist/utils/setting.d.ts

@@ -0,0 +1,12 @@
+export type SettingRow = {
+    key: string;
+    value?: unknown;
+    [field: string]: unknown;
+};
+/** Map global settings rows to a props object by key. */
+export declare function pickSiteSettings<T extends Record<string, {
+    key: string;
+    default: string;
+}>>(settings: SettingRow[], schema: T): {
+    [K in keyof T]: string;
+};

package/dist/utils/setting.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickSiteSettings = pickSiteSettings;
+/** Map global settings rows to a props object by key. */
+function pickSiteSettings(settings, schema) {
+    const out = {};
+    for (const prop of Object.keys(schema)) {
+        const { key, default: fallback } = schema[prop];
+        const row = settings.find((s) => s.key === key);
+        out[prop] = row?.value != null ? String(row.value) : fallback;
+    }
+    return out;
+}

package/dist/utils/string.d.ts

@@ -0,0 +1,4 @@
+/** Strip HTML tags and collapse whitespace. */
+export declare function stripHtml(html: string): string;
+/** Truncate text to a word limit with an ellipsis. */
+export declare function truncateWords(text: string, limit: number): string;

package/dist/utils/string.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripHtml = stripHtml;
+exports.truncateWords = truncateWords;
+/** Strip HTML tags and collapse whitespace. */
+function stripHtml(html) {
+    return html.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Truncate text to a word limit with an ellipsis. */
+function truncateWords(text, limit) {
+    const words = text.trim().split(/\s+/).filter(Boolean);
+    if (words.length <= limit)
+        return text.trim();
+    return `${words.slice(0, limit).join(' ')}…`;
+}

package/dist/utils/viewport.d.ts

@@ -0,0 +1,3 @@
+/** Whether an element's top edge is within the upper viewport band. */
+export declare function elementInViewport(el: Element | null | undefined): boolean;
+export declare function isOdd(value: number): boolean;

package/dist/utils/viewport.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.elementInViewport = elementInViewport;
+exports.isOdd = isOdd;
+/** Whether an element's top edge is within the upper viewport band. */
+function elementInViewport(el) {
+    if (!el || !(el instanceof HTMLElement))
+        return false;
+    const rect = el.getBoundingClientRect();
+    return rect.top >= 0 && rect.top <= window.innerHeight * 0.4;
+}
+function isOdd(value) {
+    return value % 2 !== 0;
+}

package/package.json

@@ -1,24 +1,135 @@
 {
   "name": "@fecommunity/reactpress-toolkit",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./api": "./dist/api/index.js",
-    "./api/instance": "./dist/api/instance.js",
-    "./types": "./dist/types/index.js",
-    "./utils": "./dist/utils/index.js",
-    "./config": "./dist/config/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./api/instance": {
+      "types": "./dist/api/instance.d.ts",
+      "default": "./dist/api/instance.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "default": "./dist/utils/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "default": "./dist/config/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme/index.d.ts",
+      "default": "./dist/theme/index.js"
+    },
+    "./theme/server": {
+      "types": "./dist/theme/server.d.ts",
+      "default": "./dist/theme/server.js"
+    },
+    "./theme/next-config": {
+      "types": "./dist/theme/next-config.d.ts",
+      "default": "./dist/theme/next-config.js"
+    },
+    "./theme/node": {
+      "types": "./dist/theme/node.d.ts",
+      "default": "./dist/theme/node.js"
+    },
+    "./theme/providers": {
+      "types": "./dist/theme/providers/index.d.ts",
+      "default": "./dist/theme/providers/index.js"
+    },
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "default": "./dist/app/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "default": "./dist/ui/index.js"
+    },
+    "./ui/content": {
+      "types": "./dist/ui/components/content/index.d.ts",
+      "default": "./dist/ui/components/content/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "default": "./dist/plugin/index.js"
+    },
+    "./plugin/admin": {
+      "types": "./dist/plugin/admin/index.d.ts",
+      "default": "./dist/plugin/admin/index.js"
+    },
+    "./plugin/client": {
+      "types": "./dist/plugin/client/index.d.ts",
+      "default": "./dist/plugin/client/index.js"
+    },
+    "./plugin/react": {
+      "types": "./dist/plugin/react/index.d.ts",
+      "default": "./dist/plugin/react/index.js"
+    },
+    "./plugin/dev": {
+      "types": "./dist/plugin/dev/index.d.ts",
+      "default": "./dist/plugin/dev/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@ant-design/cssinjs": ">=1",
+    "@tanstack/react-query": ">=5",
+    "highlight.js": ">=9",
+    "next": ">=12",
+    "nprogress": ">=0.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "viewerjs": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": { "optional": true },
+    "@ant-design/cssinjs": { "optional": true },
+    "highlight.js": { "optional": true },
+    "next": { "optional": true },
+    "nprogress": { "optional": true },
+    "react": { "optional": true },
+    "react-dom": { "optional": true },
+    "viewerjs": { "optional": true }
+  },
+  "scripts": {
+    "generate": "node scripts/generate-swagger.js",
+    "build": "tsc && rm -rf dist/config/locales && cp -r src/config/locales dist/config/locales",
+    "typecheck": "tsc --noEmit"
   },
   "files": [
     "dist"
   ],
-  "keywords": [],
-  "author": "",
+  "keywords": [
+    "reactpress",
+    "cms",
+    "toolkit",
+    "theme",
+    "headless"
+  ],
+  "author": "fecommunity",
   "license": "ISC",
-  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fecommunity/reactpress.git",
+    "directory": "toolkit"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "ReactPress TypeScript toolkit: OpenAPI clients, theme SSR helpers, headless UI, and admin plugin registry.",
   "dependencies": {
+    "ajv": "^8.17.1",
     "axios": "^1.12.2",
     "dotenv": "^8.6.0",
     "fs-extra": "^10.0.0",
@@ -26,11 +137,13 @@
     "swagger-typescript-api": "^12.0.4"
   },
   "devDependencies": {
+    "@ant-design/cssinjs": "^1.22.0",
     "@types/fs-extra": "^9.0.13",
-    "@types/node": "^17.0.22"
-  },
-  "scripts": {
-    "generate": "node scripts/generate-swagger.js",
-    "build": "tsc && cp -r src/locales dist/"
+    "@types/node": "^17.0.22",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.7.3"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
- 
-Copyright (c) [2024] [fecommunity]
- 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
- 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
- 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.