@aglyn/besigner-ui 1.0.0-beta.143

package/src/lib/components/property-values-form.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/property-values-form.component.tsx"],"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 type * as Aglyn from '@aglyn/aglyn'\nimport {\n  canvas,\n  components,\n  EntityPickerContext,\n  FieldComponentType,\n  getKnownPluginInstallsVersion,\n  ScreenLinkContext,\n  subscribeKnownPluginInstalls,\n} from '@aglyn/aglyn'\nimport { useAglynSiteTheme } from '@aglyn/aglyn-node-renderer'\nimport {\n  FormRenderer,\n  FormSpy,\n  type FormTemplateRenderProps,\n  useFormApi,\n} from '@aglyn/shared-ui-jsx-forms'\nimport { useHostThemeDocument } from '@aglyn/shared-ui-theme'\nimport { Grid } from '@mui/material'\nimport {\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react'\n\nimport { MediaPickerContext } from '../contexts/media-picker-context'\nimport useInsertTokenOptions from '../hooks/use-insert-token-options'\nimport { buildStyleThemeScales } from '../utils/theme-scale-options'\nimport {\n  type AttributeFieldResolveContext,\n  buildPropertyField,\n  elementPropsComponentMapper,\n  entityKindsForAttributes,\n  type PropertyOwnerNoun,\n  resolveAttributeField,\n  withNumericValueParse,\n} from './element-props-form.component'\nimport { TOKEN_TEXT_FIELD_COMPONENT } from './token-text-field.component'\n\n/**\n * Property values edited OUTSIDE the Attributes panel, with the Attributes\n * panel's own controls (AGL-2893): the Properties dialog's Default for each\n * property, a kind's settings, a condition's operand, and a screen's values\n * for the layout it renders inside.\n *\n * Each field is an attribute field — {@link buildPropertyField} for a\n * property — finished by {@link resolveAttributeField} against the same site\n * data the panel reads and drawn by `elementPropsComponentMapper`. So a Yes /\n * no is the switch, an Icon the icon picker and a Color the color picker\n * here exactly as they are on an instance, and nothing here can drift from\n * the panel into a look-alike.\n */\n\n/** The form's nothing-to-submit: every change is reported as it happens. */\nconst noop = () => undefined\n\n/** The values each change reports, compared so a re-render is not a change. */\nfunction serialize(values: unknown): string {\n  try {\n    return JSON.stringify(values ?? {})\n  } catch {\n    return ''\n  }\n}\n\n/** Hands the parent every change, and the form API for writes from outside. */\nfunction AttributeFieldsFormTemplate(\n  props: FormTemplateRenderProps & {\n    onValues: (values: Record<string, unknown>) => void\n    formApiRef: { current: ReturnType<typeof useFormApi> | undefined }\n  },\n) {\n  const { formFields, onValues, formApiRef } = props\n  const formApi = useFormApi()\n  formApiRef.current = formApi\n  // The values the form opened with, so the spy's first report — the state\n  // it subscribed to, not a change — is not handed on as one.\n  const last = useRef(serialize(formApi.getState().values))\n  return (\n    <form onSubmit={(event) => event.preventDefault()} noValidate>\n      <Grid container spacing={2}>\n        {formFields as unknown as JSX.Node}\n      </Grid>\n      <FormSpy\n        subscription={{ values: true }}\n        onChange={({ values }: { values: Record<string, unknown> }) => {\n          const next = serialize(values)\n          if (next === last.current) return\n          last.current = next\n          onValues(values)\n        }}\n      />\n    </form>\n  )\n}\n\nexport interface AttributeFieldsFormProps {\n  /**\n   * Attribute fields — as a coded component would declare them, or as\n   * {@link buildPropertyField} draws a property — named for paths in\n   * `values`.\n   */\n  fields: ReadonlyArray<Record<string, unknown>>\n  /** The values the form starts from. Later changes to this are not re-read. */\n  values?: Record<string, unknown>\n  onChange: (values: Record<string, unknown>) => void\n  /** Written into the field when a media library pick lands, by field name. */\n  mediaFields?: ReadonlySet<string>\n}\n\n/**\n * Attribute fields in a form of their own, resolved and drawn exactly as the\n * Attributes panel draws them, reporting every change.\n */\nexport function AttributeFieldsForm(props: AttributeFieldsFormProps) {\n  const { fields, values, onChange, mediaFields } = props\n  const [initialValues] = useState(() => values ?? {})\n  const formApiRef = useRef<ReturnType<typeof useFormApi> | undefined>(undefined)\n  const onChangeRef = useRef(onChange)\n  onChangeRef.current = onChange\n\n  const { screens, labels } = useContext(ScreenLinkContext)\n  const entityOptions = useContext(EntityPickerContext)\n  const { onPickMedia } = useContext(MediaPickerContext)\n  const { options: insertOptions, labelContext: tokenLabelContext } =\n    useInsertTokenOptions(undefined)\n  const pluginInstallsVersion = useSyncExternalStore(\n    subscribeKnownPluginInstalls,\n    getKnownPluginInstallsVersion,\n    getKnownPluginInstallsVersion,\n  )\n\n  // Ask for the entity lists these fields' pickers show (AGL-703), as the\n  // Attributes panel does for the element it edits.\n  const requestEntities = entityOptions.request\n  useEffect(() => {\n    if (!requestEntities) return\n    for (const kind of entityKindsForAttributes(\n      fields as unknown as Aglyn.AglynAttributeSchema[],\n    )) {\n      requestEntities(kind)\n    }\n  }, [fields, requestEntities])\n\n  // The canvas's elements, for element pickers.\n  const wantsNodes = fields.some(\n    (field) => field['component'] === FieldComponentType.NODE_SELECT,\n  )\n  const nodeOptions = useMemo(() => {\n    if (!wantsNodes) return []\n    const canvasNodes = (canvas.toJSON().nodes ?? {}) as Record<string, any>\n    return Object.entries(canvasNodes)\n      .filter(([id]) => Boolean(id))\n      .map(([id, candidate]) => {\n        const displayName =\n          components.getSchema(candidate?.componentId)?.displayName ??\n          candidate?.componentId ??\n          'Element'\n        const text =\n          typeof candidate?.props?.children === 'string'\n            ? candidate.props.children.trim().slice(0, 24)\n            : ''\n        return {\n          value: id,\n          label: `${displayName}${text ? ` \"${text}\"` : ''} · ${id.slice(0, 6)}`,\n        }\n      })\n      .sort((a, b) => a.label.localeCompare(b.label))\n  }, [wantsNodes])\n\n  const context = useMemo<AttributeFieldResolveContext>(\n    () => ({\n      screens,\n      labels,\n      values: initialValues,\n      entityOptions,\n      nodeOptions,\n      insertOptions,\n      tokenLabelContext,\n      pluginInstallsVersion,\n    }),\n    [\n      screens,\n      labels,\n      initialValues,\n      entityOptions,\n      nodeOptions,\n      insertOptions,\n      tokenLabelContext,\n      pluginInstallsVersion,\n    ],\n  )\n\n  const resolved = useMemo(\n    () =>\n      fields\n        .map((field) => resolveAttributeField(field, context))\n        .map((field) =>\n          onPickMedia &&\n          mediaFields?.has(String(field['name'])) &&\n          field['component'] === TOKEN_TEXT_FIELD_COMPONENT\n            ? {\n                ...field,\n                onBrowseMedia: () =>\n                  onPickMedia((value) =>\n                    formApiRef.current?.change(String(field['name']), value),\n                  ),\n              }\n            : field,\n        )\n        .filter((field) => String(field['component']) in elementPropsComponentMapper)\n        .map(withNumericValueParse),\n    [fields, context, onPickMedia, mediaFields],\n  )\n\n  // One component for the life of the form: a template created per render\n  // would be a new component type each time, remounting every field.\n  const [Template] = useState(\n    () =>\n      function BoundTemplate(templateProps: FormTemplateRenderProps) {\n        return (\n          <AttributeFieldsFormTemplate\n            {...templateProps}\n            formApiRef={formApiRef}\n            onValues={(next) => onChangeRef.current(next)}\n          />\n        )\n      },\n  )\n\n  return (\n    <FormRenderer\n      componentMapper={elementPropsComponentMapper}\n      FormTemplate={Template}\n      initialValues={initialValues}\n      onSubmit={noop}\n      schema={{ fields: resolved as never }}\n    />\n  )\n}\n\nexport interface PropertyValuesFormProps {\n  /** The properties the owner declares. */\n  declared: readonly Aglyn.ReusableComponentProp[]\n  /** Each property's value, by name. */\n  values?: Record<string, unknown>\n  /** Every property's value, by name, after each change. */\n  onChange: (values: Record<string, unknown>) => void\n  /**\n   * `value` for a page setting them, with each empty field falling back to\n   * the default and every condition applied; `default` for declaring those\n   * defaults.\n   */\n  role?: 'value' | 'default'\n  noun?: PropertyOwnerNoun\n  /** Only these properties, by name; all of them when omitted. */\n  only?: readonly string[]\n}\n\n/** The path a property's value sits at inside this form. */\nconst VALUES_KEY = 'values'\nconst pathOf = (name: string) => `${VALUES_KEY}.${name}`\n\n/**\n * A component's or layout's properties, each edited with the control its\n * kind names in the Attributes panel.\n */\nexport function PropertyValuesForm(props: PropertyValuesFormProps) {\n  const { declared, values, onChange, role = 'value', noun = 'component', only } = props\n  const hostThemeDoc = useHostThemeDocument()\n  const siteTheme = useAglynSiteTheme({ theme: hostThemeDoc })\n  const themeScales = useMemo(\n    () => buildStyleThemeScales(siteTheme as any) as unknown as Record<string, unknown>,\n    [siteTheme],\n  )\n  const shown = useMemo(\n    () =>\n      declared.filter(\n        (prop) => Boolean(prop?.name) && (!only || only.includes(prop.name)),\n      ),\n    [declared, only],\n  )\n  const fields = useMemo(\n    () =>\n      shown.map((prop) =>\n        buildPropertyField(prop, {\n          name: pathOf(prop.name),\n          role,\n          declared,\n          valuePath: pathOf,\n          noun,\n          themeScales,\n        }),\n      ),\n    [shown, role, declared, noun, themeScales],\n  )\n  const mediaFields = useMemo(\n    () =>\n      new Set(\n        shown\n          .filter((prop) => prop.type === 'image')\n          .map((prop) => pathOf(prop.name)),\n      ),\n    [shown],\n  )\n  const [initial] = useState(() => ({ [VALUES_KEY]: values ?? {} }))\n  return (\n    <AttributeFieldsForm\n      fields={fields}\n      values={initial}\n      mediaFields={mediaFields}\n      onChange={(next) =>\n        onChange(\n          (next?.[VALUES_KEY] as Record<string, unknown> | undefined) ?? {},\n        )\n      }\n    />\n  )\n}\n\nexport default PropertyValuesForm\n"],"names":["canvas","components","EntityPickerContext","FieldComponentType","getKnownPluginInstallsVersion","ScreenLinkContext","subscribeKnownPluginInstalls","useAglynSiteTheme","FormRenderer","FormSpy","useFormApi","useHostThemeDocument","Grid","useContext","useEffect","useMemo","useRef","useState","useSyncExternalStore","MediaPickerContext","useInsertTokenOptions","buildStyleThemeScales","buildPropertyField","elementPropsComponentMapper","entityKindsForAttributes","resolveAttributeField","withNumericValueParse","TOKEN_TEXT_FIELD_COMPONENT","noop","undefined","serialize","values","JSON","stringify","AttributeFieldsFormTemplate","props","formFields","onValues","formApiRef","formApi","current","last","getState","form","onSubmit","event","preventDefault","noValidate","container","spacing","subscription","onChange","next","AttributeFieldsForm","fields","mediaFields","initialValues","onChangeRef","screens","labels","entityOptions","onPickMedia","options","insertOptions","labelContext","tokenLabelContext","pluginInstallsVersion","requestEntities","request","kind","wantsNodes","some","field","NODE_SELECT","nodeOptions","canvasNodes","toJSON","nodes","Object","entries","filter","id","Boolean","map","candidate","displayName","getSchema","componentId","text","children","trim","slice","value","label","sort","a","b","localeCompare","context","resolved","has","String","onBrowseMedia","change","Template","BoundTemplate","templateProps","componentMapper","FormTemplate","schema","VALUES_KEY","pathOf","name","PropertyValuesForm","declared","role","noun","only","hostThemeDoc","siteTheme","theme","themeScales","shown","prop","includes","valuePath","Set","type","initial"],"mappings":"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"}

package/src/lib/components/scheme-preview-controls.component.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 { type IconButtonProps as MuiIconButtonProps } from '@mui/material';
+export interface SchemePreviewControlsProps extends Partial<MuiIconButtonProps> {
+}
+/**
+ * Toggles the color scheme the canvas previews the host theme in. Only the
+ * artboard is affected — the surrounding console UI keeps its own theme.
+ */
+declare const SchemePreviewControlsComponent: import("react").ForwardRefExoticComponent<Omit<SchemePreviewControlsProps, "ref"> & import("react").RefAttributes<any>>;
+export { SchemePreviewControlsComponent };
+export default SchemePreviewControlsComponent;

package/src/lib/components/scheme-preview-controls.component.js

@@ -0,0 +1,56 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 { ICON_VARIANT_THEME_DARK, ICON_VARIANT_THEME_LIGHT } from "@aglyn/shared-data-enums";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { IconButton as MuiIconButton, Tooltip as MuiTooltip } from "@mui/material";
+import { forwardRef, useCallback } from "react";
+import useAglynBesignerFlag from "../hooks/use-aglyn-besigner-flag.js";
+/**
+ * Toggles the color scheme the canvas previews the host theme in. Only the
+ * artboard is affected — the surrounding console UI keeps its own theme.
+ */ const SchemePreviewControlsComponent = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const {} = props, rest = _extends({}, props);
+    const [canvasScheme, setCanvasScheme] = useAglynBesignerFlag('canvasScheme');
+    const isDark = canvasScheme === 'dark';
+    const handleToggle = useCallback(()=>{
+        setCanvasScheme((prev)=>prev === 'dark' ? 'light' : 'dark');
+    }, [
+        setCanvasScheme
+    ]);
+    return /*#__PURE__*/ _jsx(MuiTooltip, {
+        title: `Preview ${isDark ? 'light' : 'dark'} scheme on the artboard`,
+        children: /*#__PURE__*/ _jsx(MuiIconButton, _extends({
+            ref: ref,
+            "aria-label": "toggle artboard color scheme",
+            size: "small",
+            color: "inherit",
+            onClick: handleToggle
+        }, rest, {
+            children: /*#__PURE__*/ _jsx(MdiIcon, {
+                fontSize: "inherit",
+                path: isDark ? ICON_VARIANT_THEME_DARK.path : ICON_VARIANT_THEME_LIGHT.path
+            })
+        }))
+    });
+});
+SchemePreviewControlsComponent.displayName = 'SchemePreviewControlsComponent';
+SchemePreviewControlsComponent.aglyn = true;
+export { SchemePreviewControlsComponent };
+export default SchemePreviewControlsComponent;
+
+//# sourceMappingURL=scheme-preview-controls.component.js.map

package/src/lib/components/scheme-preview-controls.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/scheme-preview-controls.component.tsx"],"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 {\n  ICON_VARIANT_THEME_DARK,\n  ICON_VARIANT_THEME_LIGHT,\n} from '@aglyn/shared-data-enums'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport {\n  IconButton as MuiIconButton,\n  type IconButtonProps as MuiIconButtonProps,\n  Tooltip as MuiTooltip,\n} from '@mui/material'\nimport { forwardRef, useCallback } from 'react'\nimport useAglynBesignerFlag from '../hooks/use-aglyn-besigner-flag'\n\nexport interface SchemePreviewControlsProps\n  extends Partial<MuiIconButtonProps> {}\n\n/**\n * Toggles the color scheme the canvas previews the host theme in. Only the\n * artboard is affected — the surrounding console UI keeps its own theme.\n */\nconst SchemePreviewControlsComponent = forwardRef<\n  any,\n  SchemePreviewControlsProps\n>((props, ref) => {\n  const { ...rest } = props\n  const [canvasScheme, setCanvasScheme] = useAglynBesignerFlag('canvasScheme')\n  const isDark = canvasScheme === 'dark'\n\n  const handleToggle = useCallback(() => {\n    setCanvasScheme((prev) => (prev === 'dark' ? 'light' : 'dark'))\n  }, [setCanvasScheme])\n\n  return (\n    <MuiTooltip\n      title={`Preview ${isDark ? 'light' : 'dark'} scheme on the artboard`}\n    >\n      <MuiIconButton\n        ref={ref}\n        aria-label=\"toggle artboard color scheme\"\n        size=\"small\"\n        color=\"inherit\"\n        onClick={handleToggle}\n        {...rest}\n      >\n        <MdiIcon\n          fontSize=\"inherit\"\n          path={\n            isDark ? ICON_VARIANT_THEME_DARK.path : ICON_VARIANT_THEME_LIGHT.path\n          }\n        />\n      </MuiIconButton>\n    </MuiTooltip>\n  )\n})\nSchemePreviewControlsComponent.displayName = 'SchemePreviewControlsComponent'\nSchemePreviewControlsComponent.aglyn = true\n\nexport { SchemePreviewControlsComponent }\nexport default SchemePreviewControlsComponent\n"],"names":["ICON_VARIANT_THEME_DARK","ICON_VARIANT_THEME_LIGHT","MdiIcon","IconButton","MuiIconButton","Tooltip","MuiTooltip","forwardRef","useCallback","useAglynBesignerFlag","SchemePreviewControlsComponent","props","ref","rest","canvasScheme","setCanvasScheme","isDark","handleToggle","prev","title","aria-label","size","color","onClick","fontSize","path","displayName","aglyn"],"mappings":";;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,uBAAuB,EACvBC,wBAAwB,QACnB,2BAA0B;AACjC,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,SACEC,cAAcC,aAAa,EAE3BC,WAAWC,UAAU,QAChB,gBAAe;AACtB,SAASC,UAAU,EAAEC,WAAW,QAAQ,QAAO;AAC/C,OAAOC,0BAA0B,sCAAkC;AAKnE;;;CAGC,GACD,MAAMC,+CAAiCH,WAGrC,CAACI,OAAOC;IACR,MAAM,EAAW,GAAGD,OAATE,oBAASF;IACpB,MAAM,CAACG,cAAcC,gBAAgB,GAAGN,qBAAqB;IAC7D,MAAMO,SAASF,iBAAiB;IAEhC,MAAMG,eAAeT,YAAY;QAC/BO,gBAAgB,CAACG,OAAUA,SAAS,SAAS,UAAU;IACzD,GAAG;QAACH;KAAgB;IAEpB,qBACE,KAACT;QACCa,OAAO,CAAC,QAAQ,EAAEH,SAAS,UAAU,OAAO,uBAAuB,CAAC;kBAEpE,cAAA,KAACZ;YACCQ,KAAKA;YACLQ,cAAW;YACXC,MAAK;YACLC,OAAM;YACNC,SAASN;WACLJ;sBAEJ,cAAA,KAACX;gBACCsB,UAAS;gBACTC,MACET,SAAShB,wBAAwByB,IAAI,GAAGxB,yBAAyBwB,IAAI;;;;AAMjF;AACAf,+BAA+BgB,WAAW,GAAG;AAC7ChB,+BAA+BiB,KAAK,GAAG;AAEvC,SAASjB,8BAA8B,GAAE;AACzC,eAAeA,+BAA8B"}

package/src/lib/components/screen-link-field.component.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @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 { EXTERNAL_URL_OPTION } from '@aglyn/aglyn-markdown-editor';
+import { type FormFieldGridProps } from '@aglyn/shared-ui-jsx-forms';
+import type { ReactNode } from 'react';
+/**
+ * The picker's "type a URL instead" choice (AGL-1335) — UI-only and never
+ * stored. Defined beside the shared lookup, which offers the same choice in
+ * the markdown link dialog, and re-exported here where it was first needed.
+ */
+export { EXTERNAL_URL_OPTION };
+/** Mapper key for {@link ScreenLinkField} in the attributes form. */
+export declare const SCREEN_LINK_FIELD_COMPONENT = "aglyn-screen-link-field";
+export interface ScreenLinkValuePickerProps {
+    /** Stored value: `screen:<id>`, a literal href, or empty. */
+    value?: string;
+    onChange: (next: string) => void;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    /** Placeholder for the URL box — the component's default, where set. */
+    placeholder?: string;
+    disabled?: boolean;
+    size?: 'small' | 'medium';
+    /** Label on the "unset" option; the wording differs per surface. */
+    emptyLabel?: string;
+    /**
+     * The component default this field falls back to when left unset — named
+     * on the empty option so "not set" says what the page will actually
+     * render. A screen reference is resolved to the screen's NAME here: the
+     * stored `screen:9aXk…` is not a sentence anyone can act on.
+     */
+    defaultValue?: string;
+    /** Whose default `defaultValue` is, in the empty option's words. */
+    defaultOwner?: 'component' | 'layout';
+    name?: string;
+    error?: boolean;
+}
+/**
+ * The screen picker a `Link`-typed value is authored with (AGL-1335) — a
+ * screen list with an external-URL escape hatch, controlled and free of the
+ * form stack so BOTH ends can use the same control: the component's
+ * Properties dialog (its `Default` cell) and the instance Attributes panel.
+ *
+ * Two ends mattering is the whole point of the issue. `Link` used to be a
+ * plain text box in both places, so a prop-driven CTA stored a hardcoded
+ * path and broke silently when the target screen was renamed — a regression
+ * against the Button's own `Link to screen` field (AGL-139) that the prop
+ * replaced. A picked screen stores `screen:<id>` and resolves through the
+ * published routing map at render, exactly like that field.
+ *
+ * The screen list comes from {@link Aglyn.ScreenLinkContext} — the same map
+ * the canvas resolves hrefs against, so the picker can never offer a screen
+ * the renderer would not resolve. A value the map does not know (a screen
+ * deleted since, or a component opened before the map loads) is kept and
+ * shown rather than silently reset to "not set".
+ *
+ * A search, not a list (AGL-3119): screens, listings and feeds narrow as the
+ * author types, and a collection ENTRY is looked up through
+ * `LinkTargetSearchContext` and stored as `entry:<collectionId>/<entryId>`,
+ * so a renamed post keeps every link to it.
+ */
+export declare function ScreenLinkValuePicker(props: ScreenLinkValuePickerProps): import("react").JSX.Element;
+export declare namespace ScreenLinkValuePicker {
+    var displayName: string;
+}
+export interface ScreenLinkFieldProps {
+    [key: string]: unknown;
+    placeholder?: string;
+    FormFieldGridProps?: FormFieldGridProps;
+}
+/**
+ * The data-driven-forms adapter for {@link ScreenLinkValuePicker}, registered
+ * as {@link SCREEN_LINK_FIELD_COMPONENT} in the attributes mapper so a
+ * `Link`-typed instance prop edits with the picker instead of a text box
+ * (AGL-1335).
+ *
+ * The stored string flows through react-final-form exactly like the text
+ * field it replaces, so the debounced autosave commits it through the
+ * existing path with nothing new to teach it.
+ */
+export declare function ScreenLinkField(props: ScreenLinkFieldProps): import("react").JSX.Element;
+export declare namespace ScreenLinkField {
+    var displayName: string;
+}
+/** Mapper key for {@link ScreenTargetField}, the attributes panel's Screen picker. */
+export declare const SCREEN_TARGET_FIELD_COMPONENT = "aglyn-screen-target-field";
+/**
+ * The attributes panel's Screen picker (`SCREEN_SELECT`) as the lookup
+ * (AGL-3119): the Screen Link's "Screen", the "Link to screen" of a Button and
+ * an Image, the Link Container's target, an Accordion header's, a Form's
+ * redirect, and each tab of a Tabs strip.
+ *
+ * It was a plain select over the routing map, which had no room for entries.
+ * Its options are still the ones `resolveAttributeField` builds, so both
+ * pickers offer one list; the value is stored exactly as the select stored it
+ * — a bare screen id, or a listing's, feed's or entry's own key — and there is
+ * no typed-address choice, because each of these elements carries its own
+ * External URL field for that.
+ */
+export declare function ScreenTargetField(props: ScreenLinkFieldProps): import("react").JSX.Element;
+export declare namespace ScreenTargetField {
+    var displayName: string;
+}
+export default ScreenLinkField;

package/src/lib/components/screen-link-field.component.js

@@ -0,0 +1,282 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { bareFragmentLinkWarning, formatScreenLinkValue, linkTargetKind, parseScreenLinkValue, resolveScreenHref, ScreenLinkContext, screenLinkTargetOptions, screenRoutesAnswerFor, unavailableScreenLabel, useLinkTargetLabel } from "@aglyn/aglyn";
+import { EXTERNAL_URL_OPTION, LinkTargetAutocomplete } from "@aglyn/aglyn-markdown-editor";
+import { FormFieldGrid, useFieldApi, validationError } from "@aglyn/shared-ui-jsx-forms";
+import { Stack, TextField } from "@mui/material";
+import { useCallback, useContext, useEffect, useMemo, useState } from "react";
+/**
+ * The picker's "type a URL instead" choice (AGL-1335) — UI-only and never
+ * stored. Defined beside the shared lookup, which offers the same choice in
+ * the markdown link dialog, and re-exported here where it was first needed.
+ */ export { EXTERNAL_URL_OPTION };
+/** Mapper key for {@link ScreenLinkField} in the attributes form. */ export const SCREEN_LINK_FIELD_COMPONENT = 'aglyn-screen-link-field';
+/** The escape hatch the `Link` picker ends its list with. */ const EXTERNAL_CHOICE = [
+    {
+        value: EXTERNAL_URL_OPTION,
+        label: 'External URL or path…'
+    }
+];
+/**
+ * The screen picker a `Link`-typed value is authored with (AGL-1335) — a
+ * screen list with an external-URL escape hatch, controlled and free of the
+ * form stack so BOTH ends can use the same control: the component's
+ * Properties dialog (its `Default` cell) and the instance Attributes panel.
+ *
+ * Two ends mattering is the whole point of the issue. `Link` used to be a
+ * plain text box in both places, so a prop-driven CTA stored a hardcoded
+ * path and broke silently when the target screen was renamed — a regression
+ * against the Button's own `Link to screen` field (AGL-139) that the prop
+ * replaced. A picked screen stores `screen:<id>` and resolves through the
+ * published routing map at render, exactly like that field.
+ *
+ * The screen list comes from {@link Aglyn.ScreenLinkContext} — the same map
+ * the canvas resolves hrefs against, so the picker can never offer a screen
+ * the renderer would not resolve. A value the map does not know (a screen
+ * deleted since, or a component opened before the map loads) is kept and
+ * shown rather than silently reset to "not set".
+ *
+ * A search, not a list (AGL-3119): screens, listings and feeds narrow as the
+ * author types, and a collection ENTRY is looked up through
+ * `LinkTargetSearchContext` and stored as `entry:<collectionId>/<entryId>`,
+ * so a renamed post keeps every link to it.
+ */ export function ScreenLinkValuePicker(props) {
+    var _ref, // A bare `#fragment` goes nowhere on the published page
+    // (AGL-2867); saying so outranks the general note, and only a
+    // validation error outranks it.
+    _ref1;
+    const { value, onChange, label, helperText, placeholder, disabled, size = 'small', emptyLabel, defaultValue, defaultOwner = 'component', name, error } = props;
+    const { screens, labels } = useContext(ScreenLinkContext);
+    const screenId = parseScreenLinkValue(value);
+    const literal = screenId ? '' : value != null ? value : '';
+    // Mode is remembered, not derived, for one reason: choosing "External
+    // URL" leaves the value empty until something is typed, and a derived
+    // mode would snap the box shut under the author's cursor. It re-syncs
+    // whenever a value arrives from OUTSIDE (a different instance selected,
+    // an undo), which is what keeps a remembered flag from going stale.
+    const [external, setExternal] = useState(()=>!screenId && Boolean(literal));
+    useEffect(()=>{
+        if (screenId) setExternal(false);
+        else if (literal) setExternal(true);
+    }, [
+        screenId,
+        literal
+    ]);
+    // Screens by name, then the site's collection listings (AGL-2799) and their
+    // feeds — built by the same function as the attributes panel's Screen
+    // picker.
+    const options = useMemo(()=>screenLinkTargetOptions(screens, labels, 'label'), [
+        screens,
+        labels
+    ]);
+    // A stored id the routing map doesn't know still has to be selectable, or
+    // opening the dialog would silently rewrite the author's link to "unset".
+    // Not an entry: the map holds none, and the lookup names one by reading it.
+    const unknownScreen = screenId && linkTargetKind(screenId) !== 'entry' && resolveScreenHref(screens, screenId) === undefined ? screenId : undefined;
+    const defaultScreen = defaultValue ? parseScreenLinkValue(defaultValue) : undefined;
+    // An entry default is named by the same lookup a picked entry is.
+    const defaultEntry = useLinkTargetLabel(defaultScreen && linkTargetKind(defaultScreen) === 'entry' ? defaultScreen : undefined);
+    const describeDefault = ()=>{
+        var _ref, _ref1;
+        if (!defaultValue) return undefined;
+        if (!defaultScreen) return defaultValue;
+        if (defaultEntry) return defaultEntry.label;
+        return (_ref = (_ref1 = labels == null ? void 0 : labels[defaultScreen]) != null ? _ref1 : screens == null ? void 0 : screens[defaultScreen]) != null ? _ref : undefined;
+    };
+    const described = describeDefault();
+    const resolvedEmptyLabel = emptyLabel != null ? emptyLabel : described ? `Use the ${defaultOwner} default (${described})` : defaultValue ? `Use the ${defaultOwner} default` : 'Not set';
+    // A default that is a screen reference is not a URL, so it must not be
+    // offered as one in the text box.
+    const urlPlaceholder = placeholder && !parseScreenLinkValue(placeholder) ? placeholder : 'https://example.com';
+    const selectValue = external ? EXTERNAL_URL_OPTION : screenId ? screenId : '';
+    const leading = useMemo(()=>[
+            {
+                value: '',
+                label: resolvedEmptyLabel
+            },
+            ...unknownScreen ? [
+                {
+                    value: unknownScreen,
+                    // Wording shared with the plain Screen picker (AGL-1893): the
+                    // same condition told two different stories in two panels, and
+                    // "Unknown screen" reads as "we cannot look it up" rather than
+                    // "this link is dead". The value stays the bare id — the
+                    // handler re-wraps it through `formatScreenLinkValue`.
+                    label: unavailableScreenLabel(unknownScreen, screenRoutesAnswerFor(screens, unknownScreen))
+                }
+            ] : []
+        ], [
+        resolvedEmptyLabel,
+        unknownScreen,
+        screens
+    ]);
+    const handleSelect = useCallback((next, detail)=>{
+        if (next === EXTERNAL_URL_OPTION) {
+            var _detail_address;
+            setExternal(true);
+            // An address typed straight into the lookup is used as typed.
+            // Otherwise keep whatever literal was already there — switching
+            // modes back and forth must not eat a URL typed a moment ago.
+            onChange((_detail_address = detail.address) != null ? _detail_address : literal);
+            return;
+        }
+        setExternal(false);
+        onChange(next ? formatScreenLinkValue(next) : '');
+    }, [
+        literal,
+        onChange
+    ]);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1,
+        sx: {
+            width: '100%'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(LinkTargetAutocomplete, {
+                name: name,
+                label: label,
+                size: size,
+                value: selectValue,
+                disabled: disabled,
+                error: error,
+                onChange: handleSelect,
+                helperText: external ? undefined : helperText,
+                targets: options,
+                leading: leading,
+                trailing: EXTERNAL_CHOICE,
+                addressOption: EXTERNAL_URL_OPTION
+            }),
+            external ? /*#__PURE__*/ _jsx(TextField, {
+                size: size,
+                value: literal,
+                disabled: disabled,
+                placeholder: urlPlaceholder,
+                helperText: (_ref = (_ref1 = error ? helperText : bareFragmentLinkWarning(literal)) != null ? _ref1 : helperText) != null ? _ref : 'Typed addresses do not follow a screen rename.',
+                onChange: (event)=>onChange(event.target.value),
+                fullWidth: true,
+                slotProps: {
+                    htmlInput: {
+                        'aria-label': 'External URL'
+                    }
+                }
+            }) : null
+        ]
+    });
+}
+ScreenLinkValuePicker.displayName = 'ScreenLinkValuePicker';
+/**
+ * The data-driven-forms adapter for {@link ScreenLinkValuePicker}, registered
+ * as {@link SCREEN_LINK_FIELD_COMPONENT} in the attributes mapper so a
+ * `Link`-typed instance prop edits with the picker instead of a text box
+ * (AGL-1335).
+ *
+ * The stored string flows through react-final-form exactly like the text
+ * field it replaces, so the debounced autosave commits it through the
+ * existing path with nothing new to teach it.
+ */ export function ScreenLinkField(props) {
+    var _input_value;
+    const { input, isDisabled, isReadOnly, label, placeholder, helperText, description, validateOnMount, meta, help, propDefault, propDefaultOwner, emptyLabel, FormFieldGridProps = {} } = useFieldApi(props);
+    const invalid = validationError(meta, validateOnMount);
+    return /*#__PURE__*/ _jsx(FormFieldGrid, _extends({
+        help: help
+    }, FormFieldGridProps, {
+        children: /*#__PURE__*/ _jsx(ScreenLinkValuePicker, {
+            name: input.name,
+            value: (_input_value = input.value) != null ? _input_value : '',
+            onChange: input.onChange,
+            label: label,
+            placeholder: placeholder,
+            defaultValue: propDefault,
+            defaultOwner: propDefaultOwner,
+            emptyLabel: emptyLabel,
+            disabled: isDisabled || isReadOnly,
+            error: Boolean(invalid),
+            helperText: invalid || helperText || description
+        })
+    }));
+}
+ScreenLinkField.displayName = 'ScreenLinkField';
+/** Mapper key for {@link ScreenTargetField}, the attributes panel's Screen picker. */ export const SCREEN_TARGET_FIELD_COMPONENT = 'aglyn-screen-target-field';
+/**
+ * The options `resolveAttributeField` built, sorted into the targets the
+ * routing map holds — offered in groups, narrowed as the author types — and
+ * the choices pinned above them: the empty one, and a stored target the host
+ * no longer has. An entry is neither: the lookup names it by reading it.
+ */ function splitScreenTargetOptions(options, screens) {
+    const leading = [];
+    const targets = [];
+    for (const option of Array.isArray(options) ? options : []){
+        var _ref;
+        const value = typeof (option == null ? void 0 : option.value) === 'string' ? option.value : '';
+        const choice = {
+            value,
+            label: String((_ref = option == null ? void 0 : option.label) != null ? _ref : value)
+        };
+        if (value && linkTargetKind(value) === 'entry') continue;
+        if (value && resolveScreenHref(screens, value) !== undefined) {
+            targets.push(choice);
+        } else {
+            leading.push(choice);
+        }
+    }
+    return {
+        leading,
+        targets
+    };
+}
+/**
+ * The attributes panel's Screen picker (`SCREEN_SELECT`) as the lookup
+ * (AGL-3119): the Screen Link's "Screen", the "Link to screen" of a Button and
+ * an Image, the Link Container's target, an Accordion header's, a Form's
+ * redirect, and each tab of a Tabs strip.
+ *
+ * It was a plain select over the routing map, which had no room for entries.
+ * Its options are still the ones `resolveAttributeField` builds, so both
+ * pickers offer one list; the value is stored exactly as the select stored it
+ * — a bare screen id, or a listing's, feed's or entry's own key — and there is
+ * no typed-address choice, because each of these elements carries its own
+ * External URL field for that.
+ */ export function ScreenTargetField(props) {
+    const { input, isDisabled, isReadOnly, label, helperText, description, validateOnMount, meta, help, options, FormFieldGridProps = {} } = useFieldApi(props);
+    const { screens } = useContext(ScreenLinkContext);
+    const invalid = validationError(meta, validateOnMount);
+    const { leading, targets } = useMemo(()=>splitScreenTargetOptions(options, screens), [
+        options,
+        screens
+    ]);
+    const stored = typeof input.value === 'string' ? input.value.trim() : '';
+    return /*#__PURE__*/ _jsx(FormFieldGrid, _extends({
+        help: help
+    }, FormFieldGridProps, {
+        children: /*#__PURE__*/ _jsx(LinkTargetAutocomplete, {
+            name: input.name,
+            value: stored,
+            onChange: (next)=>input.onChange(next),
+            targets: targets,
+            leading: leading,
+            label: label,
+            disabled: isDisabled || isReadOnly,
+            error: Boolean(invalid),
+            helperText: invalid || helperText || description
+        })
+    }));
+}
+ScreenTargetField.displayName = 'ScreenTargetField';
+export default ScreenLinkField;
+
+//# sourceMappingURL=screen-link-field.component.js.map

package/src/lib/components/screen-link-field.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/besigner/feature/designer/src/lib/components/screen-link-field.component.tsx"],"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  bareFragmentLinkWarning,\n  formatScreenLinkValue,\n  linkTargetKind,\n  parseScreenLinkValue,\n  resolveScreenHref,\n  ScreenLinkContext,\n  screenLinkTargetOptions,\n  screenRoutesAnswerFor,\n  unavailableScreenLabel,\n  useLinkTargetLabel,\n} from '@aglyn/aglyn'\nimport {\n  EXTERNAL_URL_OPTION,\n  LinkTargetAutocomplete,\n  type LinkTargetChangeDetail,\n  type LinkTargetChoice,\n} from '@aglyn/aglyn-markdown-editor'\nimport {\n  FormFieldGrid,\n  type FormFieldGridProps,\n  useFieldApi,\n  validationError,\n  type ExtendedFieldMeta,\n} from '@aglyn/shared-ui-jsx-forms'\nimport { Stack, TextField } from '@mui/material'\nimport { useCallback, useContext, useEffect, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\n\n/**\n * The picker's \"type a URL instead\" choice (AGL-1335) — UI-only and never\n * stored. Defined beside the shared lookup, which offers the same choice in\n * the markdown link dialog, and re-exported here where it was first needed.\n */\nexport { EXTERNAL_URL_OPTION }\n\n/** Mapper key for {@link ScreenLinkField} in the attributes form. */\nexport const SCREEN_LINK_FIELD_COMPONENT = 'aglyn-screen-link-field'\n\n/** The escape hatch the `Link` picker ends its list with. */\nconst EXTERNAL_CHOICE: readonly LinkTargetChoice[] = [\n  { value: EXTERNAL_URL_OPTION, label: 'External URL or path…' },\n]\n\nexport interface ScreenLinkValuePickerProps {\n  /** Stored value: `screen:<id>`, a literal href, or empty. */\n  value?: string\n  onChange: (next: string) => void\n  label?: ReactNode\n  helperText?: ReactNode\n  /** Placeholder for the URL box — the component's default, where set. */\n  placeholder?: string\n  disabled?: boolean\n  size?: 'small' | 'medium'\n  /** Label on the \"unset\" option; the wording differs per surface. */\n  emptyLabel?: string\n  /**\n   * The component default this field falls back to when left unset — named\n   * on the empty option so \"not set\" says what the page will actually\n   * render. A screen reference is resolved to the screen's NAME here: the\n   * stored `screen:9aXk…` is not a sentence anyone can act on.\n   */\n  defaultValue?: string\n  /** Whose default `defaultValue` is, in the empty option's words. */\n  defaultOwner?: 'component' | 'layout'\n  name?: string\n  error?: boolean\n}\n\n/**\n * The screen picker a `Link`-typed value is authored with (AGL-1335) — a\n * screen list with an external-URL escape hatch, controlled and free of the\n * form stack so BOTH ends can use the same control: the component's\n * Properties dialog (its `Default` cell) and the instance Attributes panel.\n *\n * Two ends mattering is the whole point of the issue. `Link` used to be a\n * plain text box in both places, so a prop-driven CTA stored a hardcoded\n * path and broke silently when the target screen was renamed — a regression\n * against the Button's own `Link to screen` field (AGL-139) that the prop\n * replaced. A picked screen stores `screen:<id>` and resolves through the\n * published routing map at render, exactly like that field.\n *\n * The screen list comes from {@link Aglyn.ScreenLinkContext} — the same map\n * the canvas resolves hrefs against, so the picker can never offer a screen\n * the renderer would not resolve. A value the map does not know (a screen\n * deleted since, or a component opened before the map loads) is kept and\n * shown rather than silently reset to \"not set\".\n *\n * A search, not a list (AGL-3119): screens, listings and feeds narrow as the\n * author types, and a collection ENTRY is looked up through\n * `LinkTargetSearchContext` and stored as `entry:<collectionId>/<entryId>`,\n * so a renamed post keeps every link to it.\n */\nexport function ScreenLinkValuePicker(props: ScreenLinkValuePickerProps) {\n  const {\n    value,\n    onChange,\n    label,\n    helperText,\n    placeholder,\n    disabled,\n    size = 'small',\n    emptyLabel,\n    defaultValue,\n    defaultOwner = 'component',\n    name,\n    error,\n  } = props\n  const { screens, labels } = useContext(ScreenLinkContext)\n  const screenId = parseScreenLinkValue(value)\n  const literal = screenId ? '' : (value ?? '')\n\n  // Mode is remembered, not derived, for one reason: choosing \"External\n  // URL\" leaves the value empty until something is typed, and a derived\n  // mode would snap the box shut under the author's cursor. It re-syncs\n  // whenever a value arrives from OUTSIDE (a different instance selected,\n  // an undo), which is what keeps a remembered flag from going stale.\n  const [external, setExternal] = useState(() => !screenId && Boolean(literal))\n  useEffect(() => {\n    if (screenId) setExternal(false)\n    else if (literal) setExternal(true)\n  }, [screenId, literal])\n\n  // Screens by name, then the site's collection listings (AGL-2799) and their\n  // feeds — built by the same function as the attributes panel's Screen\n  // picker.\n  const options = useMemo(\n    () => screenLinkTargetOptions(screens, labels, 'label'),\n    [screens, labels],\n  )\n\n  // A stored id the routing map doesn't know still has to be selectable, or\n  // opening the dialog would silently rewrite the author's link to \"unset\".\n  // Not an entry: the map holds none, and the lookup names one by reading it.\n  const unknownScreen =\n    screenId &&\n    linkTargetKind(screenId) !== 'entry' &&\n    resolveScreenHref(screens, screenId) === undefined\n      ? screenId\n      : undefined\n\n  const defaultScreen = defaultValue\n    ? parseScreenLinkValue(defaultValue)\n    : undefined\n  // An entry default is named by the same lookup a picked entry is.\n  const defaultEntry = useLinkTargetLabel(\n    defaultScreen && linkTargetKind(defaultScreen) === 'entry'\n      ? defaultScreen\n      : undefined,\n  )\n  const describeDefault = () => {\n    if (!defaultValue) return undefined\n    if (!defaultScreen) return defaultValue\n    if (defaultEntry) return defaultEntry.label\n    return labels?.[defaultScreen] ?? screens?.[defaultScreen] ?? undefined\n  }\n  const described = describeDefault()\n  const resolvedEmptyLabel =\n    emptyLabel ??\n    (described\n      ? `Use the ${defaultOwner} default (${described})`\n      : defaultValue\n        ? `Use the ${defaultOwner} default`\n        : 'Not set')\n  // A default that is a screen reference is not a URL, so it must not be\n  // offered as one in the text box.\n  const urlPlaceholder =\n    placeholder && !parseScreenLinkValue(placeholder)\n      ? placeholder\n      : 'https://example.com'\n\n  const selectValue = external\n    ? EXTERNAL_URL_OPTION\n    : screenId\n      ? screenId\n      : ''\n\n  const leading = useMemo<LinkTargetChoice[]>(\n    () => [\n      { value: '', label: resolvedEmptyLabel },\n      ...(unknownScreen\n        ? [\n            {\n              value: unknownScreen,\n              // Wording shared with the plain Screen picker (AGL-1893): the\n              // same condition told two different stories in two panels, and\n              // \"Unknown screen\" reads as \"we cannot look it up\" rather than\n              // \"this link is dead\". The value stays the bare id — the\n              // handler re-wraps it through `formatScreenLinkValue`.\n              label: unavailableScreenLabel(\n                unknownScreen,\n                screenRoutesAnswerFor(screens, unknownScreen),\n              ),\n            },\n          ]\n        : []),\n    ],\n    [resolvedEmptyLabel, unknownScreen, screens],\n  )\n\n  const handleSelect = useCallback(\n    (next: string, detail: LinkTargetChangeDetail) => {\n      if (next === EXTERNAL_URL_OPTION) {\n        setExternal(true)\n        // An address typed straight into the lookup is used as typed.\n        // Otherwise keep whatever literal was already there — switching\n        // modes back and forth must not eat a URL typed a moment ago.\n        onChange(detail.address ?? literal)\n        return\n      }\n      setExternal(false)\n      onChange(next ? formatScreenLinkValue(next) : '')\n    },\n    [literal, onChange],\n  )\n\n  return (\n    <Stack spacing={1} sx={{ width: '100%' }}>\n      <LinkTargetAutocomplete\n        name={name}\n        label={label}\n        size={size}\n        value={selectValue}\n        disabled={disabled}\n        error={error}\n        onChange={handleSelect}\n        helperText={external ? undefined : helperText}\n        targets={options}\n        leading={leading}\n        trailing={EXTERNAL_CHOICE}\n        addressOption={EXTERNAL_URL_OPTION}\n      />\n      {external ? (\n        <TextField\n          size={size}\n          value={literal}\n          disabled={disabled}\n          placeholder={urlPlaceholder}\n          helperText={\n            // A bare `#fragment` goes nowhere on the published page\n            // (AGL-2867); saying so outranks the general note, and only a\n            // validation error outranks it.\n            (error ? helperText : bareFragmentLinkWarning(literal)) ??\n            helperText ??\n            'Typed addresses do not follow a screen rename.'\n          }\n          onChange={(event) => onChange(event.target.value)}\n          fullWidth\n          slotProps={{ htmlInput: { 'aria-label': 'External URL' } }}\n        />\n      ) : null}\n    </Stack>\n  )\n}\nScreenLinkValuePicker.displayName = 'ScreenLinkValuePicker'\n\nexport interface ScreenLinkFieldProps {\n  [key: string]: unknown\n  placeholder?: string\n  FormFieldGridProps?: FormFieldGridProps\n}\n\n/**\n * The data-driven-forms adapter for {@link ScreenLinkValuePicker}, registered\n * as {@link SCREEN_LINK_FIELD_COMPONENT} in the attributes mapper so a\n * `Link`-typed instance prop edits with the picker instead of a text box\n * (AGL-1335).\n *\n * The stored string flows through react-final-form exactly like the text\n * field it replaces, so the debounced autosave commits it through the\n * existing path with nothing new to teach it.\n */\nexport function ScreenLinkField(props: ScreenLinkFieldProps) {\n  const {\n    input,\n    isDisabled,\n    isReadOnly,\n    label,\n    placeholder,\n    helperText,\n    description,\n    validateOnMount,\n    meta,\n    help,\n    propDefault,\n    propDefaultOwner,\n    emptyLabel,\n    FormFieldGridProps = {},\n    // Nothing is spread onto the controls below, so free-text leftovers\n    // from a schema authored as a TEXT_FIELD (`multiline`, `inputProps`,\n    // the token-picker inputs) are simply never read — they cannot reach\n    // the select the way they would through a `{...rest}`.\n  } = useFieldApi(props as never) as Record<string, any>\n  const invalid = validationError(meta as ExtendedFieldMeta, validateOnMount)\n\n  return (\n    <FormFieldGrid help={help} {...FormFieldGridProps}>\n      <ScreenLinkValuePicker\n        name={input.name}\n        value={input.value ?? ''}\n        onChange={input.onChange}\n        label={label}\n        placeholder={placeholder}\n        defaultValue={propDefault}\n        defaultOwner={propDefaultOwner}\n        emptyLabel={emptyLabel}\n        disabled={isDisabled || isReadOnly}\n        error={Boolean(invalid)}\n        helperText={invalid || helperText || description}\n      />\n    </FormFieldGrid>\n  )\n}\nScreenLinkField.displayName = 'ScreenLinkField'\n\n/** Mapper key for {@link ScreenTargetField}, the attributes panel's Screen picker. */\nexport const SCREEN_TARGET_FIELD_COMPONENT = 'aglyn-screen-target-field'\n\n/**\n * The options `resolveAttributeField` built, sorted into the targets the\n * routing map holds — offered in groups, narrowed as the author types — and\n * the choices pinned above them: the empty one, and a stored target the host\n * no longer has. An entry is neither: the lookup names it by reading it.\n */\nfunction splitScreenTargetOptions(\n  options: unknown,\n  screens: Aglyn.ScreenRouteMap | undefined,\n): { leading: LinkTargetChoice[]; targets: LinkTargetChoice[] } {\n  const leading: LinkTargetChoice[] = []\n  const targets: LinkTargetChoice[] = []\n  for (const option of Array.isArray(options) ? options : []) {\n    const value = typeof option?.value === 'string' ? option.value : ''\n    const choice = { value, label: String(option?.label ?? value) }\n    if (value && linkTargetKind(value) === 'entry') continue\n    if (value && resolveScreenHref(screens, value) !== undefined) {\n      targets.push(choice)\n    } else {\n      leading.push(choice)\n    }\n  }\n  return { leading, targets }\n}\n\n/**\n * The attributes panel's Screen picker (`SCREEN_SELECT`) as the lookup\n * (AGL-3119): the Screen Link's \"Screen\", the \"Link to screen\" of a Button and\n * an Image, the Link Container's target, an Accordion header's, a Form's\n * redirect, and each tab of a Tabs strip.\n *\n * It was a plain select over the routing map, which had no room for entries.\n * Its options are still the ones `resolveAttributeField` builds, so both\n * pickers offer one list; the value is stored exactly as the select stored it\n * — a bare screen id, or a listing's, feed's or entry's own key — and there is\n * no typed-address choice, because each of these elements carries its own\n * External URL field for that.\n */\nexport function ScreenTargetField(props: ScreenLinkFieldProps) {\n  const {\n    input,\n    isDisabled,\n    isReadOnly,\n    label,\n    helperText,\n    description,\n    validateOnMount,\n    meta,\n    help,\n    options,\n    FormFieldGridProps = {},\n  } = useFieldApi(props as never) as Record<string, any>\n  const { screens } = useContext(ScreenLinkContext)\n  const invalid = validationError(meta as ExtendedFieldMeta, validateOnMount)\n  const { leading, targets } = useMemo(\n    () => splitScreenTargetOptions(options, screens),\n    [options, screens],\n  )\n  const stored = typeof input.value === 'string' ? input.value.trim() : ''\n\n  return (\n    <FormFieldGrid help={help} {...FormFieldGridProps}>\n      <LinkTargetAutocomplete\n        name={input.name}\n        value={stored}\n        onChange={(next) => input.onChange(next)}\n        targets={targets}\n        leading={leading}\n        label={label}\n        disabled={isDisabled || isReadOnly}\n        error={Boolean(invalid)}\n        helperText={invalid || helperText || description}\n      />\n    </FormFieldGrid>\n  )\n}\nScreenTargetField.displayName = 'ScreenTargetField'\n\nexport default ScreenLinkField\n"],"names":["bareFragmentLinkWarning","formatScreenLinkValue","linkTargetKind","parseScreenLinkValue","resolveScreenHref","ScreenLinkContext","screenLinkTargetOptions","screenRoutesAnswerFor","unavailableScreenLabel","useLinkTargetLabel","EXTERNAL_URL_OPTION","LinkTargetAutocomplete","FormFieldGrid","useFieldApi","validationError","Stack","TextField","useCallback","useContext","useEffect","useMemo","useState","SCREEN_LINK_FIELD_COMPONENT","EXTERNAL_CHOICE","value","label","ScreenLinkValuePicker","props","error","onChange","helperText","placeholder","disabled","size","emptyLabel","defaultValue","defaultOwner","name","screens","labels","screenId","literal","external","setExternal","Boolean","options","unknownScreen","undefined","defaultScreen","defaultEntry","describeDefault","described","resolvedEmptyLabel","urlPlaceholder","selectValue","leading","handleSelect","next","detail","address","spacing","sx","width","targets","trailing","addressOption","event","target","fullWidth","slotProps","htmlInput","displayName","ScreenLinkField","input","isDisabled","isReadOnly","description","validateOnMount","meta","help","propDefault","propDefaultOwner","FormFieldGridProps","invalid","SCREEN_TARGET_FIELD_COMPONENT","splitScreenTargetOptions","option","Array","isArray","choice","String","push","ScreenTargetField","stored","trim"],"mappings":"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"}

package/src/lib/components/site-theme-color-tokens-provider.component.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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.
+ */
+/**
+ * Feeds the two-stage color picker (AGL-588) with the SITE theme's
+ * palette token references, resolved through BOTH schemes of the host's
+ * persisted theme document so every swatch previews its light and dark
+ * colors. Mounted around the designer's aside panels, it reaches every
+ * COLOR_PICKER field — styles panel, attribute forms, and email block
+ * attributes — through the shared field component, with no per-form
+ * wiring.
+ */
+export declare const SiteThemeColorTokensProvider: {
+    (props: {
+        children?: JSX.Children;
+    }): import("react").JSX.Element;
+    displayName: string;
+    aglyn: boolean;
+};
+export default SiteThemeColorTokensProvider;