@auto-engineer/generate-react-client 1.33.0 → 1.35.0

package/dist/starter/src/components/ui/Tabs.stories.tsx

@@ -8,6 +8,7 @@ const meta: Meta<typeof Tabs> = {
 export default meta;
 type Story = StoryObj<typeof Tabs>;
 
+/** Shows the default pill-style tabs with three panels. */
 export const Default: Story = {
   render: () => (
     <Tabs defaultValue="account" className="w-[400px]">
@@ -29,6 +30,7 @@ export const Default: Story = {
   ),
 };
 
+/** Shows the line variant where the active tab is indicated by an underline rather than a background. */
 export const LineVariant: Story = {
   render: () => (
     <Tabs defaultValue="overview" className="w-[400px]">

package/dist/starter/src/components/ui/Tabs.tsx

@@ -4,6 +4,7 @@ import { Tabs as TabsPrimitive } from 'radix-ui';
 
 import { cn } from '@/lib/utils';
 
+/** Layered content panels activated by tab triggers. Supports horizontal and vertical orientations with keyboard navigation. */
 function Tabs({ className, orientation = 'horizontal', ...props }: React.ComponentProps<typeof TabsPrimitive.Root>) {
   return (
     <TabsPrimitive.Root
@@ -31,6 +32,9 @@ const tabsListVariants = cva(
   },
 );
 
+/**
+ * The container for tab triggers. Supports "default" (pill background) and "line" (underline indicator) variants.
+ */
 function TabsList({
   className,
   variant = 'default',
@@ -46,6 +50,7 @@ function TabsList({
   );
 }
 
+/** A clickable tab button that activates its associated TabsContent panel. */
 function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
   return (
     <TabsPrimitive.Trigger
@@ -62,6 +67,7 @@ function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPr
   );
 }
 
+/** The content panel associated with a tab trigger, shown when its corresponding trigger is active. */
 function TabsContent({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Content>) {
   return <TabsPrimitive.Content data-slot="tabs-content" className={cn('flex-1 outline-none', className)} {...props} />;
 }

package/dist/starter/src/components/ui/Textarea.stories.tsx

@@ -8,14 +8,17 @@ const meta: Meta<typeof Textarea> = {
 export default meta;
 type Story = StoryObj<typeof Textarea>;
 
+/** Shows the textarea in its default empty state. */
 export const Default: Story = {};
 
+/** Shows the textarea with placeholder text. */
 export const WithPlaceholder: Story = {
   args: {
     placeholder: 'Type your message here...',
   },
 };
 
+/** Shows a disabled textarea that cannot receive input. */
 export const Disabled: Story = {
   args: {
     placeholder: 'This textarea is disabled',

package/dist/starter/src/components/ui/Textarea.tsx

@@ -2,6 +2,10 @@ import * as React from 'react';
 
 import { cn } from '@/lib/utils';
 
+/**
+ * A multi-line text input that auto-sizes to its content via field-sizing-content.
+ * Supports aria-invalid styling for form validation errors.
+ */
 function Textarea({ className, ...props }: React.ComponentProps<'textarea'>) {
   return (
     <textarea

package/dist/starter/src/components/ui/Toast.stories.tsx

@@ -40,6 +40,7 @@ function ToastDemo() {
   );
 }
 
+/** Demonstrates triggering a basic toast notification with a title and description. */
 export const Default: Story = {
   render: () => <ToastDemo />,
 };
@@ -66,6 +67,7 @@ function ToastDestructiveDemo() {
   );
 }
 
+/** Shows a destructive-variant toast for error or warning scenarios. */
 export const Destructive: Story = {
   render: () => <ToastDestructiveDemo />,
 };
@@ -92,10 +94,12 @@ function ToastWithActionDemo() {
   );
 }
 
+/** Shows a toast with an action button (e.g., "Undo") alongside the message. */
 export const WithAction: Story = {
   render: () => <ToastWithActionDemo />,
 };
 
+/** Shows a toast rendered inline (always open) using the primitive subcomponents directly. */
 export const Inline: Story = {
   render: () => (
     <ToastProvider>

package/dist/starter/src/components/ui/Toast.tsx

@@ -7,10 +7,14 @@ import { Toast as ToastPrimitive } from 'radix-ui';
 
 import { cn } from '@/lib/utils';
 
+/** Temporary notification at screen edge with swipe-to-dismiss. Supports default and destructive variants. */
+
+/** Provides the toast context for managing toast state and swipe behavior. */
 function ToastProvider({ ...props }: React.ComponentProps<typeof ToastPrimitive.Provider>) {
   return <ToastPrimitive.Provider data-slot="toast-provider" {...props} />;
 }
 
+/** The fixed-position viewport where toasts are rendered, positioned at bottom-right on larger screens. */
 function ToastViewport({ className, ...props }: React.ComponentProps<typeof ToastPrimitive.Viewport>) {
   return (
     <ToastPrimitive.Viewport
@@ -39,6 +43,7 @@ const toastVariants = cva(
   },
 );
 
+/** An individual toast notification with default or destructive variant styling. */
 function Toast({
   className,
   variant,
@@ -47,6 +52,7 @@ function Toast({
   return <ToastPrimitive.Root data-slot="toast" className={cn(toastVariants({ variant }), className)} {...props} />;
 }
 
+/** An action button displayed within a toast, such as "Undo" or "Retry". */
 function ToastAction({ className, ...props }: React.ComponentProps<typeof ToastPrimitive.Action>) {
   return (
     <ToastPrimitive.Action
@@ -60,6 +66,7 @@ function ToastAction({ className, ...props }: React.ComponentProps<typeof ToastP
   );
 }
 
+/** A close button positioned in the top-right corner of a toast, visible on hover. */
 function ToastClose({ className, ...props }: React.ComponentProps<typeof ToastPrimitive.Close>) {
   return (
     <ToastPrimitive.Close
@@ -76,6 +83,7 @@ function ToastClose({ className, ...props }: React.ComponentProps<typeof ToastPr
   );
 }
 
+/** The bold heading text of a toast notification. */
 function ToastTitle({ className, ...props }: React.ComponentProps<typeof ToastPrimitive.Title>) {
   return (
     <ToastPrimitive.Title
@@ -86,6 +94,7 @@ function ToastTitle({ className, ...props }: React.ComponentProps<typeof ToastPr
   );
 }
 
+/** The secondary descriptive text of a toast notification. */
 function ToastDescription({ className, ...props }: React.ComponentProps<typeof ToastPrimitive.Description>) {
   return (
     <ToastPrimitive.Description

package/dist/starter/src/components/ui/Toaster.tsx

@@ -3,6 +3,10 @@
 import { useToast } from '@/hooks/use-toast';
 import { Toast, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport } from '@/components/ui/Toast';
 
+/**
+ * Renders all active toasts from the useToast hook into a fixed-position viewport.
+ * Place once at the app root to enable imperative toast notifications via the useToast hook.
+ */
 function Toaster() {
   const { toasts } = useToast();
 

package/dist/starter/src/components/ui/Toggle.stories.tsx

@@ -9,6 +9,7 @@ const meta: Meta<typeof Toggle> = {
 export default meta;
 type Story = StoryObj<typeof Toggle>;
 
+/** Shows a toggle button with a bold icon in the default ghost variant. */
 export const Default: Story = {
   args: {
     'aria-label': 'Toggle bold',
@@ -16,6 +17,7 @@ export const Default: Story = {
   },
 };
 
+/** Shows the outline variant with a visible border. */
 export const Outline: Story = {
   args: {
     variant: 'outline',
@@ -24,6 +26,7 @@ export const Outline: Story = {
   },
 };
 
+/** Shows a toggle with a text label instead of an icon. */
 export const WithText: Story = {
   args: {
     'aria-label': 'Toggle italic',
@@ -31,6 +34,7 @@ export const WithText: Story = {
   },
 };
 
+/** Shows a toggle in its initially pressed (on) state. */
 export const Pressed: Story = {
   args: {
     defaultPressed: true,

package/dist/starter/src/components/ui/Toggle.tsx

@@ -27,6 +27,7 @@ const toggleVariants = cva(
   },
 );
 
+/** A two-state button for toolbar controls. Has "default" (ghost) and "outline" variants in sm/default/lg sizes. */
 function Toggle({
   className,
   variant,

package/dist/starter/src/components/ui/ToggleGroup.stories.tsx

@@ -9,6 +9,7 @@ const meta: Meta<typeof ToggleGroup> = {
 export default meta;
 type Story = StoryObj<typeof ToggleGroup>;
 
+/** Shows a single-selection toggle group where only one item can be active at a time. */
 export const Single: Story = {
   render: () => (
     <ToggleGroup type="single">
@@ -25,6 +26,7 @@ export const Single: Story = {
   ),
 };
 
+/** Shows a multi-selection toggle group with bold and italic pre-selected. */
 export const Multiple: Story = {
   render: () => (
     <ToggleGroup type="multiple" defaultValue={['bold', 'italic']}>
@@ -41,6 +43,7 @@ export const Multiple: Story = {
   ),
 };
 
+/** Shows a toggle group using the outline variant with visible borders. */
 export const Outline: Story = {
   render: () => (
     <ToggleGroup type="single" variant="outline">

package/dist/starter/src/components/ui/ToggleGroup.tsx

@@ -17,10 +17,12 @@ const ToggleGroupContext = React.createContext<
   spacing: 0,
 });
 
+/** A group of toggles where one (`type="single"`) or multiple (`type="multiple"`) can be active. */
 function ToggleGroup({
   className,
   variant,
   size,
+  /** Controls gap between items. When 0, items are visually joined with shared borders. */
   spacing = 0,
   children,
   ...props
@@ -46,6 +48,7 @@ function ToggleGroup({
   );
 }
 
+/** An individual toggle button within a ToggleGroup. Inherits variant and size from the parent group context. */
 function ToggleGroupItem({
   className,
   children,

package/dist/starter/src/components/ui/Tooltip.stories.tsx

@@ -9,6 +9,7 @@ const meta: Meta<typeof Tooltip> = {
 export default meta;
 type Story = StoryObj<typeof Tooltip>;
 
+/** Shows a basic tooltip appearing on hover over a button. */
 export const Default: Story = {
   render: () => (
     <TooltipProvider>
@@ -24,6 +25,7 @@ export const Default: Story = {
   ),
 };
 
+/** Shows a tooltip with additional spacing between the trigger and content via sideOffset. */
 export const WithSideOffset: Story = {
   render: () => (
     <TooltipProvider>

package/dist/starter/src/components/ui/Tooltip.tsx

@@ -3,18 +3,24 @@ import { Tooltip as TooltipPrimitive } from 'radix-ui';
 
 import { cn } from '@/lib/utils';
 
+/** Brief descriptive popup on hover/focus. Has enter/exit animations and arrow indicator. Wrap app in TooltipProvider first. */
+
+/** Provides shared tooltip configuration (e.g., delay duration) for all nested Tooltip instances. */
 function TooltipProvider({ delayDuration = 0, ...props }: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
   return <TooltipPrimitive.Provider data-slot="tooltip-provider" delayDuration={delayDuration} {...props} />;
 }
 
+/** The root component that manages open/close state for a single tooltip. */
 function Tooltip({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Root>) {
   return <TooltipPrimitive.Root data-slot="tooltip" {...props} />;
 }
 
+/** The element that triggers the tooltip on hover or focus. */
 function TooltipTrigger({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
   return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
 }
 
+/** The popup content panel rendered via a portal with an arrow indicator. */
 function TooltipContent({
   className,
   sideOffset = 0,

package/dist/starter/src/gql/execute.ts

@@ -0,0 +1,11 @@
+import request from 'graphql-request';
+import type { TypedDocumentString } from './graphql';
+
+const GRAPHQL_ENDPOINT = 'http://localhost:4000/graphql';
+
+export async function execute<TResult, TVariables>(
+  query: TypedDocumentString<TResult, TVariables>,
+  ...[variables]: TVariables extends Record<string, never> ? [] : [TVariables]
+): Promise<TResult> {
+  return request(GRAPHQL_ENDPOINT, query.toString(), variables ? variables : undefined);
+}

package/dist/starter/src/gql/fragment-masking.ts

@@ -0,0 +1,83 @@
+/* eslint-disable */
+import { ResultOf, DocumentTypeDecoration } from '@graphql-typed-document-node/core';
+import { Incremental, TypedDocumentString } from './graphql';
+
+
+export type FragmentType<TDocumentType extends DocumentTypeDecoration<any, any>> = TDocumentType extends DocumentTypeDecoration<
+  infer TType,
+  any
+>
+  ? [TType] extends [{ ' $fragmentName'?: infer TKey }]
+    ? TKey extends string
+      ? { ' $fragmentRefs'?: { [key in TKey]: TType } }
+      : never
+    : never
+  : never;
+
+// return non-nullable if `fragmentType` is non-nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: FragmentType<DocumentTypeDecoration<TType, any>>
+): TType;
+// return nullable if `fragmentType` is undefined
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | undefined
+): TType | undefined;
+// return nullable if `fragmentType` is nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | null
+): TType | null;
+// return nullable if `fragmentType` is nullable or undefined
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | null | undefined
+): TType | null | undefined;
+// return array of non-nullable if `fragmentType` is array of non-nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: Array<FragmentType<DocumentTypeDecoration<TType, any>>>
+): Array<TType>;
+// return array of nullable if `fragmentType` is array of nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: Array<FragmentType<DocumentTypeDecoration<TType, any>>> | null | undefined
+): Array<TType> | null | undefined;
+// return readonly array of non-nullable if `fragmentType` is array of non-nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: ReadonlyArray<FragmentType<DocumentTypeDecoration<TType, any>>>
+): ReadonlyArray<TType>;
+// return readonly array of nullable if `fragmentType` is array of nullable
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: ReadonlyArray<FragmentType<DocumentTypeDecoration<TType, any>>> | null | undefined
+): ReadonlyArray<TType> | null | undefined;
+export function useFragment<TType>(
+  _documentNode: DocumentTypeDecoration<TType, any>,
+  fragmentType: FragmentType<DocumentTypeDecoration<TType, any>> | Array<FragmentType<DocumentTypeDecoration<TType, any>>> | ReadonlyArray<FragmentType<DocumentTypeDecoration<TType, any>>> | null | undefined
+): TType | Array<TType> | ReadonlyArray<TType> | null | undefined {
+  return fragmentType as any;
+}
+
+
+export function makeFragmentData<
+  F extends DocumentTypeDecoration<any, any>,
+  FT extends ResultOf<F>
+>(data: FT, _fragment: F): FragmentType<F> {
+  return data as FragmentType<F>;
+}
+export function isFragmentReady<TQuery, TFrag>(
+  queryNode: TypedDocumentString<TQuery, any>,
+  fragmentNode: TypedDocumentString<TFrag, any>,
+  data: FragmentType<TypedDocumentString<Incremental<TFrag>, any>> | null | undefined
+): data is FragmentType<typeof fragmentNode> {
+  const deferredFields = queryNode.__meta__?.deferredFields as Record<string, (keyof TFrag)[]>;
+  const fragName = fragmentNode.__meta__?.fragmentName as string | undefined;
+
+  if (!deferredFields || !fragName) return true;
+
+  const fields = deferredFields[fragName] ?? [];
+  return fields.length > 0 && fields.every(field => data && field in data);
+}

package/dist/starter/src/gql/gql.ts

@@ -0,0 +1,9 @@
+/* eslint-disable */
+import * as types from './graphql';
+
+
+
+const documents = {}
+export function graphql(source: string) {
+  return (documents as any)[source] ?? {};
+}

package/dist/starter/src/gql/graphql.ts

@@ -0,0 +1,182 @@
+/* eslint-disable */
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = T | null | undefined;
+export type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]?: Maybe<T[SubKey]> };
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]: Maybe<T[SubKey]> };
+export type MakeEmpty<T extends { [key: string]: unknown }, K extends keyof T> = { [_ in K]?: never };
+export type Incremental<T> = T | { [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never };
+/** All built-in and custom scalars, mapped to their actual values */
+export type Scalars = {
+  ID: { input: string; output: string; }
+  String: { input: string; output: string; }
+  Boolean: { input: boolean; output: boolean; }
+  Int: { input: number; output: number; }
+  Float: { input: number; output: number; }
+  /** A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.This scalar is serialized to a string in ISO 8601 format and parsed from a string in ISO 8601 format. */
+  DateTimeISO: { input: any; output: any; }
+};
+
+export type ActiveWorkoutView = {
+  __typename?: 'ActiveWorkoutView';
+  duration: Scalars['String']['output'];
+  exercises: Array<ActiveWorkoutViewExercises>;
+  sessionId: Scalars['String']['output'];
+  totalSets: Scalars['Float']['output'];
+};
+
+export type ActiveWorkoutViewExercises = {
+  __typename?: 'ActiveWorkoutViewExercises';
+  exerciseId: Scalars['String']['output'];
+  reps: Scalars['Float']['output'];
+  sets: Scalars['Float']['output'];
+};
+
+export type CalculateWorkoutStatsInput = {
+  sessionId: Scalars['String']['input'];
+};
+
+export type CompleteWorkoutInput = {
+  endTime: Scalars['DateTimeISO']['input'];
+  sessionId: Scalars['String']['input'];
+};
+
+export type Mutation = {
+  __typename?: 'Mutation';
+  calculateWorkoutStats: MutationResponse;
+  completeWorkout: MutationResponse;
+  setFitnessGoal: MutationResponse;
+  startWorkout: MutationResponse;
+  updateGoalProgress: MutationResponse;
+};
+
+
+export type MutationCalculateWorkoutStatsArgs = {
+  input: CalculateWorkoutStatsInput;
+};
+
+
+export type MutationCompleteWorkoutArgs = {
+  input: CompleteWorkoutInput;
+};
+
+
+export type MutationSetFitnessGoalArgs = {
+  input: SetFitnessGoalInput;
+};
+
+
+export type MutationStartWorkoutArgs = {
+  input: StartWorkoutInput;
+};
+
+
+export type MutationUpdateGoalProgressArgs = {
+  input: UpdateGoalProgressInput;
+};
+
+export type MutationError = {
+  __typename?: 'MutationError';
+  message?: Maybe<Scalars['String']['output']>;
+  type: Scalars['String']['output'];
+};
+
+export type MutationResponse = {
+  __typename?: 'MutationResponse';
+  error?: Maybe<MutationError>;
+  success: Scalars['Boolean']['output'];
+};
+
+export type ProgressDashboardView = {
+  __typename?: 'ProgressDashboardView';
+  avgVolume: Scalars['Float']['output'];
+  goals: Array<ProgressDashboardViewGoals>;
+  totalWorkouts: Scalars['Float']['output'];
+  userId: Scalars['String']['output'];
+};
+
+export type ProgressDashboardViewGoals = {
+  __typename?: 'ProgressDashboardViewGoals';
+  complete: Scalars['Boolean']['output'];
+  goalId: Scalars['String']['output'];
+  progress: Scalars['Float']['output'];
+};
+
+export type Query = {
+  __typename?: 'Query';
+  activeWorkout: Array<ActiveWorkoutView>;
+  progressDashboard: Array<ProgressDashboardView>;
+  workoutHistory: Array<WorkoutHistoryView>;
+};
+
+
+export type QueryActiveWorkoutArgs = {
+  userId?: InputMaybe<Scalars['ID']['input']>;
+};
+
+
+export type QueryProgressDashboardArgs = {
+  userId?: InputMaybe<Scalars['ID']['input']>;
+};
+
+
+export type QueryWorkoutHistoryArgs = {
+  input?: InputMaybe<Scalars['String']['input']>;
+};
+
+export type SetFitnessGoalInput = {
+  goalId: Scalars['String']['input'];
+  periodStart: Scalars['DateTimeISO']['input'];
+  target: Scalars['Float']['input'];
+  type: Scalars['String']['input'];
+  userId: Scalars['String']['input'];
+};
+
+export type StartWorkoutExercisesInput = {
+  exerciseId: Scalars['String']['input'];
+  reps: Scalars['Float']['input'];
+  sets: Scalars['Float']['input'];
+};
+
+export type StartWorkoutInput = {
+  exercises: Array<StartWorkoutExercisesInput>;
+  sessionId: Scalars['String']['input'];
+};
+
+export type UpdateGoalProgressInput = {
+  addedVolume: Scalars['Float']['input'];
+  goalId: Scalars['String']['input'];
+};
+
+export type WorkoutHistoryView = {
+  __typename?: 'WorkoutHistoryView';
+  sessions: Array<WorkoutHistoryViewSessions>;
+  userId: Scalars['String']['output'];
+};
+
+export type WorkoutHistoryViewSessions = {
+  __typename?: 'WorkoutHistoryViewSessions';
+  date: Scalars['DateTimeISO']['output'];
+  duration: Scalars['String']['output'];
+  sessionId: Scalars['String']['output'];
+  volume: Scalars['Float']['output'];
+};
+
+export class TypedDocumentString<TResult, TVariables>
+  extends String
+  implements DocumentTypeDecoration<TResult, TVariables>
+{
+  __apiType?: NonNullable<DocumentTypeDecoration<TResult, TVariables>['__apiType']>;
+  private value: string;
+  public __meta__?: Record<string, any> | undefined;
+
+  constructor(value: string, __meta__?: Record<string, any> | undefined) {
+    super(value);
+    this.value = value;
+    this.__meta__ = __meta__;
+  }
+
+  override toString(): string & DocumentTypeDecoration<TResult, TVariables> {
+    return this.value;
+  }
+}

package/dist/starter/src/gql/index.ts

@@ -0,0 +1,2 @@
+export * from "./fragment-masking";
+export * from "./gql";

package/dist/starter/tsconfig.json

@@ -1,4 +1,10 @@
 {
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
   "files": [],
   "references": [{ "path": "./tsconfig.app.json" }]
 }

package/package.json

@@ -19,12 +19,12 @@
   },
   "dependencies": {
     "debug": "^4.4.1",
-    "@auto-engineer/message-bus": "1.33.0"
+    "@auto-engineer/message-bus": "1.35.0"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12"
   },
-  "version": "1.33.0",
+  "version": "1.35.0",
   "scripts": {
     "build": "tsc && tsx ../../scripts/fix-esm-imports.ts && cp -r starter dist/",
     "test-cli": "tsx test-cli.ts",