polen 0.11.0-next.11 → 0.11.0-next.12

package/src/template/stores/schema.ts

@@ -0,0 +1,52 @@
+import type { GraphQLSchema } from 'graphql'
+import { proxy, ref } from 'valtio'
+
+/**
+ * Schema store state interface
+ */
+export interface State {
+  /** Currently selected schema version */
+  currentVersion: string
+  /** All available schema versions */
+  availableVersions: string[]
+  /** Currently loaded GraphQL schema instance */
+  currentSchema: GraphQLSchema | null
+}
+
+/**
+ * Initial state for the schema store
+ */
+export const initialState: State = {
+  currentVersion: 'latest',
+  availableVersions: [],
+  currentSchema: null,
+}
+
+/**
+ * Schema store
+ *
+ * Manages GraphQL schema state including version selection and schema instances.
+ * Used for version switching and schema-aware navigation.
+ */
+export const store = proxy({
+  ...initialState,
+
+  /**
+   * Reset store to initial state
+   */
+  reset() {
+    Object.assign(store, initialState)
+  },
+
+  /**
+   * Set store state
+   * @param data - New state data
+   */
+  set(data: State) {
+    // Set each property individually to avoid issues with complex objects
+    store.currentVersion = data.currentVersion
+    store.availableVersions = data.availableVersions
+    // Use ref() to prevent Valtio from deeply proxying the GraphQL schema
+    store.currentSchema = data.currentSchema ? ref(data.currentSchema) : null
+  },
+})

package/src/template/stores/toast.ts

@@ -0,0 +1,153 @@
+import { proxy } from 'valtio'
+
+/**
+ * Toast notification types
+ */
+export const Type = {
+  info: 'info',
+  success: 'success',
+  warning: 'warning',
+  error: 'error',
+} as const
+
+export type Type = typeof Type[keyof typeof Type]
+
+/**
+ * Toast notification interface
+ */
+export interface Toast {
+  /** Unique identifier for the toast */
+  id: string
+  /** Primary message text */
+  message: string
+  /** Optional secondary description text */
+  description?: string
+  /** Visual type/variant of the toast */
+  type?: Type
+  /** Duration in milliseconds before auto-dismiss. Set to 0 to disable auto-dismiss */
+  duration?: number
+  /** Optional action buttons configuration */
+  actions: {
+    /** Action button label */
+    label: string
+    /** Action button click handler */
+    onClick: () => void
+  }[]
+}
+
+/**
+ * Toast store state interface
+ */
+export interface State {
+  /** Array of active toast notifications */
+  toasts: Toast[]
+}
+
+/**
+ * Initial state for the toast store
+ */
+export const initialState: State = {
+  toasts: [],
+}
+
+/**
+ * Default values for toast properties
+ */
+const toastDefaults = {
+  duration: 5000,
+  actions: [],
+} satisfies Partial<Toast>
+
+/**
+ * Toast notification store
+ *
+ * Manages toast notifications with auto-dismiss functionality and type-specific convenience methods.
+ */
+export const store = proxy({
+  ...initialState,
+
+  /**
+   * Add a new toast notification
+   * @param toast - Toast configuration (id will be auto-generated)
+   * @returns Generated toast ID
+   */
+  add(toast: Omit<Toast, 'id'>): string {
+    const id = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`
+    store.toasts.push({ ...toast, id })
+
+    // Auto-remove after duration (default 5 seconds). Set duration to 0 to disable auto-dismiss
+    if (toast.duration !== 0) {
+      setTimeout(() => store.remove(id), toast.duration || toastDefaults.duration)
+    }
+
+    return id
+  },
+
+  /**
+   * Remove a toast by ID
+   * @param id - Toast ID to remove
+   */
+  remove(id: string): void {
+    const index = store.toasts.findIndex(t => t.id === id)
+    if (index > -1) {
+      store.toasts.splice(index, 1)
+    }
+  },
+
+  /**
+   * Reset store to initial state
+   */
+  reset() {
+    Object.assign(store, initialState)
+  },
+
+  /**
+   * Set store state
+   * @param data - New state data
+   */
+  set(data: State) {
+    Object.assign(store, data)
+  },
+
+  /**
+   * Show an info toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  info(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.info })
+  },
+
+  /**
+   * Show a success toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  success(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.success })
+  },
+
+  /**
+   * Show a warning toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  warning(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.warning })
+  },
+
+  /**
+   * Show an error toast
+   * @param message - Toast message
+   * @param options - Additional toast options
+   * @returns Generated toast ID
+   */
+  error(message: string, options?: InputOptions) {
+    return store.add({ ...toastDefaults, ...options, message, type: Type.error })
+  },
+})
+
+type InputOptions = Partial<Omit<Toast, 'id' | 'message' | 'type'>>

package/src/template/utils/try-with-toast.ts

@@ -0,0 +1,41 @@
+import { Stores } from '../stores/$.js'
+
+/**
+ * Execute an async function with automatic error handling and toast notifications
+ *
+ * @param fn - Async function to execute
+ * @param errorMessage - Optional custom error message for the toast (defaults to error message)
+ * @returns Promise that resolves to null on success or Error on failure
+ */
+export const tryWithToast = async <T>(
+  fn: () => Promise<T>,
+  errorMessage?: string,
+): Promise<Error | null> => {
+  try {
+    await fn()
+    return null
+  } catch (error) {
+    // Log to console in all environments
+    console.error('Error in tryWithToast:', error)
+
+    // Determine the error message
+    const baseMessage = error instanceof Error ? error.message : String(error)
+    const toastMessage = errorMessage || baseMessage
+
+    // In development, show detailed error info
+    if (import.meta.env.DEV) {
+      Stores.Toast.store.error(toastMessage, {
+        description: error instanceof Error
+          ? `${error.name}: ${error.message}${error.stack ? '\n\nStack trace available in console.' : ''}`
+          : `Error details: ${String(error)}`,
+        duration: 10000, // Longer duration in dev for debugging
+      })
+    } else {
+      // In production, show simplified message
+      Stores.Toast.store.error(toastMessage)
+    }
+
+    // Return the error for downstream fallback logic
+    return error instanceof Error ? error : new Error(baseMessage)
+  }
+}

package/build/template/components/VersionSelector.d.ts

@@ -1,8 +0,0 @@
-import type { React } from '#dep/react/index';
-interface Props {
-    availableVersions: string[];
-    currentVersion: string;
-}
-export declare const VersionSelector: React.FC<Props>;
-export {};
-//# sourceMappingURL=VersionSelector.d.ts.map

package/build/template/components/VersionSelector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionSelector.d.ts","sourceRoot":"","sources":["../../../src/template/components/VersionSelector.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAI7C,UAAU,KAAK;IACb,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CA+B3C,CAAA"}

package/build/template/components/VersionSelector.js

@@ -1,22 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Api } from '#api/iso';
-import { Select } from '@radix-ui/themes';
-import { useNavigate, useParams } from 'react-router';
-export const VersionSelector = ({ availableVersions, currentVersion }) => {
-    const navigate = useNavigate();
-    const params = useParams();
-    // Don't show selector if only one version
-    if (availableVersions.length <= 1) {
-        return null;
-    }
-    const handleVersionChange = (newVersion) => {
-        const newPath = Api.Schema.Routing.createReferencePath({
-            version: newVersion,
-            type: params[`type`],
-            field: params[`field`],
-        });
-        navigate(newPath);
-    };
-    return (_jsxs(Select.Root, { value: currentVersion, onValueChange: handleVersionChange, children: [_jsx(Select.Trigger, {}), _jsx(Select.Content, { children: availableVersions.map(version => (_jsx(Select.Item, { value: version, children: version === Api.Schema.VERSION_LATEST ? `Latest` : version }, version))) })] }));
-};
-//# sourceMappingURL=VersionSelector.js.map

package/build/template/components/VersionSelector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VersionSelector.js","sourceRoot":"","sources":["../../../src/template/components/VersionSelector.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAOrD,MAAM,CAAC,MAAM,eAAe,GAAoB,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,EAAE,EAAE;IACxF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,0CAA0C;IAC1C,IAAI,iBAAiB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,mBAAmB,GAAG,CAAC,UAAkB,EAAE,EAAE;QACjD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACrD,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;SACvB,CAAC,CAAA;QAEF,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnB,CAAC,CAAA;IAED,OAAO,CACL,MAAC,MAAM,CAAC,IAAI,IAAC,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,aACpE,KAAC,MAAM,CAAC,OAAO,KAAG,EAClB,KAAC,MAAM,CAAC,OAAO,cACZ,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAChC,KAAC,MAAM,CAAC,IAAI,IAAe,KAAK,EAAE,OAAO,YACtC,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IAD3C,OAAO,CAEX,CACf,CAAC,GACa,IACL,CACf,CAAA;AACH,CAAC,CAAA"}

package/src/template/components/VersionSelector.tsx

@@ -1,42 +0,0 @@
-import { Api } from '#api/iso'
-import type { React } from '#dep/react/index'
-import { Select } from '@radix-ui/themes'
-import { useNavigate, useParams } from 'react-router'
-
-interface Props {
-  availableVersions: string[]
-  currentVersion: string
-}
-
-export const VersionSelector: React.FC<Props> = ({ availableVersions, currentVersion }) => {
-  const navigate = useNavigate()
-  const params = useParams()
-
-  // Don't show selector if only one version
-  if (availableVersions.length <= 1) {
-    return null
-  }
-
-  const handleVersionChange = (newVersion: string) => {
-    const newPath = Api.Schema.Routing.createReferencePath({
-      version: newVersion,
-      type: params[`type`],
-      field: params[`field`],
-    })
-
-    navigate(newPath)
-  }
-
-  return (
-    <Select.Root value={currentVersion} onValueChange={handleVersionChange}>
-      <Select.Trigger />
-      <Select.Content>
-        {availableVersions.map(version => (
-          <Select.Item key={version} value={version}>
-            {version === Api.Schema.VERSION_LATEST ? `Latest` : version}
-          </Select.Item>
-        ))}
-      </Select.Content>
-    </Select.Root>
-  )
-}