@fecommunity/reactpress 4.0.0-beta.0 → 4.0.0-beta.10

package/toolkit/dist/utils/api-envelope.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackPaginated = unpackPaginated;
+exports.unpackPaginatedPair = unpackPaginatedPair;
+exports.unpackList = unpackList;
+exports.unpackOne = unpackOne;
+/** Paginated endpoints: `data` is `[items, total]`. */
+function unpackPaginated(res) {
+    const payload = res?.data;
+    if (Array.isArray(payload) && Array.isArray(payload[0])) {
+        return payload[0];
+    }
+    return [];
+}
+/** Paginated endpoints — returns `[items, total]`. */
+function unpackPaginatedPair(res) {
+    const payload = res?.data;
+    if (Array.isArray(payload) && Array.isArray(payload[0])) {
+        return [payload[0], typeof payload[1] === 'number' ? payload[1] : payload[0].length];
+    }
+    return [[], 0];
+}
+/** List or single entity wrapped in `data`. */
+function unpackList(res) {
+    const data = res?.data;
+    return Array.isArray(data) ? data : [];
+}
+function unpackOne(res) {
+    const data = res?.data;
+    return data != null ? data : null;
+}

package/toolkit/dist/utils/clipboard.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyToClipboard = copyToClipboard;
+/** Copy text to clipboard; returns whether the operation succeeded. */
+function copyToClipboard(text) {
+    if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+        void navigator.clipboard.writeText(text);
+        return true;
+    }
+    try {
+        const textarea = document.createElement('textarea');
+        textarea.value = text;
+        textarea.style.position = 'fixed';
+        textarea.style.opacity = '0';
+        document.body.appendChild(textarea);
+        textarea.select();
+        const ok = document.execCommand('copy');
+        document.body.removeChild(textarea);
+        return ok;
+    }
+    catch {
+        return false;
+    }
+}

package/toolkit/dist/utils/cookie.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRequestCookie = readRequestCookie;
+function readRequestCookie(req, name) {
+    const header = req?.headers?.cookie ?? '';
+    const match = new RegExp(`(?:^|;\\s*)${name}=([^;]*)`).exec(header);
+    if (!match?.[1])
+        return undefined;
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        return match[1];
+    }
+}

package/toolkit/dist/utils/date.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.formatPublishDate = formatPublishDate;
+exports.formatPublishDateShort = formatPublishDateShort;
+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);
+}
+/** Format article `publishAt` for templates (SSR-safe). */
+function formatPublishDate(value, options = {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+}, locale = 'en-US') {
+    if (value == null || value === '')
+        return '';
+    try {
+        const date = value instanceof Date ? value : new Date(value);
+        if (Number.isNaN(date.getTime()))
+            return '';
+        return date.toLocaleDateString(locale, options);
+    }
+    catch {
+        return '';
+    }
+}
+function formatPublishDateShort(value) {
+    if (value == null || value === '')
+        return '';
+    try {
+        const date = value instanceof Date ? value : new Date(value);
+        if (Number.isNaN(date.getTime()))
+            return '';
+        return formatDate(date, 'YYYY-MM-DD');
+    }
+    catch {
+        return '';
+    }
+}

package/toolkit/dist/utils/email.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMENT_EMAIL_REGEXP = void 0;
+exports.isValidCommentEmail = isValidCommentEmail;
+/** Permissive enough for common guest comment emails (qq/163/gmail, subdomains). */
+exports.COMMENT_EMAIL_REGEXP = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isValidCommentEmail(email) {
+    return Boolean(email?.trim() && exports.COMMENT_EMAIL_REGEXP.test(email.trim()));
+}

package/toolkit/dist/utils/error.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.isApiError = isApiError;
+function isApiError(error) {
+    return Boolean(error &&
+        typeof error === 'object' &&
+        'response' in error &&
+        error.response?.data);
+}
+class ApiError extends Error {
+    constructor(message, code = 500, details = null) {
+        super(message);
+        this.name = 'ApiError';
+        this.code = code;
+        this.details = details;
+    }
+    static isInstance(error) {
+        return (error instanceof ApiError ||
+            Boolean(error &&
+                typeof error === 'object' &&
+                error.name === 'ApiError' &&
+                error.code !== undefined));
+    }
+}
+exports.ApiError = ApiError;

package/toolkit/dist/utils/image.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImageUrl = resolveImageUrl;
+const VARIANT_SUFFIX = {
+    medium: '_medium',
+    thumb: '_thumb',
+    avatar: '_avatar',
+};
+const WEBP_VARIANT_PATTERN = /^(.+?)(?:_(medium|thumb|avatar))?\.webp(\?.*)?$/i;
+function extractWebpBase(url) {
+    const match = url.match(WEBP_VARIANT_PATTERN);
+    if (!match) {
+        return null;
+    }
+    return match[1];
+}
+/**
+ * 根据展示场景解析图片 URL。
+ * 上传后的 WebP 资源会按 `_medium` / `_thumb` / `_avatar` 后缀生成多尺寸版本；
+ * 非 WebP 或无法识别的 URL 将原样返回，兼容历史数据。
+ */
+function resolveImageUrl(url, variant = 'medium') {
+    if (!url) {
+        return '';
+    }
+    const base = extractWebpBase(url);
+    if (!base) {
+        return url;
+    }
+    if (variant === 'large') {
+        return `${base}.webp`;
+    }
+    return `${base}${VARIANT_SUFFIX[variant]}.webp`;
+}

package/toolkit/dist/utils/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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/toolkit/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/toolkit/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/toolkit/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/toolkit/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/toolkit/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/toolkit/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;
+}