@makeswift/runtime 0.28.8-canary.19 → 0.28.8-canary.20

package/dist/cjs/api/graphql-api-client.js

@@ -27,7 +27,7 @@ class MakeswiftGraphQLApiClient {
   graphqlClient;
   constructor({ endpoint }) {
     this.graphqlClient = new import_client.GraphQLClient(endpoint, {
-      "makeswift-runtime-version": "0.28.8-canary.19"
+      "makeswift-runtime-version": "0.28.8-canary.20"
     });
   }
   async createTableRecord(tableId, columns) {

package/dist/cjs/api/rest-api-client.js

@@ -147,7 +147,7 @@ class MakeswiftRestAPIClient {
     const requestHeaders = new Headers({
       "x-api-key": this.apiKey,
       "makeswift-site-api-key": this.apiKey,
-      "makeswift-runtime-version": "0.28.8-canary.19"
+      "makeswift-runtime-version": "0.28.8-canary.20"
     });
     if (siteVersion?.token) {
       requestUrl.searchParams.set("version", siteVersion.version);

package/dist/cjs/api-handler/handlers/manifest.js

@@ -28,7 +28,7 @@ async function manifestHandler(req, { apiKey, manifest }) {
     return import_request_response.ApiResponse.json({ message: "Unauthorized" }, { status: 401 });
   }
   return import_request_response.ApiResponse.json({
-    version: "0.28.8-canary.19",
+    version: "0.28.8-canary.20",
     interactionMode: true,
     clientSideNavigation: false,
     elementFromPoint: false,

package/dist/cjs/client/index.js

@@ -689,7 +689,7 @@ Received "${apiKey}" instead.`
       headers: {
         "x-api-key": this.apiKey,
         "makeswift-site-api-key": this.apiKey,
-        "makeswift-runtime-version": "0.28.8-canary.19",
+        "makeswift-runtime-version": "0.28.8-canary.20",
         "content-type": "application/json"
       },
       body: JSON.stringify({ token }),

package/dist/cjs/runtimes/react/components/control-instances-context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"sourcesContent":["'use client'\n\nimport { createContext, useContext } from 'react'\n\nimport { ControlInstance } from '@makeswift/controls'\n\ntype Context = {\n  elementKey: string\n  instances: Record<string, ControlInstance> | null\n}\n\nconst ControlInstancesContext = createContext<Context | null>(null)\n\nexport const ControlInstancesProvider = ControlInstancesContext.Provider\n\nexport function useControlInstances(elementKey: string): Context['instances'] | null {\n  const cx = useContext(ControlInstancesContext)\n  return cx && cx.elementKey === elementKey ? cx.instances : null\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAA0C;AAS1C,MAAM,8BAA0B,4BAA8B,IAAI;AAE3D,MAAM,2BAA2B,wBAAwB;AAEzD,SAAS,oBAAoB,YAAiD;AACnF,QAAM,SAAK,yBAAW,uBAAuB;AAC7C,SAAO,MAAM,GAAG,eAAe,aAAa,GAAG,YAAY;AAC7D;","names":[]}
+{"version":3,"sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"sourcesContent":["'use client'\n\nimport { createContext, useContext } from 'react'\n\nimport { type AnyControlInstance } from '@makeswift/controls'\n\ntype Context = {\n  elementKey: string\n  instances: Record<string, AnyControlInstance> | null\n}\n\nconst ControlInstancesContext = createContext<Context | null>(null)\n\nexport const ControlInstancesProvider = ControlInstancesContext.Provider\n\nexport function useControlInstances(elementKey: string | undefined): Context['instances'] | null {\n  const cx = useContext(ControlInstancesContext)\n  return cx && cx.elementKey === elementKey ? cx.instances : null\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAA0C;AAS1C,MAAM,8BAA0B,4BAA8B,IAAI;AAE3D,MAAM,2BAA2B,wBAAwB;AAEzD,SAAS,oBAAoB,YAA6D;AAC/F,QAAM,SAAK,yBAAW,uBAAuB;AAC7C,SAAO,MAAM,GAAG,eAAe,aAAa,GAAG,YAAY;AAC7D;","names":[]}

package/dist/cjs/runtimes/react/hooks/use-control-instance.js

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var use_control_instance_exports = {};
+__export(use_control_instance_exports, {
+  getInstanceByPropPath: () => getInstanceByPropPath,
+  getInstanceChainByPropPath: () => getInstanceChainByPropPath,
+  useControlInstance: () => useControlInstance
+});
+module.exports = __toCommonJS(use_control_instance_exports);
+var import_react = require("react");
+var import_controls = require("@makeswift/controls");
+var import_use_control_instances = require("./use-control-instances");
+function useControlInstance(instanceKey, instanceClass) {
+  const { elementKey, propPath } = instanceKey ?? {};
+  const instances = (0, import_use_control_instances.useControlInstances)(elementKey);
+  const getInstance = (0, import_react.useCallback)(
+    () => instances != null && propPath != null ? getInstanceByPropPath(instances, propPath) : null,
+    [instances, propPath]
+  );
+  const subscribe = (0, import_react.useCallback)(
+    (onStateChange) => {
+      if (instances == null || propPath == null)
+        return () => {
+        };
+      let unsubscribes = [];
+      const handleStateChange = () => {
+        resubscribe();
+        onStateChange();
+      };
+      const resubscribe = () => {
+        unsubscribes.forEach((unsubscribe) => unsubscribe());
+        const chain = getInstanceChainByPropPath(instances, propPath).filter(import_controls.isNotNil);
+        unsubscribes = chain.map((instance) => instance.subscribe(handleStateChange));
+      };
+      resubscribe();
+      return () => unsubscribes.forEach((unsubscribe) => unsubscribe());
+    },
+    [instances, propPath]
+  );
+  const result = (0, import_react.useSyncExternalStore)(subscribe, getInstance, getInstance);
+  if (result) {
+    const foundKey = result.instanceKey;
+    if (foundKey.elementKey !== elementKey || foundKey.propPath != propPath) {
+      console.error("Mismatching control instance key: expected", instanceKey, " got", foundKey);
+      return null;
+    }
+    if (!(result instanceof instanceClass)) {
+      console.error(
+        `Unexpected control instance class: requested '${instanceClass.name}', found '${result.constructor.name}'`,
+        { instanceKey }
+      );
+      return null;
+    }
+  }
+  return result;
+}
+function getInstanceChainByPropPath(instances, propPath) {
+  const [parentProp, ...childPath] = propPath.split(".");
+  const parentInstance = instances[parentProp];
+  const getInstanceChain = (parent, childPath2) => parent == null || childPath2.length === 0 ? [parent ?? null] : [parent, ...getInstanceChain(parent.child(childPath2[0]), childPath2.slice(1))];
+  return getInstanceChain(parentInstance, childPath);
+}
+function getInstanceByPropPath(instances, propPath) {
+  return getInstanceChainByPropPath(instances, propPath).at(-1) ?? null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getInstanceByPropPath,
+  getInstanceChainByPropPath,
+  useControlInstance
+});
+//# sourceMappingURL=use-control-instance.js.map

package/dist/cjs/runtimes/react/hooks/use-control-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/runtimes/react/hooks/use-control-instance.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react'\nimport { type AnyControlInstance, type ControlInstanceKey, isNotNil } from '@makeswift/controls'\n\nimport { useControlInstances } from './use-control-instances'\n\ntype InstanceConstructor<T extends AnyControlInstance> = abstract new (...args: never[]) => T\n\nexport function useControlInstance<T extends AnyControlInstance>(\n  instanceKey: ControlInstanceKey | undefined,\n  instanceClass: InstanceConstructor<T>,\n): T | null {\n  const { elementKey, propPath } = instanceKey ?? {}\n\n  const instances = useControlInstances(elementKey)\n  const getInstance = useCallback(\n    () =>\n      instances != null && propPath != null ? getInstanceByPropPath(instances, propPath) : null,\n    [instances, propPath],\n  )\n\n  const subscribe = useCallback(\n    (onStateChange: () => void) => {\n      if (instances == null || propPath == null) return () => {}\n\n      let unsubscribes: (() => void)[] = []\n\n      // recompute the instance chain and resubscribe to its updates on every notification,\n      // since a control's own update (e.g. a `ListControl` replacing its children) can replace\n      // the instances further down the chain\n      const handleStateChange = () => {\n        resubscribe()\n        onStateChange()\n      }\n\n      const resubscribe = () => {\n        unsubscribes.forEach(unsubscribe => unsubscribe())\n\n        const chain = getInstanceChainByPropPath(instances, propPath).filter(isNotNil)\n        unsubscribes = chain.map(instance => instance.subscribe(handleStateChange))\n      }\n\n      resubscribe()\n\n      return () => unsubscribes.forEach(unsubscribe => unsubscribe())\n    },\n    [instances, propPath],\n  )\n\n  const result = useSyncExternalStore(subscribe, getInstance, getInstance)\n\n  if (result) {\n    const foundKey = result.instanceKey\n    if (foundKey.elementKey !== elementKey || foundKey.propPath != propPath) {\n      console.error('Mismatching control instance key: expected', instanceKey, ' got', foundKey)\n      return null\n    }\n\n    if (!(result instanceof instanceClass)) {\n      console.error(\n        `Unexpected control instance class: requested '${instanceClass.name}', found '${result.constructor.name}'`,\n        { instanceKey },\n      )\n\n      return null\n    }\n  }\n\n  return result\n}\n\nexport function getInstanceChainByPropPath(\n  instances: Record<string, AnyControlInstance>,\n  propPath: string,\n): (AnyControlInstance | null)[] {\n  const [parentProp, ...childPath] = propPath.split('.')\n  const parentInstance = instances[parentProp]\n\n  const getInstanceChain = (\n    parent: AnyControlInstance | undefined,\n    childPath: string[],\n  ): (AnyControlInstance | null)[] =>\n    parent == null || childPath.length === 0\n      ? [parent ?? null]\n      : [parent, ...getInstanceChain(parent.child(childPath[0]), childPath.slice(1))]\n\n  return getInstanceChain(parentInstance, childPath)\n}\n\nexport function getInstanceByPropPath(\n  instances: Record<string, AnyControlInstance>,\n  propPath: string,\n): AnyControlInstance | null {\n  return getInstanceChainByPropPath(instances, propPath).at(-1) ?? null\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkD;AAClD,sBAA2E;AAE3E,mCAAoC;AAI7B,SAAS,mBACd,aACA,eACU;AACV,QAAM,EAAE,YAAY,SAAS,IAAI,eAAe,CAAC;AAEjD,QAAM,gBAAY,kDAAoB,UAAU;AAChD,QAAM,kBAAc;AAAA,IAClB,MACE,aAAa,QAAQ,YAAY,OAAO,sBAAsB,WAAW,QAAQ,IAAI;AAAA,IACvF,CAAC,WAAW,QAAQ;AAAA,EACtB;AAEA,QAAM,gBAAY;AAAA,IAChB,CAAC,kBAA8B;AAC7B,UAAI,aAAa,QAAQ,YAAY;AAAM,eAAO,MAAM;AAAA,QAAC;AAEzD,UAAI,eAA+B,CAAC;AAKpC,YAAM,oBAAoB,MAAM;AAC9B,oBAAY;AACZ,sBAAc;AAAA,MAChB;AAEA,YAAM,cAAc,MAAM;AACxB,qBAAa,QAAQ,iBAAe,YAAY,CAAC;AAEjD,cAAM,QAAQ,2BAA2B,WAAW,QAAQ,EAAE,OAAO,wBAAQ;AAC7E,uBAAe,MAAM,IAAI,cAAY,SAAS,UAAU,iBAAiB,CAAC;AAAA,MAC5E;AAEA,kBAAY;AAEZ,aAAO,MAAM,aAAa,QAAQ,iBAAe,YAAY,CAAC;AAAA,IAChE;AAAA,IACA,CAAC,WAAW,QAAQ;AAAA,EACtB;AAEA,QAAM,aAAS,mCAAqB,WAAW,aAAa,WAAW;AAEvE,MAAI,QAAQ;AACV,UAAM,WAAW,OAAO;AACxB,QAAI,SAAS,eAAe,cAAc,SAAS,YAAY,UAAU;AACvE,cAAQ,MAAM,8CAA8C,aAAa,QAAQ,QAAQ;AACzF,aAAO;AAAA,IACT;AAEA,QAAI,EAAE,kBAAkB,gBAAgB;AACtC,cAAQ;AAAA,QACN,iDAAiD,cAAc,IAAI,aAAa,OAAO,YAAY,IAAI;AAAA,QACvG,EAAE,YAAY;AAAA,MAChB;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,2BACd,WACA,UAC+B;AAC/B,QAAM,CAAC,YAAY,GAAG,SAAS,IAAI,SAAS,MAAM,GAAG;AACrD,QAAM,iBAAiB,UAAU,UAAU;AAE3C,QAAM,mBAAmB,CACvB,QACAA,eAEA,UAAU,QAAQA,WAAU,WAAW,IACnC,CAAC,UAAU,IAAI,IACf,CAAC,QAAQ,GAAG,iBAAiB,OAAO,MAAMA,WAAU,CAAC,CAAC,GAAGA,WAAU,MAAM,CAAC,CAAC,CAAC;AAElF,SAAO,iBAAiB,gBAAgB,SAAS;AACnD;AAEO,SAAS,sBACd,WACA,UAC2B;AAC3B,SAAO,2BAA2B,WAAW,QAAQ,EAAE,GAAG,EAAE,KAAK;AACnE;","names":["childPath"]}

package/dist/esm/api/graphql-api-client.js

@@ -9,7 +9,7 @@ class MakeswiftGraphQLApiClient {
   graphqlClient;
   constructor({ endpoint }) {
     this.graphqlClient = new GraphQLClient(endpoint, {
-      "makeswift-runtime-version": "0.28.8-canary.19"
+      "makeswift-runtime-version": "0.28.8-canary.20"
     });
   }
   async createTableRecord(tableId, columns) {

package/dist/esm/api/rest-api-client.js

@@ -113,7 +113,7 @@ class MakeswiftRestAPIClient {
     const requestHeaders = new Headers({
       "x-api-key": this.apiKey,
       "makeswift-site-api-key": this.apiKey,
-      "makeswift-runtime-version": "0.28.8-canary.19"
+      "makeswift-runtime-version": "0.28.8-canary.20"
     });
     if (siteVersion?.token) {
       requestUrl.searchParams.set("version", siteVersion.version);

package/dist/esm/api-handler/handlers/manifest.js

@@ -8,7 +8,7 @@ async function manifestHandler(req, { apiKey, manifest }) {
     return ApiResponse.json({ message: "Unauthorized" }, { status: 401 });
   }
   return ApiResponse.json({
-    version: "0.28.8-canary.19",
+    version: "0.28.8-canary.20",
     interactionMode: true,
     clientSideNavigation: false,
     elementFromPoint: false,

package/dist/esm/client/index.js

@@ -669,7 +669,7 @@ Received "${apiKey}" instead.`
       headers: {
         "x-api-key": this.apiKey,
         "makeswift-site-api-key": this.apiKey,
-        "makeswift-runtime-version": "0.28.8-canary.19",
+        "makeswift-runtime-version": "0.28.8-canary.20",
         "content-type": "application/json"
       },
       body: JSON.stringify({ token }),

package/dist/esm/runtimes/react/components/control-instances-context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"sourcesContent":["'use client'\n\nimport { createContext, useContext } from 'react'\n\nimport { ControlInstance } from '@makeswift/controls'\n\ntype Context = {\n  elementKey: string\n  instances: Record<string, ControlInstance> | null\n}\n\nconst ControlInstancesContext = createContext<Context | null>(null)\n\nexport const ControlInstancesProvider = ControlInstancesContext.Provider\n\nexport function useControlInstances(elementKey: string): Context['instances'] | null {\n  const cx = useContext(ControlInstancesContext)\n  return cx && cx.elementKey === elementKey ? cx.instances : null\n}\n"],"mappings":";AAEA,SAAS,eAAe,kBAAkB;AAS1C,MAAM,0BAA0B,cAA8B,IAAI;AAE3D,MAAM,2BAA2B,wBAAwB;AAEzD,SAAS,oBAAoB,YAAiD;AACnF,QAAM,KAAK,WAAW,uBAAuB;AAC7C,SAAO,MAAM,GAAG,eAAe,aAAa,GAAG,YAAY;AAC7D;","names":[]}
+{"version":3,"sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"sourcesContent":["'use client'\n\nimport { createContext, useContext } from 'react'\n\nimport { type AnyControlInstance } from '@makeswift/controls'\n\ntype Context = {\n  elementKey: string\n  instances: Record<string, AnyControlInstance> | null\n}\n\nconst ControlInstancesContext = createContext<Context | null>(null)\n\nexport const ControlInstancesProvider = ControlInstancesContext.Provider\n\nexport function useControlInstances(elementKey: string | undefined): Context['instances'] | null {\n  const cx = useContext(ControlInstancesContext)\n  return cx && cx.elementKey === elementKey ? cx.instances : null\n}\n"],"mappings":";AAEA,SAAS,eAAe,kBAAkB;AAS1C,MAAM,0BAA0B,cAA8B,IAAI;AAE3D,MAAM,2BAA2B,wBAAwB;AAEzD,SAAS,oBAAoB,YAA6D;AAC/F,QAAM,KAAK,WAAW,uBAAuB;AAC7C,SAAO,MAAM,GAAG,eAAe,aAAa,GAAG,YAAY;AAC7D;","names":[]}

package/dist/esm/runtimes/react/hooks/use-control-instance.js

@@ -0,0 +1,62 @@
+import { useCallback, useSyncExternalStore } from "react";
+import { isNotNil } from "@makeswift/controls";
+import { useControlInstances } from "./use-control-instances";
+function useControlInstance(instanceKey, instanceClass) {
+  const { elementKey, propPath } = instanceKey ?? {};
+  const instances = useControlInstances(elementKey);
+  const getInstance = useCallback(
+    () => instances != null && propPath != null ? getInstanceByPropPath(instances, propPath) : null,
+    [instances, propPath]
+  );
+  const subscribe = useCallback(
+    (onStateChange) => {
+      if (instances == null || propPath == null)
+        return () => {
+        };
+      let unsubscribes = [];
+      const handleStateChange = () => {
+        resubscribe();
+        onStateChange();
+      };
+      const resubscribe = () => {
+        unsubscribes.forEach((unsubscribe) => unsubscribe());
+        const chain = getInstanceChainByPropPath(instances, propPath).filter(isNotNil);
+        unsubscribes = chain.map((instance) => instance.subscribe(handleStateChange));
+      };
+      resubscribe();
+      return () => unsubscribes.forEach((unsubscribe) => unsubscribe());
+    },
+    [instances, propPath]
+  );
+  const result = useSyncExternalStore(subscribe, getInstance, getInstance);
+  if (result) {
+    const foundKey = result.instanceKey;
+    if (foundKey.elementKey !== elementKey || foundKey.propPath != propPath) {
+      console.error("Mismatching control instance key: expected", instanceKey, " got", foundKey);
+      return null;
+    }
+    if (!(result instanceof instanceClass)) {
+      console.error(
+        `Unexpected control instance class: requested '${instanceClass.name}', found '${result.constructor.name}'`,
+        { instanceKey }
+      );
+      return null;
+    }
+  }
+  return result;
+}
+function getInstanceChainByPropPath(instances, propPath) {
+  const [parentProp, ...childPath] = propPath.split(".");
+  const parentInstance = instances[parentProp];
+  const getInstanceChain = (parent, childPath2) => parent == null || childPath2.length === 0 ? [parent ?? null] : [parent, ...getInstanceChain(parent.child(childPath2[0]), childPath2.slice(1))];
+  return getInstanceChain(parentInstance, childPath);
+}
+function getInstanceByPropPath(instances, propPath) {
+  return getInstanceChainByPropPath(instances, propPath).at(-1) ?? null;
+}
+export {
+  getInstanceByPropPath,
+  getInstanceChainByPropPath,
+  useControlInstance
+};
+//# sourceMappingURL=use-control-instance.js.map

package/dist/esm/runtimes/react/hooks/use-control-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/runtimes/react/hooks/use-control-instance.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react'\nimport { type AnyControlInstance, type ControlInstanceKey, isNotNil } from '@makeswift/controls'\n\nimport { useControlInstances } from './use-control-instances'\n\ntype InstanceConstructor<T extends AnyControlInstance> = abstract new (...args: never[]) => T\n\nexport function useControlInstance<T extends AnyControlInstance>(\n  instanceKey: ControlInstanceKey | undefined,\n  instanceClass: InstanceConstructor<T>,\n): T | null {\n  const { elementKey, propPath } = instanceKey ?? {}\n\n  const instances = useControlInstances(elementKey)\n  const getInstance = useCallback(\n    () =>\n      instances != null && propPath != null ? getInstanceByPropPath(instances, propPath) : null,\n    [instances, propPath],\n  )\n\n  const subscribe = useCallback(\n    (onStateChange: () => void) => {\n      if (instances == null || propPath == null) return () => {}\n\n      let unsubscribes: (() => void)[] = []\n\n      // recompute the instance chain and resubscribe to its updates on every notification,\n      // since a control's own update (e.g. a `ListControl` replacing its children) can replace\n      // the instances further down the chain\n      const handleStateChange = () => {\n        resubscribe()\n        onStateChange()\n      }\n\n      const resubscribe = () => {\n        unsubscribes.forEach(unsubscribe => unsubscribe())\n\n        const chain = getInstanceChainByPropPath(instances, propPath).filter(isNotNil)\n        unsubscribes = chain.map(instance => instance.subscribe(handleStateChange))\n      }\n\n      resubscribe()\n\n      return () => unsubscribes.forEach(unsubscribe => unsubscribe())\n    },\n    [instances, propPath],\n  )\n\n  const result = useSyncExternalStore(subscribe, getInstance, getInstance)\n\n  if (result) {\n    const foundKey = result.instanceKey\n    if (foundKey.elementKey !== elementKey || foundKey.propPath != propPath) {\n      console.error('Mismatching control instance key: expected', instanceKey, ' got', foundKey)\n      return null\n    }\n\n    if (!(result instanceof instanceClass)) {\n      console.error(\n        `Unexpected control instance class: requested '${instanceClass.name}', found '${result.constructor.name}'`,\n        { instanceKey },\n      )\n\n      return null\n    }\n  }\n\n  return result\n}\n\nexport function getInstanceChainByPropPath(\n  instances: Record<string, AnyControlInstance>,\n  propPath: string,\n): (AnyControlInstance | null)[] {\n  const [parentProp, ...childPath] = propPath.split('.')\n  const parentInstance = instances[parentProp]\n\n  const getInstanceChain = (\n    parent: AnyControlInstance | undefined,\n    childPath: string[],\n  ): (AnyControlInstance | null)[] =>\n    parent == null || childPath.length === 0\n      ? [parent ?? null]\n      : [parent, ...getInstanceChain(parent.child(childPath[0]), childPath.slice(1))]\n\n  return getInstanceChain(parentInstance, childPath)\n}\n\nexport function getInstanceByPropPath(\n  instances: Record<string, AnyControlInstance>,\n  propPath: string,\n): AnyControlInstance | null {\n  return getInstanceChainByPropPath(instances, propPath).at(-1) ?? null\n}\n"],"mappings":"AAAA,SAAS,aAAa,4BAA4B;AAClD,SAA2D,gBAAgB;AAE3E,SAAS,2BAA2B;AAI7B,SAAS,mBACd,aACA,eACU;AACV,QAAM,EAAE,YAAY,SAAS,IAAI,eAAe,CAAC;AAEjD,QAAM,YAAY,oBAAoB,UAAU;AAChD,QAAM,cAAc;AAAA,IAClB,MACE,aAAa,QAAQ,YAAY,OAAO,sBAAsB,WAAW,QAAQ,IAAI;AAAA,IACvF,CAAC,WAAW,QAAQ;AAAA,EACtB;AAEA,QAAM,YAAY;AAAA,IAChB,CAAC,kBAA8B;AAC7B,UAAI,aAAa,QAAQ,YAAY;AAAM,eAAO,MAAM;AAAA,QAAC;AAEzD,UAAI,eAA+B,CAAC;AAKpC,YAAM,oBAAoB,MAAM;AAC9B,oBAAY;AACZ,sBAAc;AAAA,MAChB;AAEA,YAAM,cAAc,MAAM;AACxB,qBAAa,QAAQ,iBAAe,YAAY,CAAC;AAEjD,cAAM,QAAQ,2BAA2B,WAAW,QAAQ,EAAE,OAAO,QAAQ;AAC7E,uBAAe,MAAM,IAAI,cAAY,SAAS,UAAU,iBAAiB,CAAC;AAAA,MAC5E;AAEA,kBAAY;AAEZ,aAAO,MAAM,aAAa,QAAQ,iBAAe,YAAY,CAAC;AAAA,IAChE;AAAA,IACA,CAAC,WAAW,QAAQ;AAAA,EACtB;AAEA,QAAM,SAAS,qBAAqB,WAAW,aAAa,WAAW;AAEvE,MAAI,QAAQ;AACV,UAAM,WAAW,OAAO;AACxB,QAAI,SAAS,eAAe,cAAc,SAAS,YAAY,UAAU;AACvE,cAAQ,MAAM,8CAA8C,aAAa,QAAQ,QAAQ;AACzF,aAAO;AAAA,IACT;AAEA,QAAI,EAAE,kBAAkB,gBAAgB;AACtC,cAAQ;AAAA,QACN,iDAAiD,cAAc,IAAI,aAAa,OAAO,YAAY,IAAI;AAAA,QACvG,EAAE,YAAY;AAAA,MAChB;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,2BACd,WACA,UAC+B;AAC/B,QAAM,CAAC,YAAY,GAAG,SAAS,IAAI,SAAS,MAAM,GAAG;AACrD,QAAM,iBAAiB,UAAU,UAAU;AAE3C,QAAM,mBAAmB,CACvB,QACAA,eAEA,UAAU,QAAQA,WAAU,WAAW,IACnC,CAAC,UAAU,IAAI,IACf,CAAC,QAAQ,GAAG,iBAAiB,OAAO,MAAMA,WAAU,CAAC,CAAC,GAAGA,WAAU,MAAM,CAAC,CAAC,CAAC;AAElF,SAAO,iBAAiB,gBAAgB,SAAS;AACnD;AAEO,SAAS,sBACd,WACA,UAC2B;AAC3B,SAAO,2BAA2B,WAAW,QAAQ,EAAE,GAAG,EAAE,KAAK;AACnE;","names":["childPath"]}

package/dist/types/runtimes/react/components/control-instances-context.d.ts

@@ -1,9 +1,9 @@
-import { ControlInstance } from '@makeswift/controls';
+import { type AnyControlInstance } from '@makeswift/controls';
 type Context = {
     elementKey: string;
-    instances: Record<string, ControlInstance> | null;
+    instances: Record<string, AnyControlInstance> | null;
 };
 export declare const ControlInstancesProvider: import("react").Provider<Context | null>;
-export declare function useControlInstances(elementKey: string): Context['instances'] | null;
+export declare function useControlInstances(elementKey: string | undefined): Context['instances'] | null;
 export {};
 //# sourceMappingURL=control-instances-context.d.ts.map

package/dist/types/runtimes/react/components/control-instances-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-instances-context.d.ts","sourceRoot":"","sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,KAAK,OAAO,GAAG;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAAA;CAClD,CAAA;AAID,eAAO,MAAM,wBAAwB,0CAAmC,CAAA;AAExE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAGnF"}
+{"version":3,"file":"control-instances-context.d.ts","sourceRoot":"","sources":["../../../../../src/runtimes/react/components/control-instances-context.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE7D,KAAK,OAAO,GAAG;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CAAA;CACrD,CAAA;AAID,eAAO,MAAM,wBAAwB,0CAAmC,CAAA;AAExE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAG/F"}

package/dist/types/runtimes/react/hooks/__tests__/use-control-instance.test.d.ts

@@ -0,0 +1,3 @@
+/** @jest-environment jsdom */
+import '@testing-library/jest-dom';
+//# sourceMappingURL=use-control-instance.test.d.ts.map

package/dist/types/runtimes/react/hooks/__tests__/use-control-instance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-control-instance.test.d.ts","sourceRoot":"","sources":["../../../../../../src/runtimes/react/hooks/__tests__/use-control-instance.test.tsx"],"names":[],"mappings":"AAAA,8BAA8B;AAI9B,OAAO,2BAA2B,CAAA"}

package/dist/types/runtimes/react/hooks/use-control-instance.d.ts

@@ -0,0 +1,7 @@
+import { type AnyControlInstance, type ControlInstanceKey } from '@makeswift/controls';
+type InstanceConstructor<T extends AnyControlInstance> = abstract new (...args: never[]) => T;
+export declare function useControlInstance<T extends AnyControlInstance>(instanceKey: ControlInstanceKey | undefined, instanceClass: InstanceConstructor<T>): T | null;
+export declare function getInstanceChainByPropPath(instances: Record<string, AnyControlInstance>, propPath: string): (AnyControlInstance | null)[];
+export declare function getInstanceByPropPath(instances: Record<string, AnyControlInstance>, propPath: string): AnyControlInstance | null;
+export {};
+//# sourceMappingURL=use-control-instance.d.ts.map

package/dist/types/runtimes/react/hooks/use-control-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-control-instance.d.ts","sourceRoot":"","sources":["../../../../../src/runtimes/react/hooks/use-control-instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAY,MAAM,qBAAqB,CAAA;AAIhG,KAAK,mBAAmB,CAAC,CAAC,SAAS,kBAAkB,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AAE7F,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,EAC7D,WAAW,EAAE,kBAAkB,GAAG,SAAS,EAC3C,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,GACpC,CAAC,GAAG,IAAI,CA0DV;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC7C,QAAQ,EAAE,MAAM,GACf,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAa/B;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC7C,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,IAAI,CAE3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makeswift/runtime",
-  "version": "0.28.8-canary.19",
+  "version": "0.28.8-canary.20",
   "license": "MIT",
   "repository": {
     "url": "makeswift/makeswift",
@@ -238,9 +238,9 @@
     "use-sync-external-store": "^1.5.0",
     "uuid": "^9.0.0",
     "zod": "^3.21.4",
-    "@makeswift/controls": "0.1.21-canary.9",
+    "@makeswift/controls": "0.1.21-canary.10",
     "@makeswift/next-plugin": "0.6.1",
-    "@makeswift/prop-controllers": "0.4.15-canary.9"
+    "@makeswift/prop-controllers": "0.4.15-canary.10"
   },
   "devDependencies": {
     "@emotion/jest": "^11.11.0",