@figma-vars/hooks 3.0.0 → 3.1.0

package/README.md

@@ -254,6 +254,53 @@ function VariableEditor() {
 
 ## 🛡️ Error Handling
 
+### Error Boundaries (Recommended)
+
+Wrap your Figma-connected components with an error boundary to gracefully handle errors:
+
+```tsx
+import { ErrorBoundary } from 'react-error-boundary'
+import { FigmaVarsProvider } from '@figma-vars/hooks'
+
+function FigmaErrorFallback({ error }: { error: Error }) {
+  return (
+    <div role='alert'>
+      <h2>Failed to load Figma data</h2>
+      <pre>{error.message}</pre>
+    </div>
+  )
+}
+
+function App() {
+  return (
+    <ErrorBoundary FallbackComponent={FigmaErrorFallback}>
+      <FigmaVarsProvider
+        token={FIGMA_TOKEN}
+        fileKey={FIGMA_FILE_KEY}>
+        <YourApp />
+      </FigmaVarsProvider>
+    </ErrorBoundary>
+  )
+}
+```
+
+> **Note:** The provider validates fallback file structure at runtime and logs warnings in development. Invalid fallback data won't crash the app but will result in `undefined` data.
+
+### Runtime Validation
+
+Use type guards to validate data at runtime:
+
+```tsx
+import { isLocalVariablesResponse, isPublishedVariablesResponse } from '@figma-vars/hooks'
+
+// Validate before using
+if (isLocalVariablesResponse(data)) {
+  // Safe to access data.meta.variables
+}
+```
+
+### Error Utilities
+
 3.0.0 introduces powerful error handling utilities for type-safe error checking:
 
 ```tsx
@@ -371,6 +418,7 @@ Customize SWR behavior globally through the provider:
 ### Hooks
 
 - **Queries**: `useVariables` (local), `usePublishedVariables` (library/published), `useVariableCollections`, `useVariableModes`, `useFigmaToken`
+- **Granular Selectors**: `useCollectionById`, `useModesByCollection`, `useVariableById` (optimized selectors for specific entities)
 - **Mutations**: `useCreateVariable`, `useUpdateVariable`, `useDeleteVariable`, `useBulkUpdateVariables`
 - **Cache**: `useInvalidateVariables` (invalidate/revalidate cache)
 
@@ -378,6 +426,8 @@ Customize SWR behavior globally through the provider:
 
 - **Filtering**: `filterVariables` (filter by type, name, etc.)
 - **Error Handling**: `isFigmaApiError`, `getErrorStatus`, `getErrorMessage`, `hasErrorStatus`
+- **Type Guards**: `isLocalVariablesResponse`, `isPublishedVariablesResponse`, `validateFallbackData` (runtime validation)
+- **SWR Keys**: `getVariablesKey`, `getPublishedVariablesKey`, `getInvalidationKeys` (centralized cache key construction)
 - **Core helpers**: `fetcher`, `mutator`, constants for endpoints and headers
 
 ### Types

package/dist/api/fetcher.d.ts

@@ -1,3 +1,22 @@
+/**
+ * Options for configuring fetcher behavior.
+ *
+ * @public
+ */
+export interface FetcherOptions {
+    /**
+     * Optional AbortSignal to cancel the request.
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional timeout in milliseconds. Creates an AbortSignal internally if provided.
+     */
+    timeout?: number;
+    /**
+     * Optional fetch implementation override (useful for testing or custom fetch implementations).
+     */
+    fetch?: typeof fetch;
+}
 /**
  * Low-level utility to fetch data from the Figma Variables REST API with authentication.
  *
@@ -6,13 +25,17 @@
  * Parses JSON responses and throws detailed errors for failed requests.
  * Intended for internal use by hooks but can be used directly for custom API interactions.
  *
+ * Supports request cancellation via AbortSignal and timeout handling.
+ *
  * @param url - The full Figma REST API endpoint URL (e.g., 'https://api.figma.com/v1/files/{file_key}/variables').
  * @param token - Figma Personal Access Token (PAT) for authentication.
+ * @param options - Optional configuration for abort signal, timeout, or custom fetch implementation.
  *
  * @returns A Promise resolving to the parsed JSON response from the Figma API.
  *
  * @throws Throws an Error if the token is not provided.
  * @throws Throws an Error if the HTTP response is not ok, including the message returned by the Figma API or a default error message.
+ * @throws Throws an AbortError if the request is aborted or times out.
  *
  * @example
  * ```ts
@@ -23,7 +46,15 @@
  *   const data = await fetcher(url, token);
  *   return data;
  * }
+ *
+ * // With timeout:
+ * const data = await fetcher(url, token, { timeout: 5000 });
+ *
+ * // With abort signal:
+ * const controller = new AbortController();
+ * const data = await fetcher(url, token, { signal: controller.signal });
+ * controller.abort(); // Cancel the request
  * ```
  */
-export declare function fetcher<TResponse = unknown>(url: string, token: string): Promise<TResponse>;
+export declare function fetcher<TResponse = unknown>(url: string, token: string, options?: FetcherOptions): Promise<TResponse>;
 //# sourceMappingURL=fetcher.d.ts.map

package/dist/api/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/api/fetcher.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,CAAC,CAyCpB"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/api/fetcher.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CA0FpB"}

package/dist/api/index.d.ts

@@ -23,4 +23,6 @@
  */
 export { fetcher } from './fetcher';
 export { mutator } from './mutator';
+export type { FetcherOptions } from './fetcher';
+export type { MutatorOptions } from './mutator';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA"}

package/dist/api/mutator.d.ts

@@ -1,4 +1,23 @@
 import { VariableAction, BulkUpdatePayload } from '../types/mutations.js';
+/**
+ * Options for configuring mutator behavior.
+ *
+ * @public
+ */
+export interface MutatorOptions {
+    /**
+     * Optional AbortSignal to cancel the request.
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional timeout in milliseconds. Creates an AbortSignal internally if provided.
+     */
+    timeout?: number;
+    /**
+     * Optional fetch implementation override (useful for testing or custom fetch implementations).
+     */
+    fetch?: typeof fetch;
+}
 /**
  * Low-level utility to send authenticated POST, PUT, or DELETE requests to the Figma Variables REST API.
  *
@@ -7,15 +26,19 @@ import { VariableAction, BulkUpdatePayload } from '../types/mutations.js';
  * It handles JSON serialization of the request body, parses JSON responses, and propagates detailed errors.
  * Intended primarily for internal use by mutation hooks, but also suitable for direct custom API mutations.
  *
+ * Supports request cancellation via AbortSignal and timeout handling.
+ *
  * @typeParam TResponse - The expected response type returned from the Figma API.
  * @param url - The full Figma REST API endpoint URL (e.g., 'https://api.figma.com/v1/files/{file_key}/variables').
  * @param token - Figma Personal Access Token (PAT) used for authentication.
  * @param action - The action for the mutation: 'CREATE', 'UPDATE', or 'DELETE'.
  * @param body - Optional request payload. For bulk operations, use BulkUpdatePayload. For individual operations, use objects with `variables` array.
+ * @param options - Optional configuration for abort signal, timeout, or custom fetch implementation.
  *
  * @returns A Promise resolving to the parsed JSON response from the Figma API.
  *
  * @throws Throws a FigmaApiError if the token is not provided or if the HTTP response is unsuccessful.
+ * @throws Throws an AbortError if the request is aborted or times out.
  *
  * @example
  * ```ts
@@ -27,9 +50,12 @@ import { VariableAction, BulkUpdatePayload } from '../types/mutations.js';
  *   const result = await mutator(url, token, 'UPDATE', payload);
  *   return result;
  * }
+ *
+ * // With timeout:
+ * const result = await mutator(url, token, 'UPDATE', payload, { timeout: 5000 });
  * ```
  */
 export declare function mutator<TResponse = unknown>(url: string, token: string, action: VariableAction, body?: BulkUpdatePayload | {
     variables?: Array<Record<string, unknown>>;
-} | Record<string, unknown>): Promise<TResponse>;
+} | Record<string, unknown>, options?: MutatorOptions): Promise<TResponse>;
 //# sourceMappingURL=mutator.d.ts.map

package/dist/api/mutator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../../src/api/mutator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EACD,iBAAiB,GACjB;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,OAAO,CAAC,SAAS,CAAC,CAwDpB"}
+{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../../src/api/mutator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAC/C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EACD,iBAAiB,GACjB;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAyGpB"}

package/dist/contexts/FigmaVarsProvider.d.ts

@@ -7,6 +7,8 @@ import { FigmaVarsProviderProps } from '../types/contexts';
  *
  * This is the central source of truth for Figma authentication and file context within the app.
  *
+ * Fallback JSON files are parsed once during provider initialization to avoid repeated parsing and provide early validation.
+ *
  * @example
  * ```tsx
  * import { FigmaVarsProvider } from '@figma-vars/hooks/contexts';

package/dist/contexts/FigmaVarsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FigmaVarsProvider.d.ts","sourceRoot":"","sources":["../../src/contexts/FigmaVarsProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,gBAAgB,CAAA;AAMvB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,GAAI,wDAM/B,sBAAsB,4CAsBxB,CAAA"}
+{"version":3,"file":"FigmaVarsProvider.d.ts","sourceRoot":"","sources":["../../src/contexts/FigmaVarsProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,gBAAgB,CAAA;AAIvB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,iBAAiB,GAAI,wDAM/B,sBAAsB,4CAqFxB,CAAA"}

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./index-BIUpDTdr.cjs");exports.CONTENT_TYPE_JSON=_.CONTENT_TYPE_JSON;exports.ERROR_MSG_BULK_UPDATE_FAILED=_.ERROR_MSG_BULK_UPDATE_FAILED;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=_.ERROR_MSG_CREATE_VARIABLE_FAILED;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=_.ERROR_MSG_DELETE_VARIABLE_FAILED;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=_.ERROR_MSG_FETCH_FIGMA_DATA_FAILED;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=_.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED;exports.ERROR_MSG_TOKEN_REQUIRED=_.ERROR_MSG_TOKEN_REQUIRED;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=_.ERROR_MSG_UPDATE_VARIABLE_FAILED;exports.FIGMA_API_BASE_URL=_.FIGMA_API_BASE_URL;exports.FIGMA_FILES_ENDPOINT=_.FIGMA_FILES_ENDPOINT;exports.FIGMA_FILE_VARIABLES_PATH=_.FIGMA_FILE_VARIABLES_PATH;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=_.FIGMA_LOCAL_VARIABLES_ENDPOINT;exports.FIGMA_PUBLISHED_VARIABLES_PATH=_.FIGMA_PUBLISHED_VARIABLES_PATH;exports.FIGMA_TOKEN_HEADER=_.FIGMA_TOKEN_HEADER;exports.fetcher=_.fetcher;exports.filterVariables=_.filterVariables;exports.mutator=_.mutator;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./index-5ZyKWuYv.cjs");exports.CONTENT_TYPE_JSON=_.CONTENT_TYPE_JSON;exports.ERROR_MSG_BULK_UPDATE_FAILED=_.ERROR_MSG_BULK_UPDATE_FAILED;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=_.ERROR_MSG_CREATE_VARIABLE_FAILED;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=_.ERROR_MSG_DELETE_VARIABLE_FAILED;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=_.ERROR_MSG_FETCH_FIGMA_DATA_FAILED;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=_.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED;exports.ERROR_MSG_TOKEN_REQUIRED=_.ERROR_MSG_TOKEN_REQUIRED;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=_.ERROR_MSG_UPDATE_VARIABLE_FAILED;exports.FIGMA_API_BASE_URL=_.FIGMA_API_BASE_URL;exports.FIGMA_FILES_ENDPOINT=_.FIGMA_FILES_ENDPOINT;exports.FIGMA_FILE_VARIABLES_PATH=_.FIGMA_FILE_VARIABLES_PATH;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=_.FIGMA_LOCAL_VARIABLES_ENDPOINT;exports.FIGMA_PUBLISHED_VARIABLES_PATH=_.FIGMA_PUBLISHED_VARIABLES_PATH;exports.FIGMA_TOKEN_HEADER=_.FIGMA_TOKEN_HEADER;exports.fetcher=_.fetcher;exports.filterVariables=_.filterVariables;exports.mutator=_.mutator;

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { C as A, j as R, k as I, l as a, o as L, a as s, E as F, n as T, e as D, g as O, F as G, h as M, b as S, i as N, f as B, d as P, m as U } from "./index-Cd4HQQHO.js";
+import { C as A, j as R, k as I, l as a, o as L, a as s, E as F, n as T, d as D, e as O, F as G, h as M, g as S, i as N, f as B, c as P, m as U } from "./index-ClHLYVvu.js";
 export {
   A as CONTENT_TYPE_JSON,
   R as ERROR_MSG_BULK_UPDATE_FAILED,

package/dist/hooks/index.d.ts

@@ -160,4 +160,49 @@ export { useInvalidateVariables } from './useInvalidateVariables';
  * @public
  */
 export { usePublishedVariables } from './usePublishedVariables';
+/**
+ * React hook to select a single variable by ID from loaded Figma variables data.
+ *
+ * @remarks
+ * Returns the variable with the specified ID, or undefined if not found.
+ *
+ * @example
+ * ```tsx
+ * import { useVariableById } from '@figma-vars/hooks';
+ * const variable = useVariableById('VariableID:123:456');
+ * ```
+ *
+ * @public
+ */
+export { useVariableById } from './useVariableById';
+/**
+ * React hook to select a single variable collection by ID from loaded Figma variables data.
+ *
+ * @remarks
+ * Returns the collection with the specified ID, or undefined if not found.
+ *
+ * @example
+ * ```tsx
+ * import { useCollectionById } from '@figma-vars/hooks';
+ * const collection = useCollectionById('VariableCollectionId:123:456');
+ * ```
+ *
+ * @public
+ */
+export { useCollectionById } from './useCollectionById';
+/**
+ * React hook to select modes for a specific variable collection.
+ *
+ * @remarks
+ * Returns an array of modes belonging to the specified collection.
+ *
+ * @example
+ * ```tsx
+ * import { useModesByCollection } from '@figma-vars/hooks';
+ * const modes = useModesByCollection('VariableCollectionId:123:456');
+ * ```
+ *
+ * @public
+ */
+export { useModesByCollection } from './useModesByCollection';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACnE;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/hooks/useCollectionById.d.ts

@@ -0,0 +1,31 @@
+import { FigmaCollection } from 'types';
+/**
+ * React hook that selects a single variable collection by ID from loaded Figma variables data.
+ *
+ * @remarks
+ * Returns the collection with the specified ID, or `undefined` if not found.
+ * Useful for accessing a specific collection without manually mapping through all collections.
+ *
+ * @param collectionId - The ID of the collection to retrieve.
+ * @returns The collection object, or `undefined` if not found.
+ *
+ * @example
+ * ```tsx
+ * import { useCollectionById } from '@figma-vars/hooks';
+ *
+ * function CollectionDetails({ collectionId }: { collectionId: string }) {
+ *   const collection = useCollectionById(collectionId);
+ *
+ *   if (!collection) return <div>Collection not found</div>;
+ *
+ *   return <div>
+ *     <h2>{collection.name}</h2>
+ *     <p>Variables: {collection.variableIds.length}</p>
+ *   </div>;
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const useCollectionById: (collectionId: string) => FigmaCollection | undefined;
+//# sourceMappingURL=useCollectionById.d.ts.map

package/dist/hooks/useCollectionById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionById.d.ts","sourceRoot":"","sources":["../../src/hooks/useCollectionById.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,iBAAiB,GAC5B,cAAc,MAAM,KACnB,eAAe,GAAG,SAMpB,CAAA"}

package/dist/hooks/useInvalidateVariables.d.ts

@@ -5,6 +5,9 @@
  * Returns functions to invalidate and revalidate SWR cache for variables hooks.
  * Use this after mutations to ensure fresh data is fetched.
  *
+ * Supports both live API usage (with token and fileKey) and fallback-only usage
+ * (with fallbackFile but no fileKey).
+ *
  * @returns Object with `invalidate` and `revalidate` functions.
  *
  * @example

package/dist/hooks/useInvalidateVariables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInvalidateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useInvalidateVariables.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB;;;CAgElC,CAAA"}
+{"version":3,"file":"useInvalidateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useInvalidateVariables.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,sBAAsB;;;CAoDlC,CAAA"}

package/dist/hooks/useModesByCollection.d.ts

@@ -0,0 +1,34 @@
+import { VariableMode } from 'types';
+/**
+ * React hook that selects modes for a specific variable collection.
+ *
+ * @remarks
+ * Returns an array of modes belonging to the specified collection, or an empty array if not found.
+ * Useful for filtering modes by collection without manually accessing modesByCollectionId.
+ *
+ * @param collectionId - The ID of the collection to get modes for.
+ * @returns An array of VariableMode objects for the collection, or an empty array if not found.
+ *
+ * @example
+ * ```tsx
+ * import { useModesByCollection } from '@figma-vars/hooks';
+ *
+ * function CollectionModes({ collectionId }: { collectionId: string }) {
+ *   const modes = useModesByCollection(collectionId);
+ *
+ *   if (!modes.length) return <div>No modes found</div>;
+ *
+ *   return (
+ *     <ul>
+ *       {modes.map(mode => (
+ *         <li key={mode.modeId}>{mode.name}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const useModesByCollection: (collectionId: string) => VariableMode[];
+//# sourceMappingURL=useModesByCollection.d.ts.map

package/dist/hooks/useModesByCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModesByCollection.d.ts","sourceRoot":"","sources":["../../src/hooks/useModesByCollection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,YAAY,EAMvE,CAAA"}

package/dist/hooks/usePublishedVariables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublishedVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/usePublishedVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,qBAAqB,sMAsCjC,CAAA"}
+{"version":3,"file":"usePublishedVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/usePublishedVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,qBAAqB,sMA+CjC,CAAA"}

package/dist/hooks/useVariableById.d.ts

@@ -0,0 +1,31 @@
+import { FigmaVariable } from 'types';
+/**
+ * React hook that selects a single variable by ID from loaded Figma variables data.
+ *
+ * @remarks
+ * Returns the variable with the specified ID, or `undefined` if not found.
+ * Useful for accessing a specific variable without manually mapping through all variables.
+ *
+ * @param variableId - The ID of the variable to retrieve.
+ * @returns The variable object, or `undefined` if not found.
+ *
+ * @example
+ * ```tsx
+ * import { useVariableById } from '@figma-vars/hooks';
+ *
+ * function VariableDetails({ variableId }: { variableId: string }) {
+ *   const variable = useVariableById(variableId);
+ *
+ *   if (!variable) return <div>Variable not found</div>;
+ *
+ *   return <div>
+ *     <h2>{variable.name}</h2>
+ *     <p>Type: {variable.resolvedType}</p>
+ *   </div>;
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const useVariableById: (variableId: string) => FigmaVariable | undefined;
+//# sourceMappingURL=useVariableById.d.ts.map

package/dist/hooks/useVariableById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVariableById.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariableById.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,KACjB,aAAa,GAAG,SASlB,CAAA"}

package/dist/hooks/useVariables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAGzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,0LAyCxB,CAAA"}
+{"version":3,"file":"useVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAIzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,0LAgDxB,CAAA"}

package/dist/index-5ZyKWuYv.cjs

@@ -0,0 +1 @@
+"use strict";var N=Object.defineProperty;var g=(t,s,r)=>s in t?N(t,s,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[s]=r;var m=(t,s,r)=>g(t,typeof s!="symbol"?s+"":s,r);const T="https://api.figma.com",O=`${T}/v1/files`,v=t=>`/v1/files/${t}/variables/published`,P=t=>`/v1/files/${t}/variables`,y=t=>`${O}/${t}/variables/local`,D="application/json",p="X-FIGMA-TOKEN",h="A Figma API token is required.",B=`${h} and file key are required.`,U="Failed to perform bulk update.",w="Failed to create Figma variable.",b="Failed to delete Figma variable.",C="Failed to update Figma variable.",G="An error occurred while fetching data from the Figma API.";class l extends Error{constructor(r,o,c){super(r);m(this,"statusCode");m(this,"retryAfter");this.name="FigmaApiError",this.statusCode=o,this.retryAfter=c??void 0,Error.captureStackTrace&&Error.captureStackTrace(this,l)}}async function V(t,s,r){if(!s)throw new Error(h);const{signal:o,timeout:c,fetch:F=fetch}=r??{};let i,A;const a=o||(c?(A=new AbortController,i=setTimeout(()=>{A==null||A.abort()},c),A.signal):void 0);try{const E=t.startsWith("http://")||t.startsWith("https://")?t:`${T}${t.startsWith("/")?"":"/"}${t}`,n=await F(E,{method:"GET",headers:{[p]:s,"Content-Type":D},...a!==void 0&&{signal:a}});if(i!==void 0&&(clearTimeout(i),i=void 0),!n.ok){let R=G;const L=n.status;let d;if(L===429){const _=n.headers.get("Retry-After");if(_){const e=parseInt(_,10);Number.isNaN(e)||(d=e)}}try{const _=n.headers.get("content-type");if(_!=null&&_.includes("application/json")){const e=await n.json();e!=null&&e.message?R=e.message:e!=null&&e.err&&(R=e.err)}}catch{}throw new l(R,L,d)}return n.json()}catch(E){throw i!==void 0&&(clearTimeout(i),i=void 0),E}}async function H(t,s,r,o,c){if(!s)throw new Error(h);const{signal:F,timeout:i,fetch:A=fetch}=c??{};let a,E;const n=F||(i?(E=new AbortController,a=setTimeout(()=>{E==null||E.abort()},i),E.signal):void 0);try{const d={method:{CREATE:"POST",UPDATE:"PUT",DELETE:"DELETE"}[r],headers:{"Content-Type":"application/json",[p]:s},...n!==void 0&&{signal:n}};o&&(d.body=JSON.stringify(o));const _=t.startsWith("http://")||t.startsWith("https://")?t:`${T}${t.startsWith("/")?"":"/"}${t}`,e=await A(_,d);if(a!==void 0&&(clearTimeout(a),a=void 0),!e.ok){const S=e.status;let u="An API error occurred",M;if(S===429){const I=e.headers.get("Retry-After");if(I){const f=parseInt(I,10);Number.isNaN(f)||(M=f)}}try{const I=e.headers.get("content-type");if(I!=null&&I.includes("application/json")){const f=await e.json();u=f.err||f.message||u}}catch{}throw new l(u,S,M)}return e.status===204||!e.body?{}:e.json()}catch(R){throw a!==void 0&&(clearTimeout(a),a=void 0),R}}function $(t,s){return t.filter(r=>{let o=!0;return s.resolvedType&&(o=o&&r.resolvedType===s.resolvedType),s.name&&(o=o&&r.name.includes(s.name)),o})}exports.CONTENT_TYPE_JSON=D;exports.ERROR_MSG_BULK_UPDATE_FAILED=U;exports.ERROR_MSG_CREATE_VARIABLE_FAILED=w;exports.ERROR_MSG_DELETE_VARIABLE_FAILED=b;exports.ERROR_MSG_FETCH_FIGMA_DATA_FAILED=G;exports.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED=B;exports.ERROR_MSG_TOKEN_REQUIRED=h;exports.ERROR_MSG_UPDATE_VARIABLE_FAILED=C;exports.FIGMA_API_BASE_URL=T;exports.FIGMA_FILES_ENDPOINT=O;exports.FIGMA_FILE_VARIABLES_PATH=P;exports.FIGMA_LOCAL_VARIABLES_ENDPOINT=y;exports.FIGMA_PUBLISHED_VARIABLES_PATH=v;exports.FIGMA_TOKEN_HEADER=p;exports.FigmaApiError=l;exports.fetcher=V;exports.filterVariables=$;exports.mutator=H;

package/dist/index-ClHLYVvu.js

@@ -0,0 +1,142 @@
+var L = Object.defineProperty;
+var S = (t, s, r) => s in t ? L(t, s, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[s] = r;
+var I = (t, s, r) => S(t, typeof s != "symbol" ? s + "" : s, r);
+const T = "https://api.figma.com", M = `${T}/v1/files`, D = (t) => `/v1/files/${t}/variables/published`, G = (t) => `/v1/files/${t}/variables`, b = (t) => `${M}/${t}/variables/local`, N = "application/json", y = "X-FIGMA-TOKEN", F = "A Figma API token is required.", P = `${F} and file key are required.`, C = "Failed to perform bulk update.", $ = "Failed to create Figma variable.", U = "Failed to delete Figma variable.", j = "Failed to update Figma variable.", O = "An error occurred while fetching data from the Figma API.";
+class p extends Error {
+  constructor(r, a, A) {
+    super(r);
+    /** HTTP status code from the API response. */
+    I(this, "statusCode");
+    /**
+     * Retry-After header value in seconds (for 429 rate limit errors).
+     * Undefined if not a rate limit error or header not present.
+     */
+    I(this, "retryAfter");
+    this.name = "FigmaApiError", this.statusCode = a, this.retryAfter = A ?? void 0, Error.captureStackTrace && Error.captureStackTrace(this, p);
+  }
+}
+async function B(t, s, r) {
+  if (!s)
+    throw new Error(F);
+  const {
+    signal: a,
+    timeout: A,
+    fetch: u = fetch
+  } = r ?? {};
+  let o, d;
+  const i = a || (A ? (d = new AbortController(), o = setTimeout(() => {
+    d == null || d.abort();
+  }, A), d.signal) : void 0);
+  try {
+    const n = t.startsWith("http://") || t.startsWith("https://") ? t : `${T}${t.startsWith("/") ? "" : "/"}${t}`, c = await u(n, {
+      method: "GET",
+      headers: {
+        [y]: s,
+        "Content-Type": N
+      },
+      ...i !== void 0 && { signal: i }
+    });
+    if (o !== void 0 && (clearTimeout(o), o = void 0), !c.ok) {
+      let f = O;
+      const m = c.status;
+      let h;
+      if (m === 429) {
+        const E = c.headers.get("Retry-After");
+        if (E) {
+          const e = parseInt(E, 10);
+          Number.isNaN(e) || (h = e);
+        }
+      }
+      try {
+        const E = c.headers.get("content-type");
+        if (E != null && E.includes("application/json")) {
+          const e = await c.json();
+          e != null && e.message ? f = e.message : e != null && e.err && (f = e.err);
+        }
+      } catch {
+      }
+      throw new p(f, m, h);
+    }
+    return c.json();
+  } catch (n) {
+    throw o !== void 0 && (clearTimeout(o), o = void 0), n;
+  }
+}
+async function H(t, s, r, a, A) {
+  if (!s)
+    throw new Error(F);
+  const {
+    signal: u,
+    timeout: o,
+    fetch: d = fetch
+  } = A ?? {};
+  let i, n;
+  const c = u || (o ? (n = new AbortController(), i = setTimeout(() => {
+    n == null || n.abort();
+  }, o), n.signal) : void 0);
+  try {
+    const h = {
+      method: {
+        CREATE: "POST",
+        UPDATE: "PUT",
+        DELETE: "DELETE"
+      }[r],
+      headers: {
+        "Content-Type": "application/json",
+        [y]: s
+      },
+      ...c !== void 0 && { signal: c }
+    };
+    a && (h.body = JSON.stringify(a));
+    const E = t.startsWith("http://") || t.startsWith("https://") ? t : `${T}${t.startsWith("/") ? "" : "/"}${t}`, e = await d(E, h);
+    if (i !== void 0 && (clearTimeout(i), i = void 0), !e.ok) {
+      const g = e.status;
+      let R = "An API error occurred", v;
+      if (g === 429) {
+        const l = e.headers.get("Retry-After");
+        if (l) {
+          const _ = parseInt(l, 10);
+          Number.isNaN(_) || (v = _);
+        }
+      }
+      try {
+        const l = e.headers.get("content-type");
+        if (l != null && l.includes("application/json")) {
+          const _ = await e.json();
+          R = _.err || _.message || R;
+        }
+      } catch {
+      }
+      throw new p(R, g, v);
+    }
+    return e.status === 204 || !e.body ? {} : e.json();
+  } catch (f) {
+    throw i !== void 0 && (clearTimeout(i), i = void 0), f;
+  }
+}
+function V(t, s) {
+  return t.filter((r) => {
+    let a = !0;
+    return s.resolvedType && (a = a && r.resolvedType === s.resolvedType), s.name && (a = a && r.name.includes(s.name)), a;
+  });
+}
+export {
+  N as C,
+  F as E,
+  G as F,
+  P as a,
+  p as b,
+  V as c,
+  T as d,
+  M as e,
+  B as f,
+  D as g,
+  b as h,
+  y as i,
+  C as j,
+  $ as k,
+  U as l,
+  H as m,
+  j as n,
+  O as o
+};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("react/jsx-runtime"),i=require("react"),b=require("swr"),o=require("./index-BIUpDTdr.cjs"),p=i.createContext(void 0);let v=0;const k=({children:e,token:r,fileKey:t,fallbackFile:s,swrConfig:n})=>{const a=i.useMemo(()=>(v+=1,`figma-vars-provider-${v}`),[]),c=i.useMemo(()=>{const l={token:r,fileKey:t,providerId:a,...n!==void 0&&{swrConfig:n}};return s===void 0?l:{...l,fallbackFile:s}},[r,t,s,a,n]);return h.jsx(p.Provider,{value:c,children:e})},d=()=>{const e=i.useContext(p);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e},_=()=>{const{token:e,fileKey:r,fallbackFile:t,providerId:s,swrConfig:n}=d(),a=r?`https://api.figma.com/v1/files/${r}/variables/local`:null,E=!!(e&&a)?[a,e]:!!t?[`fallback-${s??"default"}`,"fallback"]:null;return b(E,async(...u)=>{const[f,R]=Array.isArray(u[0])?u[0]:[u[0],u[1]];if(t)return typeof t=="string"?JSON.parse(t):t;if(!f||!R)throw new Error("Missing URL or token for live API request");return o.fetcher(f,R)},n)},w=()=>{const{data:e}=_(),r=i.useMemo(()=>e!=null&&e.meta?Object.values(e.meta.variableCollections):[],[e]),t=i.useMemo(()=>e!=null&&e.meta?e.meta.variableCollections:{},[e]);return{collections:r,collectionsById:t}},S=()=>{const{data:e}=_();return i.useMemo(()=>{const r=[],t={},s={};if(e!=null&&e.meta)for(const n of Object.values(e.meta.variableCollections)){r.push(...n.modes),t[n.id]=n.modes;for(const a of n.modes)s[a.modeId]=a}return{modes:r,modesByCollectionId:t,modesById:s}},[e])};function V(e,r){switch(r.type){case"loading":return{...e,status:"loading",error:null};case"success":return{...e,status:"success",data:r.payload};case"error":return{...e,status:"error",error:r.payload};default:return e}}const m=e=>{const r={status:"idle",data:null,error:null},[t,s]=i.useReducer(V,r),n=i.useRef(e),a=i.useRef(!0);return i.useEffect(()=>{n.current=e},[e]),i.useEffect(()=>(a.current=!0,()=>{a.current=!1}),[]),{mutate:i.useCallback(async l=>{if(a.current){s({type:"loading"});try{const E=await n.current(l);return a.current&&s({type:"success",payload:E}),E}catch(E){a.current&&s({type:"error",payload:E});return}}},[]),...t,isLoading:t.status==="loading",isSuccess:t.status==="success",isError:t.status==="error"}},F=()=>{const{token:e,fileKey:r}=d();return m(async s=>{if(!e)throw new Error(o.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(o.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await o.mutator(o.FIGMA_FILE_VARIABLES_PATH(r),e,"CREATE",{variables:[{action:"CREATE",...s}]})})},g=()=>{const{token:e,fileKey:r}=d();return m(async({variableId:s,payload:n})=>{if(!e)throw new Error(o.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(o.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await o.mutator(o.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",{variables:[{action:"UPDATE",id:s,...n}]})})},M=()=>{const{token:e,fileKey:r}=d();return m(async s=>{if(!e)throw new Error(o.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(o.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await o.mutator(o.FIGMA_FILE_VARIABLES_PATH(r),e,"DELETE",{variables:[{action:"DELETE",id:s}]})})},L=()=>{const{token:e,fileKey:r}=d();return m(async s=>{if(!e)throw new Error(o.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(o.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await o.mutator(o.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",s)})},T=()=>{const{mutate:e}=b.useSWRConfig(),{fileKey:r,providerId:t}=d();return{invalidate:()=>{if(!r)return;const a=[`https://api.figma.com/v1/files/${r}/variables/local`,"token-placeholder"];e(a);const c=[o.FIGMA_PUBLISHED_VARIABLES_PATH(r),"token-placeholder"];if(e(c),t){const l=[`fallback-${t}`,"fallback"];e(l)}},revalidate:()=>{if(!r)return;const a=[`https://api.figma.com/v1/files/${r}/variables/local`,"token-placeholder"];e(a,void 0,{revalidate:!0});const c=[o.FIGMA_PUBLISHED_VARIABLES_PATH(r),"token-placeholder"];if(e(c,void 0,{revalidate:!0}),t){const l=[`fallback-${t}`,"fallback"];e(l,void 0,{revalidate:!0})}}}},K=()=>{const{token:e,fileKey:r,fallbackFile:t,providerId:s,swrConfig:n}=d(),a=r?o.FIGMA_PUBLISHED_VARIABLES_PATH(r):null,E=!!(e&&a)?[a,e]:!!t?[`fallback-${s??"default"}`,"fallback"]:null;return b(E,async(...u)=>{const[f,R]=Array.isArray(u[0])?u[0]:[u[0],u[1]];if(t)return typeof t=="string"?JSON.parse(t):t;if(!f||!R)throw new Error("Missing URL or token for live API request");return o.fetcher(f,R)},n)};function I(e){return e instanceof o.FigmaApiError}function A(e){return I(e)?e.statusCode:null}function P(e,r="An error occurred"){return e instanceof Error?e.message||r:typeof e=="string"?e:r}function O(e,r){return A(e)===r}exports.FigmaApiError=o.FigmaApiError;exports.filterVariables=o.filterVariables;exports.FigmaVarsProvider=k;exports.getErrorMessage=P;exports.getErrorStatus=A;exports.hasErrorStatus=O;exports.isFigmaApiError=I;exports.useBulkUpdateVariables=L;exports.useCreateVariable=F;exports.useDeleteVariable=M;exports.useInvalidateVariables=T;exports.usePublishedVariables=K;exports.useUpdateVariable=g;exports.useVariableCollections=w;exports.useVariableModes=S;exports.useVariables=_;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("react/jsx-runtime"),u=require("react"),m=require("swr"),i=require("./index-5ZyKWuYv.cjs"),k=u.createContext(void 0);function A(e){if(typeof e!="object"||e===null)return!1;const r=e;if(typeof r.meta!="object"||r.meta===null)return!1;const t=r.meta;return!(typeof t.variableCollections!="object"||t.variableCollections===null||typeof t.variables!="object"||t.variables===null)}function _(e){if(A(e))return e}const V=({children:e,token:r,fileKey:t,fallbackFile:o,swrConfig:s})=>{const a=u.useId(),l=u.useMemo(()=>`figma-vars-provider-${a}`,[a]),f=u.useMemo(()=>{if(o){if(typeof o=="object"){const n=_(o);if(n)return n;process.env.NODE_ENV!=="production"&&console.warn("[figma-vars-hooks] fallbackFile object does not match expected Figma Variables API response structure. Expected { meta: { variableCollections: {...}, variables: {...} } }");return}if(typeof o=="string")try{const n=JSON.parse(o),d=_(n);if(d)return d;process.env.NODE_ENV!=="production"&&console.warn("[figma-vars-hooks] Parsed fallbackFile JSON does not match expected Figma Variables API response structure. Expected { meta: { variableCollections: {...}, variables: {...} } }");return}catch(n){process.env.NODE_ENV!=="production"&&console.error(`[figma-vars-hooks] Failed to parse fallbackFile JSON: ${n instanceof Error?n.message:"Unknown error"}`);return}}},[o]),c=u.useMemo(()=>{const n={token:r,fileKey:t,providerId:l,...s!==void 0&&{swrConfig:s}};return o===void 0?n:{...n,fallbackFile:o,parsedFallbackFile:f}},[r,t,o,f,l,s]);return g.jsx(k.Provider,{value:c,children:e})},b=()=>{const e=u.useContext(k);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e};function M(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e;return!!(t&&r)&&t&&r?[`https://api.figma.com/v1/files/${r}/variables/local`,t]:s?[`fallback-${o??"default"}`,"fallback"]:null}function O(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e;return!!(t&&r)&&t&&r?[`https://api.figma.com/v1/files/${r}/variables/published`,t]:s?[`fallback-${o??"default"}`,"fallback"]:null}function I(e){const{fileKey:r,token:t,providerId:o,hasFallback:s}=e,a=[];return t&&r&&(a.push([`https://api.figma.com/v1/files/${r}/variables/local`,t]),a.push([`https://api.figma.com/v1/files/${r}/variables/published`,t])),s&&o&&a.push([`fallback-${o}`,"fallback"]),a}const R=()=>{const{token:e,fileKey:r,fallbackFile:t,parsedFallbackFile:o,providerId:s,swrConfig:a}=b(),f=M({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return m(f,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[d,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!d||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(d,E)},a)},S=()=>{const{data:e}=R(),r=u.useMemo(()=>e!=null&&e.meta?Object.values(e.meta.variableCollections):[],[e]),t=u.useMemo(()=>e!=null&&e.meta?e.meta.variableCollections:{},[e]);return{collections:r,collectionsById:t}},K=()=>{const{data:e}=R();return u.useMemo(()=>{const r=[],t={},o={};if(e!=null&&e.meta)for(const s of Object.values(e.meta.variableCollections)){r.push(...s.modes),t[s.id]=s.modes;for(const a of s.modes)o[a.modeId]=a}return{modes:r,modesByCollectionId:t,modesById:o}},[e])};function T(e,r){switch(r.type){case"loading":return{...e,status:"loading",error:null};case"success":return{...e,status:"success",data:r.payload};case"error":return{...e,status:"error",error:r.payload};default:return e}}const v=(e,r)=>{const{throwOnError:t=!1}={},o={status:"idle",data:null,error:null},[s,a]=u.useReducer(T,o),l=u.useRef(e),f=u.useRef({throwOnError:t}),c=u.useRef(!0),n=u.useRef(0);return u.useEffect(()=>{l.current=e,f.current={throwOnError:t}},[e,t]),u.useEffect(()=>(c.current=!0,()=>{c.current=!1}),[]),{mutate:u.useCallback(async E=>{if(!c.current)return;const y=++n.current;a({type:"loading"});try{const p=await l.current(E);return c.current&&y===n.current&&a({type:"success",payload:p}),p}catch(p){const h=p;if(c.current&&y===n.current&&a({type:"error",payload:h}),f.current.throwOnError)throw h;return}},[]),...s,isLoading:s.status==="loading",isSuccess:s.status==="success",isError:s.status==="error"}},C=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"CREATE",{variables:[{action:"CREATE",...o}]})})},L=()=>{const{token:e,fileKey:r}=b();return v(async({variableId:o,payload:s})=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",{variables:[{action:"UPDATE",id:o,...s}]})})},P=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"DELETE",{variables:[{action:"DELETE",id:o}]})})},D=()=>{const{token:e,fileKey:r}=b();return v(async o=>{if(!e)throw new Error(i.ERROR_MSG_TOKEN_REQUIRED);if(!r)throw new Error(i.ERROR_MSG_TOKEN_FILE_KEY_REQUIRED);return await i.mutator(i.FIGMA_FILE_VARIABLES_PATH(r),e,"UPDATE",o)})},U=()=>{const{mutate:e}=m.useSWRConfig(),{token:r,fileKey:t,fallbackFile:o,providerId:s}=b(),a=!!o;return{invalidate:()=>{const c=I({fileKey:t,token:r,providerId:s,hasFallback:a});for(const n of c)e(n)},revalidate:()=>{const c=I({fileKey:t,token:r,providerId:s,hasFallback:a});for(const n of c)e(n,void 0,{revalidate:!0})}}},N=()=>{const{token:e,fileKey:r,fallbackFile:t,parsedFallbackFile:o,providerId:s,swrConfig:a}=b(),f=O({fileKey:r,token:e,providerId:s,hasFallback:!!(t||o)});return m(f,async(...n)=>{if(o)return o;if(t&&typeof t=="object")return t;const[d,E]=Array.isArray(n[0])?n[0]:[n[0],n[1]];if(!d||!E)throw new Error("Missing URL or token for live API request");return i.fetcher(d,E)},a)};function w(e){return e instanceof i.FigmaApiError}function F(e){return w(e)?e.statusCode:null}function j(e,r="An error occurred"){return e instanceof Error?e.message||r:typeof e=="string"?e:r}function B(e,r){return F(e)===r}exports.FigmaApiError=i.FigmaApiError;exports.filterVariables=i.filterVariables;exports.FigmaVarsProvider=V;exports.getErrorMessage=j;exports.getErrorStatus=F;exports.hasErrorStatus=B;exports.isFigmaApiError=w;exports.useBulkUpdateVariables=D;exports.useCreateVariable=C;exports.useDeleteVariable=P;exports.useInvalidateVariables=U;exports.usePublishedVariables=N;exports.useUpdateVariable=L;exports.useVariableCollections=S;exports.useVariableModes=K;exports.useVariables=R;