@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/hooks/use-insert-token-options.js

@@ -0,0 +1,230 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { AUTHOR_TOKEN_CATALOG, canvas, COLLECTION_ENTRIES_COMPONENT_ID, COLLECTION_TOKEN_CATALOG, COMPONENT_PROP_NAME_PATTERN, COMPONENT_PROP_TOKEN_PREFIX, datasetItemToken, EntityPickerContext, entityValueNeedsResolution, ENTRY_TOKEN_CATALOG, readYesNoValue, reusablePropDefaultValue, reusablePropHasAnswers, reusablePropValueClass } from "@aglyn/aglyn";
+import { useContext, useEffect, useMemo } from "react";
+import { BindingPickerContext } from "../contexts/binding-picker-context.js";
+/**
+ * A component's or layout's own declared props as picker options (AGL-1335).
+ * A free-text field offers every one; a field with no text box is handed only
+ * the properties it can be bound to (see `withPropertyBinding`).
+ *
+ * Names are filtered by the SAME pattern the graft requires, so a picker can
+ * never offer a token that would not substitute.
+ */ export function componentPropBindingOptions(componentProps, owner = 'component') {
+    const options = [];
+    for (const prop of componentProps != null ? componentProps : []){
+        var _ref;
+        if (!COMPONENT_PROP_NAME_PATTERN.test((_ref = prop == null ? void 0 : prop.name) != null ? _ref : '')) continue;
+        options.push({
+            group: 'Properties',
+            groupHint: owner === 'layout' ? 'Set per screen in the Screen Properties of each screen using this layout' : 'Set per page in the Attributes panel of each instance',
+            label: prop.label || prop.name,
+            token: `{{${COMPONENT_PROP_TOKEN_PREFIX}${prop.name}}}`,
+            preview: componentPropDefaultPreview(prop)
+        });
+    }
+    return options;
+}
+/** The picker's second line for a property: what a page that sets nothing gets. */ export function componentPropDefaultPreview(prop) {
+    const valueClass = reusablePropValueClass(prop);
+    if (valueClass === 'boolean') {
+        // A yes/no has no "nothing": unset with no default substitutes `''`,
+        // which every Yes / no reader takes for a no.
+        return readYesNoValue(prop.defaultValue) === true ? 'Defaults to Yes' : 'Defaults to No';
+    }
+    if (valueClass === 'icon') {
+        // An icon id is not something to read out; the picker shows the icon.
+        return prop.defaultValue ? 'Defaults to the icon picked in Properties' : 'No default — shows no icon until a page picks one';
+    }
+    const fallback = reusablePropDefaultValue(prop);
+    if (reusablePropHasAnswers(prop)) {
+        // Named by the label a page author picks, not the value a field gets.
+        const chosen = (Array.isArray(fallback) ? fallback : [
+            fallback
+        ]).map((value)=>{
+            var _prop_options;
+            const answer = ((_prop_options = prop.options) != null ? _prop_options : []).find((option)=>(option == null ? void 0 : option.value) && option.value === value);
+            return answer ? answer.label || answer.value : undefined;
+        }).filter(Boolean);
+        return chosen.length ? `Defaults to ${chosen.join(', ')}` : 'No default — the field keeps its own until a page chooses';
+    }
+    if (fallback === undefined) {
+        return valueClass === 'text' ? 'No default — renders as nothing until a page sets it' : 'No default — the field keeps its own until a page sets it';
+    }
+    return `Defaults to "${Array.isArray(fallback) ? fallback.join(', ') : String(fallback)}"`;
+}
+/**
+ * Assembles the insert-picker options for a canvas node from ITS context
+ * (AGL-583, extracted for AGL-586 so the attributes panel and the inline
+ * text editor share one walk): the ancestor chain is scanned for a
+ * repeatable container (dataset-item tokens need its model fields) and for
+ * a Collection entries block (entry tokens resolve right there, not only
+ * on entry pages). `repeatDataset` persists a dataset id OR a legacy
+ * display name — either resolves against the entity picker options.
+ */ export function useInsertTokenOptions(node) {
+    const { options: bindingOptions, variables: bindingVariables, functions: bindingFunctions, componentProps, componentPropsOwner } = useContext(BindingPickerContext);
+    const entityOptions = useContext(EntityPickerContext);
+    const insertContext = useMemo(()=>{
+        var _canvas_toJSON_nodes, _entityOptions_datasets, _ref, _ref1, _datasets_find, _ref2;
+        var _entityOptions_resolved_datasets, _entityOptions_resolved, _entityOptions_datasetFields;
+        const nodes = (_canvas_toJSON_nodes = canvas.toJSON().nodes) != null ? _canvas_toJSON_nodes : {};
+        let repeatDatasetKey;
+        let inCollectionEntries = false;
+        let current = (node == null ? void 0 : node.$id) ? nodes[node.$id] : undefined;
+        for(let hops = 0; current && hops < 100; hops += 1){
+            var _current_props;
+            const props = (_current_props = current.props) != null ? _current_props : {};
+            if (!repeatDatasetKey && typeof props.repeatDataset === 'string' && props.repeatDataset.trim()) {
+                repeatDatasetKey = props.repeatDataset.trim();
+            }
+            if (current.componentId === COLLECTION_ENTRIES_COMPONENT_ID) {
+                inCollectionEntries = true;
+            }
+            current = current.parentId ? nodes[current.parentId] : undefined;
+        }
+        const datasets = (_entityOptions_datasets = entityOptions.datasets) != null ? _entityOptions_datasets : [];
+        /*
+     * The browse window is a PAGE of the org's datasets, so a repeat bound to
+     * one outside it matches nothing here — and this is where the token menu
+     * would silently stop offering that dataset's fields on exactly the
+     * orgs with enough datasets to need them. A resolution counts as a match,
+     * which is the same keyed read the attributes panel already spends on a
+     * picker's stored value.
+     */ const dataset = repeatDatasetKey ? (_ref = (_ref1 = (_datasets_find = datasets.find((candidate)=>candidate.id === repeatDatasetKey)) != null ? _datasets_find : datasets.find((candidate)=>candidate.label === repeatDatasetKey)) != null ? _ref1 : (_entityOptions_resolved = entityOptions.resolved) == null ? void 0 : (_entityOptions_resolved_datasets = _entityOptions_resolved.datasets) == null ? void 0 : _entityOptions_resolved_datasets[repeatDatasetKey]) != null ? _ref : undefined : undefined;
+        return {
+            inCollectionEntries,
+            datasetLabel: dataset == null ? void 0 : dataset.label,
+            datasetFields: dataset ? (_ref2 = (_entityOptions_datasetFields = entityOptions.datasetFields) == null ? void 0 : _entityOptions_datasetFields[dataset.id]) != null ? _ref2 : [] : [],
+            // Carried out of the walk so the effect below can ask for the dataset
+            // list without repeating it.
+            repeatDatasetKey
+        };
+    }, [
+        node,
+        entityOptions.datasets,
+        entityOptions.datasetFields,
+        entityOptions.resolved
+    ]);
+    /**
+   * Ask for the dataset list, and only when this node is inside a repeat
+   * bound to one (AGL-703).
+   *
+   * This hook runs on every selection — the props form and the inline text
+   * editor both call it — so requesting unconditionally would put the
+   * provider back to reading datasets on every click. `repeatDatasetKey` is
+   * the precise condition: without it there is no dataset to name and the
+   * token menu offers none.
+   */ const requestEntities = entityOptions.request;
+    const resolveEntity = entityOptions.resolve;
+    useEffect(()=>{
+        const key = insertContext.repeatDatasetKey;
+        if (!key) return;
+        requestEntities == null ? void 0 : requestEntities('datasets');
+        // Nothing to look up once the dataset is named. `repeatDataset` may hold
+        // a legacy DISPLAY NAME, which the label match above answers from the
+        // window — reading a document at that name as though it were an id would
+        // be a read that could only ever miss.
+        if (insertContext.datasetLabel) return;
+        const id = entityValueNeedsResolution(entityOptions, 'datasets', key);
+        if (id) resolveEntity == null ? void 0 : resolveEntity('datasets', id);
+    }, [
+        requestEntities,
+        resolveEntity,
+        entityOptions,
+        insertContext.repeatDatasetKey,
+        insertContext.datasetLabel
+    ]);
+    const options = useMemo(()=>{
+        const assembled = [
+            ...bindingOptions != null ? bindingOptions : []
+        ];
+        /**
+     * The component's own declared props (AGL-1335), first because they are
+     * the nearest scope — inside a component definition, `{{prop.x}}` is
+     * what the author reaches for most.
+     *
+     * They were absent from this picker entirely, so binding one meant
+     * typing `{{prop.name}}` by hand while a `{}` button sat next to the
+     * field implying otherwise.
+     */ assembled.push(...componentPropBindingOptions(componentProps, componentPropsOwner));
+        const entryHint = insertContext.inCollectionEntries ? undefined : 'Resolves in Collection entries blocks and on entry pages';
+        for (const entry of ENTRY_TOKEN_CATALOG){
+            assembled.push(_extends({
+                group: 'Entry',
+                label: entry.label,
+                token: entry.token,
+                preview: entry.description
+            }, entryHint ? {
+                groupHint: entryHint
+            } : {}));
+        }
+        for (const entry of COLLECTION_TOKEN_CATALOG){
+            assembled.push({
+                group: 'Collection',
+                label: entry.label,
+                token: entry.token,
+                preview: entry.description,
+                groupHint: 'Resolves on collection pages'
+            });
+        }
+        for (const entry of AUTHOR_TOKEN_CATALOG){
+            assembled.push({
+                group: 'Author',
+                label: entry.label,
+                token: entry.token,
+                preview: entry.description,
+                groupHint: 'Resolves on author pages'
+            });
+        }
+        for (const field of insertContext.datasetFields){
+            assembled.push(_extends({
+                group: 'Dataset item',
+                label: field.label,
+                token: datasetItemToken(field.id)
+            }, insertContext.datasetLabel ? {
+                groupHint: `From dataset "${insertContext.datasetLabel}"`
+            } : {}));
+        }
+        return assembled;
+    }, [
+        bindingOptions,
+        componentProps,
+        componentPropsOwner,
+        insertContext
+    ]);
+    const labelContext = useMemo(()=>({
+            options,
+            variables: bindingVariables,
+            functions: bindingFunctions,
+            datasetFields: insertContext.datasetFields
+        }), [
+        options,
+        bindingVariables,
+        bindingFunctions,
+        insertContext.datasetFields
+    ]);
+    return useMemo(()=>({
+            options,
+            labelContext
+        }), [
+        options,
+        labelContext
+    ]);
+}
+export default useInsertTokenOptions;
+
+//# sourceMappingURL=use-insert-token-options.js.map

package/src/lib/hooks/use-insert-token-options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-insert-token-options.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type * as Aglyn from '@aglyn/aglyn'\nimport {\n  AUTHOR_TOKEN_CATALOG,\n  canvas,\n  COLLECTION_ENTRIES_COMPONENT_ID,\n  COLLECTION_TOKEN_CATALOG,\n  COMPONENT_PROP_NAME_PATTERN,\n  COMPONENT_PROP_TOKEN_PREFIX,\n  datasetItemToken,\n  EntityPickerContext,\n  entityValueNeedsResolution,\n  ENTRY_TOKEN_CATALOG,\n  readYesNoValue,\n  reusablePropDefaultValue,\n  reusablePropHasAnswers,\n  reusablePropValueClass,\n} from '@aglyn/aglyn'\nimport { useContext, useEffect, useMemo } from 'react'\n\nimport {\n  BindingPickerContext,\n  type BindingOption,\n} from '../contexts/binding-picker-context'\nimport type { TokenLabelContext } from '../utils/token-segments'\n\nexport interface InsertTokenOptionsResult {\n  /**\n   * The full grouped picker list (AGL-583): host bindings first (AGL-100),\n   * then the data-placeholder catalogs. Entry/Collection stay browsable\n   * even out of context — with a hint saying where they resolve — while\n   * the Dataset item group only appears inside a resolvable repeatable.\n   */\n  options: BindingOption[]\n  /** Display-name resolution inputs for pill rendering (AGL-586). */\n  labelContext: TokenLabelContext\n}\n\n/**\n * A component's or layout's own declared props as picker options (AGL-1335).\n * A free-text field offers every one; a field with no text box is handed only\n * the properties it can be bound to (see `withPropertyBinding`).\n *\n * Names are filtered by the SAME pattern the graft requires, so a picker can\n * never offer a token that would not substitute.\n */\nexport function componentPropBindingOptions(\n  componentProps: readonly Aglyn.ReusableComponentProp[] | undefined | null,\n  owner: 'component' | 'layout' = 'component',\n): BindingOption[] {\n  const options: BindingOption[] = []\n  for (const prop of componentProps ?? []) {\n    if (!COMPONENT_PROP_NAME_PATTERN.test(prop?.name ?? '')) continue\n    options.push({\n      group: 'Properties',\n      groupHint:\n        owner === 'layout'\n          ? 'Set per screen in the Screen Properties of each screen using this layout'\n          : 'Set per page in the Attributes panel of each instance',\n      label: prop.label || prop.name,\n      token: `{{${COMPONENT_PROP_TOKEN_PREFIX}${prop.name}}}`,\n      preview: componentPropDefaultPreview(prop),\n    })\n  }\n  return options\n}\n\n/** The picker's second line for a property: what a page that sets nothing gets. */\nexport function componentPropDefaultPreview(\n  prop: Aglyn.ReusableComponentProp,\n): string {\n  const valueClass = reusablePropValueClass(prop)\n  if (valueClass === 'boolean') {\n    // A yes/no has no \"nothing\": unset with no default substitutes `''`,\n    // which every Yes / no reader takes for a no.\n    return readYesNoValue(prop.defaultValue) === true\n      ? 'Defaults to Yes'\n      : 'Defaults to No'\n  }\n  if (valueClass === 'icon') {\n    // An icon id is not something to read out; the picker shows the icon.\n    return prop.defaultValue\n      ? 'Defaults to the icon picked in Properties'\n      : 'No default — shows no icon until a page picks one'\n  }\n  const fallback = reusablePropDefaultValue(prop)\n  if (reusablePropHasAnswers(prop)) {\n    // Named by the label a page author picks, not the value a field gets.\n    const chosen = (Array.isArray(fallback) ? fallback : [fallback])\n      .map((value) => {\n        const answer = (prop.options ?? []).find(\n          (option) => option?.value && option.value === value,\n        )\n        return answer ? answer.label || answer.value : undefined\n      })\n      .filter(Boolean)\n    return chosen.length\n      ? `Defaults to ${chosen.join(', ')}`\n      : 'No default — the field keeps its own until a page chooses'\n  }\n  if (fallback === undefined) {\n    return valueClass === 'text'\n      ? 'No default — renders as nothing until a page sets it'\n      : 'No default — the field keeps its own until a page sets it'\n  }\n  return `Defaults to \"${Array.isArray(fallback) ? fallback.join(', ') : String(fallback)}\"`\n}\n\n/**\n * Assembles the insert-picker options for a canvas node from ITS context\n * (AGL-583, extracted for AGL-586 so the attributes panel and the inline\n * text editor share one walk): the ancestor chain is scanned for a\n * repeatable container (dataset-item tokens need its model fields) and for\n * a Collection entries block (entry tokens resolve right there, not only\n * on entry pages). `repeatDataset` persists a dataset id OR a legacy\n * display name — either resolves against the entity picker options.\n */\nexport function useInsertTokenOptions(\n  node?: Aglyn.NodeSchema<any> | null,\n): InsertTokenOptionsResult {\n  const {\n    options: bindingOptions,\n    variables: bindingVariables,\n    functions: bindingFunctions,\n    componentProps,\n    componentPropsOwner,\n  } = useContext(BindingPickerContext)\n  const entityOptions = useContext(EntityPickerContext)\n\n  const insertContext = useMemo(() => {\n    const nodes = (canvas.toJSON().nodes ?? {}) as Record<string, any>\n    let repeatDatasetKey: string | undefined\n    let inCollectionEntries = false\n    let current = node?.$id ? nodes[node.$id] : undefined\n    for (let hops = 0; current && hops < 100; hops += 1) {\n      const props = current.props ?? {}\n      if (\n        !repeatDatasetKey &&\n        typeof props.repeatDataset === 'string' &&\n        props.repeatDataset.trim()\n      ) {\n        repeatDatasetKey = props.repeatDataset.trim()\n      }\n      if (current.componentId === COLLECTION_ENTRIES_COMPONENT_ID) {\n        inCollectionEntries = true\n      }\n      current = current.parentId ? nodes[current.parentId] : undefined\n    }\n    const datasets = entityOptions.datasets ?? []\n    /*\n     * The browse window is a PAGE of the org's datasets, so a repeat bound to\n     * one outside it matches nothing here — and this is where the token menu\n     * would silently stop offering that dataset's fields on exactly the\n     * orgs with enough datasets to need them. A resolution counts as a match,\n     * which is the same keyed read the attributes panel already spends on a\n     * picker's stored value.\n     */\n    const dataset = repeatDatasetKey\n      ? datasets.find((candidate) => candidate.id === repeatDatasetKey) ??\n        datasets.find((candidate) => candidate.label === repeatDatasetKey) ??\n        entityOptions.resolved?.datasets?.[repeatDatasetKey] ??\n        undefined\n      : undefined\n    return {\n      inCollectionEntries,\n      datasetLabel: dataset?.label,\n      datasetFields: dataset\n        ? entityOptions.datasetFields?.[dataset.id] ?? []\n        : [],\n      // Carried out of the walk so the effect below can ask for the dataset\n      // list without repeating it.\n      repeatDatasetKey,\n    }\n  }, [\n    node,\n    entityOptions.datasets,\n    entityOptions.datasetFields,\n    entityOptions.resolved,\n  ])\n\n  /**\n   * Ask for the dataset list, and only when this node is inside a repeat\n   * bound to one (AGL-703).\n   *\n   * This hook runs on every selection — the props form and the inline text\n   * editor both call it — so requesting unconditionally would put the\n   * provider back to reading datasets on every click. `repeatDatasetKey` is\n   * the precise condition: without it there is no dataset to name and the\n   * token menu offers none.\n   */\n  const requestEntities = entityOptions.request\n  const resolveEntity = entityOptions.resolve\n  useEffect(() => {\n    const key = insertContext.repeatDatasetKey\n    if (!key) return\n    requestEntities?.('datasets')\n    // Nothing to look up once the dataset is named. `repeatDataset` may hold\n    // a legacy DISPLAY NAME, which the label match above answers from the\n    // window — reading a document at that name as though it were an id would\n    // be a read that could only ever miss.\n    if (insertContext.datasetLabel) return\n    const id = entityValueNeedsResolution(entityOptions, 'datasets', key)\n    if (id) resolveEntity?.('datasets', id)\n  }, [\n    requestEntities,\n    resolveEntity,\n    entityOptions,\n    insertContext.repeatDatasetKey,\n    insertContext.datasetLabel,\n  ])\n\n  const options = useMemo(() => {\n    const assembled: BindingOption[] = [...(bindingOptions ?? [])]\n    /**\n     * The component's own declared props (AGL-1335), first because they are\n     * the nearest scope — inside a component definition, `{{prop.x}}` is\n     * what the author reaches for most.\n     *\n     * They were absent from this picker entirely, so binding one meant\n     * typing `{{prop.name}}` by hand while a `{}` button sat next to the\n     * field implying otherwise.\n     */\n    assembled.push(\n      ...componentPropBindingOptions(componentProps, componentPropsOwner),\n    )\n    const entryHint = insertContext.inCollectionEntries\n      ? undefined\n      : 'Resolves in Collection entries blocks and on entry pages'\n    for (const entry of ENTRY_TOKEN_CATALOG) {\n      assembled.push({\n        group: 'Entry',\n        label: entry.label,\n        token: entry.token,\n        preview: entry.description,\n        ...(entryHint ? { groupHint: entryHint } : {}),\n      })\n    }\n    for (const entry of COLLECTION_TOKEN_CATALOG) {\n      assembled.push({\n        group: 'Collection',\n        label: entry.label,\n        token: entry.token,\n        preview: entry.description,\n        groupHint: 'Resolves on collection pages',\n      })\n    }\n    for (const entry of AUTHOR_TOKEN_CATALOG) {\n      assembled.push({\n        group: 'Author',\n        label: entry.label,\n        token: entry.token,\n        preview: entry.description,\n        groupHint: 'Resolves on author pages',\n      })\n    }\n    for (const field of insertContext.datasetFields) {\n      assembled.push({\n        group: 'Dataset item',\n        label: field.label,\n        token: datasetItemToken(field.id),\n        ...(insertContext.datasetLabel\n          ? { groupHint: `From dataset \"${insertContext.datasetLabel}\"` }\n          : {}),\n      })\n    }\n    return assembled\n  }, [bindingOptions, componentProps, componentPropsOwner, insertContext])\n\n  const labelContext = useMemo<TokenLabelContext>(\n    () => ({\n      options,\n      variables: bindingVariables as TokenLabelContext['variables'],\n      functions: bindingFunctions as TokenLabelContext['functions'],\n      datasetFields: insertContext.datasetFields,\n    }),\n    [options, bindingVariables, bindingFunctions, insertContext.datasetFields],\n  )\n\n  return useMemo(\n    () => ({ options, labelContext }),\n    [options, labelContext],\n  )\n}\n\nexport default useInsertTokenOptions\n"],"names":["AUTHOR_TOKEN_CATALOG","canvas","COLLECTION_ENTRIES_COMPONENT_ID","COLLECTION_TOKEN_CATALOG","COMPONENT_PROP_NAME_PATTERN","COMPONENT_PROP_TOKEN_PREFIX","datasetItemToken","EntityPickerContext","entityValueNeedsResolution","ENTRY_TOKEN_CATALOG","readYesNoValue","reusablePropDefaultValue","reusablePropHasAnswers","reusablePropValueClass","useContext","useEffect","useMemo","BindingPickerContext","componentPropBindingOptions","componentProps","owner","options","prop","test","name","push","group","groupHint","label","token","preview","componentPropDefaultPreview","valueClass","defaultValue","fallback","chosen","Array","isArray","map","value","answer","find","option","undefined","filter","Boolean","length","join","String","useInsertTokenOptions","node","bindingOptions","variables","bindingVariables","functions","bindingFunctions","componentPropsOwner","entityOptions","insertContext","datasets","nodes","toJSON","repeatDatasetKey","inCollectionEntries","current","$id","hops","props","repeatDataset","trim","componentId","parentId","dataset","candidate","id","resolved","datasetLabel","datasetFields","requestEntities","request","resolveEntity","resolve","key","assembled","entryHint","entry","description","field","labelContext"],"mappings":"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"}

package/src/lib/hooks/use-leaf-drag.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+import * as Besigner from '@aglyn/besigner';
+import { useDraggable } from '@dnd-kit/core';
+export type NodeDragItem = {
+    node?: Aglyn.NodeSchema<any>;
+};
+export declare function useLeafDrag(node: NodeDragItem['node'], type: Besigner.DragType): ReturnType<typeof useDraggable>;
+export default useLeafDrag;

package/src/lib/hooks/use-leaf-drag.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { useDraggable } from "@dnd-kit/core";
+export function useLeafDrag(node, type) {
+    return useDraggable({
+        id: `${type}:${node == null ? void 0 : node.$id}`,
+        data: {
+            type,
+            node
+        }
+    });
+}
+export default useLeafDrag;
+
+//# sourceMappingURL=use-leaf-drag.js.map

package/src/lib/hooks/use-leaf-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-leaf-drag.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type * as Aglyn from '@aglyn/aglyn'\nimport * as Besigner from '@aglyn/besigner'\nimport { useDraggable } from '@dnd-kit/core'\n\nexport type NodeDragItem = {\n  node?: Aglyn.NodeSchema<any>\n}\n\nexport function useLeafDrag(\n  node: NodeDragItem['node'],\n  type: Besigner.DragType,\n): ReturnType<typeof useDraggable> {\n  return useDraggable({\n    id: `${type}:${node?.$id}`,\n    data: {\n      type,\n      node,\n    },\n  })\n}\nexport default useLeafDrag\n"],"names":["useDraggable","useLeafDrag","node","type","id","$id","data"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID,SAASA,YAAY,QAAQ,gBAAe;AAM5C,OAAO,SAASC,YACdC,IAA0B,EAC1BC,IAAuB;IAEvB,OAAOH,aAAa;QAClBI,IAAI,GAAGD,KAAK,CAAC,EAAED,wBAAAA,KAAMG,GAAG,EAAE;QAC1BC,MAAM;YACJH;YACAD;QACF;IACF;AACF;AACA,eAAeD,YAAW"}

package/src/lib/hooks/use-leaf-drop.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+import * as Besigner from '@aglyn/besigner';
+import { useDroppable } from '@dnd-kit/core';
+export type NodeDropArea = {
+    node?: Aglyn.NodeSchema<any>;
+};
+export declare function useLeafDrop(node: Aglyn.NodeSchema<any>, accept?: Besigner.DragType[], 
+/**
+ * Distinct surface rendering this droppable (tree, breadcrumbs, ...).
+ * Multiple surfaces register droppables for the same node simultaneously;
+ * without a discriminator their dnd-kit ids collide and the later mount
+ * evicts the earlier one from the registry, leaving dead drop targets.
+ */
+area?: string): ReturnType<typeof useDroppable>;
+export default useLeafDrop;

package/src/lib/hooks/use-leaf-drop.js

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Besigner from "@aglyn/besigner";
+import { useDroppable } from "@dnd-kit/core";
+const acceptAll = Object.values(Besigner.DragType);
+export function useLeafDrop(node, accept = acceptAll, /**
+   * Distinct surface rendering this droppable (tree, breadcrumbs, ...).
+   * Multiple surfaces register droppables for the same node simultaneously;
+   * without a discriminator their dnd-kit ids collide and the later mount
+   * evicts the earlier one from the registry, leaving dead drop targets.
+   */ area = 'leaf') {
+    // Disable the droppable for the node that is currently being dragged.
+    // Without a DragOverlay the draggable element receives the CSS transform
+    // and moves with the cursor, which shifts its droppable rect to the cursor
+    // position. This causes it to win every pointerWithin collision check and
+    // prevents leaf nodes (like an empty Container) from ever being detected as
+    // the drop target.
+    const isBeingDragged = Besigner.dnd.isDraggingNode(node);
+    return useDroppable({
+        id: `drop:${area}:${node == null ? void 0 : node.$id}:${accept}`,
+        disabled: isBeingDragged,
+        data: {
+            accept,
+            node
+        }
+    });
+}
+export default useLeafDrop;
+
+//# sourceMappingURL=use-leaf-drop.js.map

package/src/lib/hooks/use-leaf-drop.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-leaf-drop.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type * as Aglyn from '@aglyn/aglyn'\nimport * as Besigner from '@aglyn/besigner'\nimport { useDroppable } from '@dnd-kit/core'\n\nexport type NodeDropArea = {\n  node?: Aglyn.NodeSchema<any>\n}\n\nconst acceptAll = Object.values(Besigner.DragType)\n\nexport function useLeafDrop(\n  node: Aglyn.NodeSchema<any>,\n  accept: Besigner.DragType[] = acceptAll,\n  /**\n   * Distinct surface rendering this droppable (tree, breadcrumbs, ...).\n   * Multiple surfaces register droppables for the same node simultaneously;\n   * without a discriminator their dnd-kit ids collide and the later mount\n   * evicts the earlier one from the registry, leaving dead drop targets.\n   */\n  area = 'leaf',\n): ReturnType<typeof useDroppable> {\n  // Disable the droppable for the node that is currently being dragged.\n  // Without a DragOverlay the draggable element receives the CSS transform\n  // and moves with the cursor, which shifts its droppable rect to the cursor\n  // position. This causes it to win every pointerWithin collision check and\n  // prevents leaf nodes (like an empty Container) from ever being detected as\n  // the drop target.\n  const isBeingDragged = Besigner.dnd.isDraggingNode(node)\n\n  return useDroppable({\n    id: `drop:${area}:${node?.$id}:${accept}`,\n    disabled: isBeingDragged,\n    data: {\n      accept,\n      node,\n    },\n  })\n}\nexport default useLeafDrop\n"],"names":["Besigner","useDroppable","acceptAll","Object","values","DragType","useLeafDrop","node","accept","area","isBeingDragged","dnd","isDraggingNode","id","$id","disabled","data"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,YAAYA,cAAc,kBAAiB;AAC3C,SAASC,YAAY,QAAQ,gBAAe;AAM5C,MAAMC,YAAYC,OAAOC,MAAM,CAACJ,SAASK,QAAQ;AAEjD,OAAO,SAASC,YACdC,IAA2B,EAC3BC,SAA8BN,SAAS,EACvC;;;;;GAKC,GACDO,OAAO,MAAM;IAEb,sEAAsE;IACtE,yEAAyE;IACzE,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,mBAAmB;IACnB,MAAMC,iBAAiBV,SAASW,GAAG,CAACC,cAAc,CAACL;IAEnD,OAAON,aAAa;QAClBY,IAAI,CAAC,KAAK,EAAEJ,KAAK,CAAC,EAAEF,wBAAAA,KAAMO,GAAG,CAAC,CAAC,EAAEN,QAAQ;QACzCO,UAAUL;QACVM,MAAM;YACJR;YACAD;QACF;IACF;AACF;AACA,eAAeD,YAAW"}

package/src/lib/hooks/use-markdown-media-picker.d.ts

@@ -0,0 +1,63 @@
+import type { MarkdownFieldHandle } from '@aglyn/aglyn-markdown-editor';
+export interface MarkdownMediaPicker {
+    /** Pass to `MarkdownField`'s `editorRef`. */
+    editorRef: (handle: MarkdownFieldHandle | null) => void;
+    /**
+     * Pass to `MarkdownField`'s `onPickImageFromMedia`. `undefined` when the
+     * host supplies no picker, which is what makes the editor keep offering its
+     * own URL prompt instead of a dead "Choose from media" button — the email
+     * besigner has no media scope and mounts no provider.
+     */
+    onPickImageFromMedia?: (alt: string) => void;
+}
+/**
+ * Wires a `MarkdownField` on a besigner surface to the host's media library
+ * (AGL-1645).
+ *
+ * Both besigner surfaces — the attributes panel and the in-place canvas editor
+ * — took the editor complete except for this callback, so the toolbar's image
+ * action opened a "paste a URL" prompt while every other image attribute in the
+ * designer opened the DAM. Same context, same picker, same pipeline the
+ * Attributes panel's Browse button and AGL-1304's instance `src` edit already
+ * use; nothing new is invented here.
+ *
+ * ## The picked value is stored VERBATIM
+ *
+ * Which is what every other besigner surface does, and it took AGL-1686 to get
+ * back to it.
+ *
+ * `onPickMedia` hands back what an attribute should store: a
+ * `media:{scope}/{mediaId}` reference for library assets (AGL-1215). The first
+ * pass resolved that to a `/api/media/cdn/…` path HERE, at insert time,
+ * because no markdown-lite renderer called `resolveMediaSrc` and a reference in
+ * a document would have rendered nothing. All five now resolve, so the reason
+ * is gone — and keeping the workaround anyway would not be belt-and-braces, it
+ * would be a downgrade:
+ *
+ * * **It bakes the route into the content.** A CDN path in a document couples
+ *   every screen, layout, component and template on every host to a delivery
+ *   detail that has already changed once (AGL-829). That coupling is the whole
+ *   thing the reference exists to remove.
+ * * **It is lossy in a way the renderer cannot undo.** Resolving early freezes
+ *   the picker's best-guess host qualification. `hostQualifiedScope` re-points
+ *   a reference at whichever site is actually rendering, which is what lets ONE
+ *   image in a reusable component or a shared layout work on every site that
+ *   uses it. A resolved path can only ever name one of them.
+ *
+ * The reference reaches the document unchanged, and `parseMarkdownLite` now
+ * accepts it — the other half of AGL-1686, without which the editor would
+ * insert a row that the next parse silently deleted.
+ *
+ * ## Focus
+ *
+ * The picker is a modal dialog and it steals focus, which is the class of
+ * interaction that breaks a blur-committed editor. Neither surface commits on
+ * blur — the panel is on react-final-form's debounce, the canvas on
+ * `useDebouncedCommit` — and the dialog is portaled outside both editors'
+ * React subtrees, so its Escape never reaches the canvas editor's own
+ * close-on-Escape. The insert itself arrives through the imperative handle
+ * rather than through focus, so it does not care where the caret went; the
+ * editor falls back to appending when its last selection is gone.
+ */
+export declare function useMarkdownMediaPicker(): MarkdownMediaPicker;
+export default useMarkdownMediaPicker;

package/src/lib/hooks/use-markdown-media-picker.js

@@ -0,0 +1,110 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { inheritedMediaAlt, isSupportedImageSrc } from "@aglyn/aglyn";
+import { useCallback, useContext, useMemo, useRef } from "react";
+import { MediaPickerContext } from "../contexts/media-picker-context.js";
+/**
+ * Wires a `MarkdownField` on a besigner surface to the host's media library
+ * (AGL-1645).
+ *
+ * Both besigner surfaces — the attributes panel and the in-place canvas editor
+ * — took the editor complete except for this callback, so the toolbar's image
+ * action opened a "paste a URL" prompt while every other image attribute in the
+ * designer opened the DAM. Same context, same picker, same pipeline the
+ * Attributes panel's Browse button and AGL-1304's instance `src` edit already
+ * use; nothing new is invented here.
+ *
+ * ## The picked value is stored VERBATIM
+ *
+ * Which is what every other besigner surface does, and it took AGL-1686 to get
+ * back to it.
+ *
+ * `onPickMedia` hands back what an attribute should store: a
+ * `media:{scope}/{mediaId}` reference for library assets (AGL-1215). The first
+ * pass resolved that to a `/api/media/cdn/…` path HERE, at insert time,
+ * because no markdown-lite renderer called `resolveMediaSrc` and a reference in
+ * a document would have rendered nothing. All five now resolve, so the reason
+ * is gone — and keeping the workaround anyway would not be belt-and-braces, it
+ * would be a downgrade:
+ *
+ * * **It bakes the route into the content.** A CDN path in a document couples
+ *   every screen, layout, component and template on every host to a delivery
+ *   detail that has already changed once (AGL-829). That coupling is the whole
+ *   thing the reference exists to remove.
+ * * **It is lossy in a way the renderer cannot undo.** Resolving early freezes
+ *   the picker's best-guess host qualification. `hostQualifiedScope` re-points
+ *   a reference at whichever site is actually rendering, which is what lets ONE
+ *   image in a reusable component or a shared layout work on every site that
+ *   uses it. A resolved path can only ever name one of them.
+ *
+ * The reference reaches the document unchanged, and `parseMarkdownLite` now
+ * accepts it — the other half of AGL-1686, without which the editor would
+ * insert a row that the next parse silently deleted.
+ *
+ * ## Focus
+ *
+ * The picker is a modal dialog and it steals focus, which is the class of
+ * interaction that breaks a blur-committed editor. Neither surface commits on
+ * blur — the panel is on react-final-form's debounce, the canvas on
+ * `useDebouncedCommit` — and the dialog is portaled outside both editors'
+ * React subtrees, so its Escape never reaches the canvas editor's own
+ * close-on-Escape. The insert itself arrives through the imperative handle
+ * rather than through focus, so it does not care where the caret went; the
+ * editor falls back to appending when its last selection is gone.
+ */ export function useMarkdownMediaPicker() {
+    const { onPickMedia } = useContext(MediaPickerContext);
+    const handleRef = useRef(null);
+    const editorRef = useCallback((handle)=>{
+        handleRef.current = handle;
+    }, []);
+    const onPickImageFromMedia = useMemo(()=>{
+        if (!onPickMedia) return undefined;
+        return (alt)=>{
+            onPickMedia((stored, asset)=>{
+                var _inheritedMediaAlt;
+                var _handleRef_current;
+                // Gated on what the PARSER keeps, not on what resolves: a value the
+                // editor accepts and the parser drops is an image that disappears on
+                // the next load with nothing logged, which is exactly how AGL-1645
+                // shipped broken. `insertImage` re-checks with the same predicate, so
+                // this is the early, reportable refusal rather than the guard.
+                if (!stored || !isSupportedImageSrc(stored)) return;
+                // The asset's stored alt fills a blank dialog field (AGL-1896).
+                // This surface needs the default MORE than the others, not less: an
+                // image row's alt is fixed at insert time and the editor offers no
+                // way to edit it afterwards, so an alt left empty here is
+                // unrepairable short of deleting the row and inserting it again.
+                // A typed alt still wins — `inheritedMediaAlt` returns undefined for
+                // one, and the `?? alt` below keeps it verbatim.
+                const resolvedAlt = (_inheritedMediaAlt = inheritedMediaAlt({
+                    placementAlt: alt,
+                    assetAlt: asset == null ? void 0 : asset.alt
+                })) != null ? _inheritedMediaAlt : alt;
+                (_handleRef_current = handleRef.current) == null ? void 0 : _handleRef_current.insertImage(resolvedAlt, stored);
+            });
+        };
+    }, [
+        onPickMedia
+    ]);
+    return {
+        editorRef,
+        onPickImageFromMedia
+    };
+}
+export default useMarkdownMediaPicker;
+
+//# sourceMappingURL=use-markdown-media-picker.js.map

package/src/lib/hooks/use-markdown-media-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/hooks/use-markdown-media-picker.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { inheritedMediaAlt, isSupportedImageSrc } from '@aglyn/aglyn'\nimport type { MarkdownFieldHandle } from '@aglyn/aglyn-markdown-editor'\nimport { useCallback, useContext, useMemo, useRef } from 'react'\nimport { MediaPickerContext } from '../contexts/media-picker-context'\n\nexport interface MarkdownMediaPicker {\n  /** Pass to `MarkdownField`'s `editorRef`. */\n  editorRef: (handle: MarkdownFieldHandle | null) => void\n  /**\n   * Pass to `MarkdownField`'s `onPickImageFromMedia`. `undefined` when the\n   * host supplies no picker, which is what makes the editor keep offering its\n   * own URL prompt instead of a dead \"Choose from media\" button — the email\n   * besigner has no media scope and mounts no provider.\n   */\n  onPickImageFromMedia?: (alt: string) => void\n}\n\n/**\n * Wires a `MarkdownField` on a besigner surface to the host's media library\n * (AGL-1645).\n *\n * Both besigner surfaces — the attributes panel and the in-place canvas editor\n * — took the editor complete except for this callback, so the toolbar's image\n * action opened a \"paste a URL\" prompt while every other image attribute in the\n * designer opened the DAM. Same context, same picker, same pipeline the\n * Attributes panel's Browse button and AGL-1304's instance `src` edit already\n * use; nothing new is invented here.\n *\n * ## The picked value is stored VERBATIM\n *\n * Which is what every other besigner surface does, and it took AGL-1686 to get\n * back to it.\n *\n * `onPickMedia` hands back what an attribute should store: a\n * `media:{scope}/{mediaId}` reference for library assets (AGL-1215). The first\n * pass resolved that to a `/api/media/cdn/…` path HERE, at insert time,\n * because no markdown-lite renderer called `resolveMediaSrc` and a reference in\n * a document would have rendered nothing. All five now resolve, so the reason\n * is gone — and keeping the workaround anyway would not be belt-and-braces, it\n * would be a downgrade:\n *\n * * **It bakes the route into the content.** A CDN path in a document couples\n *   every screen, layout, component and template on every host to a delivery\n *   detail that has already changed once (AGL-829). That coupling is the whole\n *   thing the reference exists to remove.\n * * **It is lossy in a way the renderer cannot undo.** Resolving early freezes\n *   the picker's best-guess host qualification. `hostQualifiedScope` re-points\n *   a reference at whichever site is actually rendering, which is what lets ONE\n *   image in a reusable component or a shared layout work on every site that\n *   uses it. A resolved path can only ever name one of them.\n *\n * The reference reaches the document unchanged, and `parseMarkdownLite` now\n * accepts it — the other half of AGL-1686, without which the editor would\n * insert a row that the next parse silently deleted.\n *\n * ## Focus\n *\n * The picker is a modal dialog and it steals focus, which is the class of\n * interaction that breaks a blur-committed editor. Neither surface commits on\n * blur — the panel is on react-final-form's debounce, the canvas on\n * `useDebouncedCommit` — and the dialog is portaled outside both editors'\n * React subtrees, so its Escape never reaches the canvas editor's own\n * close-on-Escape. The insert itself arrives through the imperative handle\n * rather than through focus, so it does not care where the caret went; the\n * editor falls back to appending when its last selection is gone.\n */\nexport function useMarkdownMediaPicker(): MarkdownMediaPicker {\n  const { onPickMedia } = useContext(MediaPickerContext)\n  const handleRef = useRef<MarkdownFieldHandle | null>(null)\n\n  const editorRef = useCallback((handle: MarkdownFieldHandle | null) => {\n    handleRef.current = handle\n  }, [])\n\n  const onPickImageFromMedia = useMemo(() => {\n    if (!onPickMedia) return undefined\n    return (alt: string) => {\n      onPickMedia((stored, asset) => {\n        // Gated on what the PARSER keeps, not on what resolves: a value the\n        // editor accepts and the parser drops is an image that disappears on\n        // the next load with nothing logged, which is exactly how AGL-1645\n        // shipped broken. `insertImage` re-checks with the same predicate, so\n        // this is the early, reportable refusal rather than the guard.\n        if (!stored || !isSupportedImageSrc(stored)) return\n        // The asset's stored alt fills a blank dialog field (AGL-1896).\n        // This surface needs the default MORE than the others, not less: an\n        // image row's alt is fixed at insert time and the editor offers no\n        // way to edit it afterwards, so an alt left empty here is\n        // unrepairable short of deleting the row and inserting it again.\n        // A typed alt still wins — `inheritedMediaAlt` returns undefined for\n        // one, and the `?? alt` below keeps it verbatim.\n        const resolvedAlt =\n          inheritedMediaAlt({\n            placementAlt: alt,\n            assetAlt: asset?.alt,\n          }) ?? alt\n        handleRef.current?.insertImage(resolvedAlt, stored)\n      })\n    }\n  }, [onPickMedia])\n\n  return { editorRef, onPickImageFromMedia }\n}\n\nexport default useMarkdownMediaPicker\n"],"names":["inheritedMediaAlt","isSupportedImageSrc","useCallback","useContext","useMemo","useRef","MediaPickerContext","useMarkdownMediaPicker","onPickMedia","handleRef","editorRef","handle","current","onPickImageFromMedia","undefined","alt","stored","asset","resolvedAlt","placementAlt","assetAlt","insertImage"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,iBAAiB,EAAEC,mBAAmB,QAAQ,eAAc;AAErE,SAASC,WAAW,EAAEC,UAAU,EAAEC,OAAO,EAAEC,MAAM,QAAQ,QAAO;AAChE,SAASC,kBAAkB,QAAQ,sCAAkC;AAcrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDC,GACD,OAAO,SAASC;IACd,MAAM,EAAEC,WAAW,EAAE,GAAGL,WAAWG;IACnC,MAAMG,YAAYJ,OAAmC;IAErD,MAAMK,YAAYR,YAAY,CAACS;QAC7BF,UAAUG,OAAO,GAAGD;IACtB,GAAG,EAAE;IAEL,MAAME,uBAAuBT,QAAQ;QACnC,IAAI,CAACI,aAAa,OAAOM;QACzB,OAAO,CAACC;YACNP,YAAY,CAACQ,QAAQC;oBAejBjB;oBAIFS;gBAlBA,oEAAoE;gBACpE,qEAAqE;gBACrE,mEAAmE;gBACnE,sEAAsE;gBACtE,+DAA+D;gBAC/D,IAAI,CAACO,UAAU,CAACf,oBAAoBe,SAAS;gBAC7C,gEAAgE;gBAChE,oEAAoE;gBACpE,mEAAmE;gBACnE,0DAA0D;gBAC1D,iEAAiE;gBACjE,qEAAqE;gBACrE,iDAAiD;gBACjD,MAAME,eACJlB,qBAAAA,kBAAkB;oBAChBmB,cAAcJ;oBACdK,QAAQ,EAAEH,yBAAAA,MAAOF,GAAG;gBACtB,cAHAf,qBAGMe;iBACRN,qBAAAA,UAAUG,OAAO,qBAAjBH,mBAAmBY,WAAW,CAACH,aAAaF;YAC9C;QACF;IACF,GAAG;QAACR;KAAY;IAEhB,OAAO;QAAEE;QAAWG;IAAqB;AAC3C;AAEA,eAAeN,uBAAsB"}