@iris-ui-kit/react 0.1.0

package/dist/chunk-TO7YVSAI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/async/useAsyncResource.ts","../src/async/usePaginatedResource.ts"],"names":["React2"],"mappings":"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","file":"chunk-TO7YVSAI.js","sourcesContent":["import * as React from 'react'\nimport {\n  createAsyncResource,\n  type AsyncResource,\n  type AsyncResourceConfig,\n  type AsyncState,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UseAsyncResourceOptions<T> extends AsyncResourceConfig<T> {\n  /** Run `load()` (no params) once on mount. Default `false`. */\n  immediate?: boolean\n}\n\nexport interface UseAsyncResourceReturn<T, P extends unknown[]> extends AsyncState<T> {\n  isLoading: boolean\n  isError: boolean\n  load: AsyncResource<T, P>['load']\n  reload: AsyncResource<T, P>['reload']\n  mutate: AsyncResource<T, P>['mutate']\n  cancel: AsyncResource<T, P>['cancel']\n  reset: AsyncResource<T, P>['reset']\n}\n\n/**\n * React binding for the framework-agnostic async resource. Instantiates the\n * resource once and bridges it via `useSyncExternalStore`. The fetcher is read\n * through a ref each render so it never goes stale, while seeding/immediacy are\n * captured on first render.\n *\n * ```tsx\n * const users = useAsyncResource(() => api.listUsers(), { immediate: true })\n * <IrisTable data={users.data ?? []} loading={users.isLoading} error={users.isError} />\n * ```\n */\nexport function useAsyncResource<T, P extends unknown[] = []>(\n  fetcher: (...params: P) => Promise<T>,\n  options: UseAsyncResourceOptions<T> = {},\n): UseAsyncResourceReturn<T, P> {\n  const latest = React.useRef(fetcher)\n  latest.current = fetcher\n\n  const ref = React.useRef<AsyncResource<T, P> | null>(null)\n  if (ref.current === null) {\n    const config: AsyncResourceConfig<T> =\n      'initialData' in options ? { initialData: options.initialData } : {}\n    ref.current = createAsyncResource<T, P>((...params) => latest.current(...params), config)\n  }\n  const resource = ref.current\n  const state = useStore(resource.store)\n\n  const immediate = React.useRef(options.immediate ?? false)\n  React.useEffect(() => {\n    if (immediate.current) void resource.load(...([] as unknown as P))\n    // Abort any in-flight request on unmount so it can't write back into an\n    // unmounted component (the token guard already prevents the state write;\n    // this also cancels the underlying request when the fetcher honors signal).\n    return () => resource.cancel()\n  }, [resource])\n\n  return {\n    ...state,\n    isLoading: state.status === 'loading',\n    isError: state.status === 'error',\n    load: resource.load,\n    reload: resource.reload,\n    mutate: resource.mutate,\n    cancel: resource.cancel,\n    reset: resource.reset,\n  }\n}\n","import * as React from 'react'\nimport {\n  createPaginatedResource,\n  type PageQuery,\n  type PageResult,\n  type PaginatedResource,\n  type PaginatedState,\n  type PaginationMode,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UsePaginatedResourceOptions {\n  pageSize?: number\n  mode?: PaginationMode\n  /** Load the first page on mount (page 1, or `loadMore` in infinite mode). */\n  immediate?: boolean\n}\n\nexport interface UsePaginatedResourceReturn<T> extends PaginatedState<T> {\n  isLoading: boolean\n  isError: boolean\n  hasMore: boolean\n  goToPage: PaginatedResource<T>['goToPage']\n  loadMore: PaginatedResource<T>['loadMore']\n  refresh: PaginatedResource<T>['refresh']\n  setPageSize: PaginatedResource<T>['setPageSize']\n}\n\n/**\n * React binding for the server-side pagination resource. Instantiates once and\n * bridges via `useSyncExternalStore`; the fetcher is read through a ref so it\n * never goes stale.\n *\n * ```tsx\n * const p = usePaginatedResource((q) => api.rows(q), { pageSize: 25, immediate: true })\n * <IrisTable data={p.items} loading={p.isLoading} error={p.isError} />\n * <IrisPagination total={p.total ?? 0} value={p.page} onValueChange={p.goToPage} />\n * ```\n */\nexport function usePaginatedResource<T>(\n  fetcher: (query: PageQuery) => Promise<PageResult<T>>,\n  options: UsePaginatedResourceOptions = {},\n): UsePaginatedResourceReturn<T> {\n  const latest = React.useRef(fetcher)\n  latest.current = fetcher\n\n  const ref = React.useRef<PaginatedResource<T> | null>(null)\n  if (ref.current === null) {\n    ref.current = createPaginatedResource<T>((query) => latest.current(query), {\n      pageSize: options.pageSize,\n      mode: options.mode,\n    })\n  }\n  const resource = ref.current\n  const state = useStore(resource.store)\n\n  const initial = React.useRef({ immediate: options.immediate ?? false, mode: options.mode })\n  React.useEffect(() => {\n    if (!initial.current.immediate) return\n    void (initial.current.mode === 'infinite' ? resource.loadMore() : resource.goToPage(1))\n  }, [resource])\n\n  return {\n    ...state,\n    isLoading: state.status === 'loading',\n    isError: state.status === 'error',\n    // `state` drives the re-render; hasMore() then reads the fresh batch state.\n    hasMore: resource.hasMore(),\n    goToPage: resource.goToPage,\n    loadMore: resource.loadMore,\n    refresh: resource.refresh,\n    setPageSize: resource.setPageSize,\n  }\n}\n"]}

package/dist/chunk-TQ33XJIK.js

@@ -0,0 +1,22 @@
+'use client'
+import { useStore } from './chunk-RZNYIFV2.js';
+import * as React from 'react';
+import { createResourceController } from '@iris-ui-kit/core';
+export { createClientFetcher, createResourceController } from '@iris-ui-kit/core';
+
+function useResourceController(config) {
+  const ref = React.useRef(null);
+  if (ref.current === null) ref.current = createResourceController({ ...config, immediate: false });
+  const controller = ref.current;
+  const immediate = config.immediate !== false;
+  React.useEffect(() => {
+    if (immediate) void controller.load();
+    return () => controller.destroy();
+  }, [controller, immediate]);
+  const state = useStore(controller.store);
+  return React.useMemo(() => ({ ...controller, state }), [controller, state]);
+}
+
+export { useResourceController };
+//# sourceMappingURL=chunk-TQ33XJIK.js.map
+//# sourceMappingURL=chunk-TQ33XJIK.js.map

package/dist/chunk-TQ33XJIK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource/useResourceController.ts"],"names":[],"mappings":";;;;;;AAyBO,SAAS,sBACd,MAAA,EAC0B;AAC1B,EAAA,MAAM,GAAA,GAAY,aAAqC,IAAI,CAAA;AAC3D,EAAA,IAAI,GAAA,CAAI,OAAA,KAAY,IAAA,EAAM,GAAA,CAAI,OAAA,GAAU,wBAAA,CAAyB,EAAE,GAAG,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,CAAA;AAChG,EAAA,MAAM,aAAa,GAAA,CAAI,OAAA;AACvB,EAAA,MAAM,SAAA,GAAY,OAAO,SAAA,KAAc,KAAA;AAIvC,EAAM,gBAAU,MAAM;AACpB,IAAA,IAAI,SAAA,EAAW,KAAK,UAAA,CAAW,IAAA,EAAK;AACpC,IAAA,OAAO,MAAM,WAAW,OAAA,EAAQ;AAAA,EAClC,CAAA,EAAG,CAAC,UAAA,EAAY,SAAS,CAAC,CAAA;AAE1B,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,UAAA,CAAW,KAAK,CAAA;AACvC,EAAA,OAAa,KAAA,CAAA,OAAA,CAAQ,OAAO,EAAE,GAAG,UAAA,EAAY,OAAM,CAAA,EAAI,CAAC,UAAA,EAAY,KAAK,CAAC,CAAA;AAC5E","file":"chunk-TQ33XJIK.js","sourcesContent":["import * as React from 'react'\nimport {\n  createResourceController,\n  type ResourceController,\n  type ResourceControllerConfig,\n  type ResourceState,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UseResourceController<T> extends ResourceController<T> {\n  /** The live resource state (rows, total, page, loading, selectedKeys). */\n  state: ResourceState<T>\n}\n\n/**\n * React bridge over the framework-agnostic {@link createResourceController} (L4\n * CRUD list composite). Creates the controller once, subscribes to its store,\n * and returns the controller plus its live `state`. A thin bridge — all logic\n * lives in `@iris-ui-kit/core`.\n *\n * The controller is constructed with `immediate: false` so no fetch fires during\n * React's (side-effect-free) render phase; the initial load is kicked from an\n * effect instead, and the controller is torn down on unmount so an in-flight\n * request never writes back to an unmounted component.\n */\nexport function useResourceController<T>(\n  config: ResourceControllerConfig<T>,\n): UseResourceController<T> {\n  const ref = React.useRef<ResourceController<T> | null>(null)\n  if (ref.current === null) ref.current = createResourceController({ ...config, immediate: false })\n  const controller = ref.current\n  const immediate = config.immediate !== false\n\n  // Construct-once controller: load on mount (when immediate) + tear down on\n  // unmount. `immediate` is captured at mount; it is not a reactive dependency.\n  React.useEffect(() => {\n    if (immediate) void controller.load()\n    return () => controller.destroy()\n  }, [controller, immediate])\n\n  const state = useStore(controller.store)\n  return React.useMemo(() => ({ ...controller, state }), [controller, state])\n}\n"]}