@readpress/wp-blog 1.0.0

package/dist/react.d.mts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType } from 'react';
+import { W as WpContentPart } from './types-BDmCnhFG.mjs';
+
+type WpPlaceholderComponents = Record<string, ComponentType<Record<string, unknown>>>;
+interface WpContentProps {
+    contentHtml?: string;
+    contentParts?: WpContentPart[];
+    components?: WpPlaceholderComponents;
+    placeholderNamespace?: string;
+    maxPlaceholderPropsLength?: number;
+    unknownPlaceholder?: "ignore" | "comment";
+}
+declare function WpContent({ contentHtml, contentParts, components, placeholderNamespace, maxPlaceholderPropsLength, unknownPlaceholder, }: WpContentProps): react_jsx_runtime.JSX.Element;
+
+export { WpContent, type WpContentProps, type WpPlaceholderComponents };

package/dist/react.d.ts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType } from 'react';
+import { W as WpContentPart } from './types-BDmCnhFG.js';
+
+type WpPlaceholderComponents = Record<string, ComponentType<Record<string, unknown>>>;
+interface WpContentProps {
+    contentHtml?: string;
+    contentParts?: WpContentPart[];
+    components?: WpPlaceholderComponents;
+    placeholderNamespace?: string;
+    maxPlaceholderPropsLength?: number;
+    unknownPlaceholder?: "ignore" | "comment";
+}
+declare function WpContent({ contentHtml, contentParts, components, placeholderNamespace, maxPlaceholderPropsLength, unknownPlaceholder, }: WpContentProps): react_jsx_runtime.JSX.Element;
+
+export { WpContent, type WpContentProps, type WpPlaceholderComponents };

package/dist/react.js

@@ -0,0 +1,167 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.tsx
+var react_exports = {};
+__export(react_exports, {
+  WpContent: () => WpContent
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/domain/placeholders.ts
+var DEFAULT_NAMESPACE = "wpapp";
+var DEFAULT_MAX_PROPS_LENGTH = 1e4;
+var PLACEHOLDER_NAME_REGEX = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function escapeRegex(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function normalizeNamespace(value) {
+  const trimmed = value == null ? void 0 : value.trim();
+  if (!trimmed) {
+    return DEFAULT_NAMESPACE;
+  }
+  return trimmed;
+}
+function normalizeMaxPropsLength(value) {
+  if (!value || !Number.isInteger(value) || value <= 0) {
+    return DEFAULT_MAX_PROPS_LENGTH;
+  }
+  return value;
+}
+function parseProps(rawProps, maxPropsLength) {
+  const trimmed = rawProps == null ? void 0 : rawProps.trim();
+  if (!trimmed) {
+    return {};
+  }
+  if (trimmed.length > maxPropsLength) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return null;
+    }
+    return parsed;
+  } catch (e) {
+    return null;
+  }
+}
+function parseContentPlaceholders(contentHtml, options = {}) {
+  if (!contentHtml) {
+    return [{ type: "html", html: "" }];
+  }
+  const namespace = normalizeNamespace(options.namespace);
+  const maxPropsLength = normalizeMaxPropsLength(options.maxPropsLength);
+  const markerRegex = new RegExp(
+    `<!--\\s*${escapeRegex(namespace)}:([A-Za-z][A-Za-z0-9_-]*)(?:\\s+([\\s\\S]*?))?\\s*-->`,
+    "g"
+  );
+  const parts = [];
+  let cursor = 0;
+  let match;
+  while ((match = markerRegex.exec(contentHtml)) !== null) {
+    const [fullMatch, rawName, rawProps] = match;
+    const matchIndex = match.index;
+    if (matchIndex > cursor) {
+      parts.push({ type: "html", html: contentHtml.slice(cursor, matchIndex) });
+    }
+    const name = rawName == null ? void 0 : rawName.trim();
+    const props = parseProps(rawProps, maxPropsLength);
+    if (!name || !PLACEHOLDER_NAME_REGEX.test(name) || !props) {
+      parts.push({ type: "html", html: fullMatch });
+      cursor = markerRegex.lastIndex;
+      continue;
+    }
+    parts.push({
+      type: "placeholder",
+      name,
+      props
+    });
+    cursor = markerRegex.lastIndex;
+  }
+  if (cursor < contentHtml.length) {
+    parts.push({ type: "html", html: contentHtml.slice(cursor) });
+  }
+  if (parts.length === 0) {
+    return [{ type: "html", html: contentHtml }];
+  }
+  return parts;
+}
+
+// src/react.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function getParts(props) {
+  var _a;
+  if (props.contentParts) {
+    return props.contentParts;
+  }
+  const options = {
+    namespace: props.placeholderNamespace,
+    maxPropsLength: props.maxPlaceholderPropsLength
+  };
+  return parseContentPlaceholders((_a = props.contentHtml) != null ? _a : "", options);
+}
+function WpContent({
+  contentHtml,
+  contentParts,
+  components = {},
+  placeholderNamespace,
+  maxPlaceholderPropsLength,
+  unknownPlaceholder = "ignore"
+}) {
+  const parts = getParts({
+    contentHtml,
+    contentParts,
+    components,
+    placeholderNamespace,
+    maxPlaceholderPropsLength,
+    unknownPlaceholder
+  });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: parts.map((part, index) => {
+    if (part.type === "html") {
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { dangerouslySetInnerHTML: { __html: part.html } }, `html-${index}`);
+    }
+    const Component = components[part.name];
+    if (!Component) {
+      if (unknownPlaceholder === "comment") {
+        return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "data-wp-placeholder": part.name, hidden: true }, `unknown-${part.name}-${index}`);
+      }
+      return null;
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Component, __spreadValues({}, part.props), `placeholder-${part.name}-${index}`);
+  }) });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WpContent
+});

package/dist/react.mjs

@@ -0,0 +1,51 @@
+import {
+  __spreadValues,
+  parseContentPlaceholders
+} from "./chunk-QKYYHVDQ.mjs";
+
+// src/react.tsx
+import { Fragment, jsx } from "react/jsx-runtime";
+function getParts(props) {
+  var _a;
+  if (props.contentParts) {
+    return props.contentParts;
+  }
+  const options = {
+    namespace: props.placeholderNamespace,
+    maxPropsLength: props.maxPlaceholderPropsLength
+  };
+  return parseContentPlaceholders((_a = props.contentHtml) != null ? _a : "", options);
+}
+function WpContent({
+  contentHtml,
+  contentParts,
+  components = {},
+  placeholderNamespace,
+  maxPlaceholderPropsLength,
+  unknownPlaceholder = "ignore"
+}) {
+  const parts = getParts({
+    contentHtml,
+    contentParts,
+    components,
+    placeholderNamespace,
+    maxPlaceholderPropsLength,
+    unknownPlaceholder
+  });
+  return /* @__PURE__ */ jsx(Fragment, { children: parts.map((part, index) => {
+    if (part.type === "html") {
+      return /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: part.html } }, `html-${index}`);
+    }
+    const Component = components[part.name];
+    if (!Component) {
+      if (unknownPlaceholder === "comment") {
+        return /* @__PURE__ */ jsx("span", { "data-wp-placeholder": part.name, hidden: true }, `unknown-${part.name}-${index}`);
+      }
+      return null;
+    }
+    return /* @__PURE__ */ jsx(Component, __spreadValues({}, part.props), `placeholder-${part.name}-${index}`);
+  }) });
+}
+export {
+  WpContent
+};

package/dist/types-BDmCnhFG.d.mts

@@ -0,0 +1,248 @@
+interface WpRenderedField {
+    rendered: string;
+}
+interface WpFeaturedMedia {
+    source_url?: string;
+}
+interface WpTerm {
+    id: number;
+    slug?: string;
+    name?: string;
+    taxonomy?: string;
+    count?: number;
+}
+interface WpAuthor {
+    id: number;
+    name?: string;
+    slug?: string;
+    url?: string;
+    description?: string;
+    link?: string;
+    avatar_urls?: Record<string, string>;
+    [key: string]: unknown;
+}
+interface WpEmbedded {
+    "wp:featuredmedia"?: WpFeaturedMedia[];
+    "wp:term"?: WpTerm[][];
+    author?: WpAuthor[];
+}
+interface WpPost {
+    id: number;
+    slug: string;
+    link: string;
+    date: string;
+    modified: string;
+    title: WpRenderedField;
+    excerpt: WpRenderedField;
+    content: WpRenderedField;
+    _embedded?: WpEmbedded;
+}
+interface LinkRewriteContext {
+    href: string;
+    pathname: string;
+    search: string;
+    hash: string;
+}
+interface LinkRewriteRule {
+    source: string;
+    destination?: string;
+    action?: "ignore";
+    transform?: (context: LinkRewriteContext) => string;
+}
+type ClassNameMapMode = "append" | "replace" | "replace-all";
+interface ClassNameMapRule {
+    className: string;
+    mode?: ClassNameMapMode;
+}
+type ClassNameMapValue = string | ClassNameMapRule;
+type ClassNameMap = Record<string, ClassNameMapValue>;
+type PlaceholderProps = Record<string, unknown>;
+interface HtmlContentPart {
+    type: "html";
+    html: string;
+}
+interface PlaceholderContentPart {
+    type: "placeholder";
+    name: string;
+    props: PlaceholderProps;
+}
+type WpContentPart = HtmlContentPart | PlaceholderContentPart;
+interface PlaceholderParseOptions {
+    namespace?: string;
+    maxPropsLength?: number;
+}
+/**
+ * Normalized post shape returned by this package.
+ */
+interface BlogPostSummary {
+    id: number;
+    slug: string;
+    url: string;
+    date: string;
+    modified: string;
+    publishedDate: string;
+    updatedDate: string;
+    title: string;
+    excerpt: string;
+    featuredImageUrl: string | null;
+    author: BlogAuthor | null;
+    categories: BlogTerm[];
+    tags: BlogTerm[];
+}
+/**
+ * Full post shape returned by single-post methods.
+ */
+interface BlogPost extends BlogPostSummary {
+    contentHtml: string;
+}
+interface BlogTerm {
+    id: number;
+    slug: string;
+    name: string;
+    count: number;
+}
+type BlogAuthor = WpAuthor;
+type BlogTermOrder = "default" | "alphabetical" | "count";
+interface GetTermsParams {
+    order?: BlogTermOrder;
+}
+interface GetAuthorsParams {
+    page?: number;
+    perPage?: number;
+}
+type BlogTextMode = "plain" | "html";
+type BlogPostSummaryField = keyof BlogPostSummary;
+type BlogPostField = keyof BlogPost;
+type SelectFields<T, TSelect extends readonly (keyof T)[] | undefined> = TSelect extends readonly (keyof T)[] ? Pick<T, TSelect[number]> : T;
+/**
+ * Pagination metadata returned from list endpoints.
+ */
+interface PaginationMeta {
+    page: number;
+    perPage: number;
+    totalItems: number;
+    totalPages: number;
+}
+/**
+ * Response returned by getPosts.
+ */
+interface PostListResult<TItem = BlogPostSummary> {
+    items: TItem[];
+    pagination: PaginationMeta;
+}
+/**
+ * Optional pagination parameters for getPosts.
+ */
+interface GetPostsParams<TSelect extends readonly BlogPostSummaryField[] | undefined = undefined> {
+    page?: number;
+    perPage?: number;
+    status?: "draft" | "private" | "publish" | "any";
+    categorySlug?: string;
+    tagSlug?: string;
+    textMode?: BlogTextMode;
+    select?: TSelect;
+}
+/**
+ * Parameters for searching published posts.
+ */
+interface SearchPostsParams<TSelect extends readonly BlogPostSummaryField[] | undefined = undefined> extends GetPostsParams<TSelect> {
+    query: string;
+}
+/**
+ * Options for creating an explicit WordPress client.
+ */
+interface WpClientOptions {
+    wpUrl?: string;
+    endpoint?: string;
+    perPage?: number;
+    auth?: WpAuthConfig;
+    rewriteLinks?: LinkRewriteRule[];
+    classNameMap?: ClassNameMap;
+    fetchImpl?: typeof fetch;
+    requestInit?: RequestInit;
+}
+type WpAuthType = "none" | "basic" | "bearer" | "headers";
+interface WpAuthConfig {
+    type?: WpAuthType;
+    user?: string;
+    appPassword?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+interface WpAuthResolvedConfig {
+    type: WpAuthType;
+    user?: string;
+    appPassword?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+interface GetPostParams<TSelect extends readonly BlogPostField[] | undefined = undefined> {
+    status?: "draft" | "private" | "publish" | "any";
+    textMode?: BlogTextMode;
+    select?: TSelect;
+}
+interface QueryRawRestInput {
+    path: string;
+    params?: Record<string, string | number | boolean | null | undefined>;
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+interface QueryRawParams {
+    rest?: QueryRawRestInput;
+    authRequired?: boolean;
+}
+interface QueryGraphqlParams {
+    query: string;
+    variables?: Record<string, unknown>;
+}
+interface QueryGraphqlResult<TData = unknown> {
+    data?: TData;
+    errors?: Array<Record<string, unknown>>;
+}
+interface WpBlogClient {
+    /**
+     * Fetches a page of published WordPress posts.
+     */
+    getPosts<TSelect extends readonly BlogPostSummaryField[] | undefined = undefined>(params?: GetPostsParams<TSelect>): Promise<PostListResult<SelectFields<BlogPostSummary, TSelect>>>;
+    /**
+     * Searches posts using the WordPress REST search parameter.
+     */
+    searchPosts<TSelect extends readonly BlogPostSummaryField[] | undefined = undefined>(params: SearchPostsParams<TSelect>): Promise<PostListResult<SelectFields<BlogPostSummary, TSelect>>>;
+    /**
+     * Fetches a single post by slug, or null when not found.
+     */
+    getPostBySlug<TSelect extends readonly BlogPostField[] | undefined = undefined>(slug: string, params?: GetPostParams<TSelect>): Promise<SelectFields<BlogPost, TSelect> | null>;
+    /**
+     * Fetches a single published post by WordPress post ID, or null when not found.
+     */
+    getPostById<TSelect extends readonly BlogPostField[] | undefined = undefined>(id: number, params?: GetPostParams<TSelect>): Promise<SelectFields<BlogPost, TSelect> | null>;
+    /**
+     * Executes a raw request against REST for custom fields/shapes.
+     * Use this as an escape hatch for custom fields/shapes.
+     */
+    queryRaw<TData = unknown>(params: QueryRawParams): Promise<TData>;
+    /**
+     * Executes a raw GraphQL request.
+     * Uses WP_URL + WP_ENDPOINT and existing WP_AUTH_* auth config.
+     */
+    queryGraphql<TData = unknown>(params: QueryGraphqlParams): Promise<QueryGraphqlResult<TData>>;
+    /**
+     * Fetches blog categories for archive navigation/sidebars.
+     */
+    getCategories(params?: GetTermsParams): Promise<BlogTerm[]>;
+    /**
+     * Fetches blog tags for archive navigation/sidebars.
+     */
+    getTags(params?: GetTermsParams): Promise<BlogTerm[]>;
+    /**
+     * Fetches a page of WordPress authors.
+     */
+    getAuthors(params?: GetAuthorsParams): Promise<BlogAuthor[]>;
+    /**
+     * Fetches a single WordPress author by ID.
+     */
+    getAuthorById(id: number): Promise<BlogAuthor | null>;
+}
+
+export type { WpAuthResolvedConfig as A, BlogTerm as B, ClassNameMap as C, WpAuthType as D, WpEmbedded as E, WpFeaturedMedia as F, GetAuthorsParams as G, HtmlContentPart as H, WpPost as I, WpRenderedField as J, WpTerm as K, LinkRewriteContext as L, PlaceholderParseOptions as P, QueryGraphqlParams as Q, SelectFields as S, WpContentPart as W, WpClientOptions as a, WpBlogClient as b, WpAuthor as c, GetTermsParams as d, BlogPostField as e, GetPostParams as f, BlogPost as g, BlogPostSummaryField as h, GetPostsParams as i, PostListResult as j, BlogPostSummary as k, QueryGraphqlResult as l, QueryRawParams as m, SearchPostsParams as n, BlogAuthor as o, BlogTermOrder as p, BlogTextMode as q, ClassNameMapMode as r, ClassNameMapRule as s, ClassNameMapValue as t, LinkRewriteRule as u, PaginationMeta as v, PlaceholderContentPart as w, PlaceholderProps as x, QueryRawRestInput as y, WpAuthConfig as z };