@figma-vars/hooks 1.0.10 → 1.1.1

package/dist/figma-vars-hooks.umd.cjs

@@ -1 +1,38 @@
-(function(t,s){typeof exports=="object"&&typeof module<"u"?s(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],s):(t=typeof globalThis<"u"?globalThis:t||self,s(t.FigmaVarsHooks={},t.react))})(this,function(t,s){"use strict";var N=Object.defineProperty;var G=(t,s,c)=>s in t?N(t,s,{enumerable:!0,configurable:!0,writable:!0,value:c}):t[s]=c;var w=(t,s,c)=>G(t,typeof s!="symbol"?s+"":s,c);const c=()=>{const[a,e]=s.useState("");return s.useEffect(()=>{e("")},[]),a},g=(a,e)=>{const[n,r]=s.useState(null),[o,i]=s.useState(!0),[l,u]=s.useState(null),h=c(),b=s.useRef(null),f=s.useCallback(async()=>{if(!h){u(new Error("API token is not provided")),i(!1);return}i(!0),u(null);try{const d=`https://api.figma.com/v1/files/${a}/variables`,m=await fetch(d,{method:"GET",headers:{"X-FIGMA-TOKEN":h}});if(!m.ok)throw new Error(`Failed to fetch Figma variables: ${m.statusText}`);const $=await m.json();r($.meta.variables)}catch(d){u(d instanceof Error?d:new Error("Failed to fetch variables"))}finally{i(!1)}},[a,h]),O=s.useCallback(()=>{f()},[f]);return s.useEffect(()=>{if(f(),e!=null&&e.pollInterval)return b.current=setInterval(f,e.pollInterval),()=>{b.current&&clearInterval(b.current)}},[f,e==null?void 0:e.pollInterval]),{variables:n,loading:o,error:l,refresh:O}},v=a=>{const[e,n]=s.useState({data:null,loading:!0,error:null}),r=c();return s.useEffect(()=>{(async()=>{if(!r){n(l=>({...l,loading:!1,error:new Error("API token is not provided")}));return}const i=`https://api.figma.com/v1/files/${a}/variable_collections`;try{const l=await fetch(i,{headers:{"X-FIGMA-TOKEN":r}});if(!l.ok)throw new Error(`Failed to fetch Figma collections: ${l.statusText}`);const u=await l.json();n({data:u.meta.variableCollections,loading:!1,error:null})}catch(l){n(u=>({...u,loading:!1,error:l instanceof Error?l:new Error("Failed to fetch")}))}})()},[a,r]),e},E=a=>{const[e,n]=s.useState(null),r=c();return s.useEffect(()=>{(async()=>{const i=`https://api.figma.com/v1/collections/${a}/modes`;try{if(!(await fetch(i,{headers:{"X-FIGMA-TOKEN":r}})).ok)throw new Error("Failed to fetch Figma modes");n({success:!0,message:"Modes fetched successfully"})}catch(l){n({success:!1,message:l instanceof Error?l.message:"Unknown error"})}})()},[a,r]),{response:e}};async function k(a,e){const n=c();if(!n)throw new Error("API token is not provided");const r=`https://api.figma.com/v1/files/${a}/variables`,o=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":n},body:JSON.stringify(e)});if(!o.ok)throw new Error("Failed to create Figma variable");return o.json()}async function V(a,e,n){const r=c();if(!r)throw new Error("API token is not provided");const o=`https://api.figma.com/v1/files/${a}/variables/${e}`,i=await fetch(o,{method:"PUT",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":r},body:JSON.stringify(n)});if(!i.ok)throw new Error("Failed to update Figma variable");return i.json()}async function p(a,e){const n=c();if(!n)throw new Error("API token is not provided");const r=`https://api.figma.com/v1/files/${a}/variables/${e}`,o=await fetch(r,{method:"DELETE",headers:{"X-FIGMA-TOKEN":n}});if(!o.ok)throw new Error("Failed to delete Figma variable");return o.json()}async function T(a,e){const n=c();if(!n)throw new Error("API token is not provided");const r=`https://api.figma.com/v1/variables/${a}/values`,o=await fetch(r,{method:"PUT",headers:{"X-FIGMA-TOKEN":n,"Content-Type":"application/json"},body:JSON.stringify(e)});if(!o.ok)throw new Error("Failed to update variable values");return o.json()}function y(a,e){return a.filter(n=>{let r=!0;return e.type&&(r=r&&n.type===e.type),e.name&&(r=r&&n.name===e.name),r})}class F{constructor(){w(this,"cache",{})}get(e){return this.cache[e]}set(e,n){this.cache[e]=n}clear(e){e?delete this.cache[e]:this.cache={}}}const A=()=>null,I=()=>!0,S=async(a,e={method:"GET"})=>{throw new Error("Figma API token is not available.")},M=()=>{const[a,e]=s.useState({});return{aliases:a,setAlias:(o,i)=>e(l=>({...l,[o]:i})),removeAlias:o=>{const i={...a};delete i[o],e(i)}}},P=()=>{const[a,e]=s.useState(new Map);return{bindings:a,bindVariable:(o,i)=>e(new Map(a.set(o,i))),unbindVariable:o=>{const i=new Map(a);i.delete(o),e(i)}}},j=()=>({}),C=()=>({});t.VariablesCache=F,t.createVariable=k,t.deleteVariable=p,t.fetchWithAuth=S,t.filterVariables=y,t.getFigmaToken=A,t.updateVariable=V,t.updateVariableValues=T,t.useFigmaToken=c,t.usePublishVars=j,t.useSync=C,t.useVariableAliases=M,t.useVariableBindings=P,t.useVariableCollections=v,t.useVariableModes=E,t.useVariables=g,t.validateToken=I,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})});
+(function(A,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],f):(A=typeof globalThis<"u"?globalThis:A||self,f(A.FigmaVarsHooks={},A.require$$0))})(this,function(A,f){"use strict";var ge={exports:{}},le={};/**
+ * @license React
+ * react-jsx-runtime.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var He;function Et(){if(He)return le;He=1;var e=Symbol.for("react.transitional.element"),n=Symbol.for("react.fragment");function t(r,o,a){var i=null;if(a!==void 0&&(i=""+a),o.key!==void 0&&(i=""+o.key),"key"in o){a={};for(var d in o)d!=="key"&&(a[d]=o[d])}else a=o;return o=a.ref,{$$typeof:e,type:r,key:i,ref:o!==void 0?o:null,props:a}}return le.Fragment=n,le.jsx=t,le.jsxs=t,le}var fe={};/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var Je;function pt(){return Je||(Je=1,process.env.NODE_ENV!=="production"&&function(){function e(s){if(s==null)return null;if(typeof s=="function")return s.$$typeof===x?null:s.displayName||s.name||null;if(typeof s=="string")return s;switch(s){case E:return"Fragment";case c:return"Profiler";case V:return"StrictMode";case C:return"Suspense";case F:return"SuspenseList";case re:return"Activity"}if(typeof s=="object")switch(typeof s.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),s.$$typeof){case _:return"Portal";case se:return(s.displayName||"Context")+".Provider";case Y:return(s._context.displayName||"Context")+".Consumer";case B:var l=s.render;return s=s.displayName,s||(s=l.displayName||l.name||"",s=s!==""?"ForwardRef("+s+")":"ForwardRef"),s;case ne:return l=s.displayName||null,l!==null?l:e(s.type)||"Memo";case O:l=s._payload,s=s._init;try{return e(s(l))}catch{}}return null}function n(s){return""+s}function t(s){try{n(s);var l=!1}catch{l=!0}if(l){l=console;var b=l.error,w=typeof Symbol=="function"&&Symbol.toStringTag&&s[Symbol.toStringTag]||s.constructor.name||"Object";return b.call(l,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",w),n(s)}}function r(s){if(s===E)return"<>";if(typeof s=="object"&&s!==null&&s.$$typeof===O)return"<...>";try{var l=e(s);return l?"<"+l+">":"<...>"}catch{return"<...>"}}function o(){var s=H.A;return s===null?null:s.getOwner()}function a(){return Error("react-stack-top-frame")}function i(s){if(J.call(s,"key")){var l=Object.getOwnPropertyDescriptor(s,"key").get;if(l&&l.isReactWarning)return!1}return s.key!==void 0}function d(s,l){function b(){ae||(ae=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",l))}b.isReactWarning=!0,Object.defineProperty(s,"key",{get:b,configurable:!0})}function p(){var s=e(this.type);return Ee[s]||(Ee[s]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),s=this.props.ref,s!==void 0?s:null}function S(s,l,b,w,M,P,ie,ce){return b=P.ref,s={$$typeof:u,type:s,key:l,props:P,_owner:M},(b!==void 0?b:null)!==null?Object.defineProperty(s,"ref",{enumerable:!1,get:p}):Object.defineProperty(s,"ref",{enumerable:!1,value:null}),s._store={},Object.defineProperty(s._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(s,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(s,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:ie}),Object.defineProperty(s,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:ce}),Object.freeze&&(Object.freeze(s.props),Object.freeze(s)),s}function g(s,l,b,w,M,P,ie,ce){var k=l.children;if(k!==void 0)if(w)if(N(k)){for(w=0;w<k.length;w++)m(k[w]);Object.freeze&&Object.freeze(k)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else m(k);if(J.call(l,"key")){k=e(s);var oe=Object.keys(l).filter(function(Re){return Re!=="key"});w=0<oe.length?"{key: someKey, "+oe.join(": ..., ")+": ...}":"{key: someKey}",ve[k+w]||(oe=0<oe.length?"{"+oe.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,w,k,oe,k),ve[k+w]=!0)}if(k=null,b!==void 0&&(t(b),k=""+b),i(l)&&(t(l.key),k=""+l.key),"key"in l){b={};for(var Z in l)Z!=="key"&&(b[Z]=l[Z])}else b=l;return k&&d(b,typeof s=="function"?s.displayName||s.name||"Unknown":s),S(s,k,P,M,o(),b,ie,ce)}function m(s){typeof s=="object"&&s!==null&&s.$$typeof===u&&s._store&&(s._store.validated=1)}var v=f,u=Symbol.for("react.transitional.element"),_=Symbol.for("react.portal"),E=Symbol.for("react.fragment"),V=Symbol.for("react.strict_mode"),c=Symbol.for("react.profiler"),Y=Symbol.for("react.consumer"),se=Symbol.for("react.context"),B=Symbol.for("react.forward_ref"),C=Symbol.for("react.suspense"),F=Symbol.for("react.suspense_list"),ne=Symbol.for("react.memo"),O=Symbol.for("react.lazy"),re=Symbol.for("react.activity"),x=Symbol.for("react.client.reference"),H=v.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,J=Object.prototype.hasOwnProperty,N=Array.isArray,K=console.createTask?console.createTask:function(){return null};v={"react-stack-bottom-frame":function(s){return s()}};var ae,Ee={},pe=v["react-stack-bottom-frame"].bind(v,a)(),X=K(r(a)),ve={};fe.Fragment=E,fe.jsx=function(s,l,b,w,M){var P=1e4>H.recentlyCreatedOwnerStacks++;return g(s,l,b,!1,w,M,P?Error("react-stack-top-frame"):pe,P?K(r(s)):X)},fe.jsxs=function(s,l,b,w,M){var P=1e4>H.recentlyCreatedOwnerStacks++;return g(s,l,b,!0,w,M,P?Error("react-stack-top-frame"):pe,P?K(r(s)):X)}}()),fe}var Ke;function vt(){return Ke||(Ke=1,process.env.NODE_ENV==="production"?ge.exports=Et():ge.exports=pt()),ge.exports}var gt=vt();const ze=f.createContext(void 0),St=({children:e,token:n})=>gt.jsx(ze.Provider,{value:{token:n},children:e}),ht=()=>{const e=f.useContext(ze);if(e===void 0)throw new Error("useFigmaTokenContext must be used within a FigmaVarsProvider");return e},$=()=>{const{token:e}=ht();return e};var Se={exports:{}},Oe={};/**
+ * @license React
+ * use-sync-external-store-shim.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var Xe;function _t(){if(Xe)return Oe;Xe=1;var e=f;function n(m,v){return m===v&&(m!==0||1/m===1/v)||m!==m&&v!==v}var t=typeof Object.is=="function"?Object.is:n,r=e.useState,o=e.useEffect,a=e.useLayoutEffect,i=e.useDebugValue;function d(m,v){var u=v(),_=r({inst:{value:u,getSnapshot:v}}),E=_[0].inst,V=_[1];return a(function(){E.value=u,E.getSnapshot=v,p(E)&&V({inst:E})},[m,u,v]),o(function(){return p(E)&&V({inst:E}),m(function(){p(E)&&V({inst:E})})},[m]),i(u),u}function p(m){var v=m.getSnapshot;m=m.value;try{var u=v();return!t(m,u)}catch{return!0}}function S(m,v){return v()}var g=typeof window>"u"||typeof window.document>"u"||typeof window.document.createElement>"u"?S:d;return Oe.useSyncExternalStore=e.useSyncExternalStore!==void 0?e.useSyncExternalStore:g,Oe}var Te={};/**
+ * @license React
+ * use-sync-external-store-shim.development.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var Ze;function bt(){return Ze||(Ze=1,process.env.NODE_ENV!=="production"&&function(){function e(u,_){return u===_&&(u!==0||1/u===1/_)||u!==u&&_!==_}function n(u,_){g||o.startTransition===void 0||(g=!0,console.error("You are using an outdated, pre-release alpha of React 18 that does not support useSyncExternalStore. The use-sync-external-store shim will not work correctly. Upgrade to a newer pre-release."));var E=_();if(!m){var V=_();a(E,V)||(console.error("The result of getSnapshot should be cached to avoid an infinite loop"),m=!0)}V=i({inst:{value:E,getSnapshot:_}});var c=V[0].inst,Y=V[1];return p(function(){c.value=E,c.getSnapshot=_,t(c)&&Y({inst:c})},[u,E,_]),d(function(){return t(c)&&Y({inst:c}),u(function(){t(c)&&Y({inst:c})})},[u]),S(E),E}function t(u){var _=u.getSnapshot;u=u.value;try{var E=_();return!a(u,E)}catch{return!0}}function r(u,_){return _()}typeof __REACT_DEVTOOLS_GLOBAL_HOOK__<"u"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart=="function"&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());var o=f,a=typeof Object.is=="function"?Object.is:e,i=o.useState,d=o.useEffect,p=o.useLayoutEffect,S=o.useDebugValue,g=!1,m=!1,v=typeof window>"u"||typeof window.document>"u"||typeof window.document.createElement>"u"?r:n;Te.useSyncExternalStore=o.useSyncExternalStore!==void 0?o.useSyncExternalStore:v,typeof __REACT_DEVTOOLS_GLOBAL_HOOK__<"u"&&typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop=="function"&&__REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error())}()),Te}var Qe;function Rt(){return Qe||(Qe=1,process.env.NODE_ENV==="production"?Se.exports=_t():Se.exports=bt()),Se.exports}var Ot=Rt();const qe=0,$e=1,et=2,tt=3;var nt=Object.prototype.hasOwnProperty;function we(e,n){var t,r;if(e===n)return!0;if(e&&n&&(t=e.constructor)===n.constructor){if(t===Date)return e.getTime()===n.getTime();if(t===RegExp)return e.toString()===n.toString();if(t===Array){if((r=e.length)===n.length)for(;r--&&we(e[r],n[r]););return r===-1}if(!t||typeof e=="object"){r=0;for(t in e)if(nt.call(e,t)&&++r&&!nt.call(n,t)||!(t in n)||!we(e[t],n[t]))return!1;return Object.keys(n).length===r}}return e!==e&&n!==n}const z=new WeakMap,ee=()=>{},L=ee(),ye=Object,h=e=>e===L,G=e=>typeof e=="function",te=(e,n)=>({...e,...n}),rt=e=>G(e.then),Ae={},he={},Ce="undefined",de=typeof window!=Ce,ke=typeof document!=Ce,Tt=de&&"Deno"in window,wt=()=>de&&typeof window.requestAnimationFrame!=Ce,ot=(e,n)=>{const t=z.get(e);return[()=>!h(n)&&e.get(n)||Ae,r=>{if(!h(n)){const o=e.get(n);n in he||(he[n]=o),t[5](n,te(o,r),o||Ae)}},t[6],()=>!h(n)&&n in he?he[n]:!h(n)&&e.get(n)||Ae]};let De=!0;const yt=()=>De,[Ie,Le]=de&&window.addEventListener?[window.addEventListener.bind(window),window.removeEventListener.bind(window)]:[ee,ee],At=()=>{const e=ke&&document.visibilityState;return h(e)||e!=="hidden"},Ct=e=>(ke&&document.addEventListener("visibilitychange",e),Ie("focus",e),()=>{ke&&document.removeEventListener("visibilitychange",e),Le("focus",e)}),kt=e=>{const n=()=>{De=!0,e()},t=()=>{De=!1};return Ie("online",n),Ie("offline",t),()=>{Le("online",n),Le("offline",t)}},Dt={isOnline:yt,isVisible:At},It={initFocus:Ct,initReconnect:kt},st=!f.useId,me=!de||Tt,Lt=e=>wt()?window.requestAnimationFrame(e):setTimeout(e,1),Ve=me?f.useEffect:f.useLayoutEffect,Fe=typeof navigator<"u"&&navigator.connection,at=!me&&Fe&&(["slow-2g","2g"].includes(Fe.effectiveType)||Fe.saveData),_e=new WeakMap,Pe=(e,n)=>ye.prototype.toString.call(e)===`[object ${n}]`;let Vt=0;const je=e=>{const n=typeof e,t=Pe(e,"Date"),r=Pe(e,"RegExp"),o=Pe(e,"Object");let a,i;if(ye(e)===e&&!t&&!r){if(a=_e.get(e),a)return a;if(a=++Vt+"~",_e.set(e,a),Array.isArray(e)){for(a="@",i=0;i<e.length;i++)a+=je(e[i])+",";_e.set(e,a)}if(o){a="#";const d=ye.keys(e).sort();for(;!h(i=d.pop());)h(e[i])||(a+=i+":"+je(e[i])+",");_e.set(e,a)}}else a=t?e.toJSON():n=="symbol"?e.toString():n=="string"?JSON.stringify(e):""+e;return a},Ne=e=>{if(G(e))try{e=e()}catch{e=""}const n=e;return e=typeof e=="string"?e:(Array.isArray(e)?e.length:e)?je(e):"",[e,n]};let Ft=0;const xe=()=>++Ft;async function it(...e){const[n,t,r,o]=e,a=te({populateCache:!0,throwOnError:!0},typeof o=="boolean"?{revalidate:o}:o||{});let i=a.populateCache;const d=a.rollbackOnError;let p=a.optimisticData;const S=v=>typeof d=="function"?d(v):d!==!1,g=a.throwOnError;if(G(t)){const v=t,u=[],_=n.keys();for(const E of _)!/^\$(inf|sub)\$/.test(E)&&v(n.get(E)._k)&&u.push(E);return Promise.all(u.map(m))}return m(t);async function m(v){const[u]=Ne(v);if(!u)return;const[_,E]=ot(n,u),[V,c,Y,se]=z.get(n),B=()=>{const N=V[u];return(G(a.revalidate)?a.revalidate(_().data,v):a.revalidate!==!1)&&(delete Y[u],delete se[u],N&&N[0])?N[0](et).then(()=>_().data):_().data};if(e.length<3)return B();let C=r,F;const ne=xe();c[u]=[ne,0];const O=!h(p),re=_(),x=re.data,H=re._c,J=h(H)?x:H;if(O&&(p=G(p)?p(J,x):p,E({data:p,_c:J})),G(C))try{C=C(J)}catch(N){F=N}if(C&&rt(C))if(C=await C.catch(N=>{F=N}),ne!==c[u][0]){if(F)throw F;return C}else F&&O&&S(F)&&(i=!0,E({data:J,_c:L}));if(i&&!F)if(G(i)){const N=i(C,J);E({data:N,error:L,_c:L})}else E({data:C,error:L,_c:L});if(c[u][1]=xe(),Promise.resolve(B()).then(()=>{E({_c:L})}),F){if(g)throw F;return}return C}}const ct=(e,n)=>{for(const t in e)e[t][0]&&e[t][0](n)},Pt=(e,n)=>{if(!z.has(e)){const t=te(It,n),r=Object.create(null),o=it.bind(L,e);let a=ee;const i=Object.create(null),d=(g,m)=>{const v=i[g]||[];return i[g]=v,v.push(m),()=>v.splice(v.indexOf(m),1)},p=(g,m,v)=>{e.set(g,m);const u=i[g];if(u)for(const _ of u)_(m,v)},S=()=>{if(!z.has(e)&&(z.set(e,[r,Object.create(null),Object.create(null),Object.create(null),o,p,d]),!me)){const g=t.initFocus(setTimeout.bind(L,ct.bind(L,r,qe))),m=t.initReconnect(setTimeout.bind(L,ct.bind(L,r,$e)));a=()=>{g&&g(),m&&m(),z.delete(e)}}};return S(),[e,o,S,a]}return[e,z.get(e)[4]]},jt=(e,n,t,r,o)=>{const a=t.errorRetryCount,i=o.retryCount,d=~~((Math.random()+.5)*(1<<(i<8?i:8)))*t.errorRetryInterval;!h(a)&&i>a||setTimeout(r,d,o)},Nt=we,[ut,xt]=Pt(new Map),Mt=te({onLoadingSlow:ee,onSuccess:ee,onError:ee,onErrorRetry:jt,onDiscarded:ee,revalidateOnFocus:!0,revalidateOnReconnect:!0,revalidateIfStale:!0,shouldRetryOnError:!0,errorRetryInterval:at?1e4:5e3,focusThrottleInterval:5*1e3,dedupingInterval:2*1e3,loadingTimeout:at?5e3:3e3,compare:Nt,isPaused:()=>!1,cache:ut,mutate:xt,fallback:{}},Dt),Ut=(e,n)=>{const t=te(e,n);if(n){const{use:r,fallback:o}=e,{use:a,fallback:i}=n;r&&a&&(t.use=r.concat(a)),o&&i&&(t.fallback=te(o,i))}return t},Wt=f.createContext({}),Gt="$inf$",lt=de&&window.__SWR_DEVTOOLS_USE__,Yt=lt?window.__SWR_DEVTOOLS_USE__:[],Bt=()=>{lt&&(window.__SWR_DEVTOOLS_REACT__=f)},Ht=e=>G(e[1])?[e[0],e[1],e[2]||{}]:[e[0],null,(e[1]===null?e[2]:e[1])||{}],Jt=()=>te(Mt,f.useContext(Wt)),Kt=e=>(n,t,r)=>e(n,t&&((...a)=>{const[i]=Ne(n),[,,,d]=z.get(ut);if(i.startsWith(Gt))return t(...a);const p=d[i];return h(p)?t(...a):(delete d[i],p)}),r),zt=Yt.concat(Kt),Xt=e=>function(...t){const r=Jt(),[o,a,i]=Ht(t),d=Ut(r,i);let p=e;const{use:S}=d,g=(S||[]).concat(zt);for(let m=g.length;m--;)p=g[m](p);return p(o,a||d.fetcher||null,d)},Zt=(e,n,t)=>{const r=n[e]||(n[e]=[]);return r.push(t),()=>{const o=r.indexOf(t);o>=0&&(r[o]=r[r.length-1],r.pop())}};Bt();const Me=f.use||(e=>{switch(e.status){case"pending":throw e;case"fulfilled":return e.value;case"rejected":throw e.reason;default:throw e.status="pending",e.then(n=>{e.status="fulfilled",e.value=n},n=>{e.status="rejected",e.reason=n}),e}}),Ue={dedupe:!0},We=Xt((e,n,t)=>{const{cache:r,compare:o,suspense:a,fallbackData:i,revalidateOnMount:d,revalidateIfStale:p,refreshInterval:S,refreshWhenHidden:g,refreshWhenOffline:m,keepPreviousData:v}=t,[u,_,E,V]=z.get(r),[c,Y]=Ne(e),se=f.useRef(!1),B=f.useRef(!1),C=f.useRef(c),F=f.useRef(n),ne=f.useRef(t),O=()=>ne.current,re=()=>O().isVisible()&&O().isOnline(),[x,H,J,N]=ot(r,c),K=f.useRef({}).current,ae=h(i)?h(t.fallback)?L:t.fallback[c]:i,Ee=(T,R)=>{for(const I in K){const y=I;if(y==="data"){if(!o(T[y],R[y])&&(!h(T[y])||!o(P,R[y])))return!1}else if(R[y]!==T[y])return!1}return!0},pe=f.useMemo(()=>{const T=!c||!n?!1:h(d)?O().isPaused()||a?!1:p!==!1:d,R=j=>{const Q=te(j);return delete Q._k,T?{isValidating:!0,isLoading:!0,...Q}:Q},I=x(),y=N(),W=R(I),ue=I===y?W:R(y);let D=W;return[()=>{const j=R(x());return Ee(j,D)?(D.data=j.data,D.isLoading=j.isLoading,D.isValidating=j.isValidating,D.error=j.error,D):(D=j,j)},()=>ue]},[r,c]),X=Ot.useSyncExternalStore(f.useCallback(T=>J(c,(R,I)=>{Ee(I,R)||T()}),[r,c]),pe[0],pe[1]),ve=!se.current,s=u[c]&&u[c].length>0,l=X.data,b=h(l)?ae&&rt(ae)?Me(ae):ae:l,w=X.error,M=f.useRef(b),P=v?h(l)?h(M.current)?b:M.current:l:b,ie=s&&!h(w)?!1:ve&&!h(d)?d:O().isPaused()?!1:a?h(b)?!1:p:h(b)||p,ce=!!(c&&n&&ve&&ie),k=h(X.isValidating)?ce:X.isValidating,oe=h(X.isLoading)?ce:X.isLoading,Z=f.useCallback(async T=>{const R=F.current;if(!c||!R||B.current||O().isPaused())return!1;let I,y,W=!0;const ue=T||{},D=!E[c]||!ue.dedupe,j=()=>st?!B.current&&c===C.current&&se.current:c===C.current,Q={isValidating:!1,isLoading:!1},ft=()=>{H(Q)},dt=()=>{const U=E[c];U&&U[1]===y&&delete E[c]},mt={isValidating:!0};h(x().data)&&(mt.isLoading=!0);try{if(D&&(H(mt),t.loadingTimeout&&h(x().data)&&setTimeout(()=>{W&&j()&&O().onLoadingSlow(c,t)},t.loadingTimeout),E[c]=[R(Y),xe()]),[I,y]=E[c],I=await I,D&&setTimeout(dt,t.dedupingInterval),!E[c]||E[c][1]!==y)return D&&j()&&O().onDiscarded(c),!1;Q.error=L;const U=_[c];if(!h(U)&&(y<=U[0]||y<=U[1]||U[1]===0))return ft(),D&&j()&&O().onDiscarded(c),!1;const q=x().data;Q.data=o(q,I)?q:I,D&&j()&&O().onSuccess(I,c,t)}catch(U){dt();const q=O(),{shouldRetryOnError:Ye}=q;q.isPaused()||(Q.error=U,D&&j()&&(q.onError(U,c,q),(Ye===!0||G(Ye)&&Ye(U))&&(!O().revalidateOnFocus||!O().revalidateOnReconnect||re())&&q.onErrorRetry(U,c,q,dn=>{const Be=u[c];Be&&Be[0]&&Be[0](tt,dn)},{retryCount:(ue.retryCount||0)+1,dedupe:!0})))}return W=!1,ft(),!0},[c,r]),Re=f.useCallback((...T)=>it(r,C.current,...T),[]);if(Ve(()=>{F.current=n,ne.current=t,h(l)||(M.current=l)}),Ve(()=>{if(!c)return;const T=Z.bind(L,Ue);let R=0;O().revalidateOnFocus&&(R=Date.now()+O().focusThrottleInterval);const y=Zt(c,u,(W,ue={})=>{if(W==qe){const D=Date.now();O().revalidateOnFocus&&D>R&&re()&&(R=D+O().focusThrottleInterval,T())}else if(W==$e)O().revalidateOnReconnect&&re()&&T();else{if(W==et)return Z();if(W==tt)return Z(ue)}});return B.current=!1,C.current=c,se.current=!0,H({_k:Y}),ie&&(h(b)||me?T():Lt(T)),()=>{B.current=!0,y()}},[c]),Ve(()=>{let T;function R(){const y=G(S)?S(x().data):S;y&&T!==-1&&(T=setTimeout(I,y))}function I(){!x().error&&(g||O().isVisible())&&(m||O().isOnline())?Z(Ue).then(R):R()}return R(),()=>{T&&(clearTimeout(T),T=-1)}},[S,g,m,c]),f.useDebugValue(P),a&&h(b)&&c){if(!st&&me)throw new Error("Fallback data is required when using Suspense in SSR.");F.current=n,ne.current=t,B.current=!1;const T=V[c];if(!h(T)){const R=Re(T);Me(R)}if(h(w)){const R=Z(Ue);h(P)||(R.status="fulfilled",R.value=!0),Me(R)}else throw w}return{mutate:Re,get data(){return K.data=!0,P},get error(){return K.error=!0,w},get isValidating(){return K.isValidating=!0,k},get isLoading(){return K.isLoading=!0,oe}}}),Qt=()=>null,be=async(e,n={method:"GET"})=>{throw new Error("Figma API token is not available.")},qt="https://api.figma.com/v1/files",Ge=e=>`${qt}/${e}/variables`,$t=e=>{const n=$(),{data:t,error:r,isLoading:o,isValidating:a}=We(n?Ge(e):null,be),i=t!=null&&t.meta?Object.values(t.meta.variables):[],d=t!=null&&t.meta?t.meta.variables:{};return{variables:i,variablesById:d,isLoading:o,isValidating:a,error:r??(t&&"message"in t?new Error(t.message):null)}},en=e=>{const n=$(),{data:t,error:r,isLoading:o,isValidating:a}=We(n?Ge(e):null,be),i=t!=null&&t.meta?Object.values(t.meta.variableCollections):[],d=t!=null&&t.meta?t.meta.variableCollections:{};return{collections:i,collectionsById:d,isLoading:o,isValidating:a,error:r??(t&&"message"in t?new Error(t.message):null)}},tn=e=>{const n=$(),{data:t,error:r,isLoading:o,isValidating:a}=We(n?Ge(e):null,be),i=[],d={},p={};if(t!=null&&t.meta)for(const S of Object.values(t.meta.variableCollections)){i.push(...S.modes),d[S.id]=S.modes;for(const g of S.modes)p[g.modeId]=g}return{modes:i,modesByCollectionId:d,modesById:p,isLoading:o,isValidating:a,error:r??(t&&"message"in t?new Error(t.message):null)}};async function nn(e,n,t){const r=`https://api.figma.com/v1/files/${n}/variables`;try{const o=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":e},body:JSON.stringify(t)}),a=await o.json();return o.ok?{error:!1,status:o.status,meta:a.meta}:{error:!0,status:o.status,message:a.message||"Failed to perform bulk update."}}catch(o){return{error:!0,status:500,message:o instanceof Error?o.message:"An unknown error occurred."}}}const rn=()=>{const e=$(),[n,t]=f.useState(!1),[r,o]=f.useState(null),[a,i]=f.useState(null);return{bulkUpdate:f.useCallback(async(p,S)=>{if(!e){o("Figma API token is not provided.");return}t(!0),o(null);const g=await nn(e,p,S);i(g),g.error&&o(g.message||"An error occurred during the bulk update."),t(!1)},[e]),loading:n,error:r,data:a}};async function on(e,n){const t="https://api.figma.com/v1/variables";try{const r=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":e},body:JSON.stringify(n)});if(!r.ok){const a=await r.json();return{error:!0,status:r.status,message:a.message||"Failed to create Figma variable"}}const o=await r.json();return{error:!1,status:r.status,variable:o}}catch(r){return{error:!0,status:500,message:r instanceof Error?r.message:"An unknown error occurred"}}}const sn=()=>{const e=$(),[n,t]=f.useState(!1),[r,o]=f.useState(null),[a,i]=f.useState(null);return{createVariable:f.useCallback(async p=>{if(!e){o("Figma API token is not provided.");return}t(!0),o(null);const S=await on(e,p);i(S),S.error&&o(S.message||"An error occurred."),t(!1)},[e]),loading:n,error:r,data:a}};async function an(e,n){const t=`https://api.figma.com/v1/variables/${n}`;try{const r=await fetch(t,{method:"DELETE",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":e}});if(!r.ok){const o=await r.json();return{error:!0,status:r.status,message:o.message||"Failed to delete Figma variable"}}return{error:!1,status:r.status}}catch(r){return{error:!0,status:500,message:r instanceof Error?r.message:"An unknown error occurred"}}}const cn=()=>{const e=$(),[n,t]=f.useState(!1),[r,o]=f.useState(null),[a,i]=f.useState(null);return{deleteVariable:f.useCallback(async p=>{if(!e){o("Figma API token is not provided.");return}t(!0),o(null);const S=await an(e,p);i(S),S.error&&o(S.message||"An error occurred."),t(!1)},[e]),loading:n,error:r,data:a}};async function un(e,n,t){const r=`https://api.figma.com/v1/variables/${n}`;try{const o=await fetch(r,{method:"PUT",headers:{"Content-Type":"application/json","X-FIGMA-TOKEN":e},body:JSON.stringify(t)});if(!o.ok){const a=await o.json();return{error:!0,status:o.status,message:a.message||"Failed to update Figma variable"}}return{error:!1,status:o.status}}catch(o){return{error:!0,status:500,message:o instanceof Error?o.message:"An unknown error occurred"}}}const ln=()=>{const e=$(),[n,t]=f.useState(!1),[r,o]=f.useState(null),[a,i]=f.useState(null);return{updateVariable:f.useCallback(async(p,S)=>{if(!e){o("Figma API token is not provided.");return}t(!0),o(null);const g=await un(e,p,S);i(g),g.error&&o(g.message||"An error occurred."),t(!1)},[e]),loading:n,error:r,data:a}};function fn(e,n){return e.filter(t=>{let r=!0;return n.resolvedType&&(r=r&&t.resolvedType===n.resolvedType),n.name&&(r=r&&t.name.includes(n.name)),r})}A.FigmaVarsProvider=St,A.fetchWithAuth=be,A.filterVariables=fn,A.getFigmaToken=Qt,A.useBulkUpdateVariables=rn,A.useCreateVariable=sn,A.useDeleteVariable=cn,A.useFigmaToken=$,A.useUpdateVariable=ln,A.useVariableCollections=en,A.useVariableModes=tn,A.useVariables=$t,Object.defineProperty(A,Symbol.toStringTag,{value:"Module"})});

package/dist/hooks/useFigmaToken.d.ts

@@ -1,5 +1,6 @@
 /**
- * Retrieves the Figma API token from environment or context (future-proofed for provider override)
+ * Retrieves the Figma API token from the FigmaVarsProvider.
+ * This hook must be used within a component wrapped by FigmaVarsProvider.
  */
-declare const useFigmaToken: () => string;
+declare const useFigmaToken: () => string | null;
 export default useFigmaToken;

package/dist/hooks/useVariableCollections.d.ts

@@ -1,3 +1,13 @@
-import { FigmaCollection, HookState } from 'types';
-declare const useVariableCollections: (fileKey: string) => HookState<FigmaCollection[]>;
-export default useVariableCollections;
+import { FigmaCollection } from 'types';
+/**
+ * A hook to fetch all variable collections for a given file.
+ * @param fileKey - The key of the Figma file to fetch collections from.
+ * @returns An object containing the variable collections, loading state, and any errors.
+ */
+export declare const useVariableCollections: (fileKey: string) => {
+    collections: FigmaCollection[];
+    collectionsById: Record<string, FigmaCollection>;
+    isLoading: boolean;
+    isValidating: boolean;
+    error: any;
+};

package/dist/hooks/useVariableModes.d.ts

@@ -1,5 +1,8 @@
-import { FigmaOperationResponse } from 'types';
-declare const useVariableModes: (collectionId: string) => {
-    response: FigmaOperationResponse | null;
-};
-export default useVariableModes;
+import { UseVariableModesResult } from '../types/hooks';
+/**
+ * A hook to fetch all variable modes for a given file.
+ *
+ * @param fileKey - The key of the file to fetch variables from.
+ * @returns An object containing the variable modes, loading state, and any errors.
+ */
+export declare const useVariableModes: (fileKey: string) => UseVariableModesResult;

package/dist/hooks/useVariables.d.ts

@@ -1,16 +1,14 @@
 import { FigmaVariable } from 'types';
 /**
- * Fetches Figma variables for a given document (file) ID.
- * Supports polling and manual refresh.
- * @param documentId - The Figma file ID
- * @param options - { pollInterval?: number }
+ * A hook to fetch all local variables for a given file.
+ *
+ * @param fileKey - The key of the file to fetch variables from.
+ * @returns An object containing the variables, loading state, and any errors.
  */
-declare const useVariables: (documentId: string, options?: {
-    pollInterval?: number;
-}) => {
-    variables: FigmaVariable[] | null;
-    loading: boolean;
-    error: Error | null;
-    refresh: () => void;
+export declare const useVariables: (fileKey: string) => {
+    variables: FigmaVariable[];
+    variablesById: Record<string, FigmaVariable>;
+    isLoading: boolean;
+    isValidating: boolean;
+    error: any;
 };
-export default useVariables;

package/dist/index.d.ts

@@ -1,16 +1,13 @@
 export { default as useFigmaToken } from './hooks/useFigmaToken';
-export { default as useVariables } from './hooks/useVariables';
-export { default as useVariableCollections } from './hooks/useVariableCollections';
-export { default as useVariableModes } from 'hooks/useVariableModes';
-export * from 'mutations/createVariable';
-export * from 'mutations/updateVariable';
-export * from 'mutations/deleteVariable';
-export * from 'mutations/updateVariableValues';
-export * from 'utils/filterVariables';
-export * from 'utils/cache';
-export * from 'utils/fetchHelpers';
-export * from 'utils/authHelpers';
-export { default as useVariableAliases } from 'experimental/useVariableAliases';
-export { default as useVariableBindings } from 'experimental/useVariableBindings';
-export { default as usePublishVars } from 'experimental/usePublishVars';
-export { default as useSync } from 'experimental/useSync';
+export { useVariables } from './hooks/useVariables';
+export { useVariableCollections } from './hooks/useVariableCollections';
+export { useVariableModes } from './hooks/useVariableModes';
+export { useBulkUpdateVariables } from './mutations/bulkUpdateVariables';
+export { useCreateVariable } from './mutations/createVariable';
+export { useDeleteVariable } from './mutations/deleteVariable';
+export { useUpdateVariable } from './mutations/updateVariable';
+export * from './types';
+export * from './utils/filterVariables';
+export * from './utils/fetchHelpers';
+export * from './utils/authHelpers';
+export { FigmaVarsProvider } from './contexts/FigmaTokenContext';

package/dist/mutations/bulkUpdateVariables.d.ts

@@ -0,0 +1,7 @@
+import { BulkUpdatePayload, BulkUpdateResponse } from '../types/mutations';
+export declare const useBulkUpdateVariables: () => {
+    bulkUpdate: (fileKey: string, payload: BulkUpdatePayload) => Promise<void>;
+    loading: boolean;
+    error: string | null;
+    data: BulkUpdateResponse | null;
+};

package/dist/mutations/createVariable.d.ts

@@ -1,8 +1,7 @@
-import { FigmaOperationResponse } from 'types';
-/**
- * Create a new Figma variable in a file.
- * @param fileKey The Figma file ID
- * @param variableData The variable data (see Figma Variables API)
- * @returns Promise<FigmaOperationResponse>
- */
-export declare function createVariable(fileKey: string, variableData: any): Promise<FigmaOperationResponse>;
+import { CreateVariablePayload, VariableActionResponse } from '../types/mutations';
+export declare const useCreateVariable: () => {
+    createVariable: (payload: CreateVariablePayload) => Promise<void>;
+    loading: boolean;
+    error: string | null;
+    data: VariableActionResponse | null;
+};

package/dist/mutations/deleteVariable.d.ts

@@ -1,8 +1,7 @@
-import { FigmaOperationResponse } from 'types';
-/**
- * Delete a Figma variable from a file.
- * @param fileKey The Figma file ID
- * @param variableId The variable ID
- * @returns Promise<FigmaOperationResponse>
- */
-export declare function deleteVariable(fileKey: string, variableId: string): Promise<FigmaOperationResponse>;
+import { VariableActionResponse } from '../types/mutations';
+export declare const useDeleteVariable: () => {
+    deleteVariable: (variableId: string) => Promise<void>;
+    loading: boolean;
+    error: string | null;
+    data: Omit<VariableActionResponse, "variable"> | null;
+};

package/dist/mutations/updateVariable.d.ts

@@ -1,9 +1,7 @@
-import { FigmaOperationResponse } from 'types';
-/**
- * Update an existing Figma variable in a file.
- * @param fileKey The Figma file ID
- * @param variableId The variable ID
- * @param newVariableData The new variable data (see Figma Variables API)
- * @returns Promise<FigmaOperationResponse>
- */
-export declare function updateVariable(fileKey: string, variableId: string, newVariableData: any): Promise<FigmaOperationResponse>;
+import { UpdateVariablePayload, VariableActionResponse } from '../types/mutations';
+export declare const useUpdateVariable: () => {
+    updateVariable: (variableId: string, payload: UpdateVariablePayload) => Promise<void>;
+    loading: boolean;
+    error: string | null;
+    data: VariableActionResponse | null;
+};

package/dist/types/figma.d.ts

@@ -1,17 +1,45 @@
+export type ResolvedType = 'BOOLEAN' | 'FLOAT' | 'STRING' | 'COLOR';
+export type VariableScope = 'ALL_SCOPES' | 'TEXT_CONTENT' | 'CORNER_RADIUS' | 'WIDTH_HEIGHT' | 'GAP' | 'STROKE_FLOAT' | 'OPACITY' | 'EFFECT_FLOAT' | 'FONT_WEIGHT' | 'FONT_SIZE' | 'LINE_HEIGHT' | 'LETTER_SPACING' | 'PARAGRAPH_SPACING' | 'PARAGRAPH_INDENT' | 'FONT_FAMILY' | 'FONT_STYLE' | 'FONT_VARIATIONS' | 'ALL_FILLS' | 'FRAME_FILL' | 'SHAPE_FILL' | 'TEXT_FILL' | 'STROKE_COLOR' | 'EFFECT_COLOR';
+export interface Color {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface VariableAlias {
+    type: 'VARIABLE_ALIAS';
+    id: string;
+}
+export type VariableValue = string | boolean | number | Color | VariableAlias;
 export interface FigmaVariable {
     id: string;
     name: string;
-    type: string;
-    description?: string;
+    variableCollectionId: string;
+    resolvedType: ResolvedType;
+    valuesByMode: Record<string, VariableValue>;
+    description: string;
+    hiddenFromPublishing: boolean;
+    scopes: VariableScope[];
+    codeSyntax: Record<string, string>;
+    updatedAt: string;
+}
+export interface VariableMode {
+    modeId: string;
+    name: string;
 }
 export interface FigmaCollection {
     id: string;
     name: string;
-    variables: FigmaVariable[];
+    modes: VariableMode[];
+    defaultModeId: string;
+    variableIds: string[];
+    hiddenFromPublishing: boolean;
+    updatedAt: string;
 }
-export interface VariablesResponse {
+export interface LocalVariablesResponse {
     meta: {
-        variables: FigmaVariable[];
+        variableCollections: Record<string, FigmaCollection>;
+        variables: Record<string, FigmaVariable>;
     };
 }
 export interface FigmaError {

package/dist/types/hooks.d.ts

@@ -1,8 +1,17 @@
+import { VariableMode } from './figma';
 export interface HookState<T> {
     data: T | null;
     loading: boolean;
     error: Error | null;
 }
+export interface UseVariableModesResult {
+    modes: VariableMode[];
+    modesByCollectionId: Record<string, VariableMode[]>;
+    modesById: Record<string, VariableMode>;
+    isLoading: boolean;
+    isValidating: boolean;
+    error: Error | null;
+}
 export interface SyncStatus {
     isSyncing: boolean;
     lastSynced: Date | null;

package/dist/types/mutations.d.ts

@@ -1,3 +1,4 @@
+import { FigmaVariable, ResolvedType, VariableScope, VariableValue } from './figma';
 export interface FigmaOperationResponse {
     success: boolean;
     message?: string;
@@ -7,3 +8,69 @@ export interface VariableValueUpdate {
     value: string;
 }
 export type SpecificType = VariableValueUpdate[];
+export interface CreateVariablePayload {
+    name: string;
+    variableCollectionId: string;
+    resolvedType: ResolvedType;
+    description?: string;
+    hiddenFromPublishing?: boolean;
+    scopes?: VariableScope[];
+    codeSyntax?: Record<string, string>;
+}
+export interface VariableActionResponse {
+    error: boolean;
+    status: number;
+    message?: string;
+    variable?: FigmaVariable;
+}
+export interface UpdateVariablePayload {
+    name?: string;
+    description?: string;
+    hiddenFromPublishing?: boolean;
+    scopes?: VariableScope[];
+    codeSyntax?: Record<string, string>;
+}
+export type VariableAction = 'CREATE' | 'UPDATE' | 'DELETE';
+export interface VariableCollectionChange {
+    action: VariableAction;
+    id: string;
+    name?: string;
+    initialModeId?: string;
+    hiddenFromPublishing?: boolean;
+}
+export interface VariableModeChange {
+    action: VariableAction;
+    id: string;
+    name?: string;
+    variableCollectionId: string;
+}
+export interface VariableChange {
+    action: VariableAction;
+    id: string;
+    name?: string;
+    variableCollectionId?: string;
+    resolvedType?: ResolvedType;
+    description?: string;
+    hiddenFromPublishing?: boolean;
+    scopes?: VariableScope[];
+    codeSyntax?: Record<string, string>;
+}
+export interface VariableModeValue {
+    variableId: string;
+    modeId: string;
+    value: VariableValue;
+}
+export interface BulkUpdatePayload {
+    variableCollections?: VariableCollectionChange[];
+    variableModes?: VariableModeChange[];
+    variables?: VariableChange[];
+    variableModeValues?: VariableModeValue[];
+}
+export interface BulkUpdateResponse {
+    error: boolean;
+    status: number;
+    message?: string;
+    meta?: {
+        tempIdToRealId: Record<string, string>;
+    };
+}

package/dist/utils/authHelpers.d.ts

@@ -2,7 +2,3 @@
  * Retrieves the Figma API token from environment variables or any other secure storage mechanism you've implemented.
  */
 export declare const getFigmaToken: () => string | null;
-/**
- * Placeholder for a more complex token validation or renewal logic, if needed.
- */
-export declare const validateToken: () => boolean;

package/dist/utils/fetchHelpers.d.ts

@@ -6,5 +6,5 @@ interface FetchOptions {
 /**
  * A helper function for making authenticated fetch requests to the Figma API.
  */
-export declare const fetchWithAuth: (endpoint: string, options?: FetchOptions) => Promise<any>;
+export declare const fetchWithAuth: (url: string, options?: FetchOptions) => Promise<any>;
 export {};

package/dist/utils/filterVariables.d.ts

@@ -1,5 +1,5 @@
-import { FigmaVariable } from 'types';
+import { FigmaVariable, ResolvedType } from 'types';
 export declare function filterVariables(variables: FigmaVariable[], criteria: {
-    type?: string;
+    resolvedType?: ResolvedType;
     name?: string;
 }): FigmaVariable[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figma-vars/hooks",
-  "version": "1.0.10",
+  "version": "1.1.1",
   "description": "Typed React hooks for managing Figma Variables, modes, tokens, and bindings via API.",
   "author": "Mark Learst",
   "license": "MIT",
@@ -42,9 +42,9 @@
   "sideEffects": false,
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
   "funding": {
@@ -64,6 +64,9 @@
   "directories": {
     "doc": "docs"
   },
+  "dependencies": {
+    "swr": "^2.3.3"
+  },
   "scripts": {
     "dev": "vite",
     "build": "tsc && vite build",

package/dist/experimental/usePublishVars.d.ts

@@ -1,2 +0,0 @@
-declare const usePublishVars: () => {};
-export default usePublishVars;

package/dist/experimental/useSync.d.ts

@@ -1,2 +0,0 @@
-declare const useSync: () => {};
-export default useSync;

package/dist/experimental/useVariableAliases.d.ts

@@ -1,9 +0,0 @@
-import { FigmaVariable } from 'types';
-declare const useVariableAliases: () => {
-    aliases: {
-        [alias: string]: FigmaVariable;
-    };
-    setAlias: (alias: string, variable: FigmaVariable) => void;
-    removeAlias: (alias: string) => void;
-};
-export default useVariableAliases;

package/dist/experimental/useVariableBindings.d.ts

@@ -1,7 +0,0 @@
-import { FigmaVariable } from 'types';
-declare const useVariableBindings: () => {
-    bindings: Map<string, FigmaVariable>;
-    bindVariable: (elementId: string, variable: FigmaVariable) => void;
-    unbindVariable: (elementId: string) => void;
-};
-export default useVariableBindings;

package/dist/mutations/updateVariableValues.d.ts

@@ -1,8 +0,0 @@
-import { FigmaOperationResponse } from 'types';
-/**
- * Update a variable's value across modes (Figma Variables API).
- * @param variableId The variable ID
- * @param values The new values for each mode
- * @returns Promise<FigmaOperationResponse>
- */
-export declare function updateVariableValues(variableId: string, values: any): Promise<FigmaOperationResponse>;

package/dist/utils/cache.d.ts

@@ -1,7 +0,0 @@
-import { FigmaVariable } from 'types';
-export declare class VariablesCache {
-    private cache;
-    get(fileKey: string): FigmaVariable[] | undefined;
-    set(fileKey: string, variables: FigmaVariable[]): void;
-    clear(fileKey?: string): void;
-}