termcast 1.3.9

package/src/globals.ts

@@ -0,0 +1,34 @@
+// @ts-nocheck
+// Set up global references for external packages
+//
+import { logger } from './logger'
+
+process.env.TERMCAST = 'true'
+
+import * as opentuiCore from '@opentui/core'
+import * as opentuiReact from '@opentui/react'
+import * as react from 'react'
+import * as reactJsxRuntime from 'react/jsx-runtime'
+import * as termcastApi from 'termcast'
+
+declare global {
+  var opentuiCore: typeof opentuiCore
+  var opentuiReact: typeof opentuiReact
+  var react: typeof react
+  var reactJsxRuntime: typeof reactJsxRuntime
+  var termcastApi: typeof termcastApi
+}
+
+// Initialize globals
+globalThis.opentuiCore = opentuiCore
+globalThis.opentuiReact = opentuiReact
+globalThis.react = react
+
+globalThis._jsx = react.createElement
+globalThis._jsxs = reactJsxRuntime.jsxs
+globalThis._Fragment = reactJsxRuntime.Fragment
+
+globalThis.reactJsxRuntime = reactJsxRuntime
+globalThis.termcastApi = termcastApi
+
+globalThis.logger = logger

package/src/hooks/index.tsx

@@ -0,0 +1,8 @@
+// Export all Raycast API hooks
+export { useActionPanel } from './use-action-panel'
+export { useId } from './use-id'
+export { useNavigation } from 'termcast/src/internal/navigation'
+export { useUnstableAI } from './use-unstable-ai'
+
+// Re-export types
+export type { ActionPanelState } from './use-action-panel'

package/src/hooks/use-action-panel.tsx

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react'
+import { logger } from 'termcast/src/logger'
+
+export interface ActionPanelState {
+  /**
+   * @deprecated No alternative :(
+   */
+  update: (actionPanel: ReactNode) => void
+}
+
+/**
+ * @deprecated No alternative :(
+ *
+ * Hook to get access to the ActionPanel state
+ * This hook is deprecated in Raycast API and provides an update function
+ * that doesn't have a clear use case in the new architecture
+ */
+export function useActionPanel(): ActionPanelState {
+  logger.warn('useActionPanel is deprecated and has no alternative')
+
+  return {
+    update: (actionPanel: ReactNode) => {
+      logger.warn('ActionPanel.update() is deprecated and has no effect', {
+        actionPanel,
+      })
+    },
+  }
+}

package/src/hooks/use-id.tsx

@@ -0,0 +1,19 @@
+import { useRef } from 'react'
+import { nanoid } from 'nanoid'
+
+/**
+ * @deprecated Use `useRef` with `nanoid`
+ *
+ * Hook that generates a unique ID that is stable across re-renders
+ * The ID is generated once on the first render and remains the same
+ * throughout the component's lifecycle
+ */
+export const useId = (): string => {
+  const idRef = useRef<string | undefined>(undefined)
+
+  if (!idRef.current) {
+    idRef.current = nanoid()
+  }
+
+  return idRef.current
+}

package/src/hooks/use-unstable-ai.tsx

@@ -0,0 +1,15 @@
+import { logger } from 'termcast/src/logger'
+
+/**
+ * @deprecated Use `useAI` from `@raycast/utils`
+ *
+ * This hook was an unstable AI interface that has been deprecated.
+ * Users should use the `useAI` hook from `@raycast/utils` instead.
+ * This implementation returns undefined to match the Raycast API behavior.
+ */
+export const useUnstableAI = (): undefined => {
+  logger.warn(
+    'useUnstableAI is deprecated. Use useAI from @raycast/utils instead',
+  )
+  return undefined
+}

package/src/hooks.tsx

@@ -0,0 +1,22 @@
+import { useCallback, useLayoutEffect, useRef } from 'react'
+
+/**
+ * Returns a stable callback that always calls the latest version of the provided handler.
+ * This prevents unnecessary re-renders and effect re-runs while ensuring the callback
+ * always has access to the latest props and state.
+ *
+ * Useful for event handlers that need to be passed to effects with empty dependency arrays
+ * or memoized child components.
+ */
+export function useEvent<T extends (...args: any[]) => any>(handler: T): T {
+  const handlerRef = useRef<T>(handler)
+
+  useLayoutEffect(() => {
+    handlerRef.current = handler
+  })
+
+  return useCallback((...args: Parameters<T>) => {
+    const fn = handlerRef.current
+    return fn(...args)
+  }, []) as T
+}

package/src/index.tsx

@@ -0,0 +1,240 @@
+// Import globals to set up global references
+import { LaunchType } from 'termcast/src/apis/environment'
+import './globals'
+
+// termcastApi will be set by the runtime when needed
+
+// Core UI Components - Lists
+export { List, Grid } from 'termcast/src/components/list'
+export { List as default } from 'termcast/src/components/list'
+export type {
+  ListProps,
+  ItemProps as ListItemProps,
+  SectionProps as ListSectionProps,
+  DetailProps as ListDetailProps,
+  MetadataProps as ListMetadataProps,
+  DropdownProps as ListDropdownProps,
+  DropdownItemProps as ListDropdownItemProps,
+  DropdownSectionProps as ListDropdownSectionProps,
+  ItemAccessory,
+  Color as ListColor,
+  GridProps,
+  GridItemProps,
+  GridSectionProps,
+  GridInset,
+} from 'termcast/src/components/list'
+
+// Core UI Components - Dropdowns
+export { Dropdown } from 'termcast/src/components/dropdown'
+export type {
+  DropdownProps,
+  DropdownItemProps,
+  DropdownSectionProps,
+} from 'termcast/src/components/dropdown'
+
+// Core UI Components - Actions
+export {
+  Action,
+  ActionPanel,
+  ActionStyle,
+} from 'termcast/src/components/actions'
+export type {
+  ActionProps,
+  ActionPanelProps,
+  ActionPanelSectionProps,
+} from 'termcast/src/components/actions'
+
+// Core UI Components - Detail
+export { Detail } from 'termcast/src/components/detail'
+export type {
+  DetailProps,
+  DetailPropsWithLoading,
+} from 'termcast/src/components/detail'
+
+// Form Components
+export {
+  Form,
+  useFormContext,
+  useFormSubmit,
+} from 'termcast/src/components/form/index'
+export { TextField } from 'termcast/src/components/form/text-field'
+export type {
+  TextFieldProps,
+  TextFieldRef,
+} from 'termcast/src/components/form/text-field'
+export { TextArea } from 'termcast/src/components/form/text-area'
+export type {
+  TextAreaProps,
+  TextAreaRef,
+} from 'termcast/src/components/form/text-area'
+export { PasswordField } from 'termcast/src/components/form/password-field'
+export type {
+  PasswordFieldProps,
+  PasswordFieldRef,
+} from 'termcast/src/components/form/password-field'
+export { Checkbox } from 'termcast/src/components/form/checkbox'
+export type {
+  CheckboxProps,
+  CheckboxRef,
+} from 'termcast/src/components/form/checkbox'
+export { Dropdown as FormDropdown } from 'termcast/src/components/form/dropdown'
+export type {
+  DropdownProps as FormDropdownProps,
+  DropdownItemProps as FormDropdownItemProps,
+  DropdownSectionProps as FormDropdownSectionProps,
+  DropdownRef as FormDropdownRef,
+} from 'termcast/src/components/form/dropdown'
+export type {
+  FormProps,
+  FormValues,
+  FormValue,
+  FormItemProps,
+  FormItemRef,
+  FormEvent,
+  FormEventType,
+} from 'termcast/src/components/form/types'
+
+// Icons and Images
+export {
+  Icon,
+  getIconEmoji,
+  IconComponent,
+} from 'termcast/src/components/icon'
+export { Image, ImageMask } from 'termcast/src/components/image'
+export type {
+  ImageProps,
+  ImageSource,
+  FileIcon,
+  ImageLike,
+} from 'termcast/src/components/image'
+
+// Alerts
+export { Alert, confirmAlert } from 'termcast/src/components/alert'
+
+// MenuBar
+export { MenuBarExtra } from 'termcast/src/components/menubar-extra'
+export type {
+  MenuBarExtraProps,
+  MenuBarExtraItemProps,
+  MenuBarExtraSeparatorProps,
+  MenuBarExtraSubmenuProps,
+  MenuBarExtraSectionProps,
+  MenuBarExtraActionEvent,
+} from 'termcast/src/components/menubar-extra'
+
+// AI
+export { AI } from 'termcast/src/apis/ai'
+
+// OAuth
+export { OAuth } from 'termcast/src/apis/oauth'
+
+// Colors
+export { Color } from 'termcast/src/colors'
+
+// Navigation
+export {
+  useNavigation,
+  NavigationContainer,
+} from 'termcast/src/internal/navigation'
+
+// Hooks
+export {
+  useActionPanel,
+  useId,
+  useUnstableAI,
+} from 'termcast/src/hooks/index'
+export type { ActionPanelState } from 'termcast/src/hooks/index'
+
+// Focus Context
+export { InFocus, useIsInFocus } from 'termcast/src/internal/focus-context'
+
+// Dialog
+export {
+  Dialog,
+  DialogProvider,
+  useDialog,
+} from 'termcast/src/internal/dialog'
+
+// Toast
+export {
+  Toast,
+  showToast,
+  showFailureToast,
+} from 'termcast/src/apis/toast'
+
+// Clipboard
+export {
+  Clipboard,
+  copyTextToClipboard,
+  clearClipboard,
+  pasteText,
+} from 'termcast/src/apis/clipboard'
+
+// Storage
+export { Cache } from 'termcast/src/apis/cache'
+export { LocalStorage } from 'termcast/src/apis/localstorage'
+
+// Utilities
+export {
+  copyToClipboard,
+  openInBrowser,
+  openFile,
+  pasteContent,
+  showInFinder,
+  moveToTrash,
+} from 'termcast/src/action-utils'
+
+export {
+  getApplications,
+  getDefaultApplication,
+  getFrontmostApplication,
+  trash,
+  open,
+  captureException,
+} from 'termcast/src/utils'
+
+// Environment
+export {
+  environment,
+  getSelectedFinderItems,
+  getSelectedText,
+} from 'termcast/src/apis/environment'
+export type {
+  Environment,
+  LaunchProps,
+} from 'termcast/src/apis/environment'
+
+export { LaunchType }
+
+// Preferences
+export {
+  getPreferenceValues,
+  openExtensionPreferences,
+  openCommandPreferences,
+} from 'termcast/src/apis/preferences'
+export type { PreferenceValues } from 'termcast/src/apis/preferences'
+
+// Common Types
+export type { CommonProps } from 'termcast/src/utils'
+
+// Theme
+export { Theme } from 'termcast/src/theme'
+
+// Logger
+export { logger } from 'termcast/src/logger'
+
+// State Management (internal use)
+export { useStore } from 'termcast/src/state'
+export type { DialogPosition } from 'termcast/src/state'
+
+// Providers (for app setup)
+export { Providers } from 'termcast/src/internal/providers'
+
+// Helper function for rendering examples
+export { renderWithProviders } from 'termcast/src/utils'
+
+// Window Management
+export { closeMainWindow, PopToRootType } from 'termcast/src/apis/window'
+
+// HUD
+export { showHUD } from 'termcast/src/apis/hud'