pagiera 0.2.0-alpha.33 → 0.2.0-alpha.37

package/README.md

@@ -1,6 +1,8 @@
 # Pagiera
 
-![Pagiera visual website builder](./thumbnail.png)
+[![Pagiera visual website builder](https://raw.githubusercontent.com/voilabs/pagiera/main/packages/pagiera/thumbnail.png)](https://pagiera.com)
+
+[Website](https://pagiera.com) · [GitHub](https://github.com/voilabs/pagiera) · [Issues](https://github.com/voilabs/pagiera/issues)
 
 Pagiera is a full-stack visual website builder for React and Next.js. It ships the editor, responsive canvas, page management, reusable components, templates, AI generation, server-side data fetching, publishing runtime, PostgreSQL persistence, and Redis caching as one installable package.
 
@@ -24,6 +26,7 @@ Design in the editor and render the same document on the server. Published pages
 - Draft preview and published page rendering
 - PostgreSQL persistence and optimistic revisions
 - Redis-backed publishing cache and AI rate limiting
+- GitHub-backed template catalog with browser caching and offline fallbacks
 - Semantic output including `main`, `section`, `nav`, `header`, `footer`, headings, links, paragraphs, and buttons
 
 ## Requirements
@@ -70,6 +73,8 @@ Pagiera creates its required PostgreSQL tables when the server initializes. Redi
 
 `full.css` contains the complete studio UI. Use `pagiera/styles.css` only with the smaller `PagieraEditor` API.
 
+Pagiera uses `@fontsource-variable/figtree` for its editor chrome, including Latin and Latin Extended glyphs. The host application does not need to configure an editor font.
+
 ### 2. Add the font provider
 
 The provider makes `next/font` fonts available in **Typography → Site font**. A selection applies to the canvas, preview, and published site.
@@ -78,6 +83,7 @@ The provider makes `next/font` fonts available in **Typography → Site font**.
 // src/app/layout.tsx
 import { Geist, Geist_Mono } from "next/font/google";
 import { PagieraProvider } from "pagiera/provider";
+import type { ReactNode } from "react";
 import "./globals.css";
 
 const geistSans = Geist({
@@ -90,7 +96,7 @@ const geistMono = Geist_Mono({
   subsets: ["latin"],
 });
 
-export default function RootLayout({ children }: LayoutProps<"/">) {
+export default function RootLayout({ children }: { children: ReactNode }) {
   return (
     <html lang="en">
       <body>
@@ -311,6 +317,27 @@ export default async function PublishedPage({ params, searchParams }: {
 }
 ```
 
+## Template registry
+
+The editor reads its catalog from the public Pagiera repository by default:
+
+```text
+https://raw.githubusercontent.com/voilabs/pagiera/main/templates/registry.json
+```
+
+This is a static GitHub Raw/CDN request, not the rate-limited GitHub REST API. Registry and template responses are cached in memory and `localStorage` for 15 minutes. The refresh button bypasses the local TTL, and the package keeps bundled fallback entries for offline use.
+
+You may point the studio at a fork, branch, or private proxy:
+
+```tsx
+<PagieraStudio
+  {...props}
+  templateRegistryUrl="https://example.com/pagiera/registry.json"
+/>
+```
+
+New templates live under the repository's `templates/` directory. They can be released independently from npm package versions. See [`templates/README.md`](https://github.com/voilabs/pagiera/blob/main/templates/README.md) for the registry schema and contribution workflow.
+
 ## Dynamic routes and request data
 
 Page slugs may contain named parameters:
@@ -507,10 +534,10 @@ Use `server.getPublishedPage(...)` or `loadPageData(...)` in a Server Component
 
 ## Local package example
 
-This repository includes `package-example`, a standalone consumer that installs the generated `.tgz` instead of importing package source files.
+This repository includes `apps/example`, a standalone workspace consumer of the package.
 
 ```bash
-cd package-example
+cd apps/example
 cp .env.example .env.local
 bun install
 bun run dev

package/dist/client.d.ts

@@ -12,7 +12,7 @@ export declare function createPagieraClient(options?: PagieraClientOptions): {
         renamePage: (id: string, name: string, slug: string) => Promise<any>;
         duplicatePage: (id: string, name: string, slug: string) => Promise<any>;
         deletePage: (id: string) => Promise<any>;
-        installTemplate: (id: string) => Promise<any>;
+        installTemplate: (template: unknown) => Promise<any>;
         publishPage: (id: string) => Promise<any>;
         unpublishPage: (id: string) => Promise<any>;
         previewSource: (source: unknown, sampleQuery: string) => Promise<any>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACnC,CAAC;AAYF,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB;yBAOzC,MAAM;uBACR,MAAM;;uBAEN,MAAM,YAAY,OAAO,mBAAmB,MAAM;2BAC9C,MAAM,QAAQ,MAAM;yBACtB,MAAM,QAAQ,MAAM,QAAQ,MAAM;4BAC/B,MAAM,QAAQ,MAAM,QAAQ,MAAM;yBACrC,MAAM;8BACD,MAAM;0BACV,MAAM;4BACJ,MAAM;gCACF,OAAO,eAAe,MAAM;4BAChC,OAAO;;EAGtC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACnC,CAAC;AAYF,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB;yBAOzC,MAAM;uBACR,MAAM;;uBAEN,MAAM,YAAY,OAAO,mBAAmB,MAAM;2BAC9C,MAAM,QAAQ,MAAM;yBACtB,MAAM,QAAQ,MAAM,QAAQ,MAAM;4BAC/B,MAAM,QAAQ,MAAM,QAAQ,MAAM;yBACrC,MAAM;oCACK,OAAO;0BAGjB,MAAM;4BACJ,MAAM;gCACF,OAAO,eAAe,MAAM;4BAChC,OAAO;;EAGtC"}

package/dist/client.js

@@ -22,7 +22,9 @@ export function createPagieraClient(options = {}) {
             renamePage: (id, name, slug) => call(`/pages/${id}`, "PATCH", { name, slug }),
             duplicatePage: (id, name, slug) => call(`/pages/${id}/duplicate`, "POST", { name, slug }),
             deletePage: (id) => call(`/pages/${id}`, "DELETE"),
-            installTemplate: (id) => call(`/templates/${id}`, "POST"),
+            installTemplate: (template) => typeof template === "string"
+                ? call(`/templates/${template}`, "POST")
+                : call("/templates/install", "POST", { template }),
             publishPage: (id) => call(`/pages/${id}/publish`, "POST"),
             unpublishPage: (id) => call(`/pages/${id}/unpublish`, "POST"),
             previewSource: (source, sampleQuery) => call("/data/preview", "POST", { source, sampleQuery }),

package/dist/client.js.map

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

package/dist/full-editor.d.ts

@@ -33,7 +33,7 @@ export type PagieraStudioAdapters = {
     renamePage?(id: string, name: string, slug: string): Promise<PagieraMutationResult>;
     duplicatePage?(id: string, name: string, slug: string): Promise<PagieraMutationResult>;
     deletePage?(id: string): Promise<PagieraMutationResult>;
-    installTemplate?(id: "nocturne" | "editorial-blog" | "orbit-saas"): Promise<PagieraMutationResult>;
+    installTemplate?(template: string | { schemaVersion: 1; id: string; version: string; pages: unknown[] }): Promise<PagieraMutationResult>;
     publishPage?(id: string): Promise<PagieraMutationResult>;
     unpublishPage?(id: string, slug: string): Promise<PagieraMutationResult>;
     navigate?(pageId: string, options?: { replace?: boolean }): void | Promise<void>;
@@ -47,6 +47,7 @@ export type PagieraStudioProps = {
     pages: Array<{ id: string; name: string; slug: string; published?: boolean }>;
     library: unknown[];
     adapters: PagieraStudioAdapters;
+    templateRegistryUrl?: string;
 };
 
 export const PagieraStudio: ComponentType<PagieraStudioProps>;