@pantheon-systems/create-p1-starter-kit 0.1.0

package/template/lib/remote-datasources.ts

@@ -0,0 +1,154 @@
+import type { RemoteDatasourceDefinition } from "@pantheon-systems/puck-css/server";
+
+export const REMOTE_DATASOURCE_REGISTRY: RemoteDatasourceDefinition[] = [
+  {
+    id: "swapi",
+    label: "Star Wars API (person)",
+    description:
+      "Person record from SWAPI. Used when editing pages that resolve a numeric person id (see resolution).",
+    resolution:
+      "Query `?id=<n>` takes precedence. If omitted, a numeric `:id` is read from the URL when it matches a collection template in the database (see `resolveSwapiIdFromPagePath`).",
+    fields: [
+      { path: "name", description: "Character name" },
+      { path: "height", description: "Height" },
+      { path: "mass", description: "Mass" },
+      { path: "hair_color", description: "Hair color" },
+      { path: "skin_color", description: "Skin color" },
+      { path: "eye_color", description: "Eye color" },
+      { path: "birth_year", description: "Birth year" },
+      { path: "gender", description: "Gender" },
+      { path: "homeworld", description: "URL of homeworld resource" },
+      { path: "films", description: "Film resource URLs" },
+      { path: "species", description: "Species resource URLs" },
+      { path: "vehicles", description: "Vehicle resource URLs" },
+      { path: "starships", description: "Starship resource URLs" },
+      { path: "created", description: "Record creation timestamp" },
+      { path: "edited", description: "Record edit timestamp" },
+      { path: "url", description: "Canonical person URL" },
+    ],
+  },
+  {
+    id: "monster",
+    label: "Pokemon GraphQL (pokemon)",
+    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`).",
+    fields: [
+      { path: "index", description: "Pokemon slug (mapped from `key`)." },
+      {
+        path: "name",
+        description: "Pokemon display name (mapped from `species`).",
+      },
+      { path: "num", description: "Pokedex number." },
+      { path: "types", description: "Type list." },
+      { path: "abilities", description: "Abilities object." },
+      { path: "hp", description: "HP stat." },
+      { path: "attack", description: "Attack stat." },
+      { path: "defense", description: "Defense stat." },
+      { path: "speed", description: "Speed stat." },
+      { path: "sprite", description: "Sprite URL." },
+      { path: "url", description: "Synthetic URL path for this monster." },
+    ],
+  },
+  {
+    id: "urlParams",
+    label: "Route URL params",
+    description:
+      "Captured params from route templates (for example `/jedis/:id`). Available to all templates.",
+    resolution:
+      "Derived from concrete URL path matches and editor preview params; query params with the same key override preview values.",
+    fields: [{ path: "id", description: "Example route param value" }],
+  },
+  {
+    id: "swapi_list",
+    label: "Star Wars API (people index)",
+    description:
+      "First page of SWAPI `/people/` (loaded every request). Use with a List block and `markdownLinks` token.",
+    resolution:
+      "First `/people/` page is fetched on every request (alongside the single-person `swapi` row). Extra SWAPI traffic on person-scoped pages; swap to lazy loading if you need to optimize.",
+    fields: [
+      {
+        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).",
+      },
+      {
+        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.',
+      },
+    ],
+  },
+  {
+    id: "monster_list",
+    label: "Pokemon GraphQL (pokemon index)",
+    description:
+      "Pokemon list from GraphQL Pokemon `getAllPokemon` (loaded every request).",
+    resolution:
+      "Fetched on every request, independent of SWAPI/person id preview settings. Uses `getAllPokemon(take, offset)`.",
+    fields: [
+      {
+        path: "items",
+        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.",
+      },
+    ],
+  },
+  {
+    id: "article",
+    label: "Content Publisher (article)",
+    description:
+      "Single Content Publisher article resolved from query/preview/route params.",
+    resolution:
+      "Resolved from `?article=...`, `?articleId=...`, `?slug=...`, then `?id=...`; then preview params; then route params (`:article`, `:articleId`, `:slug`, `:id`). Loaded using `PCCConvenienceFunctions.getArticleBySlugOrId` from `@pantheon-systems/cpub-react-sdk/server`.",
+    fields: [
+      { path: "id", description: "Article identifier." },
+      { path: "title", description: "Article title." },
+      { path: "slug", description: "Slug/path alias if present." },
+      {
+        path: "body",
+        description: "Body/content payload (shape depends on API).",
+      },
+      { path: "url", description: "Canonical article URL if present." },
+    ],
+  },
+  {
+    id: "article_list",
+    label: "Content Publisher (articles index)",
+    description:
+      "Article list from Content Publisher, loaded every request for list rendering.",
+    resolution:
+      "Fetched every request using `PCCConvenienceFunctions.getPaginatedArticles` from `@pantheon-systems/cpub-react-sdk/server`.",
+    fields: [
+      {
+        path: "items",
+        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." },
+    ],
+  },
+];

package/template/lib/swapi.ts

@@ -0,0 +1,75 @@
+import type {
+  RemoteDatasourceFetcher,
+  RemoteDatasourceFetcherParams,
+} from "@pantheon-systems/puck-css/server";
+import { getFirstValue, savedValue } from "./fetcher-helpers";
+
+const SWAPI_BASE = "https://swapi.info/api";
+
+function swapiPersonIdFromUrl(url: unknown): string | undefined {
+  if (typeof url !== "string") return undefined;
+  const m = url.match(/\/people\/(\d+)\/?$/);
+  return m?.[1];
+}
+
+function resolveSwapiId(params: RemoteDatasourceFetcherParams): string | undefined {
+  const { searchParams, urlParams, savedPreviewParams } = params;
+  const idFromQuery = getFirstValue(searchParams, "id");
+  const idSavedRaw = savedValue(savedPreviewParams, "id");
+  const idFromSaved = idSavedRaw && /^\d+$/.test(idSavedRaw) ? idSavedRaw : undefined;
+  const idFromPath = urlParams.id && /^\d+$/.test(urlParams.id) ? urlParams.id : undefined;
+  return idFromQuery ?? idFromSaved ?? idFromPath;
+}
+
+async function fetchSwapiPerson(
+  id: string | undefined,
+  fetchImpl: typeof fetch,
+): Promise<Record<string, unknown>> {
+  if (!id || !/^\d+$/.test(id)) return {};
+  try {
+    const res = await fetchImpl(`${SWAPI_BASE}/people/${id}`);
+    if (!res.ok) return {};
+    const json: unknown = await res.json();
+    if (json && typeof json === "object" && !Array.isArray(json)) {
+      return json as Record<string, unknown>;
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
+
+async function fetchSwapiPeopleList(
+  fetchImpl: typeof fetch,
+): Promise<Array<{ id: string; name: string; url?: string }>> {
+  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 }> = [];
+    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 });
+    }
+    return out;
+  } catch {
+    return [];
+  }
+}
+
+export const SWAPI_FETCHERS: RemoteDatasourceFetcher[] = [
+  {
+    id: "swapi",
+    fetch: async (params) => fetchSwapiPerson(resolveSwapiId(params), params.fetchImpl),
+  },
+  {
+    id: "swapi_list",
+    fetch: async (params) => ({ items: await fetchSwapiPeopleList(params.fetchImpl) }),
+  },
+];

package/template/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/template/next.config.mjs

@@ -0,0 +1,13 @@
+export default {
+  reactStrictMode: true,
+  experimental: {
+    staleTimes: {
+      dynamic: 0,
+    },
+  },
+  transpilePackages: [
+    "@pantheon-systems/css-client",
+    "@pantheon-systems/puck-css",
+    "@pantheon-systems/p1-next-sdk",
+  ],
+};

package/template/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "PLACEHOLDER_PROJECT_NAME",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "test": "vitest run",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@pantheon-systems/cpub-react-sdk": "^5.2.1",
+    "@pantheon-systems/css-client": "^0.4.0",
+    "@pantheon-systems/p1-next-sdk": "^0.1.0",
+    "@pantheon-systems/puck-css": "^0.4.0",
+    "@puckeditor/core": "^0.21.1",
+    "@tailwindcss/postcss": "^4.2.2",
+    "classnames": "^2.5.1",
+    "next": "^16.2.6",
+    "postcss": "^8.5.12",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-markdown": "^10.1.0",
+    "tailwindcss": "^4.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.30",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "eslint": "^9.27.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.5",
+    "@eslint/js": "^9.27.0",
+    "typescript-eslint": "^8.32.1",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-import": "^2.31.0",
+    "globals": "^16.1.0"
+  }
+}

package/template/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template/public/sw.js

@@ -0,0 +1,8 @@
+/* Minimal no-op service worker to prevent /sw.js 404 noise. */
+self.addEventListener("install", () => {
+  self.skipWaiting();
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(self.clients.claim());
+});

package/template/puck.config.tsx

@@ -0,0 +1,51 @@
+import type { Config } from "@puckeditor/core";
+
+import { buttonBlock } from "./components/puck/button-block";
+import { dividerBlock } from "./components/puck/divider-block";
+import { headingBlock } from "./components/puck/heading-block";
+import { imageBlock } from "./components/puck/image-block";
+import { gridBlock } from "./components/puck/grid-block";
+import { listBlock } from "./components/puck/list-block";
+import { paragraphBlock } from "./components/puck/paragraph-block";
+import { quoteBlock } from "./components/puck/quote-block";
+import { puckRoot } from "./components/puck/root";
+import { spacerBlock } from "./components/puck/spacer-block";
+
+export const config = {
+  categories: {
+    typography: {
+      title: "Typography",
+      components: ["HeadingBlock", "ParagraphBlock", "QuoteBlock", "ListBlock"],
+    },
+    media: {
+      title: "Media",
+      components: ["ImageBlock"],
+    },
+    data: {
+      title: "Data",
+      components: ["GridBlock"],
+    },
+    layout: {
+      title: "Layout",
+      components: ["DividerBlock", "SpacerBlock"],
+    },
+    actions: {
+      title: "Actions",
+      components: ["ButtonBlock"],
+    },
+  },
+  root: puckRoot,
+  components: {
+    HeadingBlock: headingBlock,
+    ParagraphBlock: paragraphBlock,
+    ImageBlock: imageBlock,
+    GridBlock: gridBlock,
+    QuoteBlock: quoteBlock,
+    ListBlock: listBlock,
+    DividerBlock: dividerBlock,
+    SpacerBlock: spacerBlock,
+    ButtonBlock: buttonBlock,
+  },
+} as Config;
+
+export default config;

package/template/tsconfig/base.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Default",
+  "compilerOptions": {
+    "composite": false,
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": false,
+    "isolatedModules": true,
+    "moduleResolution": "node",
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "preserveWatchOutput": true,
+    "skipLibCheck": true,
+    "strict": true
+  },
+  "exclude": ["node_modules"]
+}

package/template/tsconfig/nextjs.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Next.js",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "plugins": [{ "name": "next" }],
+    "allowJs": true,
+    "declaration": false,
+    "declarationMap": false,
+    "incremental": true,
+    "jsx": "preserve",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "module": "esnext",
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "strict": false,
+    "target": "es5"
+  },
+  "include": ["src", "next-env.d.ts"],
+  "exclude": ["node_modules"]
+}

package/template/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig/nextjs.json",
+  "compilerOptions": {
+    "plugins": [{ "name": "next" }],
+    "moduleResolution": "bundler",
+    "module": "esnext",
+    "typeRoots": ["./node_modules/@types"],
+    "paths": {
+      "react": ["./node_modules/@types/react"],
+      "react-dom": ["./node_modules/@types/react-dom"],
+      "react/jsx-runtime": ["./node_modules/@types/react/jsx-runtime"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/template/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+  },
+});