@webiny/react-properties 0.0.0-unstable.7f63ea0744 → 0.0.0-unstable.81ae05e56b

package/DevToolsSection.d.ts

@@ -0,0 +1,40 @@
+type DevToolsView = "browse" | "raw";
+interface DevToolsSectionProps {
+    name: string;
+    data: unknown;
+    /**
+     * Group name for the sidebar. Items with the same group appear
+     * under the same header. Defaults to "Sections".
+     *
+     * @example
+     * ```tsx
+     * <DevToolsSection name="Article" group="CMS" data={model} />
+     * <DevToolsSection name="Author" group="CMS" data={author} />
+     * ```
+     */
+    group?: string;
+    /**
+     * Which views to show in the detail panel.
+     * - `"browse"` — split view with root keys on the left, value tree on the right
+     * - `"raw"` — full JSON tree view
+     *
+     * Accepts a single view or an array. First item is the default tab.
+     * @default ["browse", "raw"]
+     */
+    views?: DevToolsView | DevToolsView[];
+}
+/**
+ * Registers a named section in the Webiny DevTools extension.
+ * Renders nothing — purely a data registration side-effect.
+ *
+ * When the component unmounts (e.g., route change), the section
+ * is automatically removed from DevTools.
+ *
+ * @example
+ * ```tsx
+ * <DevToolsSection name="CMS Model" data={model} />
+ * <DevToolsSection name="Article" group="CMS" data={model} views="raw" />
+ * ```
+ */
+export declare function DevToolsSection({ name, data, group, views }: DevToolsSectionProps): null;
+export {};

package/DevToolsSection.js

@@ -0,0 +1,70 @@
+import { useEffect } from "react";
+import { getHook } from "./useDebugConfig.js";
+/**
+ * Registers a named section in the Webiny DevTools extension.
+ * Renders nothing — purely a data registration side-effect.
+ *
+ * When the component unmounts (e.g., route change), the section
+ * is automatically removed from DevTools.
+ *
+ * @example
+ * ```tsx
+ * <DevToolsSection name="CMS Model" data={model} />
+ * <DevToolsSection name="Article" group="CMS" data={model} views="raw" />
+ * ```
+ */
+export function DevToolsSection({
+  name,
+  data,
+  group,
+  views
+}) {
+  // Snapshot the data on every render to get a stable, plain value.
+  // This also ensures that if data is a MobX observable, we capture
+  // the current state as a plain object (no proxies on the hook).
+  const dataKey = safeStringify(data);
+  useEffect(() => {
+    if (process.env.NODE_ENV !== "development") {
+      return;
+    }
+    const normalizedViews = views ? Array.isArray(views) ? views : [views] : ["browse", "raw"];
+    let plainData;
+    try {
+      plainData = JSON.parse(dataKey);
+    } catch {
+      plainData = data;
+    }
+    const hook = getHook();
+    hook.sections[name] = {
+      data: plainData,
+      group: group || "Sections",
+      views: normalizedViews,
+      updatedAt: Date.now()
+    };
+    hook.revision++;
+    return () => {
+      if (window.__WEBINY_DEVTOOLS_HOOK__) {
+        delete window.__WEBINY_DEVTOOLS_HOOK__.sections[name];
+        window.__WEBINY_DEVTOOLS_HOOK__.revision++;
+      }
+    };
+  }, [name, dataKey, group, Array.isArray(views) ? views.join(",") : views]);
+  return null;
+}
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value, (_key, v) => {
+      if (typeof v === "function") {
+        return `[Function: ${v.name || "anonymous"}]`;
+      }
+      if (typeof v === "undefined") {
+        return "[undefined]";
+      }
+      return v;
+    });
+  } catch {
+    return String(value);
+  }
+}
+
+//# sourceMappingURL=DevToolsSection.js.map

package/DevToolsSection.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","getHook","DevToolsSection","name","data","group","views","dataKey","safeStringify","process","env","NODE_ENV","normalizedViews","Array","isArray","plainData","JSON","parse","hook","sections","updatedAt","Date","now","revision","window","__WEBINY_DEVTOOLS_HOOK__","join","value","stringify","_key","v","String"],"sources":["DevToolsSection.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport { getHook } from \"./useDebugConfig.js\";\n\ntype DevToolsView = \"browse\" | \"raw\";\n\ninterface DevToolsSectionProps {\n    name: string;\n    data: unknown;\n    /**\n     * Group name for the sidebar. Items with the same group appear\n     * under the same header. Defaults to \"Sections\".\n     *\n     * @example\n     * ```tsx\n     * <DevToolsSection name=\"Article\" group=\"CMS\" data={model} />\n     * <DevToolsSection name=\"Author\" group=\"CMS\" data={author} />\n     * ```\n     */\n    group?: string;\n    /**\n     * Which views to show in the detail panel.\n     * - `\"browse\"` — split view with root keys on the left, value tree on the right\n     * - `\"raw\"` — full JSON tree view\n     *\n     * Accepts a single view or an array. First item is the default tab.\n     * @default [\"browse\", \"raw\"]\n     */\n    views?: DevToolsView | DevToolsView[];\n}\n\n/**\n * Registers a named section in the Webiny DevTools extension.\n * Renders nothing — purely a data registration side-effect.\n *\n * When the component unmounts (e.g., route change), the section\n * is automatically removed from DevTools.\n *\n * @example\n * ```tsx\n * <DevToolsSection name=\"CMS Model\" data={model} />\n * <DevToolsSection name=\"Article\" group=\"CMS\" data={model} views=\"raw\" />\n * ```\n */\nexport function DevToolsSection({ name, data, group, views }: DevToolsSectionProps) {\n    // Snapshot the data on every render to get a stable, plain value.\n    // This also ensures that if data is a MobX observable, we capture\n    // the current state as a plain object (no proxies on the hook).\n    const dataKey = safeStringify(data);\n\n    useEffect(() => {\n        if (process.env.NODE_ENV !== \"development\") {\n            return;\n        }\n\n        const normalizedViews: DevToolsView[] = views\n            ? Array.isArray(views)\n                ? views\n                : [views]\n            : [\"browse\", \"raw\"];\n\n        let plainData: unknown;\n        try {\n            plainData = JSON.parse(dataKey);\n        } catch {\n            plainData = data;\n        }\n\n        const hook = getHook();\n        hook.sections[name] = {\n            data: plainData,\n            group: group || \"Sections\",\n            views: normalizedViews,\n            updatedAt: Date.now()\n        };\n        hook.revision++;\n\n        return () => {\n            if (window.__WEBINY_DEVTOOLS_HOOK__) {\n                delete window.__WEBINY_DEVTOOLS_HOOK__.sections[name];\n                window.__WEBINY_DEVTOOLS_HOOK__.revision++;\n            }\n        };\n    }, [name, dataKey, group, Array.isArray(views) ? views.join(\",\") : views]);\n\n    return null;\n}\n\nfunction safeStringify(value: unknown): string {\n    try {\n        return JSON.stringify(value, (_key, v) => {\n            if (typeof v === \"function\") {\n                return `[Function: ${v.name || \"anonymous\"}]`;\n            }\n            if (typeof v === \"undefined\") {\n                return \"[undefined]\";\n            }\n            return v;\n        });\n    } catch {\n        return String(value);\n    }\n}\n"],"mappings":"AAAA,SAASA,SAAS,QAAQ,OAAO;AACjC,SAASC,OAAO;AA6BhB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAC;EAAEC,IAAI;EAAEC,IAAI;EAAEC,KAAK;EAAEC;AAA4B,CAAC,EAAE;EAChF;EACA;EACA;EACA,MAAMC,OAAO,GAAGC,aAAa,CAACJ,IAAI,CAAC;EAEnCJ,SAAS,CAAC,MAAM;IACZ,IAAIS,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,aAAa,EAAE;MACxC;IACJ;IAEA,MAAMC,eAA+B,GAAGN,KAAK,GACvCO,KAAK,CAACC,OAAO,CAACR,KAAK,CAAC,GAChBA,KAAK,GACL,CAACA,KAAK,CAAC,GACX,CAAC,QAAQ,EAAE,KAAK,CAAC;IAEvB,IAAIS,SAAkB;IACtB,IAAI;MACAA,SAAS,GAAGC,IAAI,CAACC,KAAK,CAACV,OAAO,CAAC;IACnC,CAAC,CAAC,MAAM;MACJQ,SAAS,GAAGX,IAAI;IACpB;IAEA,MAAMc,IAAI,GAAGjB,OAAO,CAAC,CAAC;IACtBiB,IAAI,CAACC,QAAQ,CAAChB,IAAI,CAAC,GAAG;MAClBC,IAAI,EAAEW,SAAS;MACfV,KAAK,EAAEA,KAAK,IAAI,UAAU;MAC1BC,KAAK,EAAEM,eAAe;MACtBQ,SAAS,EAAEC,IAAI,CAACC,GAAG,CAAC;IACxB,CAAC;IACDJ,IAAI,CAACK,QAAQ,EAAE;IAEf,OAAO,MAAM;MACT,IAAIC,MAAM,CAACC,wBAAwB,EAAE;QACjC,OAAOD,MAAM,CAACC,wBAAwB,CAACN,QAAQ,CAAChB,IAAI,CAAC;QACrDqB,MAAM,CAACC,wBAAwB,CAACF,QAAQ,EAAE;MAC9C;IACJ,CAAC;EACL,CAAC,EAAE,CAACpB,IAAI,EAAEI,OAAO,EAAEF,KAAK,EAAEQ,KAAK,CAACC,OAAO,CAACR,KAAK,CAAC,GAAGA,KAAK,CAACoB,IAAI,CAAC,GAAG,CAAC,GAAGpB,KAAK,CAAC,CAAC;EAE1E,OAAO,IAAI;AACf;AAEA,SAASE,aAAaA,CAACmB,KAAc,EAAU;EAC3C,IAAI;IACA,OAAOX,IAAI,CAACY,SAAS,CAACD,KAAK,EAAE,CAACE,IAAI,EAAEC,CAAC,KAAK;MACtC,IAAI,OAAOA,CAAC,KAAK,UAAU,EAAE;QACzB,OAAO,cAAcA,CAAC,CAAC3B,IAAI,IAAI,WAAW,GAAG;MACjD;MACA,IAAI,OAAO2B,CAAC,KAAK,WAAW,EAAE;QAC1B,OAAO,aAAa;MACxB;MACA,OAAOA,CAAC;IACZ,CAAC,CAAC;EACN,CAAC,CAAC,MAAM;IACJ,OAAOC,MAAM,CAACJ,KAAK,CAAC;EACxB;AACJ","ignoreList":[]}

package/Properties.d.ts

@@ -1,17 +1,28 @@
 import React from "react";
+import { PropertyStore } from "./domain/index.js";
+export interface ConnectToPropertiesProps {
+    name: string;
+    children: React.ReactNode;
+}
+export declare const ConnectToProperties: ({ name, children }: ConnectToPropertiesProps) => React.JSX.Element;
 export interface Property {
     id: string;
     parent: string;
     name: string;
-    value: unknown;
+    value?: unknown;
     array?: boolean;
+    $isFirst?: boolean;
+    $isLast?: boolean;
 }
 interface AddPropertyOptions {
     after?: string;
     before?: string;
+    priority?: number;
 }
 interface PropertiesContext {
-    properties: Property[];
+    name?: string;
+    store: PropertyStore;
+    getAncestor(name: string): PropertiesContext | undefined;
     getObject<T = unknown>(): T;
     addProperty(property: Property, options?: AddPropertyOptions): void;
     removeProperty(id: string): void;
@@ -19,10 +30,14 @@ interface PropertiesContext {
 }
 declare const PropertiesContext: React.Context<PropertiesContext | undefined>;
 interface PropertiesProps {
+    name?: string;
     onChange?(properties: Property[]): void;
+    children: React.ReactNode;
 }
-export declare const Properties: React.FC<PropertiesProps>;
+export declare const Properties: ({ name, onChange, children }: PropertiesProps) => React.JSX.Element;
 export declare function useProperties(): PropertiesContext;
+export declare function useMaybeProperties(): PropertiesContext | undefined;
+export declare function useAncestorByName(name: string | undefined): PropertiesContext | undefined;
 interface PropertyProps {
     id?: string;
     name: string;
@@ -34,11 +49,12 @@ interface PropertyProps {
     remove?: boolean;
     parent?: string;
     root?: boolean;
+    children?: React.ReactNode;
 }
 export declare function useParentProperty(): Property | undefined;
 interface AncestorMatch {
     [key: string]: string | boolean | number | null | undefined;
 }
 export declare function useAncestor(params: AncestorMatch): Property | undefined;
-export declare const Property: React.FC<PropertyProps>;
+export declare const Property: ({ id, name, value, children, after, before, replace, remove, array, root, parent }: PropertyProps) => React.JSX.Element | null;
 export {};

package/Properties.js

@@ -1,172 +1,156 @@
-"use strict";
-
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.Property = exports.Properties = void 0;
-exports.useAncestor = useAncestor;
-exports.useParentProperty = useParentProperty;
-exports.useProperties = useProperties;
-var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-var _react = _interopRequireWildcard(require("react"));
-var _utils = require("./utils");
-function removeByParent(id, properties) {
-  return properties.filter(function (prop) {
-    return prop.parent === id;
-  }).reduce(function (acc, item) {
-    return removeByParent(item.id, acc.filter(function (prop) {
-      return prop.id !== item.id;
-    }));
-  }, properties);
-}
-var PropertiesContext = /*#__PURE__*/(0, _react.createContext)(undefined);
-var Properties = function Properties(_ref) {
-  var onChange = _ref.onChange,
-    children = _ref.children;
-  var _useState = (0, _react.useState)([]),
-    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    properties = _useState2[0],
-    setProperties = _useState2[1];
-  (0, _react.useEffect)(function () {
-    if (onChange) {
-      onChange(properties);
+import React, { createContext, useContext, useEffect, useMemo, useRef } from "react";
+import { getUniqueId, toObject } from "./utils.js";
+import { PropertyStore } from "./domain/index.js";
+import { usePropertyPriority } from "./PropertyPriority.js";
+const PropertiesTargetContext = /*#__PURE__*/createContext(undefined);
+export const ConnectToProperties = ({
+  name,
+  children
+}) => {
+  return /*#__PURE__*/React.createElement(PropertiesTargetContext.Provider, {
+    value: name
+  }, children);
+};
+const PropertiesContext = /*#__PURE__*/createContext(undefined);
+export const Properties = ({
+  name,
+  onChange,
+  children
+}) => {
+  const storeRef = useRef(null);
+  if (!storeRef.current) {
+    storeRef.current = new PropertyStore();
+  }
+  const store = storeRef.current;
+  let parent;
+  try {
+    parent = useProperties();
+  } catch {
+    // Do nothing, if there's no parent.
+  }
+  useEffect(() => {
+    if (!onChange) {
+      return;
     }
-  }, [properties]);
-  var context = (0, _react.useMemo)(function () {
-    return {
-      properties: properties,
-      getObject: function getObject() {
-        return (0, _utils.toObject)(properties);
-      },
-      addProperty: function addProperty(property) {
-        var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-        setProperties(function (properties) {
-          // If a property with this ID already exists, merge the two properties.
-          var index = properties.findIndex(function (prop) {
-            return prop.id === property.id;
-          });
-          if (index > -1) {
-            return [].concat((0, _toConsumableArray2.default)(properties.slice(0, index)), [(0, _objectSpread2.default)((0, _objectSpread2.default)({}, properties[index]), property)], (0, _toConsumableArray2.default)(properties.slice(index + 1)));
-          }
-          if (options.after) {
-            var _index = properties.findIndex(function (prop) {
-              return prop.id === options.after;
-            });
-            if (_index > -1) {
-              return [].concat((0, _toConsumableArray2.default)(properties.slice(0, _index + 1)), [property], (0, _toConsumableArray2.default)(properties.slice(_index + 1)));
-            }
-          }
-          if (options.before) {
-            var _index2 = properties.findIndex(function (prop) {
-              return prop.id === options.before;
-            });
-            if (_index2 > -1) {
-              return [].concat((0, _toConsumableArray2.default)(properties.slice(0, _index2)), [property], (0, _toConsumableArray2.default)(properties.slice(_index2)));
-            }
-          }
-          return [].concat((0, _toConsumableArray2.default)(properties), [property]);
-        });
-      },
-      removeProperty: function removeProperty(id) {
-        setProperties(function (properties) {
-          return removeByParent(id, properties.filter(function (prop) {
-            return prop.id !== id;
-          }));
-        });
-      },
-      replaceProperty: function replaceProperty(id, property) {
-        setProperties(function (properties) {
-          var toReplace = properties.findIndex(function (prop) {
-            return prop.id === id;
-          });
-          if (toReplace > -1) {
-            // Replace the property and remove all remaining child properties.
-            return removeByParent(id, [].concat((0, _toConsumableArray2.default)(properties.slice(0, toReplace)), [property], (0, _toConsumableArray2.default)(properties.slice(toReplace + 1))));
-          }
-          return properties;
-        });
+    return store.subscribe(properties => {
+      onChange(properties);
+    });
+  }, [store, onChange]);
+
+  // Context value is stable — it never changes after mount.
+  // Children never re-render due to context changes.
+  const context = useMemo(() => ({
+    name,
+    store,
+    getAncestor(ancestorName) {
+      if (!parent) {
+        return undefined;
       }
-    };
-  }, [properties]);
-  return /*#__PURE__*/_react.default.createElement(PropertiesContext.Provider, {
+      return parent && parent.name === ancestorName ? parent : parent.getAncestor(ancestorName);
+    },
+    getObject() {
+      return toObject(store.allProperties);
+    },
+    addProperty(property, options = {}) {
+      store.addProperty(property, options);
+    },
+    removeProperty(id) {
+      store.removeProperty(id);
+    },
+    replaceProperty(id, property) {
+      store.replaceProperty(id, property);
+    }
+  }), [store]);
+  return /*#__PURE__*/React.createElement(PropertiesContext.Provider, {
     value: context
   }, children);
 };
-exports.Properties = Properties;
-function useProperties() {
-  var properties = (0, _react.useContext)(PropertiesContext);
-  if (!properties) {
+export function useProperties() {
+  const context = useContext(PropertiesContext);
+  if (!context) {
     throw Error("Properties context provider is missing!");
   }
-  return properties;
+  return context;
 }
-var PropertyContext = /*#__PURE__*/(0, _react.createContext)(undefined);
-function useParentProperty() {
-  return (0, _react.useContext)(PropertyContext);
+export function useMaybeProperties() {
+  return useContext(PropertiesContext);
 }
-function useAncestor(params) {
-  var property = useParentProperty();
-  var _useProperties = useProperties(),
-    properties = _useProperties.properties;
-  var matchOrGetAncestor = function matchOrGetAncestor(property, params) {
-    var matchedProps = properties.filter(function (prop) {
-      return prop.parent === property.id;
-    }).filter(function (prop) {
-      return prop.name in params && prop.value === params[prop.name];
-    });
+export function useAncestorByName(name) {
+  const parent = useMaybeProperties();
+  return useMemo(() => {
+    if (!name || !parent) {
+      return undefined;
+    }
+    if (parent.name === name) {
+      return parent;
+    }
+    return parent.getAncestor(name);
+  }, [name]);
+}
+const PropertyContext = /*#__PURE__*/createContext(undefined);
+export function useParentProperty() {
+  return useContext(PropertyContext);
+}
+export function useAncestor(params) {
+  const property = useParentProperty();
+  const {
+    store
+  } = useProperties();
+  const matchOrGetAncestor = (property, params) => {
+    const children = store.getChildrenOf(property.id);
+    const matchedProps = children.filter(prop => prop.name in params && prop.value === params[prop.name]);
     if (matchedProps.length === Object.keys(params).length) {
       return property;
     }
-    var newParent = property.parent ? properties.find(function (prop) {
-      return prop.id === property.parent;
-    }) : undefined;
+    const newParent = property.parent ? store.getById(property.parent) : undefined;
     return newParent ? matchOrGetAncestor(newParent, params) : undefined;
   };
   return property ? matchOrGetAncestor(property, params) : undefined;
 }
-var Property = function Property(_ref2) {
-  var id = _ref2.id,
-    name = _ref2.name,
-    value = _ref2.value,
-    children = _ref2.children,
-    _ref2$after = _ref2.after,
-    after = _ref2$after === void 0 ? undefined : _ref2$after,
-    _ref2$before = _ref2.before,
-    before = _ref2$before === void 0 ? undefined : _ref2$before,
-    _ref2$replace = _ref2.replace,
-    replace = _ref2$replace === void 0 ? undefined : _ref2$replace,
-    _ref2$remove = _ref2.remove,
-    remove = _ref2$remove === void 0 ? false : _ref2$remove,
-    _ref2$array = _ref2.array,
-    array = _ref2$array === void 0 ? false : _ref2$array,
-    _ref2$root = _ref2.root,
-    root = _ref2$root === void 0 ? false : _ref2$root,
-    _ref2$parent = _ref2.parent,
-    parent = _ref2$parent === void 0 ? undefined : _ref2$parent;
-  var uniqueId = (0, _react.useMemo)(function () {
-    return id || (0, _utils.getUniqueId)();
-  }, []);
-  var parentProperty = useParentProperty();
-  var properties = useProperties();
+export const Property = ({
+  id,
+  name,
+  value,
+  children,
+  after = undefined,
+  before = undefined,
+  replace = undefined,
+  remove = false,
+  array = false,
+  root = false,
+  parent = undefined
+}) => {
+  const targetName = useContext(PropertiesTargetContext);
+  const uniqueId = useMemo(() => id || getUniqueId(), []);
+  const parentProperty = useParentProperty();
+  const immediateProperties = useProperties();
+  const ancestorByName = useAncestorByName(targetName);
+  const previousValue = useRef(value);
+  const priority = usePropertyPriority();
+  const properties = targetName && ancestorByName ? ancestorByName : immediateProperties;
   if (!properties) {
     throw Error("<Properties> provider is missing higher in the hierarchy!");
   }
-  var addProperty = properties.addProperty,
-    removeProperty = properties.removeProperty,
-    replaceProperty = properties.replaceProperty;
-  var parentId = parent ? parent : root ? "" : (parentProperty === null || parentProperty === void 0 ? void 0 : parentProperty.id) || "";
-  var property = {
+  const {
+    addProperty,
+    removeProperty,
+    replaceProperty,
+    store: propertyStore
+  } = properties;
+  const parentId = parent ? parent : root ? "" : parentProperty?.id || "";
+  const property = {
     id: uniqueId,
-    name: name,
-    value: value,
+    name,
+    value,
     parent: parentId,
-    array: array
+    array
   };
-  (0, _react.useEffect)(function () {
+
+  // Register in the synchronous lookup during render so useAncestor can find this property.
+  if (!remove) {
+    propertyStore.registerLookup(property);
+  }
+  useEffect(() => {
     if (remove) {
       removeProperty(uniqueId);
       return;
@@ -175,19 +159,35 @@ var Property = function Property(_ref2) {
       replaceProperty(replace, property);
       return;
     }
-    addProperty(property, {
-      after: after,
-      before: before
+    const $isFirst = before === "$first";
+    const $isLast = after === "$last";
+    addProperty({
+      ...property,
+      $isFirst,
+      $isLast
+    }, {
+      after,
+      before,
+      priority
     });
-    return function () {
+    return () => {
       removeProperty(uniqueId);
     };
   }, []);
+  useEffect(() => {
+    if (previousValue.current !== value) {
+      previousValue.current = value;
+      if (!remove && !replace) {
+        replaceProperty(uniqueId, property);
+      }
+    }
+  }, [value]);
   if (children) {
-    return /*#__PURE__*/_react.default.createElement(PropertyContext.Provider, {
+    return /*#__PURE__*/React.createElement(PropertyContext.Provider, {
       value: property
     }, children);
   }
   return null;
 };
-exports.Property = Property;
+
+//# sourceMappingURL=Properties.js.map

package/Properties.js.map

@@ -1 +1 @@
-{"version":3,"names":["removeByParent","id","properties","filter","prop","parent","reduce","acc","item","PropertiesContext","createContext","undefined","Properties","onChange","children","useState","setProperties","useEffect","context","useMemo","getObject","toObject","addProperty","property","options","index","findIndex","slice","after","before","removeProperty","replaceProperty","toReplace","useProperties","useContext","Error","PropertyContext","useParentProperty","useAncestor","params","matchOrGetAncestor","matchedProps","name","value","length","Object","keys","newParent","find","Property","replace","remove","array","root","uniqueId","getUniqueId","parentProperty","parentId"],"sources":["Properties.tsx"],"sourcesContent":["import React, { createContext, useContext, useEffect, useMemo, useState } from \"react\";\nimport { getUniqueId, toObject } from \"./utils\";\n\nexport interface Property {\n    id: string;\n    parent: string;\n    name: string;\n    value: unknown;\n    array?: boolean;\n}\n\nfunction removeByParent(id: string, properties: Property[]): Property[] {\n    return properties\n        .filter(prop => prop.parent === id)\n        .reduce((acc, item) => {\n            return removeByParent(\n                item.id,\n                acc.filter(prop => prop.id !== item.id)\n            );\n        }, properties);\n}\n\ninterface AddPropertyOptions {\n    after?: string;\n    before?: string;\n}\n\ninterface PropertiesContext {\n    properties: Property[];\n    getObject<T = unknown>(): T;\n    addProperty(property: Property, options?: AddPropertyOptions): void;\n    removeProperty(id: string): void;\n    replaceProperty(id: string, property: Property): void;\n}\n\nconst PropertiesContext = createContext<PropertiesContext | undefined>(undefined);\n\ninterface PropertiesProps {\n    onChange?(properties: Property[]): void;\n}\n\nexport const Properties: React.FC<PropertiesProps> = ({ onChange, children }) => {\n    const [properties, setProperties] = useState<Property[]>([]);\n\n    useEffect(() => {\n        if (onChange) {\n            onChange(properties);\n        }\n    }, [properties]);\n\n    const context: PropertiesContext = useMemo(\n        () => ({\n            properties,\n            getObject<T>() {\n                return toObject(properties) as T;\n            },\n            addProperty(property, options = {}) {\n                setProperties(properties => {\n                    // If a property with this ID already exists, merge the two properties.\n                    const index = properties.findIndex(prop => prop.id === property.id);\n                    if (index > -1) {\n                        return [\n                            ...properties.slice(0, index),\n                            { ...properties[index], ...property },\n                            ...properties.slice(index + 1)\n                        ];\n                    }\n\n                    if (options.after) {\n                        const index = properties.findIndex(prop => prop.id === options.after);\n                        if (index > -1) {\n                            return [\n                                ...properties.slice(0, index + 1),\n                                property,\n                                ...properties.slice(index + 1)\n                            ];\n                        }\n                    }\n\n                    if (options.before) {\n                        const index = properties.findIndex(prop => prop.id === options.before);\n                        if (index > -1) {\n                            return [\n                                ...properties.slice(0, index),\n                                property,\n                                ...properties.slice(index)\n                            ];\n                        }\n                    }\n\n                    return [...properties, property];\n                });\n            },\n            removeProperty(id) {\n                setProperties(properties => {\n                    return removeByParent(\n                        id,\n                        properties.filter(prop => prop.id !== id)\n                    );\n                });\n            },\n            replaceProperty(id, property) {\n                setProperties(properties => {\n                    const toReplace = properties.findIndex(prop => prop.id === id);\n\n                    if (toReplace > -1) {\n                        // Replace the property and remove all remaining child properties.\n                        return removeByParent(id, [\n                            ...properties.slice(0, toReplace),\n                            property,\n                            ...properties.slice(toReplace + 1)\n                        ]);\n                    }\n                    return properties;\n                });\n            }\n        }),\n        [properties]\n    );\n\n    return <PropertiesContext.Provider value={context}>{children}</PropertiesContext.Provider>;\n};\n\nexport function useProperties() {\n    const properties = useContext(PropertiesContext);\n    if (!properties) {\n        throw Error(\"Properties context provider is missing!\");\n    }\n\n    return properties;\n}\n\ninterface PropertyProps {\n    id?: string;\n    name: string;\n    value?: unknown;\n    array?: boolean;\n    after?: string;\n    before?: string;\n    replace?: string;\n    remove?: boolean;\n    parent?: string;\n    root?: boolean;\n}\n\nconst PropertyContext = createContext<Property | undefined>(undefined);\n\nexport function useParentProperty() {\n    return useContext(PropertyContext);\n}\n\ninterface AncestorMatch {\n    [key: string]: string | boolean | number | null | undefined;\n}\n\nexport function useAncestor(params: AncestorMatch) {\n    const property = useParentProperty();\n    const { properties } = useProperties();\n\n    const matchOrGetAncestor = (\n        property: Property,\n        params: AncestorMatch\n    ): Property | undefined => {\n        const matchedProps = properties\n            .filter(prop => prop.parent === property.id)\n            .filter(prop => prop.name in params && prop.value === params[prop.name]);\n\n        if (matchedProps.length === Object.keys(params).length) {\n            return property;\n        }\n\n        const newParent = property.parent\n            ? properties.find(prop => prop.id === property.parent)\n            : undefined;\n\n        return newParent ? matchOrGetAncestor(newParent, params) : undefined;\n    };\n\n    return property ? matchOrGetAncestor(property, params) : undefined;\n}\n\nexport const Property: React.FC<PropertyProps> = ({\n    id,\n    name,\n    value,\n    children,\n    after = undefined,\n    before = undefined,\n    replace = undefined,\n    remove = false,\n    array = false,\n    root = false,\n    parent = undefined\n}) => {\n    const uniqueId = useMemo(() => id || getUniqueId(), []);\n    const parentProperty = useParentProperty();\n    const properties = useProperties();\n\n    if (!properties) {\n        throw Error(\"<Properties> provider is missing higher in the hierarchy!\");\n    }\n\n    const { addProperty, removeProperty, replaceProperty } = properties;\n    const parentId = parent ? parent : root ? \"\" : parentProperty?.id || \"\";\n    const property = { id: uniqueId, name, value, parent: parentId, array };\n\n    useEffect(() => {\n        if (remove) {\n            removeProperty(uniqueId);\n            return;\n        }\n\n        if (replace) {\n            replaceProperty(replace, property);\n            return;\n        }\n\n        addProperty(property, { after, before });\n\n        return () => {\n            removeProperty(uniqueId);\n        };\n    }, []);\n\n    if (children) {\n        return <PropertyContext.Provider value={property}>{children}</PropertyContext.Provider>;\n    }\n\n    return null;\n};\n"],"mappings":"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"}
+{"version":3,"names":["React","createContext","useContext","useEffect","useMemo","useRef","getUniqueId","toObject","PropertyStore","usePropertyPriority","PropertiesTargetContext","undefined","ConnectToProperties","name","children","createElement","Provider","value","PropertiesContext","Properties","onChange","storeRef","current","store","parent","useProperties","subscribe","properties","context","getAncestor","ancestorName","getObject","allProperties","addProperty","property","options","removeProperty","id","replaceProperty","Error","useMaybeProperties","useAncestorByName","PropertyContext","useParentProperty","useAncestor","params","matchOrGetAncestor","getChildrenOf","matchedProps","filter","prop","length","Object","keys","newParent","getById","Property","after","before","replace","remove","array","root","targetName","uniqueId","parentProperty","immediateProperties","ancestorByName","previousValue","priority","propertyStore","parentId","registerLookup","$isFirst","$isLast"],"sources":["Properties.tsx"],"sourcesContent":["import React, { createContext, useContext, useEffect, useMemo, useRef } from \"react\";\nimport { getUniqueId, toObject } from \"./utils.js\";\nimport { PropertyStore } from \"./domain/index.js\";\nimport { usePropertyPriority } from \"./PropertyPriority.js\";\n\nconst PropertiesTargetContext = createContext<string | undefined>(undefined);\n\nexport interface ConnectToPropertiesProps {\n    name: string;\n    children: React.ReactNode;\n}\n\nexport const ConnectToProperties = ({ name, children }: ConnectToPropertiesProps) => {\n    return (\n        <PropertiesTargetContext.Provider value={name}>{children}</PropertiesTargetContext.Provider>\n    );\n};\n\nexport interface Property {\n    id: string;\n    parent: string;\n    name: string;\n    value?: unknown;\n    array?: boolean;\n    $isFirst?: boolean;\n    $isLast?: boolean;\n}\n\ninterface AddPropertyOptions {\n    after?: string;\n    before?: string;\n    priority?: number;\n}\n\ninterface PropertiesContext {\n    name?: string;\n    store: PropertyStore;\n    getAncestor(name: string): PropertiesContext | undefined;\n    getObject<T = unknown>(): T;\n    addProperty(property: Property, options?: AddPropertyOptions): void;\n    removeProperty(id: string): void;\n    replaceProperty(id: string, property: Property): void;\n}\n\nconst PropertiesContext = createContext<PropertiesContext | undefined>(undefined);\n\ninterface PropertiesProps {\n    name?: string;\n    onChange?(properties: Property[]): void;\n    children: React.ReactNode;\n}\n\nexport const Properties = ({ name, onChange, children }: PropertiesProps) => {\n    const storeRef = useRef<PropertyStore | null>(null);\n    if (!storeRef.current) {\n        storeRef.current = new PropertyStore();\n    }\n    const store = storeRef.current;\n\n    let parent: PropertiesContext;\n\n    try {\n        parent = useProperties();\n    } catch {\n        // Do nothing, if there's no parent.\n    }\n\n    useEffect(() => {\n        if (!onChange) {\n            return;\n        }\n\n        return store.subscribe(properties => {\n            onChange(properties);\n        });\n    }, [store, onChange]);\n\n    // Context value is stable — it never changes after mount.\n    // Children never re-render due to context changes.\n    const context: PropertiesContext = useMemo(\n        () => ({\n            name,\n            store,\n            getAncestor(ancestorName: string) {\n                if (!parent) {\n                    return undefined;\n                }\n\n                return parent && parent.name === ancestorName\n                    ? parent\n                    : parent.getAncestor(ancestorName);\n            },\n            getObject<T>() {\n                return toObject(store.allProperties) as T;\n            },\n            addProperty(property, options = {}) {\n                store.addProperty(property, options);\n            },\n            removeProperty(id) {\n                store.removeProperty(id);\n            },\n            replaceProperty(id, property) {\n                store.replaceProperty(id, property);\n            }\n        }),\n        [store]\n    );\n\n    return <PropertiesContext.Provider value={context}>{children}</PropertiesContext.Provider>;\n};\n\nexport function useProperties() {\n    const context = useContext(PropertiesContext);\n    if (!context) {\n        throw Error(\"Properties context provider is missing!\");\n    }\n\n    return context;\n}\n\nexport function useMaybeProperties() {\n    return useContext(PropertiesContext);\n}\n\nexport function useAncestorByName(name: string | undefined) {\n    const parent = useMaybeProperties();\n\n    return useMemo(() => {\n        if (!name || !parent) {\n            return undefined;\n        }\n\n        if (parent.name === name) {\n            return parent;\n        }\n\n        return parent.getAncestor(name);\n    }, [name]);\n}\n\ninterface PropertyProps {\n    id?: string;\n    name: string;\n    value?: unknown;\n    array?: boolean;\n    after?: string;\n    before?: string;\n    replace?: string;\n    remove?: boolean;\n    parent?: string;\n    root?: boolean;\n    children?: React.ReactNode;\n}\n\nconst PropertyContext = createContext<Property | undefined>(undefined);\n\nexport function useParentProperty() {\n    return useContext(PropertyContext);\n}\n\ninterface AncestorMatch {\n    [key: string]: string | boolean | number | null | undefined;\n}\n\nexport function useAncestor(params: AncestorMatch) {\n    const property = useParentProperty();\n    const { store } = useProperties();\n\n    const matchOrGetAncestor = (\n        property: Property,\n        params: AncestorMatch\n    ): Property | undefined => {\n        const children = store.getChildrenOf(property.id);\n        const matchedProps = children.filter(\n            prop => prop.name in params && prop.value === params[prop.name]\n        );\n\n        if (matchedProps.length === Object.keys(params).length) {\n            return property;\n        }\n\n        const newParent = property.parent ? store.getById(property.parent) : undefined;\n\n        return newParent ? matchOrGetAncestor(newParent, params) : undefined;\n    };\n\n    return property ? matchOrGetAncestor(property, params) : undefined;\n}\n\nexport const Property = ({\n    id,\n    name,\n    value,\n    children,\n    after = undefined,\n    before = undefined,\n    replace = undefined,\n    remove = false,\n    array = false,\n    root = false,\n    parent = undefined\n}: PropertyProps) => {\n    const targetName = useContext(PropertiesTargetContext);\n    const uniqueId = useMemo(() => id || getUniqueId(), []);\n    const parentProperty = useParentProperty();\n    const immediateProperties = useProperties();\n    const ancestorByName = useAncestorByName(targetName);\n    const previousValue = useRef(value);\n    const priority = usePropertyPriority();\n\n    const properties = targetName && ancestorByName ? ancestorByName : immediateProperties;\n\n    if (!properties) {\n        throw Error(\"<Properties> provider is missing higher in the hierarchy!\");\n    }\n\n    const { addProperty, removeProperty, replaceProperty, store: propertyStore } = properties;\n    const parentId = parent ? parent : root ? \"\" : parentProperty?.id || \"\";\n    const property = { id: uniqueId, name, value, parent: parentId, array };\n\n    // Register in the synchronous lookup during render so useAncestor can find this property.\n    if (!remove) {\n        propertyStore.registerLookup(property);\n    }\n\n    useEffect(() => {\n        if (remove) {\n            removeProperty(uniqueId);\n            return;\n        }\n\n        if (replace) {\n            replaceProperty(replace, property);\n            return;\n        }\n\n        const $isFirst = before === \"$first\";\n        const $isLast = after === \"$last\";\n\n        addProperty({ ...property, $isFirst, $isLast }, { after, before, priority });\n\n        return () => {\n            removeProperty(uniqueId);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (previousValue.current !== value) {\n            previousValue.current = value;\n            if (!remove && !replace) {\n                replaceProperty(uniqueId, property);\n            }\n        }\n    }, [value]);\n\n    if (children) {\n        return <PropertyContext.Provider value={property}>{children}</PropertyContext.Provider>;\n    }\n\n    return null;\n};\n"],"mappings":"AAAA,OAAOA,KAAK,IAAIC,aAAa,EAAEC,UAAU,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,QAAQ,OAAO;AACpF,SAASC,WAAW,EAAEC,QAAQ;AAC9B,SAASC,aAAa;AACtB,SAASC,mBAAmB;AAE5B,MAAMC,uBAAuB,gBAAGT,aAAa,CAAqBU,SAAS,CAAC;AAO5E,OAAO,MAAMC,mBAAmB,GAAGA,CAAC;EAAEC,IAAI;EAAEC;AAAmC,CAAC,KAAK;EACjF,oBACId,KAAA,CAAAe,aAAA,CAACL,uBAAuB,CAACM,QAAQ;IAACC,KAAK,EAAEJ;EAAK,GAAEC,QAA2C,CAAC;AAEpG,CAAC;AA4BD,MAAMI,iBAAiB,gBAAGjB,aAAa,CAAgCU,SAAS,CAAC;AAQjF,OAAO,MAAMQ,UAAU,GAAGA,CAAC;EAAEN,IAAI;EAAEO,QAAQ;EAAEN;AAA0B,CAAC,KAAK;EACzE,MAAMO,QAAQ,GAAGhB,MAAM,CAAuB,IAAI,CAAC;EACnD,IAAI,CAACgB,QAAQ,CAACC,OAAO,EAAE;IACnBD,QAAQ,CAACC,OAAO,GAAG,IAAId,aAAa,CAAC,CAAC;EAC1C;EACA,MAAMe,KAAK,GAAGF,QAAQ,CAACC,OAAO;EAE9B,IAAIE,MAAyB;EAE7B,IAAI;IACAA,MAAM,GAAGC,aAAa,CAAC,CAAC;EAC5B,CAAC,CAAC,MAAM;IACJ;EAAA;EAGJtB,SAAS,CAAC,MAAM;IACZ,IAAI,CAACiB,QAAQ,EAAE;MACX;IACJ;IAEA,OAAOG,KAAK,CAACG,SAAS,CAACC,UAAU,IAAI;MACjCP,QAAQ,CAACO,UAAU,CAAC;IACxB,CAAC,CAAC;EACN,CAAC,EAAE,CAACJ,KAAK,EAAEH,QAAQ,CAAC,CAAC;;EAErB;EACA;EACA,MAAMQ,OAA0B,GAAGxB,OAAO,CACtC,OAAO;IACHS,IAAI;IACJU,KAAK;IACLM,WAAWA,CAACC,YAAoB,EAAE;MAC9B,IAAI,CAACN,MAAM,EAAE;QACT,OAAOb,SAAS;MACpB;MAEA,OAAOa,MAAM,IAAIA,MAAM,CAACX,IAAI,KAAKiB,YAAY,GACvCN,MAAM,GACNA,MAAM,CAACK,WAAW,CAACC,YAAY,CAAC;IAC1C,CAAC;IACDC,SAASA,CAAA,EAAM;MACX,OAAOxB,QAAQ,CAACgB,KAAK,CAACS,aAAa,CAAC;IACxC,CAAC;IACDC,WAAWA,CAACC,QAAQ,EAAEC,OAAO,GAAG,CAAC,CAAC,EAAE;MAChCZ,KAAK,CAACU,WAAW,CAACC,QAAQ,EAAEC,OAAO,CAAC;IACxC,CAAC;IACDC,cAAcA,CAACC,EAAE,EAAE;MACfd,KAAK,CAACa,cAAc,CAACC,EAAE,CAAC;IAC5B,CAAC;IACDC,eAAeA,CAACD,EAAE,EAAEH,QAAQ,EAAE;MAC1BX,KAAK,CAACe,eAAe,CAACD,EAAE,EAAEH,QAAQ,CAAC;IACvC;EACJ,CAAC,CAAC,EACF,CAACX,KAAK,CACV,CAAC;EAED,oBAAOvB,KAAA,CAAAe,aAAA,CAACG,iBAAiB,CAACF,QAAQ;IAACC,KAAK,EAAEW;EAAQ,GAAEd,QAAqC,CAAC;AAC9F,CAAC;AAED,OAAO,SAASW,aAAaA,CAAA,EAAG;EAC5B,MAAMG,OAAO,GAAG1B,UAAU,CAACgB,iBAAiB,CAAC;EAC7C,IAAI,CAACU,OAAO,EAAE;IACV,MAAMW,KAAK,CAAC,yCAAyC,CAAC;EAC1D;EAEA,OAAOX,OAAO;AAClB;AAEA,OAAO,SAASY,kBAAkBA,CAAA,EAAG;EACjC,OAAOtC,UAAU,CAACgB,iBAAiB,CAAC;AACxC;AAEA,OAAO,SAASuB,iBAAiBA,CAAC5B,IAAwB,EAAE;EACxD,MAAMW,MAAM,GAAGgB,kBAAkB,CAAC,CAAC;EAEnC,OAAOpC,OAAO,CAAC,MAAM;IACjB,IAAI,CAACS,IAAI,IAAI,CAACW,MAAM,EAAE;MAClB,OAAOb,SAAS;IACpB;IAEA,IAAIa,MAAM,CAACX,IAAI,KAAKA,IAAI,EAAE;MACtB,OAAOW,MAAM;IACjB;IAEA,OAAOA,MAAM,CAACK,WAAW,CAAChB,IAAI,CAAC;EACnC,CAAC,EAAE,CAACA,IAAI,CAAC,CAAC;AACd;AAgBA,MAAM6B,eAAe,gBAAGzC,aAAa,CAAuBU,SAAS,CAAC;AAEtE,OAAO,SAASgC,iBAAiBA,CAAA,EAAG;EAChC,OAAOzC,UAAU,CAACwC,eAAe,CAAC;AACtC;AAMA,OAAO,SAASE,WAAWA,CAACC,MAAqB,EAAE;EAC/C,MAAMX,QAAQ,GAAGS,iBAAiB,CAAC,CAAC;EACpC,MAAM;IAAEpB;EAAM,CAAC,GAAGE,aAAa,CAAC,CAAC;EAEjC,MAAMqB,kBAAkB,GAAGA,CACvBZ,QAAkB,EAClBW,MAAqB,KACE;IACvB,MAAM/B,QAAQ,GAAGS,KAAK,CAACwB,aAAa,CAACb,QAAQ,CAACG,EAAE,CAAC;IACjD,MAAMW,YAAY,GAAGlC,QAAQ,CAACmC,MAAM,CAChCC,IAAI,IAAIA,IAAI,CAACrC,IAAI,IAAIgC,MAAM,IAAIK,IAAI,CAACjC,KAAK,KAAK4B,MAAM,CAACK,IAAI,CAACrC,IAAI,CAClE,CAAC;IAED,IAAImC,YAAY,CAACG,MAAM,KAAKC,MAAM,CAACC,IAAI,CAACR,MAAM,CAAC,CAACM,MAAM,EAAE;MACpD,OAAOjB,QAAQ;IACnB;IAEA,MAAMoB,SAAS,GAAGpB,QAAQ,CAACV,MAAM,GAAGD,KAAK,CAACgC,OAAO,CAACrB,QAAQ,CAACV,MAAM,CAAC,GAAGb,SAAS;IAE9E,OAAO2C,SAAS,GAAGR,kBAAkB,CAACQ,SAAS,EAAET,MAAM,CAAC,GAAGlC,SAAS;EACxE,CAAC;EAED,OAAOuB,QAAQ,GAAGY,kBAAkB,CAACZ,QAAQ,EAAEW,MAAM,CAAC,GAAGlC,SAAS;AACtE;AAEA,OAAO,MAAM6C,QAAQ,GAAGA,CAAC;EACrBnB,EAAE;EACFxB,IAAI;EACJI,KAAK;EACLH,QAAQ;EACR2C,KAAK,GAAG9C,SAAS;EACjB+C,MAAM,GAAG/C,SAAS;EAClBgD,OAAO,GAAGhD,SAAS;EACnBiD,MAAM,GAAG,KAAK;EACdC,KAAK,GAAG,KAAK;EACbC,IAAI,GAAG,KAAK;EACZtC,MAAM,GAAGb;AACE,CAAC,KAAK;EACjB,MAAMoD,UAAU,GAAG7D,UAAU,CAACQ,uBAAuB,CAAC;EACtD,MAAMsD,QAAQ,GAAG5D,OAAO,CAAC,MAAMiC,EAAE,IAAI/B,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC;EACvD,MAAM2D,cAAc,GAAGtB,iBAAiB,CAAC,CAAC;EAC1C,MAAMuB,mBAAmB,GAAGzC,aAAa,CAAC,CAAC;EAC3C,MAAM0C,cAAc,GAAG1B,iBAAiB,CAACsB,UAAU,CAAC;EACpD,MAAMK,aAAa,GAAG/D,MAAM,CAACY,KAAK,CAAC;EACnC,MAAMoD,QAAQ,GAAG5D,mBAAmB,CAAC,CAAC;EAEtC,MAAMkB,UAAU,GAAGoC,UAAU,IAAII,cAAc,GAAGA,cAAc,GAAGD,mBAAmB;EAEtF,IAAI,CAACvC,UAAU,EAAE;IACb,MAAMY,KAAK,CAAC,2DAA2D,CAAC;EAC5E;EAEA,MAAM;IAAEN,WAAW;IAAEG,cAAc;IAAEE,eAAe;IAAEf,KAAK,EAAE+C;EAAc,CAAC,GAAG3C,UAAU;EACzF,MAAM4C,QAAQ,GAAG/C,MAAM,GAAGA,MAAM,GAAGsC,IAAI,GAAG,EAAE,GAAGG,cAAc,EAAE5B,EAAE,IAAI,EAAE;EACvE,MAAMH,QAAQ,GAAG;IAAEG,EAAE,EAAE2B,QAAQ;IAAEnD,IAAI;IAAEI,KAAK;IAAEO,MAAM,EAAE+C,QAAQ;IAAEV;EAAM,CAAC;;EAEvE;EACA,IAAI,CAACD,MAAM,EAAE;IACTU,aAAa,CAACE,cAAc,CAACtC,QAAQ,CAAC;EAC1C;EAEA/B,SAAS,CAAC,MAAM;IACZ,IAAIyD,MAAM,EAAE;MACRxB,cAAc,CAAC4B,QAAQ,CAAC;MACxB;IACJ;IAEA,IAAIL,OAAO,EAAE;MACTrB,eAAe,CAACqB,OAAO,EAAEzB,QAAQ,CAAC;MAClC;IACJ;IAEA,MAAMuC,QAAQ,GAAGf,MAAM,KAAK,QAAQ;IACpC,MAAMgB,OAAO,GAAGjB,KAAK,KAAK,OAAO;IAEjCxB,WAAW,CAAC;MAAE,GAAGC,QAAQ;MAAEuC,QAAQ;MAAEC;IAAQ,CAAC,EAAE;MAAEjB,KAAK;MAAEC,MAAM;MAAEW;IAAS,CAAC,CAAC;IAE5E,OAAO,MAAM;MACTjC,cAAc,CAAC4B,QAAQ,CAAC;IAC5B,CAAC;EACL,CAAC,EAAE,EAAE,CAAC;EAEN7D,SAAS,CAAC,MAAM;IACZ,IAAIiE,aAAa,CAAC9C,OAAO,KAAKL,KAAK,EAAE;MACjCmD,aAAa,CAAC9C,OAAO,GAAGL,KAAK;MAC7B,IAAI,CAAC2C,MAAM,IAAI,CAACD,OAAO,EAAE;QACrBrB,eAAe,CAAC0B,QAAQ,EAAE9B,QAAQ,CAAC;MACvC;IACJ;EACJ,CAAC,EAAE,CAACjB,KAAK,CAAC,CAAC;EAEX,IAAIH,QAAQ,EAAE;IACV,oBAAOd,KAAA,CAAAe,aAAA,CAAC2B,eAAe,CAAC1B,QAAQ;MAACC,KAAK,EAAEiB;IAAS,GAAEpB,QAAmC,CAAC;EAC3F;EAEA,OAAO,IAAI;AACf,CAAC","ignoreList":[]}

package/PropertyPriority.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+interface PropertyPriorityProviderProps {
+    priority: number;
+    children: React.ReactNode;
+}
+export declare const PropertyPriorityProvider: ({ priority, children }: PropertyPriorityProviderProps) => React.JSX.Element;
+export declare function usePropertyPriority(): number;
+export {};

package/PropertyPriority.js

@@ -0,0 +1,15 @@
+import React, { createContext, useContext } from "react";
+const PropertyPriorityContext = /*#__PURE__*/createContext(0);
+export const PropertyPriorityProvider = ({
+  priority,
+  children
+}) => {
+  return /*#__PURE__*/React.createElement(PropertyPriorityContext.Provider, {
+    value: priority
+  }, children);
+};
+export function usePropertyPriority() {
+  return useContext(PropertyPriorityContext);
+}
+
+//# sourceMappingURL=PropertyPriority.js.map

package/PropertyPriority.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","PropertyPriorityContext","PropertyPriorityProvider","priority","children","createElement","Provider","value","usePropertyPriority"],"sources":["PropertyPriority.tsx"],"sourcesContent":["import React, { createContext, useContext } from \"react\";\n\nconst PropertyPriorityContext = createContext(0);\n\ninterface PropertyPriorityProviderProps {\n    priority: number;\n    children: React.ReactNode;\n}\n\nexport const PropertyPriorityProvider = ({ priority, children }: PropertyPriorityProviderProps) => {\n    return (\n        <PropertyPriorityContext.Provider value={priority}>\n            {children}\n        </PropertyPriorityContext.Provider>\n    );\n};\n\nexport function usePropertyPriority(): number {\n    return useContext(PropertyPriorityContext);\n}\n"],"mappings":"AAAA,OAAOA,KAAK,IAAIC,aAAa,EAAEC,UAAU,QAAQ,OAAO;AAExD,MAAMC,uBAAuB,gBAAGF,aAAa,CAAC,CAAC,CAAC;AAOhD,OAAO,MAAMG,wBAAwB,GAAGA,CAAC;EAAEC,QAAQ;EAAEC;AAAwC,CAAC,KAAK;EAC/F,oBACIN,KAAA,CAAAO,aAAA,CAACJ,uBAAuB,CAACK,QAAQ;IAACC,KAAK,EAAEJ;EAAS,GAC7CC,QAC6B,CAAC;AAE3C,CAAC;AAED,OAAO,SAASI,mBAAmBA,CAAA,EAAW;EAC1C,OAAOR,UAAU,CAACC,uBAAuB,CAAC;AAC9C","ignoreList":[]}