@takazudo/zfb 2.0.0 → 2.2.0

package/README.md

@@ -79,7 +79,10 @@ surface. Today it covers:
 
 The package is JSX-runtime-agnostic: the `Island` component does not
 import preact or react, so it works under either framework adapter
-without bundling the wrong runtime.
+without bundling the wrong runtime. `react` is listed as a peer
+dependency but is **optional** (`peerDependenciesMeta.react.optional`)
+— a preact/compat-only consumer does not need `react` installed and
+does not need `auto-install-peers=true`.
 
 ## Usage
 

package/dist/paginate.js

@@ -1,9 +1,11 @@
 // `zfb/paginate` — paginate an array of items into per-page route entries.
 //
-// Mirrors the shape of Astro's `paginate()` so the bundled basic-blog template can
-// emit one route per page from a `paths()` export. The renderer treats
-// each returned object as `{ params, props }`, the same convention used
-// elsewhere by the routing engine.
+// Mirrors the shape of Astro's `paginate()` so a `paths()` export can emit
+// one route per page. The renderer treats each returned object as
+// `{ params, props }`, the same convention used elsewhere by the routing
+// engine. The bundled basic-blog template ships no paginated route — it
+// links this API as a next step instead — so the docs page is the worked
+// example.
 /**
  * Slice `items` into pages of `opts.pageSize` and produce one route entry
  * per page. The `param` option names the dynamic segment to fill — for

package/dist/paginate.js.map

@@ -1 +1 @@
-{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../src/paginate.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,mFAAmF;AACnF,uEAAuE;AACvE,wEAAwE;AACxE,mCAAmC;AAoCnC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,IAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,UAAU,CAClB,mDAAmD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,SAAS,CACjB,mDAAmD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAuB;YAC3D,KAAK,EAAE;gBACL,IAAI,EAAE;oBACJ,IAAI,EAAE,KAAK;oBACX,IAAI;oBACJ,QAAQ;oBACR,QAAQ;oBACR,KAAK;iBACN;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["// `zfb/paginate` — paginate an array of items into per-page route entries.\n//\n// Mirrors the shape of Astro's `paginate()` so the bundled basic-blog template can\n// emit one route per page from a `paths()` export. The renderer treats\n// each returned object as `{ params, props }`, the same convention used\n// elsewhere by the routing engine.\n\n/** Options accepted by [`paginate`]. */\nexport type PaginateOptions<K extends string = string> = {\n  /** Items per page. Must be a positive integer (>= 1). */\n  pageSize: number;\n  /** Name of the dynamic param to fill (e.g. `\"page\"` for `[page].tsx`). */\n  param: K;\n};\n\n/** One page of paginated results. The shape consumed by the page component. */\nexport type PaginatedPage<T> = {\n  /** Items belonging to this page. */\n  data: T[];\n  /** 1-based page number. */\n  page: number;\n  /** Total number of pages (>= 1). */\n  lastPage: number;\n  /** Items per page (echoed for convenience). */\n  pageSize: number;\n  /** Total item count across all pages. */\n  total: number;\n};\n\n/**\n * Route entry returned by [`paginate`], one per page.\n *\n * The `K` generic carries the literal param name through, so consumers\n * accessing e.g. `route.params.page` get `string` rather than\n * `string | undefined` under `noUncheckedIndexedAccess`.\n */\nexport type PaginateRoute<T, K extends string = string> = {\n  params: Record<K, string>;\n  props: { page: PaginatedPage<T> };\n};\n\n/**\n * Slice `items` into pages of `opts.pageSize` and produce one route entry\n * per page. The `param` option names the dynamic segment to fill — for\n * `pages/blog/page/[page].tsx` pass `param: \"page\"`.\n *\n * Always emits at least one route. An empty input list yields a single\n * empty page so the index route still renders rather than 404ing.\n */\nexport function paginate<T, K extends string = string>(\n  items: readonly T[],\n  opts: PaginateOptions<K>,\n): PaginateRoute<T, K>[] {\n  if (!Number.isInteger(opts.pageSize) || opts.pageSize < 1) {\n    throw new RangeError(\n      `paginate: pageSize must be an integer >= 1, got ${String(opts.pageSize)}`,\n    );\n  }\n  if (typeof opts.param !== \"string\" || opts.param.length === 0) {\n    throw new TypeError(\n      `paginate: param must be a non-empty string, got ${JSON.stringify(opts.param)}`,\n    );\n  }\n  const pageSize = opts.pageSize;\n  const total = items.length;\n  const lastPage = Math.max(1, Math.ceil(total / pageSize));\n  const routes: PaginateRoute<T, K>[] = [];\n  for (let page = 1; page <= lastPage; page++) {\n    const start = (page - 1) * pageSize;\n    const slice = items.slice(start, start + pageSize);\n    routes.push({\n      params: { [opts.param]: String(page) } as Record<K, string>,\n      props: {\n        page: {\n          data: slice,\n          page,\n          lastPage,\n          pageSize,\n          total,\n        },\n      },\n    });\n  }\n  return routes;\n}\n"]}
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../src/paginate.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,2EAA2E;AAC3E,kEAAkE;AAClE,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,WAAW;AAoCX;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,IAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,UAAU,CAClB,mDAAmD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,SAAS,CACjB,mDAAmD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC1D,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAuB;YAC3D,KAAK,EAAE;gBACL,IAAI,EAAE;oBACJ,IAAI,EAAE,KAAK;oBACX,IAAI;oBACJ,QAAQ;oBACR,QAAQ;oBACR,KAAK;iBACN;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["// `zfb/paginate` — paginate an array of items into per-page route entries.\n//\n// Mirrors the shape of Astro's `paginate()` so a `paths()` export can emit\n// one route per page. The renderer treats each returned object as\n// `{ params, props }`, the same convention used elsewhere by the routing\n// engine. The bundled basic-blog template ships no paginated route — it\n// links this API as a next step instead — so the docs page is the worked\n// example.\n\n/** Options accepted by [`paginate`]. */\nexport type PaginateOptions<K extends string = string> = {\n  /** Items per page. Must be a positive integer (>= 1). */\n  pageSize: number;\n  /** Name of the dynamic param to fill (e.g. `\"page\"` for `[page].tsx`). */\n  param: K;\n};\n\n/** One page of paginated results. The shape consumed by the page component. */\nexport type PaginatedPage<T> = {\n  /** Items belonging to this page. */\n  data: T[];\n  /** 1-based page number. */\n  page: number;\n  /** Total number of pages (>= 1). */\n  lastPage: number;\n  /** Items per page (echoed for convenience). */\n  pageSize: number;\n  /** Total item count across all pages. */\n  total: number;\n};\n\n/**\n * Route entry returned by [`paginate`], one per page.\n *\n * The `K` generic carries the literal param name through, so consumers\n * accessing e.g. `route.params.page` get `string` rather than\n * `string | undefined` under `noUncheckedIndexedAccess`.\n */\nexport type PaginateRoute<T, K extends string = string> = {\n  params: Record<K, string>;\n  props: { page: PaginatedPage<T> };\n};\n\n/**\n * Slice `items` into pages of `opts.pageSize` and produce one route entry\n * per page. The `param` option names the dynamic segment to fill — for\n * `pages/blog/page/[page].tsx` pass `param: \"page\"`.\n *\n * Always emits at least one route. An empty input list yields a single\n * empty page so the index route still renders rather than 404ing.\n */\nexport function paginate<T, K extends string = string>(\n  items: readonly T[],\n  opts: PaginateOptions<K>,\n): PaginateRoute<T, K>[] {\n  if (!Number.isInteger(opts.pageSize) || opts.pageSize < 1) {\n    throw new RangeError(\n      `paginate: pageSize must be an integer >= 1, got ${String(opts.pageSize)}`,\n    );\n  }\n  if (typeof opts.param !== \"string\" || opts.param.length === 0) {\n    throw new TypeError(\n      `paginate: param must be a non-empty string, got ${JSON.stringify(opts.param)}`,\n    );\n  }\n  const pageSize = opts.pageSize;\n  const total = items.length;\n  const lastPage = Math.max(1, Math.ceil(total / pageSize));\n  const routes: PaginateRoute<T, K>[] = [];\n  for (let page = 1; page <= lastPage; page++) {\n    const start = (page - 1) * pageSize;\n    const slice = items.slice(start, start + pageSize);\n    routes.push({\n      params: { [opts.param]: String(page) } as Record<K, string>,\n      props: {\n        page: {\n          data: slice,\n          page,\n          lastPage,\n          pageSize,\n          total,\n        },\n      },\n    });\n  }\n  return routes;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zfb",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "private": false,
   "type": "module",
   "description": "Rust-built static-site engine for Astro and Next.js users — millisecond rebuilds, single binary. SDK with islands, content collections, pagination, and config helpers.",
@@ -74,11 +74,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@takazudo/zfb-darwin-arm64": "2.0.0",
-    "@takazudo/zfb-darwin-x64": "2.0.0",
-    "@takazudo/zfb-linux-arm64-gnu": "2.0.0",
-    "@takazudo/zfb-linux-x64-gnu": "2.0.0",
-    "@takazudo/zfb-win32-x64-msvc": "2.0.0"
+    "@takazudo/zfb-darwin-arm64": "2.2.0",
+    "@takazudo/zfb-darwin-x64": "2.2.0",
+    "@takazudo/zfb-linux-arm64-gnu": "2.2.0",
+    "@takazudo/zfb-linux-x64-gnu": "2.2.0",
+    "@takazudo/zfb-win32-x64-msvc": "2.2.0"
   },
   "publishConfig": {
     "access": "public"