@qewordly/react 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# @qewordly/react
+
+Headless-first blog SDK. Data functions run on the server (RSC, SSG, Route Handlers); components render to static HTML with zero client JS.
+
+## 5-minute integration (Next.js App Router)
+
+```tsx
+// lib/qw.ts
+import { createQewordlyClient } from "@qewordly/react";
+
+export const qw = createQewordlyClient({
+  baseUrl: process.env.QEWORLDLY_API_URL!, // e.g. https://api.qewordly.com
+  apiKey: process.env.QEWORLDLY_API_KEY!, // qw_live_… — server env only
+});
+```
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { QewordlyPost, QewordlyJsonLd, getPostJsonLd, getPostMetadata } from "@qewordly/react";
+import { qw } from "@/lib/qw";
+import { notFound } from "next/navigation";
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const post = await qw.getPost((await params).slug);
+  if (!post) return {};
+  const meta = getPostMetadata(post);
+  return { title: meta.title, description: meta.description };
+}
+
+export default async function PostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const post = await qw.getPost((await params).slug, { revalidate: 60 });
+  if (!post) notFound();
+  return (
+    <>
+      <QewordlyPost post={post} />
+      <QewordlyJsonLd data={getPostJsonLd(post, { url: `https://yoursite.com/blog/${post.slug}` })} />
+    </>
+  );
+}
+```
+
+```tsx
+// app/sitemap.ts
+import { qw } from "@/lib/qw";
+
+export default async function sitemap() {
+  const entries = await qw.getSitemapEntries();
+  return entries.map((e) => ({
+    url: `https://yoursite.com/blog/${e.slug}`,
+    lastModified: new Date(e.updatedAt),
+  }));
+}
+```
+
+## Rules
+
+- **Keys stay server-side.** Never prefix the key with `NEXT_PUBLIC_`, never fetch from the browser. There are no client hooks in this package — that is deliberate, not missing.
+- **Theme:** `qw.getTheme()` + `<QewordlyStyles theme={theme} />` injects `--qw-*` variables. Components accept `className`; bring your own CSS.
+- **Preview:** issue a token (`POST /workspace/preview-token`), enable Next draft mode, pass `previewToken` to any read. Drafts resolve; archived never does.
+- **Caching:** pass `revalidate` / `tags` to map onto Next fetch semantics. Publish webhooks (US-094) will call your `revalidateTag` endpoint for instant updates.
+- **Eject anytime:** every component is a thin wrapper — `qw.getPosts()` returns plain data you can render however you like.

package/dist/client.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Headless Qewordly client (US-090). Framework-free data functions that run
+ * anywhere `fetch` exists — React Server Components, Route Handlers, SSG —
+ * with zero client JS required to render. Keys stay server-side: there are
+ * deliberately NO client hooks in this package (browser fetching would leak
+ * the key); see README.
+ *
+ * Wire shapes mirror the API JSON (dates are ISO strings, not Date objects)
+ * rather than reusing @repo/types rows, so the types never lie about what
+ * crossed the network.
+ */
+export interface TaxonomyRef {
+    id: string;
+    name: string;
+    slug: string;
+}
+export interface PublicPost {
+    id: string;
+    title: string;
+    slug: string;
+    content: string;
+    excerpt: string | null;
+    status: string;
+    metaTitle: string | null;
+    metaDesc: string | null;
+    coverImage: string | null;
+    publishedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    categories: TaxonomyRef[];
+    tags: TaxonomyRef[];
+}
+export interface PageMeta {
+    page: number;
+    limit: number;
+    total: number;
+}
+export interface ListResult<T> {
+    data: T[];
+    meta: PageMeta;
+}
+export interface SitemapEntry {
+    slug: string;
+    updatedAt: string;
+}
+export interface SdkTheme {
+    primaryColor: string;
+    backgroundColor: string;
+    textColor: string;
+    fontFamily: string;
+    logoUrl: string | null;
+}
+export declare class QewordlyError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status?: number, code?: string);
+}
+export interface NextFetchOptions {
+    /** Maps to Next.js fetch `next.revalidate`. Omitted = framework default. */
+    revalidate?: number | false;
+    /** Maps to Next.js fetch `next.tags`. */
+    tags?: string[];
+}
+export interface ClientConfig {
+    /** API origin, e.g. "https://api.qewordly.com". Trailing slash tolerated. */
+    baseUrl: string;
+    /** `qw_live_…` key. Server-side only — never ship to the browser. */
+    apiKey: string;
+    /** Injectable for tests and edge runtimes. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+export interface ListOptions extends NextFetchOptions {
+    page?: number;
+    limit?: number;
+    category?: string;
+    tag?: string;
+    /** Short-lived draft token from POST /workspace/preview-token. */
+    previewToken?: string;
+}
+export interface ReadOptions extends NextFetchOptions {
+    previewToken?: string;
+}
+export declare function createQewordlyClient(config: ClientConfig): {
+    getPosts(opts?: ListOptions): Promise<ListResult<PublicPost>>;
+    /** Null when the slug has no visible post (draft without preview, unknown slug). Other failures throw. */
+    getPost(slug: string, opts?: ReadOptions): Promise<PublicPost | null>;
+    searchPosts(q: string, opts?: ListOptions): Promise<ListResult<PublicPost>>;
+    getCategories(opts?: ReadOptions): Promise<TaxonomyRef[]>;
+    getTags(opts?: ReadOptions): Promise<TaxonomyRef[]>;
+    getSitemapEntries(opts?: ReadOptions): Promise<SitemapEntry[]>;
+    getTheme(opts?: ReadOptions): Promise<SdkTheme>;
+    /**
+     * Resolve an image path from the API to an absolute URL. Uploads live on
+     * the API origin (`/uploads/…`), so relative paths resolve against this
+     * client's baseUrl; absolute URLs pass through untouched. Null stays null.
+     */
+    getImageUrl(path: string | null): string | null;
+};
+export type QewordlyClient = ReturnType<typeof createQewordlyClient>;
+export interface PostMetadata {
+    title: string;
+    description: string;
+    image: string | null;
+}
+/**
+ * Resolve an image path from the API to an absolute URL. Uploads live on the
+ * API origin (`/uploads/…`), so relative paths resolve against the given base
+ * (the client's baseUrl, or `imageBaseUrl`); absolute URLs pass through
+ * untouched. Null/blank stays null. Single contract shared by getPostMetadata,
+ * getPostJsonLd, and the React components.
+ */
+export declare function resolveImageUrl(path: string | null, imageBaseUrl?: string): string | null;
+/**
+ * Sanity-style fallback chains: metaTitle → title → ""; metaDesc → excerpt
+ * → "". Title is never null — callers can spread this straight into
+ * generateMetadata without conditionals.
+ */
+export declare function getPostMetadata(post: Pick<PublicPost, "title" | "metaTitle" | "metaDesc" | "excerpt" | "coverImage">, opts?: {
+    imageBaseUrl?: string;
+}): PostMetadata;
+export interface ArticleJsonLd {
+    "@context": "https://schema.org";
+    "@type": "Article";
+    headline: string;
+    description?: string;
+    image?: string;
+    datePublished?: string;
+    dateModified: string;
+    url?: string;
+}
+/**
+ * Article structured data with only defined fields emitted. Feeds the GEO
+ * "citable content" story — the SDK renders content AI engines can quote.
+ */
+export declare function getPostJsonLd(post: Pick<PublicPost, "title" | "metaDesc" | "excerpt" | "coverImage" | "publishedAt" | "updatedAt">, opts?: {
+    url?: string;
+    imageBaseUrl?: string;
+}): ArticleJsonLd;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Headless Qewordly client (US-090). Framework-free data functions that run
+ * anywhere `fetch` exists — React Server Components, Route Handlers, SSG —
+ * with zero client JS required to render. Keys stay server-side: there are
+ * deliberately NO client hooks in this package (browser fetching would leak
+ * the key); see README.
+ *
+ * Wire shapes mirror the API JSON (dates are ISO strings, not Date objects)
+ * rather than reusing @repo/types rows, so the types never lie about what
+ * crossed the network.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QewordlyError = void 0;
+exports.createQewordlyClient = createQewordlyClient;
+exports.resolveImageUrl = resolveImageUrl;
+exports.getPostMetadata = getPostMetadata;
+exports.getPostJsonLd = getPostJsonLd;
+// ─── Errors ──────────────────────────────────────────────────────────────────
+class QewordlyError extends Error {
+    status;
+    code;
+    constructor(message, status = 0, code = "UNKNOWN") {
+        super(message);
+        this.name = "QewordlyError";
+        this.status = status;
+        this.code = code;
+    }
+}
+exports.QewordlyError = QewordlyError;
+function createQewordlyClient(config) {
+    const baseUrl = config.baseUrl.replace(/\/$/, "");
+    const fetchFn = (config.fetch ?? globalThis.fetch);
+    if (!config.apiKey)
+        throw new QewordlyError("apiKey is required.", 0, "MISSING_API_KEY");
+    async function doFetch(url, opts) {
+        const init = {
+            headers: { "X-API-Key": config.apiKey, Accept: "application/json" },
+        };
+        if (opts.revalidate !== undefined || opts.tags !== undefined) {
+            init.next = {};
+            if (opts.revalidate !== undefined)
+                init.next.revalidate = opts.revalidate;
+            if (opts.tags !== undefined)
+                init.next.tags = opts.tags;
+        }
+        let res;
+        try {
+            res = await fetchFn(url, init);
+        }
+        catch (err) {
+            throw new QewordlyError(`Could not reach the Qewordly API: ${err instanceof Error ? err.message : String(err)}`, 0, "FETCH_FAILED");
+        }
+        if (!res.ok) {
+            const body = (await res.json().catch(() => null));
+            throw new QewordlyError(body?.error ?? `Request failed with status ${res.status}.`, res.status, body?.code ?? "REQUEST_FAILED");
+        }
+        return res;
+    }
+    function buildUrl(path, params) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                qs.set(k, String(v));
+        }
+        return `${baseUrl}/v1/public${path}${qs.size > 0 ? `?${qs}` : ""}`;
+    }
+    async function request(path, params, opts) {
+        const res = await doFetch(buildUrl(path, params), opts);
+        const json = (await res.json());
+        return json.data;
+    }
+    async function requestList(path, params, opts) {
+        const res = await doFetch(buildUrl(path, params), opts);
+        return (await res.json());
+    }
+    const previewParam = (token) => (token ? { preview: token } : {});
+    return {
+        getPosts(opts = {}) {
+            const { previewToken, revalidate, tags, ...rest } = opts;
+            return requestList("/posts", { ...rest, ...previewParam(previewToken) }, { revalidate, tags });
+        },
+        /** Null when the slug has no visible post (draft without preview, unknown slug). Other failures throw. */
+        async getPost(slug, opts = {}) {
+            try {
+                return await request(`/posts/${encodeURIComponent(slug)}`, { ...previewParam(opts.previewToken) }, opts);
+            }
+            catch (err) {
+                if (err instanceof QewordlyError && err.status === 404)
+                    return null;
+                throw err;
+            }
+        },
+        searchPosts(q, opts = {}) {
+            const { previewToken, revalidate, tags, ...rest } = opts;
+            return requestList("/search", { q, ...rest, ...previewParam(previewToken) }, { revalidate, tags });
+        },
+        getCategories(opts = {}) {
+            return request("/categories", { ...previewParam(opts.previewToken) }, opts);
+        },
+        getTags(opts = {}) {
+            return request("/tags", { ...previewParam(opts.previewToken) }, opts);
+        },
+        getSitemapEntries(opts = {}) {
+            return request("/sitemap", { ...previewParam(opts.previewToken) }, opts);
+        },
+        getTheme(opts = {}) {
+            return request("/theme", { ...previewParam(opts.previewToken) }, opts);
+        },
+        /**
+         * Resolve an image path from the API to an absolute URL. Uploads live on
+         * the API origin (`/uploads/…`), so relative paths resolve against this
+         * client's baseUrl; absolute URLs pass through untouched. Null stays null.
+         */
+        getImageUrl(path) {
+            if (!path)
+                return null;
+            if (/^https?:\/\//i.test(path))
+                return path;
+            return `${baseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
+        },
+    };
+}
+/**
+ * Resolve an image path from the API to an absolute URL. Uploads live on the
+ * API origin (`/uploads/…`), so relative paths resolve against the given base
+ * (the client's baseUrl, or `imageBaseUrl`); absolute URLs pass through
+ * untouched. Null/blank stays null. Single contract shared by getPostMetadata,
+ * getPostJsonLd, and the React components.
+ */
+function resolveImageUrl(path, imageBaseUrl) {
+    const trimmed = path?.trim() || null;
+    if (trimmed === null)
+        return null;
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    const base = (imageBaseUrl ?? "").replace(/\/$/, "");
+    return base !== "" ? `${base}${trimmed.startsWith("/") ? "" : "/"}${trimmed}` : trimmed;
+}
+/**
+ * Sanity-style fallback chains: metaTitle → title → ""; metaDesc → excerpt
+ * → "". Title is never null — callers can spread this straight into
+ * generateMetadata without conditionals.
+ */
+function getPostMetadata(post, opts = {}) {
+    const title = post.metaTitle?.trim() || post.title || "";
+    const description = post.metaDesc?.trim() || post.excerpt?.trim() || "";
+    const image = resolveImageUrl(post.coverImage, opts.imageBaseUrl);
+    return { title, description, image };
+}
+/**
+ * Article structured data with only defined fields emitted. Feeds the GEO
+ * "citable content" story — the SDK renders content AI engines can quote.
+ */
+function getPostJsonLd(post, opts = {}) {
+    const description = post.metaDesc?.trim() || post.excerpt?.trim() || undefined;
+    // Relative API paths ("/uploads/…") would be broken image URLs in structured
+    // data — resolve against the API origin like getPostMetadata does.
+    const image = resolveImageUrl(post.coverImage, opts.imageBaseUrl);
+    // Conditional spreads keep key order deterministic (headline → optionals →
+    // dateModified → url) regardless of which fields are present.
+    return {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        headline: post.title,
+        ...(description !== undefined ? { description } : {}),
+        ...(image ? { image } : {}),
+        ...(post.publishedAt ? { datePublished: post.publishedAt } : {}),
+        dateModified: post.updatedAt,
+        ...(opts.url ? { url: opts.url } : {}),
+    };
+}

package/dist/components.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Presentational components (US-090). Server Components by default — no
+ * "use client", no hooks, no browser APIs — so they render to static HTML
+ * with zero client JS. Every component is a thin wrapper over plain data:
+ * pass props from the headless client and keep your own design via
+ * className. No CSS is shipped; theme variables come from QewordlyStyles.
+ */
+import type { ReactNode } from "react";
+import type { PublicPost, SdkTheme } from "./client";
+import type { ArticleJsonLd } from "./client";
+export declare function QewordlyStyles({ theme }: {
+    theme: SdkTheme;
+}): import("react").JSX.Element;
+export declare function QewordlyJsonLd({ data }: {
+    data: ArticleJsonLd;
+}): import("react").JSX.Element;
+export interface QewordlyPostProps {
+    post: PublicPost;
+    className?: string;
+    /**
+     * API origin used to resolve relative coverImage paths (`/uploads/…`),
+     * same contract as the client's getImageUrl. Absolute URLs pass through;
+     * omit it and relative paths render unchanged (previous behavior).
+     */
+    imageBaseUrl?: string;
+}
+export declare function QewordlyPost({ post, className, imageBaseUrl }: QewordlyPostProps): import("react").JSX.Element;
+export interface QewordlyBlogProps {
+    posts: PublicPost[];
+    className?: string;
+    /** Host-owned item rendering (links, cards, dates). Default is title + excerpt, deliberately link-free: routes belong to the host. */
+    renderPost?: (post: PublicPost) => ReactNode;
+}
+export declare function QewordlyBlog({ posts, className, renderPost }: QewordlyBlogProps): import("react").JSX.Element;
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,+BAE5D;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,+BAE/D;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,iBAAiB,+BAWhF;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sIAAsI;IACtI,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;CAC9C;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,iBAAiB,+BAe/E"}

package/dist/components.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QewordlyStyles = QewordlyStyles;
+exports.QewordlyJsonLd = QewordlyJsonLd;
+exports.QewordlyPost = QewordlyPost;
+exports.QewordlyBlog = QewordlyBlog;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const client_1 = require("./client");
+const helpers_1 = require("./helpers");
+function QewordlyStyles({ theme }) {
+    return (0, jsx_runtime_1.jsx)("style", { children: (0, helpers_1.themeToCssText)(theme) });
+}
+function QewordlyJsonLd({ data }) {
+    return (0, jsx_runtime_1.jsx)("script", { type: "application/ld+json", children: JSON.stringify(data) });
+}
+function QewordlyPost({ post, className, imageBaseUrl }) {
+    const cover = (0, client_1.resolveImageUrl)(post.coverImage, imageBaseUrl);
+    return ((0, jsx_runtime_1.jsxs)("article", { className: className, children: [(0, jsx_runtime_1.jsx)("h1", { children: post.title }), cover && (0, jsx_runtime_1.jsx)("img", { src: cover, alt: post.title }), (0, jsx_runtime_1.jsx)("div", { dangerouslySetInnerHTML: { __html: post.content } })] }));
+}
+function QewordlyBlog({ posts, className, renderPost }) {
+    return ((0, jsx_runtime_1.jsx)("div", { className: className, children: posts.map((post) => renderPost ? ((0, jsx_runtime_1.jsx)("div", { children: renderPost(post) }, post.id)) : ((0, jsx_runtime_1.jsxs)("article", { children: [(0, jsx_runtime_1.jsx)("h2", { children: post.title }), post.excerpt && (0, jsx_runtime_1.jsx)("p", { children: post.excerpt })] }, post.id))) }));
+}

package/dist/helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Theme → CSS variable helpers (US-090/US-091). Pure and framework-free.
+ * Trust boundary: values originate from the tenant's own dashboard, so no
+ * escaping is applied — never feed untrusted input through these.
+ */
+import type { SdkTheme } from "./client";
+export declare const THEME_VARS: {
+    readonly primary: "--qw-primary";
+    readonly background: "--qw-background";
+    readonly text: "--qw-text";
+    readonly font: "--qw-font";
+};
+export declare function themeToCssVars(theme: SdkTheme): Record<string, string>;
+/** `:root{--qw-primary:…;…}` block for QewordlyStyles. */
+export declare function themeToCssText(theme: SdkTheme): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAKtD"}

package/dist/helpers.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_VARS = void 0;
+exports.themeToCssVars = themeToCssVars;
+exports.themeToCssText = themeToCssText;
+exports.THEME_VARS = {
+    primary: "--qw-primary",
+    background: "--qw-background",
+    text: "--qw-text",
+    font: "--qw-font",
+};
+function themeToCssVars(theme) {
+    return {
+        [exports.THEME_VARS.primary]: theme.primaryColor,
+        [exports.THEME_VARS.background]: theme.backgroundColor,
+        [exports.THEME_VARS.text]: theme.textColor,
+        [exports.THEME_VARS.font]: theme.fontFamily,
+    };
+}
+/** `:root{--qw-primary:…;…}` block for QewordlyStyles. */
+function themeToCssText(theme) {
+    const vars = themeToCssVars(theme);
+    return `:root{${Object.entries(vars)
+        .map(([k, v]) => `${k}:${v}`)
+        .join(";")}}`;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createQewordlyClient, QewordlyError, getPostMetadata, getPostJsonLd, resolveImageUrl, } from "./client";
+export type { QewordlyClient, ClientConfig, ListOptions, ReadOptions, NextFetchOptions, PublicPost, TaxonomyRef, PageMeta, ListResult, SitemapEntry, SdkTheme, PostMetadata, ArticleJsonLd, } from "./client";
+export { themeToCssVars, themeToCssText, THEME_VARS } from "./helpers";
+export { QewordlyStyles, QewordlyJsonLd, QewordlyPost, QewordlyBlog } from "./components";
+export type { QewordlyPostProps, QewordlyBlogProps } from "./components";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QewordlyBlog = exports.QewordlyPost = exports.QewordlyJsonLd = exports.QewordlyStyles = exports.THEME_VARS = exports.themeToCssText = exports.themeToCssVars = exports.resolveImageUrl = exports.getPostJsonLd = exports.getPostMetadata = exports.QewordlyError = exports.createQewordlyClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "createQewordlyClient", { enumerable: true, get: function () { return client_1.createQewordlyClient; } });
+Object.defineProperty(exports, "QewordlyError", { enumerable: true, get: function () { return client_1.QewordlyError; } });
+Object.defineProperty(exports, "getPostMetadata", { enumerable: true, get: function () { return client_1.getPostMetadata; } });
+Object.defineProperty(exports, "getPostJsonLd", { enumerable: true, get: function () { return client_1.getPostJsonLd; } });
+Object.defineProperty(exports, "resolveImageUrl", { enumerable: true, get: function () { return client_1.resolveImageUrl; } });
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "themeToCssVars", { enumerable: true, get: function () { return helpers_1.themeToCssVars; } });
+Object.defineProperty(exports, "themeToCssText", { enumerable: true, get: function () { return helpers_1.themeToCssText; } });
+Object.defineProperty(exports, "THEME_VARS", { enumerable: true, get: function () { return helpers_1.THEME_VARS; } });
+var components_1 = require("./components");
+Object.defineProperty(exports, "QewordlyStyles", { enumerable: true, get: function () { return components_1.QewordlyStyles; } });
+Object.defineProperty(exports, "QewordlyJsonLd", { enumerable: true, get: function () { return components_1.QewordlyJsonLd; } });
+Object.defineProperty(exports, "QewordlyPost", { enumerable: true, get: function () { return components_1.QewordlyPost; } });
+Object.defineProperty(exports, "QewordlyBlog", { enumerable: true, get: function () { return components_1.QewordlyBlog; } });

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@qewordly/react",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Headless-first React SDK for Qewordly blogs. Server Components supported, zero client JS required.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.5",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "7.0.2"
+  }
+}