@pantheon-systems/create-p1-starter-kit 0.8.0 → 0.10.0

package/template/eslint.config.js

@@ -81,7 +81,11 @@ export default tseslint.config(
       '@typescript-eslint/no-shadow': 'warn',
       '@typescript-eslint/no-require-imports': 'warn',
       'no-async-promise-executor': 'warn',
-      '@typescript-eslint/consistent-type-definitions': 'warn',
+      // Off deliberately. The rule's `interface` default is unsafe: interfaces have
+      // no implicit index signature, so autofixing `type X = {...}` to an interface
+      // silently breaks assignability to Record<string, unknown>. Both spellings are
+      // fine; this is not worth a footgun.
+      '@typescript-eslint/consistent-type-definitions': 'off',
       'no-useless-escape': 'warn',
       'no-useless-catch': 'warn',
       '@typescript-eslint/no-inferrable-types': 'warn',
@@ -90,7 +94,10 @@ export default tseslint.config(
       '@typescript-eslint/ban-ts-comment': 'warn',
       '@typescript-eslint/no-unused-expressions': 'warn',
       '@typescript-eslint/no-non-null-asserted-optional-chain': 'warn',
-      '@typescript-eslint/no-empty-function': 'warn',
+      // A no-op default for an optional callback is idiomatic here
+      // (`onLogout ?? (() => {})`), and the rule cannot tell it from an
+      // accidentally empty body. Still catches empty function declarations.
+      '@typescript-eslint/no-empty-function': ['warn', { allow: ['arrowFunctions', 'methods'] }],
       '@typescript-eslint/no-empty-object-type': 'warn',
       '@typescript-eslint/no-wrapper-object-types': 'warn',
       'no-constant-binary-expression': 'warn',
@@ -99,14 +106,20 @@ export default tseslint.config(
       '@typescript-eslint/no-redeclare': 'warn',
       'no-case-declarations': 'warn',
       'no-empty': 'warn',
-      '@typescript-eslint/no-dynamic-delete': 'warn',
+      // Off: `delete record[computedKey]` is the normal way to drop a cache
+      // entry or a patch path segment. The rule's alternative is switching the
+      // structure to a Map, which is a design change, not a lint fix.
+      '@typescript-eslint/no-dynamic-delete': 'off',
       'no-constant-condition': 'warn',
       'no-empty-pattern': 'warn',
       'no-var': 'warn',
       '@typescript-eslint/no-namespace': 'warn',
       '@typescript-eslint/no-extraneous-class': 'warn',
       '@typescript-eslint/unified-signatures': 'warn',
-      '@typescript-eslint/no-invalid-void-type': 'warn',
+      // Off: `request<void>(...)` for an endpoint that returns no body is the
+      // normal spelling in css-client, and that is a generic type argument —
+      // which the rule's own message calls valid.
+      '@typescript-eslint/no-invalid-void-type': 'off',
       '@typescript-eslint/no-this-alias': 'warn',
     },
   },
@@ -127,6 +140,9 @@ export default tseslint.config(
       'coverage/**',
       '**/*.d.ts',
       '**/generated/**',
+      // Vendored snapshots and test data. Linting these rewrites them, which
+      // silently breaks any test asserting byte-identical output against them.
+      '**/fixtures/**',
       '**/.puppeteerrc.cjs',
     ],
   },

package/template/lib/chatbot-flag/ai-generate.ts

@@ -0,0 +1,23 @@
+import type { DraftRequestChannel } from "@pantheon-systems/p1-ai-chat";
+
+/**
+ * Build the Create Page modal's "Generate with AI" handler, or `undefined` when the
+ * chatbot is disabled (which leaves the modal tile a placeholder).
+ *
+ * The page does not exist yet: the chat proposes the page template it should start from and
+ * creates it once the user agrees, because a document's template can only be set as it is
+ * created (PCC-3555). Until then the request carries the title and path the dialog collected.
+ */
+export function createGenerateWithAIHandler(
+  draftRequests: DraftRequestChannel,
+  enabled: boolean,
+): ((brief: string, page: { path: string; title?: string }) => void) | undefined {
+  if (!enabled) return undefined;
+  return (brief, page) => {
+    draftRequests.publish({
+      kind: "create-page",
+      brief: brief.trim(),
+      page: { path: page.path, title: page.title?.trim() ?? "" },
+    });
+  };
+}

package/template/lib/chatbot-flag/draft-request-channel.ts

@@ -0,0 +1,12 @@
+import { createDraftRequestChannel, type DraftRequestChannel } from "@pantheon-systems/p1-ai-chat";
+
+let channel: DraftRequestChannel | null = null;
+
+/**
+ * Module-level singleton, not component state: the publish and the consume happen either
+ * side of a navigation that remounts the editor tree, so a per-mount ref would drop it.
+ */
+export function getDraftRequestChannel(): DraftRequestChannel {
+  if (!channel) channel = createDraftRequestChannel();
+  return channel;
+}

package/template/lib/monsters-api.ts

@@ -35,6 +35,8 @@ function resolveMonsterIndex(params: RemoteDatasourceFetcherParams): string | un
   );
 }
 
+type MonsterItem = { index: string; name: string; url: string } & Record<string, unknown>;
+
 async function fetchMonster(
   index: string | undefined,
   fetchImpl: typeof fetch,
@@ -50,9 +52,10 @@ async function fetchMonster(
     key
     num
     species
-    types
-    abilities { first second hidden special }
-    hp attack defense spAtk spDef speed sprite
+    sprite
+    types { name }
+    abilities { first { name } second { name } hidden { name } }
+    baseStats { hp attack defense specialattack specialdefense speed }
   }
 }`,
         variables: { pokemon: index },
@@ -74,9 +77,7 @@ async function fetchMonster(
   }
 }
 
-async function fetchMonsterList(
-  fetchImpl: typeof fetch,
-): Promise<Array<{ index: string; name: string; url?: string }>> {
+async function fetchMonsterList(fetchImpl: typeof fetch): Promise<MonsterItem[]> {
   try {
     const res = await fetchImpl(GRAPHQL_POKEMON_ENDPOINT, {
       method: "POST",
@@ -85,7 +86,12 @@ async function fetchMonsterList(
         query: `query GetAllPokemon($take: Int!, $offset: Int!) {
   getAllPokemon(take: $take, offset: $offset) {
     key
+    num
     species
+    sprite
+    types { name }
+    abilities { first { name } second { name } hidden { name } }
+    baseStats { hp attack defense specialattack specialdefense speed }
   }
 }`,
         variables: { take: 200, offset: 89 },
@@ -98,14 +104,14 @@ async function fetchMonsterList(
     if (!data || typeof data !== "object" || Array.isArray(data)) return [];
     const results = (data as { getAllPokemon?: unknown }).getAllPokemon;
     if (!Array.isArray(results)) return [];
-    const out: Array<{ index: string; name: string; url?: string }> = [];
+    const out: MonsterItem[] = [];
     for (const row of results) {
       if (!row || typeof row !== "object" || Array.isArray(row)) continue;
       const r = row as Record<string, unknown>;
       const index = typeof r.key === "string" ? r.key : "";
       const name = typeof r.species === "string" ? r.species : "";
       const url = index ? `/pokemon/${index}` : undefined;
-      if (index && name) out.push({ index, name, url });
+      if (index && name && url) out.push({ ...r, index, name, url });
     }
     return out;
   } catch {

package/template/lib/page-seo.ts

@@ -11,6 +11,7 @@ import {
 } from "@pantheon-systems/puck-css/server";
 import { REMOTE_DATASOURCE_FETCHERS } from "./remote-datasource-fetchers";
 import { buildPageMetadata } from "./seo-metadata";
+import type { PageMetaFields } from "./seo-metadata";
 
 type PageData = Awaited<ReturnType<typeof getPage>>;
 
@@ -19,8 +20,25 @@ type PageData = Awaited<ReturnType<typeof getPage>>;
 const DEFAULT_EDITOR_TITLE = "My Puck Editor";
 
 /**
- * Produces the per-page <head> Metadata for a route (PCC-3407). Title and
- * description are template-allowed properties.
+ * Metadata fields that accept `{{ }}`. ogType and twitterCard are absent by
+ * design: their values are checked against a union, so a template could only
+ * ever resolve to something the renderer rejects.
+ */
+const TEMPLATED_META_FIELDS = [
+  "ogTitle",
+  "ogDescription",
+  "ogImage",
+  "ogLocale",
+  "twitterTitle",
+  "twitterImage",
+] as const satisfies readonly (keyof PageMetaFields)[];
+
+const carriesTemplate = (value: unknown): value is string =>
+  typeof value === "string" && value.includes("{{");
+
+/**
+ * Produces the per-page <head> Metadata for a route (PCC-3407). Title,
+ * description and the free-text metadata fields are template-allowed.
  */
 export async function resolvePageMetadata({
   pageData,
@@ -33,16 +51,21 @@ export async function resolvePageMetadata({
 }): Promise<Metadata> {
   const rootProps: Record<string, unknown> | undefined = pageData?.root.props;
   const seo: Partial<SeoMetadata> | undefined = rootProps?._seo;
+  const authoredMeta = rootProps?._meta as PageMetaFields | undefined;
   const rootTitle = rootProps?.title as string | undefined;
   const rawTitle = rootTitle === DEFAULT_EDITOR_TITLE ? undefined : rootTitle;
   const rawDescription = rootProps?.description as string | undefined;
 
+  const templatedMeta = TEMPLATED_META_FIELDS.filter((field) =>
+    carriesTemplate(authoredMeta?.[field]),
+  );
   const needsTemplates =
-    (typeof rawTitle === "string" && rawTitle.includes("{{")) ||
-    (typeof rawDescription === "string" && rawDescription.includes("{{"));
+    carriesTemplate(rawTitle) || carriesTemplate(rawDescription) || templatedMeta.length > 0;
 
   let title = rawTitle;
   let description = rawDescription;
+  let meta = authoredMeta;
+
   if (needsTemplates && pageData) {
     const routeTemplateKeys = await listRouteTemplateKeysFromDatabase();
     const referencedDatasourceIds = extractReferencedDatasourceIds(pageData);
@@ -55,17 +78,25 @@ export async function resolvePageMetadata({
       referencedDatasourceIds,
     });
 
-    const [resolvedTitle, resolvedDescription] = await Promise.all([
-      typeof rawTitle === "string"
-        ? resolveStringTemplates(rawTitle, context)
-        : rawTitle,
-      typeof rawDescription === "string"
-        ? resolveStringTemplates(rawDescription, context)
-        : rawDescription,
+    // One context load, then every templated value resolved against it. Only
+    // the fields that carry a template are resolved, so an ordinary page with a
+    // templated title does not pay for eight passes.
+    const resolveField = async (value: string) => resolveStringTemplates(value, context);
+
+    const [resolvedTitle, resolvedDescription, ...resolvedMeta] = await Promise.all([
+      carriesTemplate(rawTitle) ? resolveField(rawTitle) : rawTitle,
+      carriesTemplate(rawDescription) ? resolveField(rawDescription) : rawDescription,
+      ...templatedMeta.map((field) => resolveField(authoredMeta?.[field] as string)),
     ]);
 
     title = resolvedTitle;
     description = resolvedDescription;
+    meta = {
+      ...authoredMeta,
+      ...Object.fromEntries(
+        templatedMeta.map((field, index) => [field, resolvedMeta[index]]),
+      ),
+    };
   }
 
   return buildPageMetadata({
@@ -73,6 +104,8 @@ export async function resolvePageMetadata({
       title,
       description,
       siteName: seo?.siteName,
+      siteDefaults: { ogImage: seo?.ogImage, ogLocale: seo?.ogLocale },
+      meta,
     },
     path,
   });

package/template/lib/remote-datasources.ts

@@ -3,7 +3,7 @@ import type { RemoteDatasourceDefinition } from "@pantheon-systems/puck-css/serv
 export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
   {
     id: "swapi",
-    label: "Star Wars API (person)",
+    label: "Star Wars character detail",
     description:
       "Person record from SWAPI. Used when editing pages that resolve a numeric person id (see resolution).",
     resolution:
@@ -29,7 +29,7 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
   },
   {
     id: "monster",
-    label: "Pokemon GraphQL (pokemon)",
+    label: "Pokemon detail",
     description: "Single pokemon record from GraphQL Pokemon (`getPokemon`).",
     resolution:
       "Resolved from query params (`?monster=...`, `?monsterIndex=...`, `?index=...`, then `?id=...`), preview params, or route params (`:monster`, `:monsterIndex`, `:index`, `:id`).",
@@ -61,7 +61,7 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
   },
   {
     id: "swapi_list",
-    label: "Star Wars API (people index)",
+    label: "Star Wars characters list",
     description:
       "First page of SWAPI `/people/` (loaded every request). Use with a List block and `markdownLinks` token.",
     resolution:
@@ -70,23 +70,28 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
       {
         path: "items",
         description:
-          "Array of `{ id, name }` rows from SWAPI `/people/`. In an Array field, set value to `{{ swapi_list.items }}` to hydrate cards/rows.",
-      },
-      {
-        path: "items.0.url",
-        description:
-          "Canonical SWAPI URL for each item (available as `item.url` in per-card templates).",
+          "Array of `{ id, name, url }` rows from SWAPI `/people/`. In an Array field, set value to `{{ swapi_list.items }}` to hydrate cards/rows.",
       },
       {
         path: "markdownLinks",
         description:
           'In a List block\'s items field: `{{ swapi_list.markdownLinks "/jedi/{id}" }}` (or bare `{{ swapi_list.markdownLinks }}`) -- expands to one `[name](/jedi/n)` line per person.',
       },
+      { path: "items[].id", description: "Person ID (extracted from URL)" },
+      { path: "items[].name", description: "Character name" },
+      { path: "items[].height", description: "Height" },
+      { path: "items[].mass", description: "Mass" },
+      { path: "items[].hair_color", description: "Hair color" },
+      { path: "items[].skin_color", description: "Skin color" },
+      { path: "items[].eye_color", description: "Eye color" },
+      { path: "items[].birth_year", description: "Birth year" },
+      { path: "items[].gender", description: "Gender" },
+      { path: "items[].url", description: "Canonical person URL" },
     ],
   },
   {
     id: "monster_list",
-    label: "Pokemon GraphQL (pokemon index)",
+    label: "Pokemon list",
     description:
       "Pokemon list from GraphQL Pokemon `getAllPokemon` (loaded every request).",
     resolution:
@@ -97,23 +102,16 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
         description:
           "Array of `{ index, name, url }` rows from `getAllPokemon` (mapped from `key` + `species`). In an Array field, set `{{ monster_list.items }}` to hydrate cards/rows.",
       },
-      {
-        path: "items.0.index",
-        description: "Pokemon slug/index (for example `bulbasaur`).",
-      },
-      {
-        path: "items.0.name",
-        description: "Display name (for example `Bulbasaur`).",
-      },
-      {
-        path: "items.0.url",
-        description: "Synthetic URL path for per-item links.",
-      },
+      { path: "items[].index", description: "Pokemon slug (from key)" },
+      { path: "items[].name", description: "Pokemon name (from species)" },
+      { path: "items[].num", description: "Pokedex number" },
+      { path: "items[].sprite", description: "Sprite URL" },
+      { path: "items[].url", description: "URL path for this pokemon" },
     ],
   },
   {
     id: "article",
-    label: "Content Publisher (article)",
+    label: "Article detail",
     description:
       "Single Content Publisher article resolved from query/preview/route params.",
     resolution:
@@ -131,7 +129,7 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
   },
   {
     id: "article_list",
-    label: "Content Publisher (articles index)",
+    label: "Articles list",
     description:
       "Article list from Content Publisher, loaded every request for list rendering.",
     resolution:
@@ -142,13 +140,10 @@ export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
         description:
           "Array of normalized `{ id, title, slug?, url? }` rows. Use `{{ article_list.items }}` to hydrate array/list blocks.",
       },
-      { path: "items.0.id", description: "Article identifier." },
-      { path: "items.0.title", description: "Article title." },
-      {
-        path: "items.0.slug",
-        description: "Article slug/path alias if present.",
-      },
-      { path: "items.0.url", description: "Canonical URL if present." },
+      { path: "items[].id", description: "Article identifier" },
+      { path: "items[].title", description: "Article title" },
+      { path: "items[].slug", description: "Slug/path alias" },
+      { path: "items[].url", description: "Canonical article URL" },
     ],
   },
 ];

package/template/lib/seo-metadata.consts.ts

@@ -0,0 +1,21 @@
+/**
+ * The fixed vocabularies shared by the renderer and the editor.
+ *
+ * Next types `og:type` and `twitter:card` as unions rather than strings, so
+ * buildPageMetadata validates against these lists and falls back rather than
+ * letting an unrecognised value reach the tag. The Puck root config builds its
+ * dropdown options from the same lists, so an option cannot offer a value the
+ * renderer will reject.
+ */
+
+export const OG_TYPES = ["website", "article", "book", "profile"] as const;
+
+export const TWITTER_CARDS = [
+  "summary",
+  "summary_large_image",
+  "player",
+  "app",
+] as const;
+
+export type OgType = (typeof OG_TYPES)[number];
+export type TwitterCard = (typeof TWITTER_CARDS)[number];

package/template/lib/seo-metadata.ts

@@ -1,15 +1,64 @@
 import type { Metadata } from "next";
+import { OG_TYPES, TWITTER_CARDS } from "./seo-metadata.consts";
+
+/**
+ * Authored page metadata, stored at `root.props._meta`. Empty means inherit: a
+ * blank field resolves from the page's own title/description at render time
+ * rather than having been copied when the page was created.
+ */
+export interface PageMetaFields {
+  ogTitle?: string;
+  ogDescription?: string;
+  ogType?: string;
+  ogImage?: string;
+  ogLocale?: string;
+  twitterCard?: string;
+  twitterTitle?: string;
+  twitterImage?: string;
+}
+
+/**
+ * Site-wide fallbacks from the backend's SeoMetadata payload, for the fields a
+ * site can sensibly default. They resolve below the page's own values.
+ */
+export interface SiteMetaDefaults {
+  ogImage?: string;
+  ogLocale?: string;
+}
 
 /**
  * Head-side metadata inputs. Title, description, and canonical are derived
- * client-side (root props, request path); only siteName arrives from the
- * backend's SeoMetadata payload.
+ * client-side (root props, request path); siteName and the site defaults arrive
+ * from the backend's SeoMetadata payload.
  */
 export interface PageHeadMetadata {
   title?: string;
   description?: string;
   canonicalUrl?: string;
   siteName?: string;
+  siteDefaults?: SiteMetaDefaults;
+  meta?: PageMetaFields;
+}
+
+/**
+ * The editor offers these as dropdowns built from the same lists, but the API
+ * and MCP write the props directly, so the validation stays.
+ */
+function oneOf<T extends readonly string[]>(
+  allowed: T,
+  authored: string | undefined,
+  fallback: T[number],
+): T[number] {
+  return authored && (allowed as readonly string[]).includes(authored)
+    ? (authored as T[number])
+    : fallback;
+}
+
+/** Drops absent values so no empty tag is emitted. */
+function compact<T extends object>(value: T): T {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, v]) => v !== undefined && v !== ""),
+  ) as T;
 }
 
 /**
@@ -19,6 +68,13 @@ export interface PageHeadMetadata {
  * only when NEXT_PUBLIC_SITE_URL is configured to resolve it — otherwise Next
  * would resolve it against a localhost default, and a wrong canonical is worse
  * than none. An empty title is treated as absent.
+ *
+ * Social tags resolve as: page value → site default (og:image, og:locale) →
+ * derived from title/description → omit. There is no separate template tier:
+ * a template's defaults are copied into the page's own `_meta` at create time,
+ * so by the time they reach here they are page values and outrank the site
+ * default. A field the template left empty is copied in as an empty string,
+ * which is falsy, so it still falls through to the site tier.
  */
 export function buildPageMetadata({
   seo,
@@ -27,22 +83,47 @@ export function buildPageMetadata({
   seo?: PageHeadMetadata;
   path: string;
 }): Metadata {
-  const { description, canonicalUrl } = seo ?? {};
+  const meta = seo?.meta ?? {};
+
   const title = seo?.title || undefined;
-  const siteName = seo?.siteName ?? process.env.NEXT_PUBLIC_SITE_NAME;
+  const description = seo?.description || undefined;
   const canonical =
-    canonicalUrl ?? (process.env.NEXT_PUBLIC_SITE_URL ? path : undefined);
+    seo?.canonicalUrl ?? (process.env.NEXT_PUBLIC_SITE_URL ? path : undefined);
+
+  const siteDefaults = seo?.siteDefaults ?? {};
+  const ogImage = meta.ogImage || siteDefaults.ogImage || undefined;
+  const ogLocale = meta.ogLocale || siteDefaults.ogLocale || undefined;
+  const twitterTitle = meta.twitterTitle || meta.ogTitle || title;
+  const twitterImage = meta.twitterImage || ogImage;
 
-  return {
+  return compact({
     title,
     description,
-    ...(canonical ? { alternates: { canonical } } : {}),
-    openGraph: {
-      type: "website",
-      title,
-      description,
-      ...(canonical ? { url: canonical } : {}),
-      ...(siteName ? { siteName } : {}),
-    },
-  };
+    alternates: canonical ? { canonical } : undefined,
+
+    openGraph: compact({
+      type: oneOf(OG_TYPES, meta.ogType, "website"),
+      title: meta.ogTitle || title,
+      description: meta.ogDescription || description,
+      url: canonical,
+      siteName: seo?.siteName ?? process.env.NEXT_PUBLIC_SITE_NAME,
+      images: ogImage,
+      locale: ogLocale,
+    }),
+
+    // Without a card style X renders nothing, so it is always set when there is
+    // anything to show — but an untitled, imageless page gets no twitter tags.
+    twitter:
+      twitterTitle || twitterImage
+        ? compact({
+            card: oneOf(
+              TWITTER_CARDS,
+              meta.twitterCard,
+              twitterImage ? "summary_large_image" : "summary",
+            ),
+            title: twitterTitle,
+            images: twitterImage,
+          })
+        : undefined,
+  });
 }

package/template/lib/swapi.ts

@@ -39,23 +39,23 @@ async function fetchSwapiPerson(
   }
 }
 
-async function fetchSwapiPeopleList(
-  fetchImpl: typeof fetch,
-): Promise<Array<{ id: string; name: string; url?: string }>> {
+type SwapiItem = { id: string; name: string; url?: string } & Record<string, unknown>;
+
+async function fetchSwapiPeopleList(fetchImpl: typeof fetch): Promise<SwapiItem[]> {
   try {
     const res = await fetchImpl(`${SWAPI_BASE}/people`);
     if (!res.ok) return [];
     const json: unknown = await res.json();
     const results = Array.isArray(json) ? json : null;
     if (!results) return [];
-    const out: Array<{ id: string; name: string; url?: string }> = [];
+    const out: SwapiItem[] = [];
     for (const row of results) {
       if (!row || typeof row !== "object" || Array.isArray(row)) continue;
       const r = row as Record<string, unknown>;
       const id = swapiPersonIdFromUrl(r.url);
       const name = typeof r.name === "string" ? r.name : "";
       const url = typeof r.url === "string" ? r.url : undefined;
-      if (id && name) out.push({ id, name, url });
+      if (id && name) out.push({ ...r, id, name, url });
     }
     return out;
   } catch {

package/template/middleware.ts

@@ -0,0 +1,15 @@
+import { createP1Middleware } from "@pantheon-systems/p1-next-sdk/server";
+
+const p1Middleware = createP1Middleware({
+  cssBaseUrl: process.env.NEXT_PUBLIC_CSS_BASE_URL ?? "http://localhost:8787",
+  apiToken: process.env.CSS_API_KEY ?? "",
+  siteId: process.env.NEXT_PUBLIC_CSS_SITE_ID ?? "",
+});
+
+export async function middleware(request: Request) {
+  return p1Middleware(request);
+}
+
+export const config = {
+  matcher: ["/((?!_next/static|_next/image|favicon.ico).*)"],
+};

package/template/next.config.mjs

@@ -1,3 +1,6 @@
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+
 export default {
   reactStrictMode: true,
   experimental: {
@@ -10,4 +13,12 @@ export default {
     "@pantheon-systems/puck-css",
     "@pantheon-systems/p1-next-sdk",
   ],
+  turbopack: {},
+  webpack: (config) => {
+    config.resolve.alias = {
+      ...config.resolve.alias,
+      yjs: require.resolve("yjs"),
+    };
+    return config;
+  },
 };

package/template/package.json

@@ -3,29 +3,32 @@
   "version": "0.1.0",
   "type": "module",
   "scripts": {
-    "dev": "next dev",
     "build": "next build",
+    "clean": "rm -rf .next out *.tsbuildinfo node_modules/.vite",
+    "dev": "next dev",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "start": "next start",
+    "sync:registry": "tsx scripts/sync-puck-registry.ts",
     "test": "vitest run",
-    "lint": "eslint .",
-    "sync:registry": "tsx scripts/sync-puck-registry.ts"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@pantheon-systems/cpub-react-sdk": "^5.2.1",
-    "@pantheon-systems/css-client": "^0.8.0",
-    "@pantheon-systems/p1-ai-chat": "^0.1.2",
-    "@pantheon-systems/p1-media": "^0.4.2",
-    "@pantheon-systems/p1-next-sdk": "^0.8.0",
+    "@pantheon-systems/css-client": "^0.10.0",
+    "@pantheon-systems/p1-ai-chat": "workspace:*",
+    "@pantheon-systems/p1-media": "workspace:*",
+    "@pantheon-systems/p1-next-sdk": "^0.10.0",
     "@pantheon-systems/pds-toolkit-react": "2.0.0-alpha.51",
-    "@pantheon-systems/puck-css": "^0.8.0",
+    "@pantheon-systems/puck-css": "^0.10.0",
     "@puckeditor/core": "^0.21.1",
     "@tailwindcss/postcss": "^4.2.2",
     "@tailwindcss/typography": "^0.5.16",
     "classnames": "^2.5.1",
     "isomorphic-dompurify": "^3.18.0",
     "launchdarkly-react-client-sdk": "^3.9.2",
-    "next": "^16.2.6",
-    "postcss": "^8.5.12",
+    "next": "^16.2.12",
+    "postcss": "^8.5.25",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "react-markdown": "^10.1.0",
@@ -35,7 +38,7 @@
     "@types/node": "^20.19.30",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^4.7.0",
+    "@vitejs/plugin-react": "^6.0.5",
     "eslint": "^9.27.0",
     "tsx": "^4.23.1",
     "typescript": "^5.9.3",