@figma-vars/hooks 3.0.0-beta.1 → 3.0.0

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,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}
+{"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"}

package/dist/api/mutator.d.ts

@@ -1,4 +1,4 @@
-import { VariableAction } from '../types/mutations';
+import { VariableAction, BulkUpdatePayload } from '../types/mutations.js';
 /**
  * Low-level utility to send authenticated POST, PUT, or DELETE requests to the Figma Variables REST API.
  *
@@ -7,28 +7,29 @@ import { VariableAction } from '../types/mutations';
  * 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.
  *
- * @typeParam T - The expected response type returned from the Figma API.
+ * @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 sent as a JSON string.
+ * @param body - Optional request payload. For bulk operations, use BulkUpdatePayload. For individual operations, use objects with `variables` array.
  *
  * @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 unsuccessful, including the error message from the API or a default message.
+ * @throws Throws a FigmaApiError if the token is not provided or if the HTTP response is unsuccessful.
  *
  * @example
  * ```ts
  * import { mutator } from '@figma-vars/hooks/api';
  *
  * async function updateVariable(fileKey: string, token: string, variableId: string) {
- *   const url = `https://api.figma.com/v1/files/${fileKey}/variables/${variableId}`;
- *   const payload = { name: 'Updated Name' };
- *   const result = await mutator(url, token, 'PUT', payload);
+ *   const url = `https://api.figma.com/v1/files/${fileKey}/variables`;
+ *   const payload = { variables: [{ action: 'UPDATE', id: variableId, name: 'Updated Name' }] };
+ *   const result = await mutator(url, token, 'UPDATE', payload);
  *   return result;
  * }
  * ```
  */
-export declare function mutator<TResponse = unknown, TBody extends Record<string, unknown> = Record<string, unknown>>(url: string, token: string, action: VariableAction, body?: TBody): Promise<TResponse>;
+export declare function mutator<TResponse = unknown>(url: string, token: string, action: VariableAction, body?: BulkUpdatePayload | {
+    variables?: Array<Record<string, unknown>>;
+} | Record<string, unknown>): 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":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,KAAK,GACX,OAAO,CAAC,SAAS,CAAC,CAqCpB"}
+{"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"}

package/dist/constants/index.d.ts

@@ -11,34 +11,8 @@
  */
 export declare const FIGMA_API_BASE_URL = "https://api.figma.com";
 export declare const FIGMA_FILES_ENDPOINT = "https://api.figma.com/v1/files";
-/**
- * Builds the Figma Variables endpoint URL for a given file key.
- *
- * @param fileKey - The unique key of the Figma file.
- * @returns The URL string to access variables in the specified file.
- *
- * @example
- * ```ts
- * const url = FIGMA_VARIABLES_ENDPOINT('your-file-key')
- * ```
- */
-export declare const FIGMA_VARIABLES_ENDPOINT: (fileKey: string) => string;
-/**
- * The base endpoint for creating new variables via POST requests.
- */
-export declare const FIGMA_POST_VARIABLES_ENDPOINT = "https://api.figma.com/v1/variables";
-/**
- * Builds the URL to access a specific Figma variable by its ID.
- *
- * @param variableId - The unique ID of the Figma variable.
- * @returns The URL string to access the variable.
- *
- * @example
- * ```ts
- * const url = FIGMA_VARIABLE_BY_ID_ENDPOINT('variable-id')
- * ```
- */
-export declare const FIGMA_VARIABLE_BY_ID_ENDPOINT: (variableId: string) => string;
+export declare const FIGMA_PUBLISHED_VARIABLES_PATH: (fileKey: string) => string;
+export declare const FIGMA_FILE_VARIABLES_PATH: (fileKey: string) => string;
 /**
  * Builds the URL to fetch local variables for a given Figma file.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAE1D,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AAIrE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,WACR,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,6BAA6B,uCAAmC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,GAAI,YAAY,MAAM,WACX,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS,MAAM,WACR,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,iCAAiC,8DAA2D,CAAC;AAE1G;;GAEG;AACH,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,iCAAiC,8DACe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,kBAAkB,0BAA0B,CAAA;AAEzD,eAAO,MAAM,oBAAoB,mCAAmC,CAAA;AAEpE,eAAO,MAAM,8BAA8B,GAAI,SAAS,MAAM,WAClB,CAAA;AAE5C,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,WACvB,CAAA;AAElC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS,MAAM,WACR,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,wBAAwB,mCAAmC,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,iCAAiC,8DAA2D,CAAA;AAEzG;;GAEG;AACH,eAAO,MAAM,4BAA4B,mCAAmC,CAAA;AAE5E;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCACT,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCACT,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,gCAAgC,qCACT,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,iCAAiC,8DACe,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"FigmaTokenContext.d.ts","sourceRoot":"","sources":["../../src/contexts/FigmaTokenContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,eAAO,MAAM,iBAAiB,4DAA8D,CAAC"}
+{"version":3,"file":"FigmaTokenContext.d.ts","sourceRoot":"","sources":["../../src/contexts/FigmaTokenContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE3D,eAAO,MAAM,iBAAiB,4DAElB,CAAA"}

package/dist/contexts/FigmaVarsProvider.d.ts

@@ -22,5 +22,5 @@ import { FigmaVarsProviderProps } from '../types/contexts';
  *
  * @public
  */
-export declare const FigmaVarsProvider: ({ children, token, fileKey, fallbackFile, }: FigmaVarsProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FigmaVarsProvider: ({ children, token, fileKey, fallbackFile, swrConfig, }: FigmaVarsProviderProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=FigmaVarsProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FigmaVarsProvider.d.ts","sourceRoot":"","sources":["../../src/contexts/FigmaVarsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGpF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,GAAI,6CAK/B,sBAAsB,4CAUxB,CAAC"}
+{"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"}

package/dist/contexts/index.d.ts

@@ -18,7 +18,7 @@
  * }
  * ```
  */
-export { FigmaVarsProvider, } from './FigmaVarsProvider';
+export { FigmaVarsProvider } from './FigmaVarsProvider';
 export { useFigmaTokenContext } from './useFigmaTokenContext';
 export { FigmaTokenContext } from './FigmaTokenContext';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useFigmaTokenContext.d.ts","sourceRoot":"","sources":["../../src/contexts/useFigmaTokenContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,eAAO,MAAM,oBAAoB,QAAO,qBAMvC,CAAC"}
+{"version":3,"file":"useFigmaTokenContext.d.ts","sourceRoot":"","sources":["../../src/contexts/useFigmaTokenContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE3D,eAAO,MAAM,oBAAoB,QAAO,qBAQvC,CAAA"}

package/dist/core/index.d.cts

@@ -0,0 +1,8 @@
+import { fetcher } from '../api/fetcher.js';
+import { mutator } from '../api/mutator.js';
+import { filterVariables } from '../utils/filterVariables.js';
+export { fetcher, mutator, filterVariables };
+export * from '../constants/index.js';
+export type * from '../types/figma.js';
+export type * from '../types/mutations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+import { fetcher } from '../api/fetcher.js';
+import { mutator } from '../api/mutator.js';
+import { filterVariables } from '../utils/filterVariables.js';
+export { fetcher, mutator, filterVariables };
+export * from '../constants/index.js';
+export type * from '../types/figma.js';
+export type * from '../types/mutations.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,uBAAuB,CAAA"}

package/dist/core.cjs

@@ -0,0 +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;

package/dist/core.d.cts

@@ -0,0 +1,2 @@
+export * from './core/index'
+export {}

package/dist/core.d.ts

@@ -0,0 +1,2 @@
+export * from './core/index'
+export {}

package/dist/core.mjs

@@ -0,0 +1,20 @@
+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";
+export {
+  A as CONTENT_TYPE_JSON,
+  R as ERROR_MSG_BULK_UPDATE_FAILED,
+  I as ERROR_MSG_CREATE_VARIABLE_FAILED,
+  a as ERROR_MSG_DELETE_VARIABLE_FAILED,
+  L as ERROR_MSG_FETCH_FIGMA_DATA_FAILED,
+  s as ERROR_MSG_TOKEN_FILE_KEY_REQUIRED,
+  F as ERROR_MSG_TOKEN_REQUIRED,
+  T as ERROR_MSG_UPDATE_VARIABLE_FAILED,
+  D as FIGMA_API_BASE_URL,
+  O as FIGMA_FILES_ENDPOINT,
+  G as FIGMA_FILE_VARIABLES_PATH,
+  M as FIGMA_LOCAL_VARIABLES_ENDPOINT,
+  S as FIGMA_PUBLISHED_VARIABLES_PATH,
+  N as FIGMA_TOKEN_HEADER,
+  B as fetcher,
+  P as filterVariables,
+  U as mutator
+};

package/dist/hooks/index.d.ts

@@ -141,4 +141,23 @@ export { useDeleteVariable } from './useDeleteVariable';
  * @public
  */
 export { useBulkUpdateVariables } from './useBulkUpdateVariables';
+export { useInvalidateVariables } from './useInvalidateVariables';
+/**
+ * React hook to fetch published Figma Variables from a file.
+ *
+ * @remarks
+ * Fetches variables that have been published to a library. Published variables
+ * are shared across files and represent the source of truth for design tokens.
+ *
+ * @see {@link https://www.figma.com/developers/api#variables | Figma Variables API}
+ *
+ * @example
+ * ```tsx
+ * import { usePublishedVariables } from '@figma-vars/hooks';
+ * const { data, isLoading } = usePublishedVariables();
+ * ```
+ *
+ * @public
+ */
+export { usePublishedVariables } from './usePublishedVariables';
 //# 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,CAAC;AAClD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}
+{"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"useBulkUpdateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useBulkUpdateVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAOzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,sBAAsB,4EAclC,CAAC"}
+{"version":3,"file":"useBulkUpdateVariables.d.ts","sourceRoot":"","sources":["../../src/hooks/useBulkUpdateVariables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,sBAAsB,4EAiBlC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useCreateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useCreateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAO7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,iBAAiB,gFAc7B,CAAC"}
+{"version":3,"file":"useCreateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useCreateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,iBAAiB,gFAmB7B,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useDeleteVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useDeleteVariable.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,oDAc7B,CAAC"}
+{"version":3,"file":"useDeleteVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useDeleteVariable.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,oDAmB7B,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useFigmaToken.d.ts","sourceRoot":"","sources":["../../src/hooks/useFigmaToken.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,aAAa,QAAO,MAAM,GAAG,IAGlC,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"useFigmaToken.d.ts","sourceRoot":"","sources":["../../src/hooks/useFigmaToken.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,aAAa,QAAO,MAAM,GAAG,IAGlC,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/hooks/useInvalidateVariables.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hook that provides cache invalidation utilities for Figma variables.
+ *
+ * @remarks
+ * Returns functions to invalidate and revalidate SWR cache for variables hooks.
+ * Use this after mutations to ensure fresh data is fetched.
+ *
+ * @returns Object with `invalidate` and `revalidate` functions.
+ *
+ * @example
+ * ```tsx
+ * import { useInvalidateVariables, useUpdateVariable } from '@figma-vars/hooks';
+ *
+ * function UpdateButton() {
+ *   const { mutate } = useUpdateVariable();
+ *   const { invalidate } = useInvalidateVariables();
+ *
+ *   const handleUpdate = async () => {
+ *     await mutate({ variableId: 'id', payload: { name: 'New Name' } });
+ *     invalidate(); // Refetch all variable queries
+ *   };
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare const useInvalidateVariables: () => {
+    invalidate: () => void;
+    revalidate: () => void;
+};
+//# sourceMappingURL=useInvalidateVariables.d.ts.map

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

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

package/dist/hooks/usePublishedVariables.d.ts

@@ -0,0 +1,42 @@
+import { PublishedVariablesResponse } from '../types/figma';
+/**
+ * Hook to fetch published Figma Variables from a file.
+ *
+ * @remarks
+ * This hook fetches variables that have been published to a library in Figma.
+ * Published variables are shared across files and represent the "source of truth"
+ * for design tokens in a design system. Use this hook when you need to access
+ * variables that are consumed from a library, rather than local file variables.
+ *
+ * **When to use:**
+ * - Fetching design tokens from a published library
+ * - Building design system dashboards that track published tokens
+ * - Monitoring changes to shared variables across a design system
+ * - Validating consistency between published and local variables
+ *
+ * **Rate Limiting:**
+ * The Figma API has rate limits. Published variables are typically more stable
+ * than local variables, so they can be cached longer. SWR handles caching and
+ * revalidation automatically, but be mindful of frequent refetches in production.
+ *
+ * @returns SWR response object with `data`, `error`, `isLoading`, and `isValidating`.
+ *
+ * @public
+ *
+ * @example
+ * ```tsx
+ * import { usePublishedVariables } from '@figma-vars/hooks';
+ *
+ * function LibraryTokens() {
+ *   const { data, isLoading, error } = usePublishedVariables();
+ *
+ *   if (isLoading) return <div>Loading published variables...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   const variables = Object.values(data?.meta.variables ?? {});
+ *   return <ul>{variables.map(v => <li key={v.id}>{v.name}</li>)}</ul>;
+ * }
+ * ```
+ */
+export declare const usePublishedVariables: () => import('swr').SWRResponse<PublishedVariablesResponse, any, import('swr').SWRConfiguration<PublishedVariablesResponse, any, import('swr').BareFetcher<PublishedVariablesResponse>> | undefined>;
+//# sourceMappingURL=usePublishedVariables.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1 +1 @@
-{"version":3,"file":"useUpdateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB;gBAGoB,MAAM;aAAW,qBAAqB;EAavF,CAAC"}
+{"version":3,"file":"useUpdateVariable.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateVariable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAQ5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB;gBAOZ,MAAM;aACT,qBAAqB;EAyBnC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useVariableCollections.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariableCollections.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,sBAAsB;;;CAiBlC,CAAC"}
+{"version":3,"file":"useVariableCollections.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariableCollections.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,sBAAsB;;;CAiBlC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useVariableModes.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariableModes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,gBAAgB,QAAO,sBAwBnC,CAAC"}
+{"version":3,"file":"useVariableModes.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariableModes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,gBAAgB,QAAO,sBA0BnC,CAAA"}

package/dist/hooks/useVariables.d.ts

@@ -4,7 +4,9 @@ import { LocalVariablesResponse } from '../types/figma';
  *
  * @remarks
  * This hook uses SWR for caching and revalidation. It fetches the variables for the
- * file key provided via the FigmaVarsProvider context.
+ * file key provided via the FigmaVarsProvider context. If a fallbackFile is provided,
+ * it will use that instead of making an API request, which is useful for users without
+ * Figma Enterprise accounts or for offline development.
  *
  * @returns SWR response object with `data`, `error`, `isLoading`, and `isValidating`.
  *

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,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,0LAUxB,CAAC"}
+{"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"}

package/dist/index-BIUpDTdr.cjs

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

package/dist/index-Cd4HQQHO.js

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

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react/jsx-runtime"),i=require("react"),_=require("swr"),p=i.createContext(void 0),v=({children:e,token:o,fileKey:t,fallbackFile:r})=>{const s=r===void 0?{token:o,fileKey:t}:{token:o,fileKey:t,fallbackFile:r};return b.jsx(p.Provider,{value:s,children:e})},l=()=>{const e=i.useContext(p);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e},h="https://api.figma.com",w=`${h}/v1/variables`,T=w,A=e=>`${w}/${e}`,I="application/json",y="X-FIGMA-TOKEN",c="A Figma API token is required.",g="An error occurred while fetching data from the Figma API.";async function V(e,o){if(!o)throw new Error(c);const t=await fetch(e,{method:"GET",headers:{[y]:o,"Content-Type":I}});if(!t.ok){let r=g;try{const s=await t.json();s!=null&&s.message&&(r=s.message)}catch{}throw new Error(r)}return t.json()}const E=()=>{const{token:e,fileKey:o}=l(),t=e&&o?`https://api.figma.com/v1/files/${o}/variables/local`:null;return _(t&&e?[t,e]:null,t&&e?([s,n])=>V(s,n):()=>Promise.resolve(void 0))},R=()=>{const{data:e}=E(),o=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:o,collectionsById:t}},C=()=>{const{data:e}=E();return i.useMemo(()=>{const o=[],t={},r={};if(e!=null&&e.meta)for(const s of Object.values(e.meta.variableCollections)){o.push(...s.modes),t[s.id]=s.modes;for(const n of s.modes)r[n.modeId]=n}return{modes:o,modesByCollectionId:t,modesById:r}},[e])};function M(e,o){switch(o.type){case"loading":return{...e,status:"loading",error:null};case"success":return{...e,status:"success",data:o.payload};case"error":return{...e,status:"error",error:o.payload};default:return e}}const d=e=>{const o={status:"idle",data:null,error:null},[t,r]=i.useReducer(M,o);return{mutate:i.useCallback(async n=>{r({type:"loading"});try{const a=await e(n);return r({type:"success",payload:a}),a}catch(a){r({type:"error",payload:a});return}},[e]),...t,isLoading:t.status==="loading",isSuccess:t.status==="success",isError:t.status==="error"}};async function m(e,o,t,r){if(!o)throw new Error(c);const a={method:{CREATE:"POST",UPDATE:"PUT",DELETE:"DELETE"}[t],headers:{"Content-Type":"application/json",[y]:o}};r&&(a.body=JSON.stringify(r));const u=await fetch(`${h}${e}`,a);if(!u.ok){const f=await u.json().catch(()=>({}));throw new Error(f.err||f.message||"An API error occurred")}return u.status===204||!u.body?{}:u.json()}const P=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(T,e,"CREATE",t)})},O=()=>{const{token:e}=l();return d(async({variableId:t,payload:r})=>{if(!e)throw new Error(c);return await m(A(t),e,"UPDATE",r)})},D=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(A(t),e,"DELETE",void 0)})},F=()=>{const{token:e}=l();return d(async t=>{if(!e)throw new Error(c);return await m(T,e,"CREATE",t)})};function S(e,o){return e.filter(t=>{let r=!0;return o.resolvedType&&(r=r&&t.resolvedType===o.resolvedType),o.name&&(r=r&&t.name.includes(o.name)),r})}exports.FigmaVarsProvider=v;exports.filterVariables=S;exports.useBulkUpdateVariables=F;exports.useCreateVariable=P;exports.useDeleteVariable=D;exports.useUpdateVariable=O;exports.useVariableCollections=R;exports.useVariableModes=C;exports.useVariables=E;
+"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=_;

package/dist/index.d.cts

@@ -52,20 +52,25 @@ export { FigmaVarsProvider } from 'contexts';
  * }
  * ```
  */
-export { useVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, } from 'hooks';
+export { useVariables, usePublishedVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, useInvalidateVariables, } from 'hooks';
 /**
  * Utility functions for Figma Variable management.
  *
  * @remarks
- * Helpers like `filterVariables` for searching and filtering variable lists. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
+ * Helpers like `filterVariables` for searching and filtering variable lists, and error handling utilities. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
  *
  * @example
  * ```ts
- * import { filterVariables } from '@figma-vars/hooks';
+ * import { filterVariables, isFigmaApiError, getErrorStatus } from '@figma-vars/hooks';
  * const filtered = filterVariables(variables, { resolvedType: 'COLOR' });
+ *
+ * // Error handling
+ * if (isFigmaApiError(error)) {
+ *   console.log('Status:', error.statusCode);
+ * }
  * ```
  */
-export { filterVariables } from 'utils';
+export { filterVariables, isFigmaApiError, getErrorStatus, getErrorMessage, hasErrorStatus, } from 'utils';
 /**
  * All official TypeScript types for advanced usage and type-safe integration.
  *

package/dist/index.d.ts

@@ -52,20 +52,25 @@ export { FigmaVarsProvider } from 'contexts';
  * }
  * ```
  */
-export { useVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, } from 'hooks';
+export { useVariables, usePublishedVariables, useVariableCollections, useVariableModes, useCreateVariable, useUpdateVariable, useDeleteVariable, useBulkUpdateVariables, useInvalidateVariables, } from 'hooks';
 /**
  * Utility functions for Figma Variable management.
  *
  * @remarks
- * Helpers like `filterVariables` for searching and filtering variable lists. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
+ * Helpers like `filterVariables` for searching and filtering variable lists, and error handling utilities. All utilities are stateless and type-safe—use for UI filtering, scripting, and dashboard logic.
  *
  * @example
  * ```ts
- * import { filterVariables } from '@figma-vars/hooks';
+ * import { filterVariables, isFigmaApiError, getErrorStatus } from '@figma-vars/hooks';
  * const filtered = filterVariables(variables, { resolvedType: 'COLOR' });
+ *
+ * // Error handling
+ * if (isFigmaApiError(error)) {
+ *   console.log('Status:', error.statusCode);
+ * }
  * ```
  */
-export { filterVariables } from 'utils';
+export { filterVariables, isFigmaApiError, getErrorStatus, getErrorMessage, hasErrorStatus, } from 'utils';
 /**
  * All official TypeScript types for advanced usage and type-safe integration.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC;;;;;;;;;;GAUG;AACH,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,OAAO,CAAA;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,OAAO,CAAA;AAEd;;;;;;;;;;GAUG;AACH,cAAc,OAAO,CAAA"}