@cedros/data-react 0.1.1 → 0.1.2

package/dist/admin/index.d.ts

@@ -1,13 +1,13 @@
-export type { AdminPlugin, AdminSectionConfig, AdminGroupConfig, AdminSectionProps, HostContext, PluginContext, PluginRegistry, PluginId, SectionId, QualifiedSectionId, PluginPermission } from "./types.js";
+export type { AdminPlugin, AdminSectionConfig, AdminGroupConfig, AdminSectionProps, HostContext, PluginContext, PluginRegistry, PluginId, SectionId, QualifiedSectionId, PluginPermission, ResolvedSection } from "./types.js";
 export { cedrosDataPlugin, dataPlugin } from "./plugin.js";
 export { default as defaultDataPlugin } from "./plugin.js";
 export { CEDROS_DATA_SECTIONS, CEDROS_DATA_SECTION_IDS, CEDROS_DATA_GROUPS } from "./sectionIds.js";
 export { AdminButton, Card, TextInput, SelectInput, JsonEditor, StatusNotice } from "./components.js";
 export { DataTable, type DataTableProps, type DataTableColumn } from "./primitives/DataTable.js";
-export { Toolbar, SearchInput, FilterChips, type FilterChipItem } from "./primitives/Toolbar.js";
-export { Pagination } from "./primitives/Pagination.js";
-export { JsonCodeEditor } from "./primitives/JsonCodeEditor.js";
+export { Toolbar, SearchInput, FilterChips, type ToolbarProps, type SearchInputProps, type FilterChipsProps, type FilterChipItem } from "./primitives/Toolbar.js";
+export { Pagination, type AdminPaginationProps } from "./primitives/Pagination.js";
+export { JsonCodeEditor, type JsonCodeEditorProps } from "./primitives/JsonCodeEditor.js";
 export { DiffViewer, type DiffBlock } from "./primitives/DiffViewer.js";
 export { FormFieldRow, FieldTypeSelect, type FormFieldRowValue, type FieldTypeOption } from "./primitives/FormFieldRow.js";
-export { ConfirmDialog } from "./primitives/ConfirmDialog.js";
+export { ConfirmDialog, type ConfirmDialogProps } from "./primitives/ConfirmDialog.js";
 export { ToastProvider, useToast, InlineAlert, type AlertTone } from "./primitives/alerts.js";

package/dist/admin/primitives/ConfirmDialog.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-interface ConfirmDialogProps {
+export interface ConfirmDialogProps {
     open: boolean;
     title: string;
     description?: string;
@@ -11,4 +11,3 @@ interface ConfirmDialogProps {
     children?: ReactNode;
 }
 export declare function ConfirmDialog({ open, title, description, confirmLabel, cancelLabel, tone, onConfirm, onCancel, children }: ConfirmDialogProps): React.JSX.Element | null;
-export {};

package/dist/admin/primitives/JsonCodeEditor.d.ts

@@ -1,4 +1,4 @@
-interface JsonCodeEditorProps {
+export interface JsonCodeEditorProps {
     value: string;
     onChange: (value: string) => void;
     label?: string;
@@ -7,4 +7,3 @@ interface JsonCodeEditorProps {
     onValidJson?: (value: unknown) => void;
 }
 export declare function JsonCodeEditor({ value, onChange, label, placeholder, readOnly, onValidJson }: JsonCodeEditorProps): React.JSX.Element;
-export {};

package/dist/admin/primitives/Pagination.d.ts

@@ -1,8 +1,7 @@
-interface PaginationProps {
+export interface AdminPaginationProps {
     page: number;
     pageSize: number;
     total: number;
     onPageChange: (page: number) => void;
 }
-export declare function Pagination({ page, pageSize, total, onPageChange }: PaginationProps): React.JSX.Element;
-export {};
+export declare function Pagination({ page, pageSize, total, onPageChange }: AdminPaginationProps): React.JSX.Element;

package/dist/admin/primitives/Toolbar.d.ts

@@ -1,10 +1,10 @@
 import type { ReactNode } from "react";
-interface ToolbarProps {
+export interface ToolbarProps {
     left?: ReactNode;
     right?: ReactNode;
 }
 export declare function Toolbar({ left, right }: ToolbarProps): React.JSX.Element;
-interface SearchInputProps {
+export interface SearchInputProps {
     value: string;
     onChange: (value: string) => void;
     placeholder?: string;
@@ -15,9 +15,8 @@ export interface FilterChipItem {
     label: string;
     active: boolean;
 }
-interface FilterChipsProps {
+export interface FilterChipsProps {
     items: FilterChipItem[];
     onToggle: (key: string) => void;
 }
 export declare function FilterChips({ items, onToggle }: FilterChipsProps): React.JSX.Element;
-export {};

package/dist/react/index.d.ts

@@ -7,4 +7,4 @@
 export { CmsContent, type CmsContentProps } from "./CmsContent.js";
 export { getOrCreateVisitorId } from "./visitor.js";
 export { sanitizeCmsHtml, renderCmsMarkdown } from "./sanitize.js";
-export type { CmsPageRecord, SiteDataRecord, SanitizeOptions, ContentType, } from "./types.js";
+export type { CmsPageRecord, PageMetadataInput, SiteDataRecord, SanitizeOptions, ContentType, MeteredReadsInfo, } from "./types.js";

package/dist/react/metadata.d.ts

@@ -1,4 +1,4 @@
-import type { BuildPageMetadataOptions, CmsPageRecord, ServerFetchOptions } from "./types.js";
+import type { BuildPageMetadataOptions, CmsPageRecord, PageMetadataInput, ServerFetchOptions } from "./types.js";
 /**
  * Metadata object compatible with Next.js `generateMetadata` return type.
  * Kept as a plain object so this module doesn't import `next` as a dependency.
@@ -26,13 +26,15 @@ export interface PageMetadata {
     other?: Record<string, string>;
 }
 /**
- * Builds a Next.js-compatible Metadata object from a CMS page record.
+ * Builds a Next.js-compatible Metadata object from a page record.
  *
- * @param page  - CMS page record from the entries API
+ * Accepts both wrapped CmsPageRecord shapes and flat page records.
+ *
+ * @param page  - Page record (wrapped or flat)
  * @param options - Optional site data, origin, path, and mode
  * @returns Metadata object suitable for Next.js `generateMetadata`
  */
-export declare function buildPageMetadata(page: CmsPageRecord, options?: BuildPageMetadataOptions): PageMetadata;
+export declare function buildPageMetadata(page: CmsPageRecord | PageMetadataInput, options?: BuildPageMetadataOptions): PageMetadata;
 /**
  * Convenience wrapper that fetches a page by slug, then builds metadata.
  *

package/dist/react/metadata.js

@@ -1,28 +1,35 @@
 import { fetchJson, resolveServerUrl } from "./fetch.js";
+/** Resolves a field from the wrapped payload or flat top-level. */
+function field(page, key) {
+    const rec = page;
+    const payload = rec.payload;
+    return payload?.[key] ?? rec[key];
+}
 /**
- * Builds a Next.js-compatible Metadata object from a CMS page record.
+ * Builds a Next.js-compatible Metadata object from a page record.
+ *
+ * Accepts both wrapped CmsPageRecord shapes and flat page records.
  *
- * @param page  - CMS page record from the entries API
+ * @param page  - Page record (wrapped or flat)
  * @param options - Optional site data, origin, path, and mode
  * @returns Metadata object suitable for Next.js `generateMetadata`
  */
 export function buildPageMetadata(page, options) {
-    const p = page.payload;
     const site = options?.siteData;
     const origin = options?.origin?.replace(/\/+$/, "") ?? "";
-    const path = options?.path ?? p.route ?? "";
+    const path = options?.path ?? field(page, "route") ?? "";
     const mode = options?.mode ?? "page";
     const siteName = site?.siteName ?? site?.siteTitle ?? "";
-    const title = p.title ?? siteName ?? undefined;
-    const description = p.description ?? site?.defaultDescription ?? undefined;
-    const ogTitle = p.ogTitle ?? p.title ?? undefined;
-    const ogDescription = p.ogDescription ?? p.description ?? undefined;
-    const ogImages = buildOgImages(p.ogImage, site?.defaultOgImage);
+    const title = field(page, "title") ?? siteName ?? undefined;
+    const description = field(page, "description") ?? site?.defaultDescription ?? undefined;
+    const ogTitle = field(page, "ogTitle") ?? field(page, "title") ?? undefined;
+    const ogDescription = field(page, "ogDescription") ?? field(page, "description") ?? undefined;
+    const ogImages = buildOgImages(field(page, "ogImage"), site?.defaultOgImage);
     const pageUrl = origin ? `${origin}${path}` : undefined;
     const ogType = mode === "blog" ? "article" : "website";
-    const twitterTitle = p.twitterTitle ?? p.ogTitle ?? p.title ?? undefined;
-    const twitterDescription = p.twitterDescription ?? p.ogDescription ?? p.description ?? undefined;
-    const canonical = resolveCanonical(origin, path, mode, p.slug);
+    const twitterTitle = field(page, "twitterTitle") ?? field(page, "ogTitle") ?? field(page, "title") ?? undefined;
+    const twitterDescription = field(page, "twitterDescription") ?? field(page, "ogDescription") ?? field(page, "description") ?? undefined;
+    const canonical = resolveCanonical(origin, path, mode, field(page, "slug"));
     const metadata = {
         title,
         description,
@@ -112,31 +119,34 @@ function resolveCanonical(origin, path, mode, slug) {
     if (!origin)
         return undefined;
     if (mode === "docs" && slug) {
-        return `${origin}/blog/${slug}`;
+        return `${origin}/docs/${slug}`;
     }
     return `${origin}${path}`;
 }
 function buildBlogJsonLd(page, origin, path) {
-    const p = page.payload;
+    const updatedAt = field(page, "updatedAt");
     const jsonLd = {
         "@context": "https://schema.org",
         "@type": "BlogPosting",
-        headline: p.title,
-        description: p.description,
-        datePublished: p.publishedAt,
-        dateModified: p.updatedAt ?? page.updated_at,
+        headline: field(page, "title"),
+        description: field(page, "description"),
+        datePublished: field(page, "publishedAt"),
+        dateModified: updatedAt ?? page.updated_at,
     };
     if (origin) {
         jsonLd.url = `${origin}${path}`;
     }
-    if (p.author) {
-        jsonLd.author = { "@type": "Person", name: p.author };
+    const author = field(page, "author");
+    if (author) {
+        jsonLd.author = { "@type": "Person", name: author };
     }
-    if (p.ogImage) {
-        jsonLd.image = p.ogImage;
+    const ogImage = field(page, "ogImage");
+    if (ogImage) {
+        jsonLd.image = ogImage;
     }
-    if (p.wordCount) {
-        jsonLd.wordCount = p.wordCount;
+    const wordCount = field(page, "wordCount");
+    if (wordCount) {
+        jsonLd.wordCount = wordCount;
     }
     return JSON.stringify(jsonLd);
 }

package/dist/react/server.d.ts

@@ -11,4 +11,4 @@ export { buildPageMetadata, generatePageMetadata, type PageMetadata, } from "./m
 export { loadSitemapEntries } from "./sitemap.js";
 export { fetchBlogPost } from "./entries.js";
 export { listBlogSlugs, listContentSlugs, listLearnPathIds, } from "./slugs.js";
-export type { BuildPageMetadataOptions, CmsPageRecord, MeteredReadsInfo, SiteDataRecord, SitemapEntry, ServerFetchOptions, ContentType, } from "./types.js";
+export type { BuildPageMetadataOptions, CmsPageRecord, MeteredReadsInfo, PageMetadataInput, SiteDataRecord, SitemapEntry, ServerFetchOptions, ContentType, } from "./types.js";

package/dist/react/types.d.ts

@@ -63,6 +63,18 @@ export interface SanitizeOptions {
     /** Allowed URL protocols for href/src attributes. */
     allowedProtocols?: string[];
 }
+/**
+ * Flexible input for `buildPageMetadata`.
+ *
+ * Accepts both the wrapped CmsPageRecord shape (`{ entry_key, payload, updated_at }`)
+ * and flat page records where fields live at the top level (`{ title, ogImage, ... }`).
+ */
+export interface PageMetadataInput {
+    entry_key?: string;
+    payload?: Record<string, unknown>;
+    updated_at?: string;
+    [key: string]: unknown;
+}
 /** Options for building page metadata. */
 export interface BuildPageMetadataOptions {
     siteData?: SiteDataRecord;

package/dist/site-templates/content-styles.css

@@ -195,6 +195,10 @@
   background: color-mix(in srgb, var(--cds-link) 9%, var(--cds-muted-bg) 91%);
 }
 
+.cedros-site__docs-item--depth-0 {
+  padding-left: 0;
+}
+
 .cedros-site__docs-item--depth-1 {
   padding-left: 0.9rem;
 }
@@ -312,6 +316,10 @@
   font-size: 0.8rem;
 }
 
+.cedros-site__toc-link--depth-2 {
+  padding-left: 0;
+}
+
 .cedros-site__toc-link--depth-3 {
   padding-left: 0.65rem;
 }

package/dist/site-templates/docs-styles.css

@@ -240,6 +240,12 @@
   }
 }
 
+/* ─── Docs article modifier ──── */
+
+.cedros-site__docs-article {
+  overflow: hidden;
+}
+
 /* ─── TOC scroll-spy active link ──── */
 
 .cedros-site__toc-link--active {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedros/data-react",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "React components, page templates, and Next.js integration for cedros-data",
   "type": "module",
   "main": "./dist/react/index.js",