@headroom-cms/api 0.1.1

package/dist/react.cjs

@@ -0,0 +1,323 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.ts
+var react_exports = {};
+__export(react_exports, {
+  BlockRenderer: () => BlockRenderer,
+  BulletList: () => BulletList,
+  CheckList: () => CheckList,
+  CodeBlock: () => CodeBlock,
+  Fallback: () => Fallback,
+  Heading: () => Heading,
+  ImageBlock: () => ImageBlock,
+  InlineContent: () => InlineContent,
+  NumberedList: () => NumberedList,
+  Paragraph: () => Paragraph,
+  Table: () => Table,
+  defaultBlockComponents: () => defaultBlockComponents
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/InlineContent.tsx
+var import_react = __toESM(require("react"), 1);
+var import_jsx_runtime = require("react/jsx-runtime");
+function styleClasses(styles) {
+  if (!styles) return void 0;
+  const classes = [];
+  if (styles.bold) classes.push("hr-bold");
+  if (styles.italic) classes.push("hr-italic");
+  if (styles.underline) classes.push("hr-underline");
+  if (styles.strikethrough) classes.push("hr-strikethrough");
+  if (styles.code) classes.push("hr-code");
+  return classes.length > 0 ? classes.join(" ") : void 0;
+}
+function resolveHref(href, refs, resolveContentLink) {
+  if (!href.startsWith("headroom://content/")) return href;
+  const match = href.match(/^headroom:\/\/content\/([^/]+)\/([A-Z0-9]+)$/);
+  if (!match) return "#";
+  const [, , contentId] = match;
+  const ref = refs?.[contentId];
+  if (!ref) return "#";
+  return resolveContentLink ? resolveContentLink(ref) : `/${ref.collection}/${ref.slug}`;
+}
+function InlineContent({ content, refs, resolveContentLink }) {
+  if (!content || content.length === 0) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: content.map((item, i) => {
+    if (item.type === "link") {
+      const resolved = resolveHref(item.href, refs, resolveContentLink);
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("a", { href: resolved, className: "hr-link", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        InlineContent,
+        {
+          content: item.content,
+          refs,
+          resolveContentLink
+        }
+      ) }, i);
+    }
+    const cls = styleClasses(item.styles);
+    return cls ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: cls, children: item.text }, i) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react.default.Fragment, { children: item.text }, i);
+  }) });
+}
+
+// src/react/blocks/Paragraph.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function Paragraph({ block, refs, resolveContentLink }) {
+  const content = Array.isArray(block.content) ? block.content : [];
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "hr-paragraph", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(InlineContent, { content, refs, resolveContentLink }) });
+}
+
+// src/react/blocks/Heading.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function Heading({ block, refs, resolveContentLink }) {
+  const level = Math.min(block.props?.level || 1, 6);
+  const content = Array.isArray(block.content) ? block.content : [];
+  const className = `hr-heading hr-h${level}`;
+  const inner = /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(InlineContent, { content, refs, resolveContentLink });
+  switch (level) {
+    case 1:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { className, children: inner });
+    case 2:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { className, children: inner });
+    case 3:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h3", { className, children: inner });
+    case 4:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h4", { className, children: inner });
+    case 5:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h5", { className, children: inner });
+    case 6:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h6", { className, children: inner });
+    default:
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { className, children: inner });
+  }
+}
+
+// src/react/blocks/Image.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function ImageBlock({ block, cdnUrl }) {
+  const storedPath = block.props?.url;
+  const src = storedPath ? cdnUrl ? `${cdnUrl}${storedPath}` : storedPath : "";
+  const alt = block.props?.alt || "";
+  const caption = block.props?.caption || "";
+  if (!src) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("figure", { className: "hr-image", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("img", { src, alt, loading: "lazy" }),
+    caption && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("figcaption", { children: caption })
+  ] });
+}
+
+// src/react/blocks/CodeBlock.tsx
+var import_jsx_runtime5 = require("react/jsx-runtime");
+function CodeBlock({ block }) {
+  const language = block.props?.language || "";
+  const content = Array.isArray(block.content) ? block.content : [];
+  const code = content.map((c) => "text" in c ? c.text : "").join("");
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("pre", { className: "hr-code-block", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("code", { className: language ? `language-${language}` : "", children: code }) });
+}
+
+// src/react/blocks/BulletList.tsx
+var import_jsx_runtime6 = require("react/jsx-runtime");
+function BulletList({ items, refs, resolveContentLink }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("ul", { className: "hr-bullet-list", children: (items || []).map((item) => {
+    const content = Array.isArray(item.content) ? item.content : [];
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("li", { children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(InlineContent, { content, refs, resolveContentLink }) }, item.id);
+  }) });
+}
+
+// src/react/blocks/NumberedList.tsx
+var import_jsx_runtime7 = require("react/jsx-runtime");
+function NumberedList({ items, refs, resolveContentLink }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("ol", { className: "hr-numbered-list", children: (items || []).map((item) => {
+    const content = Array.isArray(item.content) ? item.content : [];
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("li", { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(InlineContent, { content, refs, resolveContentLink }) }, item.id);
+  }) });
+}
+
+// src/react/blocks/CheckList.tsx
+var import_jsx_runtime8 = require("react/jsx-runtime");
+function CheckList({ items, refs, resolveContentLink }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("ul", { className: "hr-check-list", children: (items || []).map((item) => {
+    const checked = item.props?.checked;
+    const content = Array.isArray(item.content) ? item.content : [];
+    return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("li", { className: "hr-check-item", "data-checked": checked || void 0, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { className: "hr-checkbox", "aria-checked": checked, children: checked && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+        "path",
+        {
+          d: "M4 8l3 3 5-6",
+          stroke: "currentColor",
+          strokeWidth: "2",
+          strokeLinecap: "round",
+          strokeLinejoin: "round"
+        }
+      ) }) }),
+      /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(InlineContent, { content, refs, resolveContentLink }) })
+    ] }, item.id);
+  }) });
+}
+
+// src/react/blocks/Table.tsx
+var import_jsx_runtime9 = require("react/jsx-runtime");
+function Table({ block, refs, resolveContentLink }) {
+  const tableContent = block.content;
+  const rows = tableContent?.rows || [];
+  if (rows.length === 0) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("table", { className: "hr-table", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("tbody", { children: rows.map((row, rowIndex) => /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("tr", { children: row.cells.map((cell, cellIndex) => {
+    const Tag = rowIndex === 0 ? "th" : "td";
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Tag, { children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(InlineContent, { content: cell, refs, resolveContentLink }) }, cellIndex);
+  }) }, rowIndex)) }) });
+}
+
+// src/react/blocks/Fallback.tsx
+var import_jsx_runtime10 = require("react/jsx-runtime");
+function Fallback({ block, refs, resolveContentLink }) {
+  const content = Array.isArray(block.content) ? block.content : [];
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "hr-fallback", "data-block-type": block.type, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { className: "hr-fallback-label", children: block.type }),
+    content.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { children: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(InlineContent, { content, refs, resolveContentLink }) })
+  ] });
+}
+
+// src/react/blocks/index.ts
+var defaultBlockComponents = {
+  paragraph: Paragraph,
+  heading: Heading,
+  image: ImageBlock,
+  codeBlock: CodeBlock,
+  bulletList: BulletList,
+  numberedList: NumberedList,
+  checkList: CheckList,
+  table: Table
+};
+
+// src/react/BlockRenderer.tsx
+var import_jsx_runtime11 = require("react/jsx-runtime");
+function defaultResolveContentLink(ref) {
+  if (!ref.published) return "#";
+  return `/${ref.collection}/${ref.slug}`;
+}
+function BlockRenderer({
+  blocks,
+  components,
+  cdnUrl,
+  refs,
+  resolveContentLink,
+  fallback,
+  className
+}) {
+  const merged = { ...defaultBlockComponents, ...components };
+  const renderItems = groupListItems(blocks);
+  const FallbackComponent = fallback === null ? null : fallback ?? Fallback;
+  const resolve = resolveContentLink ?? defaultResolveContentLink;
+  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className, children: renderItems.map((item, i) => {
+    if (item.listType) {
+      const ListComponent = merged[item.listType];
+      if (ListComponent) {
+        return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+          ListComponent,
+          {
+            block: item.items[0],
+            items: item.items,
+            cdnUrl,
+            refs,
+            resolveContentLink: resolve,
+            components: merged
+          },
+          item.items[0].id
+        );
+      }
+      return null;
+    }
+    const block = item.block;
+    const Component = merged[block.type];
+    if (!Component) {
+      if (FallbackComponent) {
+        return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+          FallbackComponent,
+          {
+            block,
+            cdnUrl,
+            refs,
+            resolveContentLink: resolve,
+            components: merged
+          },
+          block.id
+        );
+      }
+      return null;
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+      Component,
+      {
+        block,
+        cdnUrl,
+        refs,
+        resolveContentLink: resolve,
+        components: merged
+      },
+      block.id
+    );
+  }) });
+}
+var LIST_TYPE_MAP = {
+  bulletListItem: "bulletList",
+  numberedListItem: "numberedList",
+  checkListItem: "checkList"
+};
+function groupListItems(blocks) {
+  const result = [];
+  for (const block of blocks) {
+    const listType = LIST_TYPE_MAP[block.type];
+    if (listType) {
+      const last = result[result.length - 1];
+      if (last?.listType === listType) {
+        last.items.push(block);
+      } else {
+        result.push({ listType, items: [block] });
+      }
+    } else {
+      result.push({ block });
+    }
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BlockRenderer,
+  BulletList,
+  CheckList,
+  CodeBlock,
+  Fallback,
+  Heading,
+  ImageBlock,
+  InlineContent,
+  NumberedList,
+  Paragraph,
+  Table,
+  defaultBlockComponents
+});

package/dist/react.d.cts

@@ -0,0 +1,105 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ComponentType } from 'react';
+
+interface TextStyles {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    code?: boolean;
+}
+interface TextContent {
+    type: "text";
+    text: string;
+    styles?: TextStyles;
+}
+interface LinkContent {
+    type: "link";
+    href: string;
+    content: TextContent[];
+}
+type InlineContent$1 = TextContent | LinkContent;
+interface TableRow {
+    cells: InlineContent$1[][];
+}
+interface TableContent {
+    type: "tableContent";
+    rows: TableRow[];
+}
+interface Block {
+    id: string;
+    type: string;
+    props?: Record<string, unknown> | null;
+    content?: InlineContent$1[] | TableContent;
+    children?: Block[];
+}
+/** A reference to another content item (used in relationships and _refs). */
+interface ContentRef {
+    contentId: string;
+    collection: string;
+    slug: string;
+    title: string;
+}
+/**
+ * Resolved content reference in the public API `_refs` map.
+ * Includes `published` status so frontends can handle broken links.
+ */
+interface PublicContentRef extends ContentRef {
+    published: boolean;
+}
+/**
+ * Map of contentId → resolved reference metadata.
+ * Returned in `_refs` on single-content API responses.
+ * Used by block renderers to resolve `headroom://content/...` links.
+ */
+type RefsMap = Record<string, PublicContentRef>;
+
+declare function Paragraph({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function Heading({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function ImageBlock({ block, cdnUrl }: BlockComponentProps): react_jsx_runtime.JSX.Element | null;
+
+declare function CodeBlock({ block }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function BulletList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function NumberedList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function CheckList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function Table({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element | null;
+
+declare function Fallback({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+interface BlockComponentProps {
+    block: Block;
+    items?: Block[];
+    cdnUrl?: string;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+    components?: BlockComponentMap;
+}
+type BlockComponentMap = Record<string, ComponentType<BlockComponentProps>>;
+
+declare const defaultBlockComponents: BlockComponentMap;
+
+interface BlockRendererProps {
+    blocks: Block[];
+    components?: BlockComponentMap;
+    cdnUrl?: string;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+    fallback?: React.ComponentType<BlockComponentProps> | null;
+    className?: string;
+}
+declare function BlockRenderer({ blocks, components, cdnUrl, refs, resolveContentLink, fallback, className, }: BlockRendererProps): react_jsx_runtime.JSX.Element;
+
+interface Props {
+    content: InlineContent$1[] | undefined | null;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+}
+declare function InlineContent({ content, refs, resolveContentLink }: Props): react_jsx_runtime.JSX.Element | null;
+
+export { type BlockComponentMap, type BlockComponentProps, BlockRenderer, type BlockRendererProps, BulletList, CheckList, CodeBlock, Fallback, Heading, ImageBlock, InlineContent, NumberedList, Paragraph, Table, defaultBlockComponents };

package/dist/react.d.ts

@@ -0,0 +1,105 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { ComponentType } from 'react';
+
+interface TextStyles {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    code?: boolean;
+}
+interface TextContent {
+    type: "text";
+    text: string;
+    styles?: TextStyles;
+}
+interface LinkContent {
+    type: "link";
+    href: string;
+    content: TextContent[];
+}
+type InlineContent$1 = TextContent | LinkContent;
+interface TableRow {
+    cells: InlineContent$1[][];
+}
+interface TableContent {
+    type: "tableContent";
+    rows: TableRow[];
+}
+interface Block {
+    id: string;
+    type: string;
+    props?: Record<string, unknown> | null;
+    content?: InlineContent$1[] | TableContent;
+    children?: Block[];
+}
+/** A reference to another content item (used in relationships and _refs). */
+interface ContentRef {
+    contentId: string;
+    collection: string;
+    slug: string;
+    title: string;
+}
+/**
+ * Resolved content reference in the public API `_refs` map.
+ * Includes `published` status so frontends can handle broken links.
+ */
+interface PublicContentRef extends ContentRef {
+    published: boolean;
+}
+/**
+ * Map of contentId → resolved reference metadata.
+ * Returned in `_refs` on single-content API responses.
+ * Used by block renderers to resolve `headroom://content/...` links.
+ */
+type RefsMap = Record<string, PublicContentRef>;
+
+declare function Paragraph({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function Heading({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function ImageBlock({ block, cdnUrl }: BlockComponentProps): react_jsx_runtime.JSX.Element | null;
+
+declare function CodeBlock({ block }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function BulletList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function NumberedList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function CheckList({ items, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function Table({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element | null;
+
+declare function Fallback({ block, refs, resolveContentLink }: BlockComponentProps): react_jsx_runtime.JSX.Element;
+
+interface BlockComponentProps {
+    block: Block;
+    items?: Block[];
+    cdnUrl?: string;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+    components?: BlockComponentMap;
+}
+type BlockComponentMap = Record<string, ComponentType<BlockComponentProps>>;
+
+declare const defaultBlockComponents: BlockComponentMap;
+
+interface BlockRendererProps {
+    blocks: Block[];
+    components?: BlockComponentMap;
+    cdnUrl?: string;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+    fallback?: React.ComponentType<BlockComponentProps> | null;
+    className?: string;
+}
+declare function BlockRenderer({ blocks, components, cdnUrl, refs, resolveContentLink, fallback, className, }: BlockRendererProps): react_jsx_runtime.JSX.Element;
+
+interface Props {
+    content: InlineContent$1[] | undefined | null;
+    refs?: RefsMap;
+    resolveContentLink?: (ref: PublicContentRef) => string;
+}
+declare function InlineContent({ content, refs, resolveContentLink }: Props): react_jsx_runtime.JSX.Element | null;
+
+export { type BlockComponentMap, type BlockComponentProps, BlockRenderer, type BlockRendererProps, BulletList, CheckList, CodeBlock, Fallback, Heading, ImageBlock, InlineContent, NumberedList, Paragraph, Table, defaultBlockComponents };