@cfast/actions 0.3.0 → 0.3.1

package/dist/client.d.ts

@@ -32,6 +32,28 @@ declare function useActions<const TNames extends readonly string[]>(descriptor:
     [K in TNames[number]]: (input?: Serializable) => ActionHookResult;
 };
 
+/** Permission methods added to items with `_can`. */
+type CfastItemMethods = {
+    canRead: () => ActionHookResult;
+    canCreate: () => ActionHookResult;
+    canEdit: () => ActionHookResult;
+    canDelete: () => ActionHookResult;
+};
+/** An item with `_can` gets permission methods mixed in. */
+type CfastItem<T> = T & CfastItemMethods;
+/** A collection gets `canAdd()` plus each item gets permission methods. */
+type CfastCollection<T> = CfastItem<T>[] & {
+    canAdd: () => ActionHookResult;
+};
+/**
+ * Transforms a loader return type:
+ * - Arrays of objects with `_can` -> {@link CfastCollection}
+ * - Objects with `_can` -> {@link CfastItem}
+ * - Other values -> unchanged
+ */
+type CfastLoaderData<T> = {
+    [K in keyof T]: T[K] extends (infer U)[] ? U extends Record<string, unknown> ? CfastCollection<U> : T[K] : T[K] extends Record<string, unknown> ? CfastItem<T[K]> : T[K];
+};
 /**
  * Client hook that replaces `useLoaderData()` for routes using `cfastJson()`.
  *
@@ -62,7 +84,7 @@ declare function useActions<const TNames extends readonly string[]>(descriptor:
  * documents[0].canDelete()    // -> ActionHookResult
  * ```
  */
-declare function useCfastLoader<T extends (...args: any[]) => any = () => Record<string, unknown>>(): ReturnType<T> extends Promise<infer R> ? R : ReturnType<T>;
+declare function useCfastLoader<T extends (...args: any[]) => any = () => Record<string, unknown>>(): CfastLoaderData<ReturnType<T> extends Promise<infer R> ? R : ReturnType<T>>;
 
 type ActionFormProps = Omit<ComponentProps<typeof Form>, "children" | "action"> & {
     /** Object with `_action` key and input fields to inject as hidden inputs. */
@@ -89,4 +111,4 @@ type ActionFormProps = Omit<ComponentProps<typeof Form>, "children" | "action">
  */
 declare function ActionForm({ action, children, ...formProps }: ActionFormProps): react_jsx_runtime.JSX.Element;
 
-export { ActionForm, type ActionHookResult, ClientDescriptor, clientDescriptor, useActions, useCfastLoader };
+export { ActionForm, type ActionHookResult, type CfastCollection, type CfastItem, type CfastItemMethods, type CfastLoaderData, ClientDescriptor, clientDescriptor, useActions, useCfastLoader };

package/llms.txt

@@ -128,7 +128,7 @@ type ActionFormProps = Omit<ComponentProps<typeof Form>, "children" | "action">
 ```
 
 #### `useCfastLoader<T>()`
-Client hook that replaces `useLoaderData()` for routes using `cfastJson()`. Returns the same data but wraps arrays and objects that have `_can` with permission helper methods.
+Client hook that replaces `useLoaderData()` for routes using `cfastJson()`. Returns the same data but wraps arrays and objects that have `_can` with permission helper methods. The return type is `CfastLoaderData<...>`, which automatically adds permission methods to the TypeScript types so consumers get full autocomplete without local type helpers.
 
 ```typescript
 import { useCfastLoader } from "@cfast/actions/client";
@@ -157,6 +157,46 @@ Wrapping rules:
 
 All `can*()` methods return `ActionHookResult` with `permitted`, `invisible`, `reason`, `submit` (no-op), `pending` (false), `data`, `error`.
 
+#### Permission helper types
+
+Exported from `@cfast/actions/client` for consumers who need to annotate variables or build custom abstractions:
+
+```typescript
+import type {
+  CfastItem,
+  CfastCollection,
+  CfastItemMethods,
+  CfastLoaderData,
+} from "@cfast/actions/client";
+
+/** Permission methods added to items with _can */
+type CfastItemMethods = {
+  canRead: () => ActionHookResult;
+  canCreate: () => ActionHookResult;
+  canEdit: () => ActionHookResult;
+  canDelete: () => ActionHookResult;
+};
+
+/** An item with _can gets permission methods mixed in */
+type CfastItem<T> = T & CfastItemMethods;
+
+/** A collection gets canAdd() plus each item gets permission methods */
+type CfastCollection<T> = CfastItem<T>[] & {
+  canAdd: () => ActionHookResult;
+};
+
+/** Transforms a loader return type -- arrays become CfastCollection, objects become CfastItem, primitives pass through */
+type CfastLoaderData<T> = {
+  [K in keyof T]: T[K] extends (infer U)[]
+    ? U extends Record<string, unknown>
+      ? CfastCollection<U>
+      : T[K]
+    : T[K] extends Record<string, unknown>
+      ? CfastItem<T[K]>
+      : T[K];
+};
+```
+
 `ActionForm` is a form wrapper that auto-injects hidden fields from an action descriptor object. Replaces manual `<input type="hidden">` patterns when using `composeActions`.
 
 ```tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfast/actions",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Multi-action routes and permission-aware action definitions for React Router",
   "keywords": [
     "cfast",