fimo 0.4.1-staging.2 → 0.5.0-experimental.1

package/assets/content-templates/hooks-template.eta

@@ -9,8 +9,11 @@
  */
 %>
 // AUTO-GENERATED ⚠️ – do not edit by hand
-import { useSuspenseQuery, useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { FimoString, FimoMedia, FimoBoolean, FimoRichText, useLocale } from "fimo/ui";
+import { <% if (!model.isSingleton) { %>useInfiniteQuery, <% } %>useSuspenseQuery, useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+<% if (!model.isSingleton) { -%>
+import type { InfiniteData, UseInfiniteQueryResult, UseQueryResult } from "@tanstack/react-query";
+<% } -%>
+import { FimoString, FimoMedia, FimoBoolean, FimoRichText, useLocale<% if (!model.isSingleton) { %>, parseCollectionResponse<% } %> } from "fimo/ui";
 // @ts-ignore - virtual module provided by Fimo's Vite plugin
 import fimoConfig from "virtual:fimo-config";
 import type { <%= model.pascal %>, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Result<% if (!model.isSingleton) { %>, <%= model.pascal %>Fields, <%= model.pascal %>Query<% } %> } from "./<%= model.pascal %>.types";
@@ -215,6 +218,37 @@ function splitWritePayload(payload: Partial<<%= model.pascal %>Input>): Record<s
 }
 
 <% if (!model.isSingleton) { -%>
+export interface CollectionPageInfo {
+  readonly limit: number;
+  readonly offset: number;
+  readonly total: number;
+  readonly hasMore: boolean;
+  readonly nextOffset: number | null;
+}
+
+export interface CollectionPage<TItem> {
+  readonly items: TItem[];
+  readonly pageInfo: CollectionPageInfo;
+}
+
+export type InfiniteListQuery<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+> = Omit<<%= model.pascal %>Query<TFields, TPopulate>, "offset">;
+
+export type InfiniteListResult<TItem> = UseInfiniteQueryResult<
+  InfiniteData<CollectionPage<TItem>>,
+  Error
+> & {
+  readonly items: TItem[];
+  readonly total: number;
+  readonly hasMore: boolean;
+  readonly loadMore: () => ReturnType<
+    UseInfiniteQueryResult<InfiniteData<CollectionPage<TItem>>, Error>["fetchNextPage"]
+  >;
+  readonly isLoadingMore: boolean;
+};
+
 export async function getById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(
   id: string,
   options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}
@@ -282,15 +316,30 @@ function toQueryString<
   return query.toString();
 }
 
-export async function get<
+export async function list<
   TFields extends <%= model.pascal %>Fields | undefined = undefined,
   TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): Promise<<%= model.pascal %>Result<TFields, TPopulate>[]> {
+>(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): Promise<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>> {
   const qs = toQueryString(params);
   const res = await fetch(`${base}/entries/<%= model.uid %>${qs ? "?" + qs : ""}`, { headers: fimoHeaders() });
   if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return data.data.map(wrapWithSource) as <%= model.pascal %>Result<TFields, TPopulate>[];
+  const data = parseCollectionResponse(await res.json());
+  const items = data.data.map(wrapWithSource) as <%= model.pascal %>Result<TFields, TPopulate>[];
+  const pageInfo: CollectionPageInfo = {
+    limit: data.meta.limit,
+    offset: data.meta.offset,
+    total: data.meta.total,
+    hasMore: data.meta.hasMore,
+    nextOffset: data.meta.hasMore ? data.meta.offset + data.meta.limit : null,
+  };
+  return { items, pageInfo };
+}
+
+export async function get<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+>(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): Promise<<%= model.pascal %>Result<TFields, TPopulate>[]> {
+  return (await list(params)).items;
 }
 
 export async function create(payload: <%= model.pascal %>Input): Promise<<%= model.pascal %>> {
@@ -353,7 +402,11 @@ const qk = {
   byId       : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", id, options.locale, options.populate] as const,
   bySlug     : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(slug: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", "slug", slug, options.locale, options.populate] as const,
   byField    : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(field: string, value: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", field, value, options.locale, options.populate] as const,
-  list       : (params: <%= model.pascal %>Query) => ["<%= model.pascal %>", params] as const
+  list       : (params: <%= model.pascal %>Query) => ["<%= model.pascal %>", params] as const,
+  infiniteList: <
+    TFields extends <%= model.pascal %>Fields | undefined = undefined,
+    TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+  >(params: InfiniteListQuery<TFields, TPopulate>) => ["<%= model.pascal %>", "infinite", params] as const
 };
 
 export function useGetById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
@@ -380,7 +433,46 @@ export function useGet<
 >(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>) {
   const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
   const localizedParams = { ...params, locale };
-  return useQuery<<%= model.pascal %>Result<TFields, TPopulate>[], Error>({ queryKey: qk.list(localizedParams), queryFn: () => get(localizedParams) });
+  return useQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error, <%= model.pascal %>Result<TFields, TPopulate>[]>({
+    queryKey: qk.list(localizedParams),
+    queryFn: () => list(localizedParams),
+    select: (page) => page.items,
+  });
+}
+
+export function useList<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+>(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): UseQueryResult<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error> {
+  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
+  const localizedParams = { ...params, locale };
+  return useQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error>({
+    queryKey: qk.list(localizedParams),
+    queryFn: () => list(localizedParams),
+  });
+}
+
+export function useInfiniteList<
+  TFields extends <%= model.pascal %>Fields | undefined = undefined,
+  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
+>(params: InfiniteListQuery<TFields, TPopulate> = {} as InfiniteListQuery<TFields, TPopulate>): InfiniteListResult<<%= model.pascal %>Result<TFields, TPopulate>> {
+  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
+  const localizedParams = { ...params, locale };
+  const query = useInfiniteQuery({
+    queryKey: qk.infiniteList(localizedParams),
+    queryFn: ({ pageParam }) => list({ ...localizedParams, offset: pageParam }),
+    initialPageParam: 0,
+    getNextPageParam: (lastPage) => lastPage.pageInfo.nextOffset ?? undefined,
+  });
+
+  return {
+    ...query,
+    items: query.data?.pages.flatMap((page) => page.items) ?? [],
+    total: query.data?.pages[0]?.pageInfo.total ?? 0,
+    hasMore: query.hasNextPage,
+    loadMore: () => query.fetchNextPage(),
+    isLoadingMore: query.isFetchingNextPage,
+  };
 }
 
 export function useSuspenseGetById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
@@ -407,7 +499,11 @@ export function useSuspenseGet<
 >(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>) {
   const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
   const localizedParams = { ...params, locale };
-  return useSuspenseQuery<<%= model.pascal %>Result<TFields, TPopulate>[], Error>({ queryKey: qk.list(localizedParams), queryFn: () => get(localizedParams) });
+  return useSuspenseQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error, <%= model.pascal %>Result<TFields, TPopulate>[]>({
+    queryKey: qk.list(localizedParams),
+    queryFn: () => list(localizedParams),
+    select: (page) => page.items,
+  });
 }
 
 export function useCreate() {
@@ -476,6 +572,7 @@ export default {
   getById,
   getBySlug,
   getByField,
+  list,
   get,
   create,
   update,
@@ -485,6 +582,8 @@ export default {
   useGetById,
   useGetBySlug,
   useGetByField,
+  useList,
+  useInfiniteList,
   useGet,
   useSuspenseGetById,
   useSuspenseGet,

package/assets/skills/fimo/SKILL.md

@@ -20,7 +20,7 @@ For CLI commands and workflows (creating a project, pushing schemas/forms, deplo
 
 This is the load-bearing rule for every code change. **Fimo's whole point is that content editors edit content in the dashboard, not in code.** Anything hardcoded breaks that.
 
-- **Content** (posts, products, pages, lists, anything structured) → declare a schema, render with the generated `useGet()` hook + `fimo/ui` components. **Never** write `const posts = [...]` in JSX.
+- **Content** (posts, products, pages, lists, anything structured) → declare a schema, render collections with generated `useList()` or `useInfiniteList()` hooks + `fimo/ui` components. Use `useGet()` only for legacy fixed array queries. **Never** write `const posts = [...]` in JSX.
 - **Strings** (labels, CTAs, headings, descriptions, any visible text) → wrap in `t('key')` and create the default-locale value with `fimo labels set`. Use `--locale <locale>` only when intentionally writing a non-default locale. **Never** write `<h1>Welcome</h1>` directly — write `<Text value={t('home.title')} as="h1" />`.
 - **Media** (images, videos, files) → use `<Image>` / `<Video>` from `fimo/ui` for schema media, `<StaticImage>` for hard-coded URLs. **Never** use `<img src={...}>`.
 - **Forms** → use the generated Zod schema + `submitX` helper from `@/forms/<name>`. Never hand-roll fetch or validation.

package/assets/skills/fimo/references/content.md

@@ -250,6 +250,7 @@ Filtering on polymorphic fields is not supported yet.
 getById<TPopulate extends BlogPostPopulate | undefined>(id: string, options?: { populate?: TPopulate }): Promise<BlogPostResult<undefined, TPopulate>>
 getBySlug<TPopulate extends BlogPostPopulate | undefined>(slug: string, options?: { populate?: TPopulate }): Promise<BlogPostResult<undefined, TPopulate> | null>
 getByField<TPopulate extends BlogPostPopulate | undefined>(fieldName: string, value: string, options?: { populate?: TPopulate }): Promise<BlogPostResult<undefined, TPopulate> | null>
+list<TFields extends BlogPostFields | undefined, TPopulate extends BlogPostPopulate | undefined>(params?: BlogPostQuery<TFields, TPopulate>): Promise<CollectionPage<BlogPostResult<TFields, TPopulate>>>
 get<TFields extends BlogPostFields | undefined, TPopulate extends BlogPostPopulate | undefined>(params?: BlogPostQuery<TFields, TPopulate>): Promise<BlogPostResult<TFields, TPopulate>[]>
 create(payload: BlogPostInput): Promise<BlogPost>
 update(id: string, payload: Partial<BlogPostInput>): Promise<BlogPost>
@@ -259,7 +260,9 @@ remove(id: string): Promise<void>
 useGetById(id, { populate? })     // → { data: BlogPostResult<undefined, TPopulate> | undefined, isLoading, ... }
 useGetBySlug(slug, { populate? }) // → { data: BlogPostResult<undefined, TPopulate> | null | undefined, ... } — ideal for /:slug detail routes
 useGetByField(fieldName, value, { populate? })
-useGet<TFields, TPopulate>(params?) // → { data: BlogPostResult<TFields, TPopulate>[] | undefined, isLoading, ... }
+useList<TFields, TPopulate>(params?)         // → { data: CollectionPage<BlogPostResult<TFields, TPopulate>> | undefined, ... }
+useInfiniteList<TFields, TPopulate>(params?) // → { items, total, hasMore, loadMore, isLoadingMore, ... }
+useGet<TFields, TPopulate>(params?)          // → legacy array-shaped { data: BlogPostResult<TFields, TPopulate>[] | undefined, ... }
 useCreate() / useUpdate() / useRemove()
 
 // Suspense variants (same signatures, throw to a <Suspense> boundary instead of returning isLoading)
@@ -278,12 +281,37 @@ useGet(options?) / useSuspenseGet(options?) / useUpdate()
 
 Singleton clients do not expose `create`, `remove`, `getById`, or list queries. Localized singletons have one variant per locale; non-localized singletons have one locale-free row.
 
-Access pattern — the hooks **unwrap** the API envelope, so `get()` / `useGet()` resolve to a `BlogPost[]` directly (not a `{ data, meta }` wrapper):
+Choose the collection interface from the UI behavior. Use `useList` when the UI controls a page, and read pagination state from `pageInfo`:
 
 ```tsx
-const { data: posts, isLoading } = useGet({ where: { featured: true }, sort: '-publishedAt', limit: 10 });
-if (isLoading || !posts) return null;
-posts.map((post) => /* ... */); // BlogPost[]
+const { data: page, isLoading } = BlogPost.useList({ sort: '-publishedAt', limit: 12, offset: 24 });
+if (isLoading || !page) return null;
+
+page.items.map((post) => /* ... */);
+page.pageInfo; // { limit, offset, total, hasMore, nextOffset }
+```
+
+Use `useInfiniteList` for load-more and infinite-scroll views. It accumulates pages and exposes one typed `items` array, so UI code does not manage offsets or flatten pages:
+
+```tsx
+const {
+  items: posts,
+  hasMore,
+  loadMore,
+  isLoadingMore,
+} = BlogPost.useInfiniteList({
+  sort: '-publishedAt',
+  limit: 12,
+});
+```
+
+`get()` and `useGet()` remain available as legacy array-shaped helpers for small, deliberately bounded subsets:
+
+```tsx
+const { data: featured = [] } = BlogPost.useGet({
+  where: { featured: true },
+  limit: 3,
+});
 ```
 
 Query params supported: `limit` (1-100, default 20), `offset` (default 0), `search`, `sort`, `where`, `fields`, and `populate`. Use these canonical names in new code.
@@ -350,7 +378,7 @@ Do not type populated hook data as `BlogPost[]`: plain `BlogPost` keeps referenc
 
 Populate is depth-one. It only works for reference fields; trying to populate a scalar field returns 400. To-many reference order is preserved.
 
-The generated hooks do **not** surface pagination meta (`total`, `hasMore`, `limit`, `offset`). If you need it, read it from a raw fetch to `/entries/<typeName>` (see the **Read path** section below), which returns the full `{ data, meta }` envelope.
+`list()` and `useList()` surface pagination metadata as `pageInfo`. `useInfiniteList()` consumes `nextOffset` internally and exposes `hasMore` plus `loadMore()`.
 
 ## Fimo primitives (what the field values are)
 
@@ -397,15 +425,15 @@ class FimoBoolean {
 ## UI code pattern
 
 ```tsx
-import { useGet } from '@/schemas/BlogPost';
+import { useList } from '@/schemas/BlogPost';
 import { Text, RichText, Image, Date } from 'fimo/ui';
 
 export function BlogList() {
-  const { data: posts, isLoading } = useGet({ limit: 10 });
-  if (isLoading || !posts) return null;
+  const { data: page, isLoading } = useList({ limit: 10 });
+  if (isLoading || !page) return null;
   return (
     <ul>
-      {posts.map((post) => (
+      {page.items.map((post) => (
         <li key={post.id}>
           <Text value={post.title} as="h2" />
           <Image value={post.coverImage} width={800} height={400} fit="cover" />
@@ -429,7 +457,7 @@ const { data, meta } = await res.json();
 // meta: { limit, offset, total, hasMore }
 ```
 
-Prefer the generated React Query hooks from `@/schemas/{Uid}` over hand-rolled fetch — they handle caching and types (returning typed `BlogPostResult<TFields, TPopulate>[]` results). Reach for this raw fetch only when you need the pagination `meta`, which the hooks don't surface.
+Prefer the generated `useList` or `useInfiniteList` hooks from `@/schemas/{Uid}` over hand-rolled fetches. They preserve projected/populated item types, cache results, and expose the pagination state regular list UIs need. Use the raw endpoint only for lower-level integrations outside the generated client.
 
 ## Forms vs. schemas
 

package/dist/cli/bundle.json

@@ -1,8 +1,8 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-07-14T09:02:26.429Z",
-  "cliVersion": "0.4.1",
+  "bundledAt": "2026-07-14T07:07:58.432Z",
+  "cliVersion": "0.4.0",
   "external": [
     "oxc-parser",
     "fsevents"

package/dist/runtime/content/parseCollectionResponse.d.ts

@@ -0,0 +1,11 @@
+export interface CollectionResponse {
+    readonly data: Record<string, unknown>[];
+    readonly meta: {
+        readonly limit: number;
+        readonly offset: number;
+        readonly total: number;
+        readonly hasMore: boolean;
+    };
+}
+export declare function parseCollectionResponse(value: unknown): CollectionResponse;
+//# sourceMappingURL=parseCollectionResponse.d.ts.map

package/dist/runtime/content/parseCollectionResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCollectionResponse.d.ts","sourceRoot":"","sources":["../../../src/runtime/content/parseCollectionResponse.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAE1E"}

package/dist/runtime/content/parseCollectionResponse.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+const collectionResponseSchema = z.object({
+    data: z.array(z.record(z.string(), z.unknown())),
+    meta: z.object({
+        limit: z.number().int().positive(),
+        offset: z.number().int().nonnegative(),
+        total: z.number().int().nonnegative(),
+        hasMore: z.boolean(),
+    }),
+});
+export function parseCollectionResponse(value) {
+    return collectionResponseSchema.parse(value);
+}

package/dist/runtime/content/parseCollectionResponse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parseCollectionResponse.test.d.ts.map

package/dist/runtime/content/parseCollectionResponse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCollectionResponse.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/content/parseCollectionResponse.test.ts"],"names":[],"mappings":""}

package/dist/runtime/content/parseCollectionResponse.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { parseCollectionResponse } from './parseCollectionResponse.js';
+describe('parseCollectionResponse', () => {
+    it('accepts the collection envelope used by generated clients', () => {
+        const response = parseCollectionResponse({
+            data: [{ id: 'post-1', title: 'Hello' }],
+            meta: { limit: 12, offset: 24, total: 40, hasMore: true },
+        });
+        expect(response).toEqual({
+            data: [{ id: 'post-1', title: 'Hello' }],
+            meta: { limit: 12, offset: 24, total: 40, hasMore: true },
+        });
+    });
+    it('rejects invalid pagination metadata', () => {
+        expect(() => parseCollectionResponse({
+            data: [],
+            meta: { limit: 0, offset: -1, total: '40', hasMore: 'yes' },
+        })).toThrow();
+    });
+});

package/dist/runtime/index.d.ts

@@ -6,6 +6,8 @@ export type { FimoLocaleContextValue } from './i18n/FimoLocaleContext.js';
 export type { FimoLocaleResolution } from './i18n/locale.js';
 export { DataSourcesProvider } from './content/DataSourcesProvider.js';
 export { RefreshContentProvider } from './content/RefreshContentProvider.js';
+export { parseCollectionResponse } from './content/parseCollectionResponse.js';
+export type { CollectionResponse } from './content/parseCollectionResponse.js';
 export { AppErrorBoundary } from './core/AppErrorBoundary.js';
 export { ViteLifecycles } from './core/ViteLifecycles.js';
 export { Pageview } from './t/Pageview.js';

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,cAAc,uBAAuB,CAAC"}

package/dist/runtime/index.js

@@ -5,6 +5,7 @@ export { localizeFimoPath, resolveFimoLocale } from './i18n/locale.js';
 // Content
 export { DataSourcesProvider } from './content/DataSourcesProvider.js';
 export { RefreshContentProvider } from './content/RefreshContentProvider.js';
+export { parseCollectionResponse } from './content/parseCollectionResponse.js';
 // Core
 export { AppErrorBoundary } from './core/AppErrorBoundary.js';
 export { ViteLifecycles } from './core/ViteLifecycles.js';

package/dist/scripts/generated-types.test.js

@@ -75,6 +75,7 @@ const SCHEMAS = {
 };
 const USAGE = `// Agent-style usage of the generated types — compile-time contract.
 import type { PageResult, PageWhere } from "./Page";
+import Post from "./Post";
 import type { PostResult } from "./Post";
 
 export function renderFeatured(page: PageResult<undefined, readonly ["featured", "hero"]>): string[] {
@@ -112,6 +113,45 @@ export function whereContract(): PageWhere {
     featured: "some-document-id",
   };
 }
+
+export function paginatedPostContract(): void {
+  const legacy = Post.useGet({ limit: 3 });
+  const page = Post.useList({
+    fields: ["title", "author"] as const,
+    populate: ["author"] as const,
+    limit: 12,
+    offset: 24,
+  });
+  const infinite = Post.useInfiniteList({
+    fields: ["title", "author"] as const,
+    populate: ["author"] as const,
+    limit: 12,
+  });
+
+  const legacyPosts: PostResult[] = legacy.data ?? [];
+  const pagePosts: PostResult<readonly ["title", "author"], readonly ["author"]>[] = page.data?.items ?? [];
+  const total: number = page.data?.pageInfo.total ?? 0;
+  const nextOffset: number | null = page.data?.pageInfo.nextOffset ?? null;
+  const infinitePosts: PostResult<readonly ["title", "author"], readonly ["author"]>[] = infinite.items;
+  const firstAuthorName: string = infinitePosts[0]?.author ? String(infinitePosts[0].author.name) : "";
+  const hasMore: boolean = infinite.hasMore;
+  const isLoadingMore: boolean = infinite.isLoadingMore;
+
+  void infinite.loadMore();
+  // @ts-expect-error infinite lists own offset progression
+  Post.useInfiniteList({ offset: 12 });
+
+  void [legacyPosts, pagePosts, total, nextOffset, infinitePosts, firstAuthorName, hasMore, isLoadingMore];
+}
+
+export async function paginatedPostFetchContract(): Promise<void> {
+  const page = await Post.list({ limit: 12, offset: 24 });
+  const legacyPosts: PostResult[] = await Post.get({ limit: 3 });
+  const pagePosts: PostResult[] = page.items;
+  const hasMore: boolean = page.pageInfo.hasMore;
+
+  void [legacyPosts, pagePosts, hasMore];
+}
 `;
 const SHIMS = `declare module "virtual:fimo-config" {
   const config: Record<string, unknown>;

package/dist/scripts/sync-schemas.test.js

@@ -95,7 +95,7 @@ describe('syncSchemas', () => {
         expect(settings).toContain('const LOCALIZED_REFERENCE_FIELDS = new Set<string>(["homepage"]);');
         expect(settings).not.toContain('    locale: entry.locale,');
         expect(settings).toContain('readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale))');
-        expect(settings.match(/readLocale\(params, LOCALIZED_CONTENT, useQueryLocale\(params\.locale\)\)/g)?.length).toBe(2);
+        expect(settings.match(/readLocale\(params, LOCALIZED_CONTENT, useQueryLocale\(params\.locale\)\)/g)?.length).toBe(4);
         expect(settings.match(/readLocale\(options, false, useQueryLocale\(options\.locale\)\)/g)?.length).toBe(2);
     });
     it('generates singleton document APIs without collection mutations', () => {
@@ -115,6 +115,9 @@ describe('syncSchemas', () => {
         expect(settings).not.toContain('export async function create(');
         expect(settings).not.toContain('export async function remove(');
         expect(settings).not.toContain('export function useCreate(');
+        expect(settings).not.toContain('export function useList(');
+        expect(settings).not.toContain('export function useInfiniteList(');
+        expect(settings).not.toContain('useInfiniteQuery');
         expect(settingsTypes).toContain('siteName: string;');
         expect(settingsTypes).not.toContain('documentId?: string;');
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "0.4.1-staging.2",
+  "version": "0.5.0-experimental.1",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "bin": {
     "fimo": "dist/cli/index.js"

package/templates/react-router/package.json

@@ -21,7 +21,7 @@
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "0.4.1-staging.2",
+    "fimo": "0.5.0-experimental.1",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",