@visual-platform/next 0.0.0-stage → 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Client-only entry (ADR-032): import from "@visual-platform/next/events" in your "use client" files.
+ *
+ *   "use client";
+ *   import { VisualEvents } from "@visual-platform/next/events";
+ *   export function Handlers({ children }) {
+ *     return <VisualEvents handlers={{ onSubscribe: async (e) => { await subscribe(e.value); } }}>{children}</VisualEvents>;
+ *   }
+ */
+export { VisualEvents, eventData, type VisualEvent, type VisualEventData, type VisualEventHandler, type VisualEventHandlers, type VisualEventPayload, type EventKind } from "@visual-platform/runtime-core";
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/events.js

@@ -0,0 +1,12 @@
+"use client";
+/**
+ * Client-only entry (ADR-032): import from "@visual-platform/next/events" in your "use client" files.
+ *
+ *   "use client";
+ *   import { VisualEvents } from "@visual-platform/next/events";
+ *   export function Handlers({ children }) {
+ *     return <VisualEvents handlers={{ onSubscribe: async (e) => { await subscribe(e.value); } }}>{children}</VisualEvents>;
+ *   }
+ */
+export { VisualEvents, eventData } from "@visual-platform/runtime-core";
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAsI,MAAM,+BAA+B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,240 @@
+import { type ResolvedPage } from "@visual-platform/contracts";
+import { type VisualEventData, type VisualRegistry } from "@visual-platform/runtime-core";
+import type { Metadata } from "next";
+import { type ReactNode } from "react";
+export type VisualNextConfig = {
+    /** Published API base URL, e.g. process.env.VISUAL_API_URL. */
+    apiUrl: string;
+    projectId: string;
+    /** Public project key from the admin (Integrations → API keys), e.g. process.env.VISUAL_PROJECT_KEY. */
+    apiKey?: string;
+    registry: VisualRegistry;
+    /** Seconds before Next refetches (stale-while-revalidate). Webhook revalidation is immediate. Default 60. */
+    revalidate?: number;
+    /** Validate API responses with zod (default: in development only). */
+    validate?: boolean;
+    /** pageKey served at "/" (empty path). Default "home". */
+    homePageKey?: string;
+    /**
+     * Tailwind classes set in Studio (ADR-029). "platform" (default): inject the CSS the platform compiled
+     * for the release — works with or without Tailwind in your app. "app": your own Tailwind build
+     * generates them (run `vp classes pull` and add .visual/classes.txt as a source).
+     */
+    tailwind?: "platform" | "app";
+    /** Public origin of your site, e.g. "https://acmecoffee.vn" — used for canonical, hreflang and og:url. */
+    siteUrl?: string;
+    /**
+     * How content is cached (ADR-040); each VisualPage/VisualComponent may override it.
+     * "isr" (default): refetched at most every `revalidate` seconds, and immediately on the publish webhook.
+     * "static": fetched once (at `next build` for pages listed by `generateStaticParams`, else on first
+     * request) and kept until the publish webhook or the next build.
+     */
+    rendering?: Rendering;
+};
+export type Rendering = "isr" | "static";
+/** Per page/component override of the caching mode. */
+export type RenderingOptions = {
+    rendering?: Rendering;
+    revalidate?: number;
+};
+/** Server Actions by event name (ADR-040) — they receive the plain event data (VisualEventData). */
+export type VisualServerHandlers = Record<string, ((e: VisualEventData) => Promise<unknown>) | undefined>;
+/** Cache tags the SDK puts on every fetch (blueprint 53 §5). */
+export declare const visualTags: {
+    project: (projectId: string) => string;
+    page: (projectId: string, locale: string, path: string) => string;
+    component: (projectId: string, id: string) => string;
+};
+/**
+ * Next.js App Router integration (blueprint 61). Call once at module scope:
+ *
+ *   export const visual = createVisualNext({ apiUrl, projectId, registry });
+ *
+ * Fetches run on the server with Next fetch caching (cacheComponents OFF, ADR-016) and are
+ * de-duplicated per request with React `cache()`, so generateMetadata and the page share one call.
+ */
+export declare function createVisualNext(config: VisualNextConfig): {
+    client: {
+        projectId: string;
+        getResolvedPage(q: import("@visual-platform/client").PageQuery, init?: import("@visual-platform/client").FetchInit): Promise<ResolvedPage | null>;
+        getResolvedComponent(id: string, init?: import("@visual-platform/client").FetchInit, opts?: {
+            locale?: string | undefined;
+        }): Promise<import("@visual-platform/contracts").ResolvedComponent | null>;
+        listTables(init?: import("@visual-platform/client").FetchInit): Promise<{
+            dataVersion: number;
+            tables: {
+                key: string;
+                name: string;
+                columns: unknown[];
+                displayColumn: string;
+                rowCount: number;
+            }[];
+        } | null>;
+        query<Row = Record<string, unknown>>(q: {
+            table: string;
+            filter?: string;
+            where?: unknown;
+            sort?: {
+                field: string;
+                dir?: "asc" | "desc";
+            }[];
+            limit?: number;
+            offset?: number;
+            include?: string[];
+            locale?: string;
+        }, init?: import("@visual-platform/client").FetchInit): Promise<{
+            dataVersion: number;
+            total: number;
+            rows: (Row & {
+                id: string;
+            })[];
+        } | null>;
+        getLocales(init?: import("@visual-platform/client").FetchInit): Promise<import("@visual-platform/contracts").LocaleList | null>;
+        listPages(locale?: string, init?: import("@visual-platform/client").FetchInit): Promise<import("@visual-platform/contracts").PageList | null>;
+    };
+    getPageData: (locale: string, slug: string | string[] | undefined, rendering?: Rendering, revalidate?: number) => Promise<ResolvedPage | null>;
+    getComponentData: (id: string, rendering?: Rendering, revalidate?: number, locale?: string) => Promise<{
+        project: {
+            id: string;
+        };
+        release: {
+            id: string;
+            sequence: number;
+            manifestHash: string;
+        };
+        component: {
+            id: string;
+            versionId: string;
+            versionNumber: number;
+            document: {
+                schemaVersion: 1;
+                nodes: import("@visual-platform/contracts").ComponentNode[];
+                props: {
+                    name: string;
+                    label: string;
+                    type: "boolean" | "icon" | "image" | "link" | "number" | "select" | "text" | "textarea";
+                    binds: {
+                        nodeId: string;
+                        prop: string;
+                    }[];
+                    required?: boolean | undefined;
+                    options?: string[] | undefined;
+                }[];
+                defaultLocale: string;
+                translations: Record<string, Record<string, string>>;
+                theme?: string | undefined;
+                data?: {
+                    name: string;
+                    label?: string | undefined;
+                    source: "app" | "table";
+                    shape: "list" | "object";
+                    fields: import("@visual-platform/contracts").DataField[];
+                    sample?: unknown;
+                    query?: {
+                        table: string;
+                        where?: import("@visual-platform/contracts").Filter | undefined;
+                        sort?: {
+                            field: string;
+                            dir: "asc" | "desc";
+                        }[] | undefined;
+                        limit: number;
+                        offset: number;
+                        include?: string[] | undefined;
+                        locale?: string | undefined;
+                    } | undefined;
+                    single?: boolean | undefined;
+                }[] | undefined;
+                disabledLocales?: string[] | undefined;
+                childrenSlot?: {
+                    nodeId: string;
+                    slot: string;
+                } | undefined;
+            };
+        };
+        design?: {
+            vars: Record<string, string>;
+            themes: Record<string, Record<string, string>>;
+            fonts: {
+                family: string;
+                faces: {
+                    weight: number;
+                    style: "italic" | "normal";
+                    url: string;
+                    format: "opentype" | "truetype" | "woff" | "woff2";
+                    unicodeRange?: string | undefined;
+                }[];
+            }[];
+        } | null | undefined;
+        styles?: string | null | undefined;
+        locales?: Record<string, {
+            name: string;
+            nativeName: string;
+            dir: "ltr" | "rtl";
+        }> | null | undefined;
+        data?: Record<string, unknown> | undefined;
+    } | null>;
+    VisualPage: (props: {
+        locale: string;
+        slug?: string | string[] | undefined;
+        mode?: "production" | "preview";
+        data?: Record<string, unknown>;
+        handlers?: VisualServerHandlers;
+    } & RenderingOptions) => Promise<import("react").JSX.Element>;
+    VisualComponent: (props: {
+        id: string;
+        locale?: string;
+        values?: Record<string, unknown>;
+        data?: Record<string, unknown>;
+        theme?: string;
+        fallback?: ReactNode;
+        handlers?: VisualServerHandlers;
+    } & RenderingOptions) => Promise<import("react").JSX.Element>;
+    generateMetadata: (locale: string, slug: string | string[] | undefined, opts?: {
+        titleTemplate?: string;
+        baseUrl?: string;
+    } & RenderingOptions) => Promise<Metadata>;
+    revalidateHandler: (secret: string) => (request: Request) => Promise<Response>;
+    locales: () => Promise<{
+        code: string;
+        name: string;
+        nativeName: string;
+        dir: "ltr" | "rtl";
+    }[]>;
+    localeDir: (locale: string) => Promise<"ltr" | "rtl">;
+    defaultLocale: () => Promise<string | null>;
+    hasLocale: (locale: string) => Promise<boolean>;
+    generateStaticParams: (opts?: {
+        locales?: string[];
+    }) => Promise<{
+        locale: string;
+        slug: string[];
+    }[]>;
+    query: <Row = Record<string, unknown>>(q: Parameters<<Row_1 = Record<string, unknown>>(q: {
+        table: string;
+        filter?: string;
+        where?: unknown;
+        sort?: {
+            field: string;
+            dir?: "asc" | "desc";
+        }[];
+        limit?: number;
+        offset?: number;
+        include?: string[];
+        locale?: string;
+    }, init?: import("@visual-platform/client").FetchInit) => Promise<{
+        dataVersion: number;
+        total: number;
+        rows: (Row_1 & {
+            id: string;
+        })[];
+    } | null>>[0], opts?: RenderingOptions) => Promise<{
+        dataVersion: number;
+        total: number;
+        rows: (Row & {
+            id: string;
+        })[];
+    }>;
+};
+export { createVisualRegistry } from "@visual-platform/runtime-core";
+export type { VisualRegistry, VisualNodeProps, VisualEvent, VisualEventData, EventKind } from "@visual-platform/runtime-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,213 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { applyComponent, componentEnabledFor, dirOf, jsonLdDocument, withTheme } from "@visual-platform/contracts";
+import { createVisualClient } from "@visual-platform/client";
+import { renderDocument, VisualEvents } from "@visual-platform/runtime-core";
+import { revalidateTag } from "next/cache";
+import { notFound } from "next/navigation";
+import { cache } from "react";
+/** Cache tags the SDK puts on every fetch (blueprint 53 §5). */
+export const visualTags = {
+    project: (projectId) => `visual:project:${projectId}`,
+    page: (projectId, locale, path) => `visual:page:${projectId}:${locale}:${path || "/"}`,
+    component: (projectId, id) => `visual:component:${projectId}:${id}`,
+};
+const LOCALE_CODE = /^[a-z]{2,3}(-[A-Z]{2})?$/;
+const toPath = (slug) => (Array.isArray(slug) ? slug.join("/") : (slug ?? "")).replace(/^\/+|\/+$/g, "");
+/**
+ * Next.js App Router integration (blueprint 61). Call once at module scope:
+ *
+ *   export const visual = createVisualNext({ apiUrl, projectId, registry });
+ *
+ * Fetches run on the server with Next fetch caching (cacheComponents OFF, ADR-016) and are
+ * de-duplicated per request with React `cache()`, so generateMetadata and the page share one call.
+ */
+export function createVisualNext(config) {
+    const client = createVisualClient({
+        baseUrl: config.apiUrl,
+        projectId: config.projectId,
+        ...(config.apiKey ? { apiKey: config.apiKey } : {}),
+        validate: config.validate ?? process.env.NODE_ENV !== "production",
+    });
+    const home = config.homePageKey ?? "home";
+    /** Next fetch options for a caching mode: static = cached until a tag is revalidated; isr = time-based too. */
+    const fetchOpts = (tags, rendering, revalidate) => (rendering ?? config.rendering ?? "isr") === "static"
+        ? { cache: "force-cache", next: { tags } }
+        : { next: { revalidate: revalidate ?? config.revalidate ?? 60, tags } };
+    const getPageData = cache(async (locale, slug, rendering, revalidate) => {
+        // Not a locale code (e.g. /admin, /favicon.ico caught by a [locale] route) → no page → 404, never a 500.
+        if (!LOCALE_CODE.test(locale))
+            return null;
+        const path = toPath(slug);
+        return client.getResolvedPage(path ? { locale, path } : { locale, pageKey: home }, fetchOpts([visualTags.project(config.projectId), visualTags.page(config.projectId, locale, path)], rendering, revalidate));
+    });
+    /**
+     * For `generateStaticParams` in a `[locale]/[[...slug]]` route (rendering "static"): every published
+     * page of the current release. If the API is unreachable at build time, returns [] and pages are
+     * generated on first request instead (never fails the build).
+     */
+    async function generateStaticParams(opts = {}) {
+        try {
+            const list = await client.listPages(undefined, fetchOpts([visualTags.project(config.projectId)], "static"));
+            return (list?.pages ?? []).filter((p) => !opts.locales || opts.locales.includes(p.locale))
+                .map((p) => ({ locale: p.locale, slug: p.pageKey === home ? [] : p.slug.split("/").filter(Boolean) }));
+        }
+        catch (e) {
+            console.warn("[visual] generateStaticParams: Published API unreachable — pages will be generated on first request.", e);
+            return [];
+        }
+    }
+    /**
+     * Server Component. Renders the published page or calls notFound().
+     * `data` feeds the page's data inputs (ADR-034), e.g. data={{ products }} — fetched by your app.
+     */
+    async function VisualPage(props) {
+        const data = await getPageData(props.locale, props.slug, props.rendering, props.revalidate);
+        if (!data)
+            notFound();
+        const out = (_jsxs("div", { "data-vp-page": data.page.pageKey, "data-vp-release": data.release.id, lang: data.locale.content, dir: data.locale.dir ?? dirOf(null, data.locale.content), children: [(() => {
+                    // JSON-LD from Studio (allowlisted schema.org types) as ONE script (@graph when several);
+                    // "<" escaped so it can never close the script.
+                    const ld = jsonLdDocument(data.seo.structuredData);
+                    return ld ? _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(ld).replace(/</g, "\\u003c") } }) : null;
+                })(), renderDocument(data.page.document, {
+                    registry: config.registry,
+                    mode: props.mode ?? "production",
+                    locale: data.locale.content,
+                    dir: data.locale.dir ?? dirOf(null, data.locale.content),
+                    // Data-table inputs come resolved with the page (ADR-041); data from the app wins by name.
+                    ...(data.data || props.data ? { data: { ...(data.data ?? {}), ...(props.data ?? {}) } } : {}),
+                    // Tokens, themes and fonts pinned by the release (ADR-026); older releases fall back to defaults.
+                    ...(data.design ? { design: data.design } : {}),
+                    ...(config.tailwind !== "app" && data.styles ? { classCss: data.styles } : {}),
+                    ...(data.page.document.root.props.theme ? { theme: data.page.document.root.props.theme } : {}),
+                    onUnknownComponent: (type, id) => console.warn(`[visual] unknown component "${type}" (node ${id}) — add it to your registry`),
+                })] }));
+        // Server Actions by event name (ADR-040): no client wrapper needed.
+        return props.handlers ? _jsx(VisualEvents, { actions: props.handlers, children: out }) : out;
+    }
+    const getComponentData = cache((id, rendering, revalidate, locale) => client.getResolvedComponent(id, fetchOpts([visualTags.project(config.projectId), visualTags.component(config.projectId, id)], rendering, revalidate), { locale }));
+    /**
+     * Server Component for one composed component (ADR-028), anywhere in your app:
+     *   <visual.VisualComponent id="…" locale="vi" values={{ title: "Flash sale" }} />
+     * Text follows `locale` (component translations); `values` fill the component's props;
+     * `data` feeds its data inputs (ADR-034).
+     * Renders nothing when the component is not published (or `fallback`).
+     */
+    async function VisualComponent(props) {
+        const data = await getComponentData(props.id, props.rendering, props.revalidate, props.locale);
+        if (!data)
+            return _jsx(_Fragment, { children: props.fallback ?? null });
+        const doc = data.component.document;
+        if (!componentEnabledFor(doc, props.locale ?? doc.defaultLocale))
+            return _jsx(_Fragment, { children: props.fallback ?? null }); // switched off for this language
+        const nodes = withTheme(applyComponent(doc, { locale: props.locale, values: props.values }), doc.theme, `n_c${data.component.versionId.slice(0, 6)}`);
+        const page = { schemaVersion: 1, locale: props.locale ?? doc.defaultLocale, root: { props: { seo: { slug: "component", title: "component" } } }, nodes };
+        const out = (_jsx("div", { "data-vp-component": props.id, "data-vp-release": data.release.id, children: renderDocument(page, {
+                registry: config.registry, mode: "production",
+                locale: props.locale ?? doc.defaultLocale,
+                dir: dirOf(data.locales, props.locale ?? doc.defaultLocale),
+                ...(data.data || props.data ? { data: { ...(data.data ?? {}), ...(props.data ?? {}) } } : {}),
+                ...(data.design ? { design: data.design } : {}),
+                ...(config.tailwind !== "app" && data.styles ? { classCss: data.styles } : {}),
+                ...(props.theme ? { theme: props.theme } : {}),
+                onUnknownComponent: (type, id) => console.warn(`[visual] unknown component "${type}" (node ${id}) — add it to your registry`),
+            }) }));
+        // Server Actions by event name (ADR-040): no client wrapper needed.
+        return props.handlers ? _jsx(VisualEvents, { actions: props.handlers, children: out }) : out;
+    }
+    /**
+     * Use inside generateMetadata. Everything set in Studio → Page → Settings → SEO: title (+ template),
+     * description, robots (noindex/nofollow), canonical, hreflang alternates, Open Graph and Twitter card.
+     * JSON-LD is rendered by <VisualPage> itself (Next metadata has no ld+json field).
+     */
+    async function generateMetadata(locale, slug, opts = {}) {
+        const data = await getPageData(locale, slug, opts.rendering, opts.revalidate);
+        if (!data)
+            return {};
+        const seo = data.seo;
+        const base = (opts.baseUrl ?? config.siteUrl ?? "").replace(/\/$/, "");
+        // The home page (homePageKey) is served at "/{locale}"; other pages at "/{locale}/{slug}".
+        const isHome = data.page.pageKey === (config.homePageKey ?? "home");
+        const urlOf = (l, s) => `${base}/${l}${isHome || !s ? "" : `/${s}`}`;
+        const title = opts.titleTemplate ? opts.titleTemplate.replace("%s", seo.title) : seo.title;
+        const description = seo.description ?? undefined;
+        const ogImage = seo.og?.image && "url" in seo.og.image ? seo.og.image : null;
+        const url = seo.canonical ?? (base ? urlOf(data.locale.content, data.page.slug) : undefined);
+        // hreflang: every published language of this page + x-default (project default language) — ADR-037/038.
+        const alts = data.alternates ?? [];
+        const def = alts.find((a) => a.locale === data.defaultLocale);
+        const languages = base && alts.length
+            ? { ...Object.fromEntries(alts.map((a) => [a.locale, urlOf(a.locale, a.slug)])), ...(def ? { "x-default": urlOf(def.locale, def.slug) } : {}) }
+            : undefined;
+        const ogTitle = seo.og?.title ?? title;
+        const ogDescription = seo.og?.description ?? description;
+        return {
+            title,
+            ...(description ? { description } : {}),
+            ...(seo.robots ? { robots: { index: seo.robots.index, follow: seo.robots.follow } } : {}),
+            ...(url || languages ? { alternates: { ...(url ? { canonical: url } : {}), ...(languages ? { languages } : {}) } } : {}),
+            openGraph: {
+                type: "website", title: ogTitle, locale: data.locale.content.replace("-", "_"),
+                ...(ogDescription ? { description: ogDescription } : {}),
+                ...(url ? { url } : {}),
+                ...(ogImage ? { images: [{ url: ogImage.url, ...(ogImage.width ? { width: ogImage.width } : {}), ...(ogImage.height ? { height: ogImage.height } : {}), ...(ogImage.alt ? { alt: ogImage.alt } : {}) }] } : {}),
+            },
+            twitter: { card: ogImage ? "summary_large_image" : "summary", title: ogTitle, ...(ogDescription ? { description: ogDescription } : {}), ...(ogImage ? { images: [ogImage.url] } : {}) },
+        };
+    }
+    /**
+     * Query a data table from your own Server Components (ADR-041), cached like pages:
+     *   const { rows } = await visual.query({ table: "products", filter: "price < 50000", include: ["category"] })
+     */
+    async function query(q, opts = {}) {
+        return (await client.query(q, fetchOpts([visualTags.project(config.projectId)], opts.rendering, opts.revalidate))) ?? { dataVersion: 0, total: 0, rows: [] };
+    }
+    const getLocales = cache(() => client.getLocales({
+        next: { revalidate: config.revalidate ?? 60, tags: [visualTags.project(config.projectId)] },
+    }));
+    /**
+     * Languages of the project (ADR-035), from the current release: code, name, nativeName, dir.
+     * Use for a language switcher, generateStaticParams, or `<html lang dir>` in your layout.
+     */
+    async function locales() {
+        return (await getLocales())?.locales ?? [];
+    }
+    /** Default language of the project (current release), for redirecting "/" → "/{locale}". */
+    async function defaultLocale() {
+        const l = await getLocales();
+        if (l?.defaultLocale ?? l?.locales[0]?.code)
+            return l.defaultLocale ?? l.locales[0].code;
+        // Releases published before ADR-035 carry no language list: use the published home page.
+        const pages = await client.listPages(undefined, { next: { revalidate: config.revalidate ?? 60, tags: [visualTags.project(config.projectId)] } });
+        return pages?.pages.find((p) => p.pageKey === home)?.locale ?? pages?.pages[0]?.locale ?? null;
+    }
+    /** Is this one of the project's published languages? Use it to 404 unknown /{locale} segments. */
+    async function hasLocale(locale) {
+        return LOCALE_CODE.test(locale) && (await locales()).some((l) => l.code === locale);
+    }
+    /** "rtl" for Arabic etc. — `<html lang={locale} dir={await visual.localeDir(locale)}>`. */
+    async function localeDir(locale) {
+        const list = await locales();
+        return dirOf(Object.fromEntries(list.map((l) => [l.code, l])), locale);
+    }
+    /**
+     * Route handler for the platform's revalidation webhook (blueprint 53 §4 step 5):
+     *   export const POST = visual.revalidateHandler(process.env.VISUAL_REVALIDATE_SECRET!)
+     */
+    function revalidateHandler(secret) {
+        return async (request) => {
+            if (!secret || request.headers.get("x-visual-secret") !== secret) {
+                return Response.json({ error: "unauthorized" }, { status: 401 });
+            }
+            const body = (await request.json().catch(() => ({})));
+            if (body.projectId !== config.projectId)
+                return Response.json({ error: "unknown project" }, { status: 400 });
+            // Expire now (not stale-while-revalidate): the next visitor after a publish must see it.
+            revalidateTag(visualTags.project(config.projectId), { expire: 0 });
+            return Response.json({ revalidated: visualTags.project(config.projectId) });
+        };
+    }
+    return { client, getPageData, getComponentData, VisualPage, VisualComponent, generateMetadata, revalidateHandler, locales, localeDir, defaultLocale, hasLocale, generateStaticParams, query };
+}
+export { createVisualRegistry } from "@visual-platform/runtime-core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@visual-platform/next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Visual Page Platform — Next.js SDK: <VisualPage>, <VisualComponent>, metadata, ISR/static.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@visual-platform/client": "^0.1.0",
+    "@visual-platform/contracts": "^0.1.0",
+    "@visual-platform/runtime-core": "^0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=16.3.3 <17",
+    "react": "^19.2.0"
+  },
+  "devDependencies": {
+    "@visual-platform/typescript-config": "0.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "next": "16.4.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist .turbo"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.