@justanarthur/payload-www 0.3.5 → 1.2.0

package/package.json

@@ -1,108 +1,21 @@
 {
   "name": "@justanarthur/payload-www",
   "description": "Reusable Payload CMS website template — config builder, collections, globals, blocks, fields, access, hooks, metadata (JSON-LD, hreflang), page renderers, and test helpers.",
-  "version": "0.3.5",
+  "version": "1.2.0",
   "type": "module",
   "private": false,
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "bunup && node scripts/strip-createRequire.mjs",
-    "clean": "rm -rf dist .tsbuildinfo",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run clean && bun run build"
-  },
-  "dependencies": {
-    "@justanarthur/payload-imagehash-plugin": "3.2.3",
-    "@justanarthur/payload-plugin-seo": "1.3.11",
-    "@justanarthur/payload-plugin-translator": "1.3.21",
-    "@payloadcms/live-preview-react": "3.85.0",
-    "@payloadcms/richtext-lexical": "3.85.0",
-    "@payloadcms/next": "3.85.0",
-    "next": "16.2.6",
-    "next-intl": "^4.0.0",
-    "server-only": "0.0.1"
-  },
-  "devDependencies": {
-    "@types/node": "22.19.9",
-    "@types/react": "19.2.14",
-    "@types/react-dom": "19.2.3",
-    "bunup": "^0.16.32",
-    "payload": "3.85.0",
-    "react": "19.2.6",
-    "react-dom": "19.2.6",
-    "typescript": "5.7.3",
-    "vitest": "4.0.18"
-  },
-  "peerDependencies": {
-    "@payloadcms/live-preview-react": "^3.85.0",
-    "@payloadcms/next": "^3.85.0",
-    "@payloadcms/richtext-lexical": "^3.85.0",
-    "@payloadcms/translations": "^3.85.0",
-    "@payloadcms/ui": "^3.85.0",
-    "next": "^16.2.6",
-    "next-intl": "^4.0.0",
-    "payload": "^3.85.0",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6"
-  },
   "files": [
     "dist",
     "README.md"
   ],
+  "bin": {
+    "payload-www": "./dist/cli.js"
+  },
   "exports": {
-    "./data-seed": {
-      "import": {
-        "types": "./dist/data-seed.d.ts",
-        "default": "./dist/data-seed.js"
-      }
-    },
-    "./hooks": {
-      "import": {
-        "types": "./dist/hooks.d.ts",
-        "default": "./dist/hooks.js"
-      }
-    },
-    "./server": {
-      "import": {
-        "types": "./dist/server.d.ts",
-        "default": "./dist/server.js"
-      }
-    },
-    "./data-test": {
-      "import": {
-        "types": "./dist/data-test.d.ts",
-        "default": "./dist/data-test.js"
-      }
-    },
-    "./with-www-config": {
-      "import": {
-        "types": "./dist/with-www-config.d.ts",
-        "default": "./dist/with-www-config.js"
-      }
-    },
-    "./imagehash": {
-      "import": {
-        "types": "./dist/imagehash.d.ts",
-        "default": "./dist/imagehash.js"
-      }
-    },
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    },
-    "./fields": {
+    "./translator": {
       "import": {
-        "types": "./dist/fields.d.ts",
-        "default": "./dist/fields.js"
+        "types": "./dist/translator.d.ts",
+        "default": "./dist/translator.js"
       }
     },
     "./render-pages": {
@@ -111,18 +24,6 @@
         "default": "./dist/render-pages.js"
       }
     },
-    "./import-map-provider": {
-      "import": {
-        "types": "./dist/import-map-provider.d.ts",
-        "default": "./dist/import-map-provider.js"
-      }
-    },
-    "./core-access": {
-      "import": {
-        "types": "./dist/core-access.d.ts",
-        "default": "./dist/core-access.js"
-      }
-    },
     "./metadata": {
       "import": {
         "types": "./dist/metadata.d.ts",
@@ -135,52 +36,34 @@
         "default": "./dist/config.js"
       }
     },
-    "./render-utils": {
-      "import": {
-        "types": "./dist/render-utils.d.ts",
-        "default": "./dist/render-utils.js"
-      }
-    },
-    "./data-collections": {
-      "import": {
-        "types": "./dist/data-collections.d.ts",
-        "default": "./dist/data-collections.js"
-      }
-    },
-    "./seed": {
-      "import": {
-        "types": "./dist/seed.d.ts",
-        "default": "./dist/seed.js"
-      }
-    },
-    "./pages": {
+    "./imagehash": {
       "import": {
-        "types": "./dist/pages.d.ts",
-        "default": "./dist/pages.js"
+        "types": "./dist/imagehash.d.ts",
+        "default": "./dist/imagehash.js"
       }
     },
-    "./render-metadata": {
+    "./blocks": {
       "import": {
-        "types": "./dist/render-metadata.d.ts",
-        "default": "./dist/render-metadata.js"
+        "types": "./dist/blocks.d.ts",
+        "default": "./dist/blocks.js"
       }
     },
-    "./core-fields": {
+    "./collections": {
       "import": {
-        "types": "./dist/core-fields.d.ts",
-        "default": "./dist/core-fields.js"
+        "types": "./dist/collections.d.ts",
+        "default": "./dist/collections.js"
       }
     },
-    "./test": {
+    "./utils": {
       "import": {
-        "types": "./dist/test.d.ts",
-        "default": "./dist/test.js"
+        "types": "./dist/utils.d.ts",
+        "default": "./dist/utils.js"
       }
     },
-    "./render-components": {
+    "./pages": {
       "import": {
-        "types": "./dist/render-components.d.ts",
-        "default": "./dist/render-components.js"
+        "types": "./dist/pages.d.ts",
+        "default": "./dist/pages.js"
       }
     },
     "./access": {
@@ -189,56 +72,76 @@
         "default": "./dist/access.js"
       }
     },
-    "./globals": {
-      "import": {
-        "types": "./dist/globals.d.ts",
-        "default": "./dist/globals.js"
-      }
-    },
-    "./core-utils": {
-      "import": {
-        "types": "./dist/core-utils.d.ts",
-        "default": "./dist/core-utils.js"
-      }
-    },
-    "./translator": {
-      "import": {
-        "types": "./dist/translator.d.ts",
-        "default": "./dist/translator.js"
-      }
-    },
-    "./blocks": {
-      "import": {
-        "types": "./dist/blocks.d.ts",
-        "default": "./dist/blocks.js"
-      }
-    },
-    "./components": {
-      "import": {
-        "types": "./dist/components.d.ts",
-        "default": "./dist/components.js"
-      }
-    },
-    "./core-blocks": {
+    "./import-map-provider": {
       "import": {
-        "types": "./dist/core-blocks.d.ts",
-        "default": "./dist/core-blocks.js"
+        "types": "./dist/import-map-provider.d.ts",
+        "default": "./dist/import-map-provider.js"
       }
     },
-    "./collections": {
+    "./fields": {
       "import": {
-        "types": "./dist/collections.d.ts",
-        "default": "./dist/collections.js"
+        "types": "./dist/fields.d.ts",
+        "default": "./dist/fields.js"
       }
     },
-    "./utils": {
+    "./sitemap": {
       "import": {
-        "types": "./dist/utils.d.ts",
-        "default": "./dist/utils.js"
+        "types": "./dist/sitemap.d.ts",
+        "default": "./dist/sitemap.js"
       }
     },
     "./package.json": "./package.json"
   },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "NODE_ENV=production bunup && node scripts/strip-createRequire.mjs && bun run build:cli",
+    "build:lib": "NODE_ENV=production bunup",
+    "build:cli": "bun build src/cli/index.ts --target node --format esm --outfile dist/cli.js --external tsx --external 'tsx/esm/api'",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "dependencies": {
+    "@payloadcms/live-preview-react": "3.85.0",
+    "@payloadcms/plugin-mcp": "3.85.0",
+    "@payloadcms/richtext-lexical": "3.85.0",
+    "@payloadcms/next": "3.85.0",
+    "next": "16.2.6",
+    "next-intl": "^4.0.0",
+    "server-only": "0.0.1",
+    "tsx": "^4.19.2"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.9",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "bunup": "^0.16.32",
+    "payload": "3.85.1",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "typescript": "5.7.3",
+    "vitest": "4.0.18"
+  },
+  "peerDependencies": {
+    "@payloadcms/live-preview-react": "^3.85.0",
+    "@payloadcms/next": "^3.85.0",
+    "@payloadcms/richtext-lexical": "^3.85.0",
+    "@payloadcms/translations": "^3.85.0",
+    "@payloadcms/ui": "^3.85.0",
+    "next": "^16.2.6",
+    "next-intl": "^4.0.0",
+    "payload": "^3.85.0",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "@justanarthur/payload-plugin-seo": "^3.0.0",
+    "@justanarthur/payload-plugin-translator": "^3.0.0",
+    "@justanarthur/payload-imagehash-plugin": "^3.3.0"
+  },
   "properties": {
     "gitCommitScopeRelatedNames": "payload-www,render,revalidation,www",
     "priority": 1

package/dist/components.d.ts

@@ -1,6 +0,0 @@
-import { FC } from "react";
-type LivePreviewListenerProps = {
-	serverURL?: string;
-};
-declare const LivePreviewListener: FC<LivePreviewListenerProps>;
-export { LivePreviewListener as default, LivePreviewListenerProps, LivePreviewListener };

package/dist/components.js

@@ -1,39 +0,0 @@
-"use client";
-
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-
-// src/render/components/LivePreviewListener.tsx
-import { RefreshRouteOnSave as PayloadLivePreview } from "@payloadcms/live-preview-react";
-import { useRouter } from "next/navigation";
-import { jsx } from "react/jsx-runtime";
-
-var LivePreviewListener = ({ serverURL }) => {
-  const router = useRouter();
-  const url = serverURL ?? process.env.NEXT_PUBLIC_SERVER_URL ?? (typeof window !== "undefined" ? window.location.origin : "");
-  console.log("[WWW] render/components:LivePreviewListener serverURL=", url);
-  return /* @__PURE__ */ jsx(PayloadLivePreview, {
-    refresh: router.refresh,
-    serverURL: url
-  });
-};
-
-// src/exports/components.ts
-var components_default = LivePreviewListener;
-export {
-  components_default as default,
-  LivePreviewListener
-};

package/dist/core-access.d.ts

@@ -1,11 +0,0 @@
-import { Access } from "payload";
-declare const anyone: Access;
-declare const authenticated: Access;
-declare const authenticatedOrPublished: Access;
-import { Access as Access_wc6ft0 } from "payload";
-declare const _default: {
-	anyone: Access_wc6ft0;
-	authenticated: Access_wc6ft0;
-	authenticatedOrPublished: Access_wc6ft0;
-};
-export { _default as default, authenticatedOrPublished, authenticated, anyone };

package/dist/core-access.js

@@ -1,34 +0,0 @@
-
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-
-// src/core/access/index.ts
-var anyone = () => true;
-var authenticated = ({ req: { user } }) => Boolean(user);
-var authenticatedOrPublished = ({ req: { user } }) => {
-  if (user)
-    return true;
-  return { _status: { equals: "published" } };
-};
-
-// src/exports/core-access.ts
-var core_access_default = { anyone, authenticated, authenticatedOrPublished };
-export {
-  core_access_default as default,
-  authenticatedOrPublished,
-  authenticated,
-  anyone
-};

package/dist/core-blocks.d.ts

@@ -1,24 +0,0 @@
-import { FC } from "react";
-import { ImportMap, SanitizedConfig } from "payload";
-type RenderBlocksProps = {
-	blocks: Array<{
-		blockType: string;
-	} & Record<string, unknown>>;
-	blockProps?: Record<string, unknown>;
-	importMap: ImportMap;
-	config: SanitizedConfig;
-	locale: string;
-	searchParams?: Record<string, string | string[] | undefined>;
-};
-/**
-* Render a page's `blocks` array to React. Each block's render module
-* is resolved via Payload's generated importMap. The host registers
-* each block in the importMap with a key like `BlockCta#default` (use
-* `generateImportName('block', 'cta')` to build the key).
-*
-* Falls back gracefully: if a block's importMap path is missing or
-* the component is not registered, the block is skipped and a
-* `console.warn` is logged (in dev).
-*/
-declare const RenderBlocks: FC<RenderBlocksProps>;
-export { RenderBlocks as default, RenderBlocksProps, RenderBlocks };

package/dist/core-blocks.js

@@ -1,79 +0,0 @@
-
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-
-// src/core/utils/getFromImportMap.ts
-function getFromImportMap(key, importMap) {
-  return importMap[key.includes("#") ? key : key + "#default"];
-}
-
-// src/core/utils/generateImportName.ts
-function generateImportName(type, slug) {
-  switch (type) {
-    case "block":
-      return `Block${slug.replace(/(^\w|-\w)/g, (m) => m.replace("-", "").toUpperCase())}#default`;
-    case "page":
-      return `Page${slug.replace(/(^\w|-\w)/g, (m) => m.replace("-", "").toUpperCase())}#default`;
-    default:
-      throw new Error(`Unknown type: ${type}`);
-  }
-}
-
-// src/render/blocks/renderBlocks.tsx
-import { jsx, Fragment } from "react/jsx-runtime";
-var RenderBlocks = ({
-  blocks,
-  blockProps,
-  config,
-  importMap,
-  locale,
-  searchParams
-}) => {
-  if (!blocks || !Array.isArray(blocks) || blocks.length === 0) {
-    console.log("[WWW] render/blocks:RenderBlocks no blocks (locale=", locale, ")");
-    return null;
-  }
-  console.log("[WWW] render/blocks:RenderBlocks rendering count=", blocks.length, "locale=", locale);
-  const rendered = [];
-  for (let i = 0;i < blocks.length; i++) {
-    const block = blocks[i];
-    const { blockType } = block;
-    const importMapPath = config.admin?.dependencies?.[blockType]?.path ?? generateImportName("block", blockType);
-    const Block = getFromImportMap(importMapPath, importMap);
-    if (!Block) {
-      console.warn(`[WWW] render/blocks:RenderBlocks no block for type=${blockType} importMapPath=${importMapPath} (locale=${locale})`);
-      continue;
-    }
-    console.log("[WWW] render/blocks:RenderBlocks [", i, "] blockType=", blockType, "importMapPath=", importMapPath);
-    rendered.push(/* @__PURE__ */ jsx(Block, {
-      index: i,
-      ...blockProps,
-      ...block,
-      locale,
-      searchParams
-    }, i));
-  }
-  return /* @__PURE__ */ jsx(Fragment, {
-    children: rendered
-  });
-};
-
-// src/exports/core-blocks.ts
-var core_blocks_default = RenderBlocks;
-export {
-  core_blocks_default as default,
-  RenderBlocks
-};

package/dist/core-fields.d.ts

@@ -1,73 +0,0 @@
-import { Field, GroupField } from "payload";
-type LinkAppearances = "default" | "outline";
-declare const appearanceOptions: Record<LinkAppearances, {
-	label: string;
-	value: string;
-}>;
-type LinkOptions = {
-	appearances?: LinkAppearances[] | false;
-	disableLabel?: boolean;
-	/**
-	* Collection slugs the link can reference. Payload 3.85 rejects
-	* empty arrays, so the lib defaults to `['pages']` (its own Pages
-	* collection). Hosts that reference different collections pass
-	* their own list.
-	*/
-	relationTo?: string[];
-	/** Mark the text fields as `localized: true`. */
-	localized?: boolean;
-	/** Deep-merge into the resulting group. */
-	overrides?: Partial<GroupField>;
-	/** Legacy alias for the host's custom field overrides. */
-	linkOverrides?: Partial<GroupField>;
-	/**
-	* Extra fields appended to the link group — e.g. a `description`
-	* text field or a `navHover` group for a mega-menu. Lets hosts
-	* extend the nav link schema without re-implementing the whole
-	* `link` field. Appended after the standard type/label/appearance
-	* fields.
-	*/
-	extraFields?: Field[];
-};
-declare const link: (options?: LinkOptions) => Field;
-import { Field as Field2 } from "payload";
-declare const linkGroup: (options?: LinkOptions) => Field2;
-import { Field as Field3 } from "payload";
-type SlugFieldOptions = {
-	/** Field name. Default: `'slug'`. */
-	name?: string;
-	/**
-	* Allow the `_` nesting divider in the slug so `about_us` renders at
-	* `/about/us`. Relaxes validation and documents the convention in the
-	* admin UI. Pair with `createCollectionPageExports({ nested: true })`.
-	* Default: `false`.
-	*/
-	nested?: boolean;
-	/**
-	* Localize the slug — one slug per locale (`/about` in `en`, `/o-nas`
-	* in `sk`), stored in the collection's `_locales` table. This is the
-	* default: the lib's collections are multilingual, so per-locale slugs
-	* power localized URLs and hreflang alternates. Pass `false` for a
-	* single shared slug.
-	*/
-	localized?: boolean;
-};
-/**
-* The slug field shared by the lib's Pages / Posts collections: a
-* required, unique, indexed, sidebar text field, localized by default.
-*
-* The empty string is reserved for the home page (rendered at
-* `/${locale}`), so validation only rejects non-empty malformed values.
-*/
-declare const slugField: (options?: SlugFieldOptions) => Field3;
-import { Field as Field_14espm } from "payload";
-declare const _default: {
-	link: (options?: LinkOptions) => Field_14espm;
-	linkGroup: (options?: LinkOptions) => Field_14espm;
-	appearanceOptions: Record<LinkAppearances, {
-		label: string;
-		value: string;
-	}>;
-	slugField: (options?: SlugFieldOptions) => Field_14espm;
-};
-export { slugField, linkGroup, link, _default as default, appearanceOptions, SlugFieldOptions, LinkOptions, LinkAppearances };