@magmonium/one 0.4.34 → 0.4.35

package/types/magmonium-one.d.ts

@@ -9,7 +9,7 @@ import { ControlValueAccessor } from "@angular/forms";
 import { SafeStyle } from "@angular/platform-browser";
 /**
  * The three scale steps the design system renders, and the only ones — see
- * CONTEXT.md `Size` and ADR 0008. Declarable on a Section or a ButtonGroup and
+ * GLOSSARY.md `Size` and ADR 0008. Declarable on a Section or a ButtonGroup and
  * nowhere else (a SectionButtonGroup shares the latter seat, being its
  * markup-composed variant); everything below one renders at its Size.
  */
@@ -120,7 +120,7 @@ export declare class TranslateService {
   private readonly country;
   readonly remoteAppId: import("@angular/core").WritableSignal<string | undefined>;
   /**
-   * The mounted App's Default Language (store CONTEXT.md): its keys load from
+   * The mounted App's Default Language (store GLOSSARY.md): its keys load from
    * this file when the App ships none for `lang` — library keys still follow
    * `lang`.
    */
@@ -219,7 +219,7 @@ export declare class TranslateService {
 export type HeldShelf = 'local' | 'session';
 export declare class StorageService {
   /**
-   * Write a HeldValue (CONTEXT.md HeldValue, ADR 0019). Always a JSON envelope,
+   * Write a HeldValue (GLOSSARY.md HeldValue, ADR 0019). Always a JSON envelope,
    * so a `string` holding `'3'` reads back a `string` and not the `3` that
    * `getLocal` answers; `undefined` deletes the key rather than storing the
    * word; and falsiness is never a reason to skip the write, so a `false`, a
@@ -256,7 +256,7 @@ export declare class DeviceService {
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 /**
- * The language and country the visitor's browser declares (CONTEXT.md
+ * The language and country the visitor's browser declares (GLOSSARY.md
  * Browser Locale). A hint that pre-fills and breaks ties, never an authority —
  * callers clamp `language` to their own list, and `country` is null rather
  * than guessed from the language (`en` is not `US`).
@@ -554,7 +554,7 @@ type SectionTableSortDirection = 'asc' | 'desc';
 type SectionTableVariant = 'default' | 'zebra' | 'compact' | 'spacious' | 'border';
 export declare const SECTION_TABLE_VARIANTS: readonly SectionTableVariant[];
 /**
- * One entry in a SectionTable's configured heading (CONTEXT.md
+ * One entry in a SectionTable's configured heading (GLOSSARY.md
  * SectionTableColumn). The cells beneath it line up by position, so nothing
  * here says how a cell renders — a cell renders what was put in it.
  */
@@ -573,7 +573,7 @@ type SectionTableColumn = {
   dataType?: SectionTableDataType;
   /** Freezes this column and every column before it to the left edge. */
   freeze?: boolean;
-  /** Starts folded, with a toggle in its heading (CONTEXT.md Squeeze). */
+  /** Starts folded, with a toggle in its heading (GLOSSARY.md Squeeze). */
   squeeze?: boolean;
 };
 type SectionTableSort = {
@@ -761,7 +761,7 @@ export interface WebComponentConfig {
   selectorConfig?: Partial<RemoteSelectorConfig>;
   backend?: string;
   /**
-   * Open App (store CONTEXT.md), stamped by the Store on the served config: a
+   * Open App (store GLOSSARY.md), stamped by the Store on the served config: a
    * host draws it as its own — no menu node, logo or settings of its own.
    */
   open?: boolean;
@@ -811,7 +811,7 @@ export interface NavStoreRef {
   panelNavId?: Signal<string | undefined>;
   /**
    * `panelNavId` with any Browse left out — where the User stands rather than
-   * where they are looking (CONTEXT.md Browse). What a row marks itself
+   * where they are looking (GLOSSARY.md Browse). What a row marks itself
    * against, so the row they came through stays marked while they Browse.
    * Optional: a host built before it existed provides none.
    */
@@ -840,14 +840,14 @@ export interface NavStoreRef {
   }) => void;
   /**
    * Moves the open panel onto a Nav without moving the User — the Address and
-   * the Page stay put (CONTEXT.md Browse). `params` names the instance of a
+   * the Page stay put (GLOSSARY.md Browse). `params` names the instance of a
    * `dynamic` Nav. Optional: a host built before it existed provides none.
    */
   browse?: (navId: string, params?: Record<string, string | number>) => void;
   /**
    * Follows a NavRef whose dynamic segments are keyed by the Nav contributing
    * each one rather than by parameter name — what an emitted OutcomeNav calls
-   * (m-one-ui CONTEXT.md OutcomeNav). Optional: a host built before it existed
+   * (m-one-ui GLOSSARY.md OutcomeNav). Optional: a host built before it existed
    * provides none, and the gesture then does nothing rather than throwing.
    */
   followNav?: (navId: string, byNav?: Record<string, string | number>, options?: {
@@ -1043,7 +1043,7 @@ export declare const APP_LINK: InjectionToken<WritableSignal<string | undefined>
 /**
  * The loading counter this application's requests move, ahead of the host's
  * shared one. A Plugin provides its own so its requests never turn the host's
- * `busy` on (libs/one CONTEXT.md Plugin); unset, the host's counter is used.
+ * `busy` on (libs/one GLOSSARY.md Plugin); unset, the host's counter is used.
  */
 export declare const LOADING_ACTIONS_REF: InjectionToken<LoadingActionsApi>;
 export declare const IS_SIDE_PANEL: InjectionToken<boolean>;
@@ -1211,6 +1211,27 @@ export declare function derivePropertyName(inputString: string, type: ColorPrope
 export declare function setProperty(element: HTMLElement, key: string, value: string | null): void;
 export declare function getProperty(element: HTMLElement, key: string): string;
 export declare function classListSignal(element: Element): Signal<string[]>;
+/**
+ * Which element in `node`'s own root holds the caret — the document for a node
+ * in the light DOM, the nearest shadow root for a node inside one — or null when
+ * nothing there does.
+ *
+ * `document.activeElement` is the wrong question for anything that may be
+ * mounted in a shadow root, and every Screen of an app loaded under m-ui is: the
+ * Web Component wrapper gives the app's root `ViewEncapsulation.ShadowDom`, so
+ * the app renders in one. Asked from inside, the document answers with the
+ * shadow **host** — an ancestor of whoever is asking — and `contains` does not
+ * walk across the boundary, so `node.contains(document.activeElement)` reads
+ * false however well `node` holds the focus. The Section's search bar, asking
+ * the document whether its own freshly-focused input still holds the caret,
+ * therefore closes itself on the very click that opened it: the toggle is
+ * destroyed, the input mounts, the deferred check sees the host instead of the
+ * input, and `close` is called.
+ *
+ * Null is the honest answer for "no caret has been placed here", which is what
+ * a caller guarding against stealing one is asking.
+ */
+export declare function activeElementWithin(node: Node): Element | null;
 export declare function getScrollParent(node: Node | null): HTMLElement | Window;
 export declare function isJson(data: unknown): boolean;
 export declare function getValue<T, K extends keyof T>(obj: T, key: K): T[K];
@@ -1370,7 +1391,7 @@ export declare const pickSupportedLanguage: (own: string | undefined, supported:
 /**
  * One loading counter and the actions that move it. The module's own is the
  * app-wide one every Screen's `busy` reads; a Plugin makes another so its
- * requests never move it (libs/one CONTEXT.md Plugin).
+ * requests never move it (libs/one GLOSSARY.md Plugin).
  */
 export declare function createLoadingState(): {
   isLoading: import("@angular/core").Signal<boolean>;
@@ -1699,7 +1720,7 @@ export declare class MHeroColorDirective {
 /**
  * NavRef link. `mRef` names a target by NavId and nothing else — the NavKind on
  * that node decides whether following it routes or opens a panel, so this
- * directive never chooses. See libs/one/CONTEXT.md (NavRef) and ADR 0014.
+ * directive never chooses. See libs/one/GLOSSARY.md (NavRef) and ADR 0014.
  */
 export declare class MRefDirective {
   #private;
@@ -2100,7 +2121,7 @@ export interface PluginOutput {
 export declare const PLUGIN_FALLBACK_LANG = "en";
 export declare const PLUGIN_SCREENS: InjectionToken<ExposedScreens[]>;
 /**
- * Offers Screens to other apps as Plugins (libs/one CONTEXT.md). Listed in the
+ * Offers Screens to other apps as Plugins (libs/one GLOSSARY.md). Listed in the
  * app's providers; its wc bundle defines one element per Screen at load,
  * without booting the app's root.
  */
@@ -3934,7 +3955,7 @@ declare class BaseTextInputComponent<T extends Input = TextInput> extends BaseIn
 /**
  * What the results component's search input is called when nobody says
  * otherwise — the name the design editor mints on a results Screen, spelled
- * here so a hand-written caller lands on the same word (CONTEXT.md
+ * here so a hand-written caller lands on the same word (GLOSSARY.md
  * SearchResultsScreen).
  */
 declare const SEARCH_RESULT_INPUT = "search";
@@ -4217,7 +4238,7 @@ export declare class SectionFilterComponent {
   /**
    * How many numbers a `range` Filter picks: two by default, one under
    * `single`, where its key carries that number rather than a pair
-   * (CONTEXT.md FilterRangeMode). Ignored by the option-picking variants.
+   * (GLOSSARY.md FilterRangeMode). Ignored by the option-picking variants.
    */
   readonly mode: import("@angular/core").InputSignal<FilterRangeMode>;
   /**
@@ -5143,7 +5164,7 @@ export declare const SECTION_ACCORDION_GROUP: InjectionToken<SectionAccordionGro
  * its projected `m-section-header` (nothing renders, and the Section never
  * collapses, if it has no header) and everything below the header collapses
  * as one region. Ungrouped, starts open; inside an `mAccordionGroup`, only
- * the first-registered member starts open (CONTEXT.md SectionAccordion).
+ * the first-registered member starts open (GLOSSARY.md SectionAccordion).
  */
 export declare class SectionAccordionDirective implements SectionAccordionRef, OnInit, OnDestroy {
   readonly mAccordion: import("@angular/core").InputSignal<string | Partial<SectionAccordion> | null | undefined>;
@@ -5512,7 +5533,7 @@ type SectionButtonGroupConfig = Config & {
  * whatever Size the nearest Section put on the cascade, which is why its
  * Buttons then land on that Section's input geometry with no sizing code here:
  * both are 2.25x the Size.
- * See CONTEXT.md `SectionButtonGroup` and ADR 0008, ADR 0009.
+ * See GLOSSARY.md `SectionButtonGroup` and ADR 0008, ADR 0009.
  */
 export declare class SectionButtonGroupComponent extends ConfigComponent<SectionButtonGroupConfig> {
   subFolder: "section_button_groups";
@@ -5558,7 +5579,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
   }, {}, never, ["m-button, m-one-button", "*"], true, never>;
 }
 /**
- * The table composed from projected markup (CONTEXT.md SectionTable): the
+ * The table composed from projected markup (GLOSSARY.md SectionTable): the
  * `<table>` and its configured heading are this component's, every row is
  * projected. A row written inside an `@for` is drawn once per item, one outside
  * it once — so a `<tr m-section-table-row>` is all the body ever holds, and
@@ -5635,7 +5656,7 @@ export declare class SectionTableComponent extends ConfigComponent<SectionTableC
   }, never, ["*", "m-section-pagination"], true, never>;
 }
 /**
- * One `<tr>` of a SectionTable (CONTEXT.md SectionTableRow). An attribute on a
+ * One `<tr>` of a SectionTable (GLOSSARY.md SectionTableRow). An attribute on a
  * real `<tr>` rather than an element of its own: a component host between
  * `<tbody>` and its cells breaks table layout. Repeated or static is decided by
  * where it was written, never by a setting here.
@@ -5649,7 +5670,7 @@ export declare class SectionTableRowComponent {
   }, never, ["*"], true, never>;
 }
 /**
- * One `<td>` of a SectionTableRow (CONTEXT.md SectionTableCell), holding any
+ * One `<td>` of a SectionTableRow (GLOSSARY.md SectionTableCell), holding any
  * content. Answers to the column at its own position — its `cellIndex`, which
  * only the DOM knows once the row is laid out — for alignment, Squeeze and
  * freezing, and configures none of them itself.
@@ -5848,7 +5869,7 @@ type BoundConfig = Partial<Input> & {
  * The panel a `range` Filter opens: a slider over the authored bounds, and the
  * numeric boxes under it. Two thumbs and two boxes by default; one of each in
  * `single` mode, where the Filter picks one number rather than a pair
- * (CONTEXT.md FilterRangeMode). One panel for both, because the modes differ
+ * (GLOSSARY.md FilterRangeMode). One panel for both, because the modes differ
  * only in how many answers come back — the bounds and the fallbacks are the
  * same authoring either way.
  *
@@ -5876,7 +5897,7 @@ export declare class SectionFilterRangePanelComponent {
   readonly value: import("@angular/core").InputSignal<readonly (string | number)[]>;
   readonly min: import("@angular/core").InputSignal<number | undefined>;
   readonly max: import("@angular/core").InputSignal<number | undefined>;
-  /** One thumb or two. `range` by default (CONTEXT.md FilterRangeMode). */
+  /** One thumb or two. `range` by default (GLOSSARY.md FilterRangeMode). */
   readonly mode: import("@angular/core").InputSignal<FilterRangeMode>;
   /** The Filter's own heading, already a TranslationAsset key. */
   readonly label: import("@angular/core").InputSignal<string>;
@@ -6808,7 +6829,7 @@ type CheckboxGroupRow = {
   readonly checkbox: Partial<Input>;
 };
 /**
- * The many-pick sibling of `m-radio-group` (CONTEXT.md CheckboxGroup). One
+ * The many-pick sibling of `m-radio-group` (GLOSSARY.md CheckboxGroup). One
  * `m-checkbox` per option, its value the picked options' values in option
  * order. Options are bound, placed or named (ADR 0039, ADR 0041): bound or
  * placed `options` win, and an OptionSet named by `optionsAsset` / `mOptions`
@@ -7474,7 +7495,7 @@ export declare function normalizeAssetOptions(data: AssetOption[] | AssetOption[
 export declare function assetOptions(name?: () => string | undefined): Signal<DropdownOption[]>;
 /**
  * Starts a Field on its list's `default` row when it holds no value of its own
- * (m-one-ui CONTEXT.md OptionSet). The Field's own value — its config, its form
+ * (m-one-ui GLOSSARY.md OptionSet). The Field's own value — its config, its form
  * data — outranks the row, so a value already held is kept.
  *
  * Each marked row is consulted once: a User who clears the pick is not handed
@@ -7887,7 +7908,7 @@ declare const fileMatchesAccept: (file: Pick<File, "name" | "type">, accept: rea
 /**
  * Splits picked or dropped files into the ones the Field keeps and the ones it
  * reports. A drop never passes the native picker, so this is where `accept` and
- * `maxSize` are enforced rather than merely suggested (CONTEXT.md DropZone).
+ * `maxSize` are enforced rather than merely suggested (GLOSSARY.md DropZone).
  */
 declare const screenFiles: (files: readonly File[], accept: readonly string[], maxSize: number | undefined) => FileScreen;
 /** Appends `incoming` to `current`, skipping a file already held. */
@@ -8101,7 +8122,7 @@ export declare class ListComponent extends ConfigComponent<ListConfig> {
    * row authored in the asset reaches the template the way a mapped one does:
    * an authored `ListItem` carries no `row` of its own, and a body reading
    * `undefined` would make the static source unusable to anything but a bare
-   * label (m-one-ui CONTEXT.md ListControl).
+   * label (m-one-ui GLOSSARY.md ListControl).
    */
   protected readonly rowContext: (item: ListItem, index: number, first: boolean, last: boolean) => ListContext;
   static ɵfac: i0.ɵɵFactoryDeclaration<ListComponent, never>;
@@ -8973,7 +8994,7 @@ export declare class SectionFormItemComponent extends ConfigComponent<Input> imp
   }, ["projectedTemplate", "placedCheckboxes"], never, true, never>;
 }
 /**
- * Names the AssetOptions list a Field chooses from (CONTEXT.md OptionsSource).
+ * Names the AssetOptions list a Field chooses from (GLOSSARY.md OptionsSource).
  * The markup spelling of the `optionsAsset:` config key, added beside it rather
  * than in place of it (ADR 0010) — a Field still described by a file keeps
  * declaring the key inside that file.
@@ -10236,7 +10257,7 @@ export declare class RemoteComponent implements OnDestroy {
  */
 export type PluginSource = 'local' | 'beta' | 'published';
 /**
- * Mounts another app's Exposed Screen as a Plugin (libs/one CONTEXT.md): an
+ * Mounts another app's Exposed Screen as a Plugin (libs/one GLOSSARY.md): an
  * AppLink, the Screen's name, a value per input and one `output` event per
  * output the Screen emits. Never a whole app and never an address — that is
  * `m-remote`.
@@ -12000,7 +12021,7 @@ type StatAlign = 'left' | 'center' | 'right';
 type StatSurface = 'plain' | 'card' | 'shadow' | 'glow' | 'gradient';
 /**
  * A KeyValue with a corner mark: a label, a large value, and a small secondary
- * value set against the value itself (CONTEXT.md Stat).
+ * value set against the value itself (GLOSSARY.md Stat).
  *
  * The label is an attribute because a name is a string either way — a
  * TranslationAsset key, or a row's own text under `noTranslate` (ADR 0022);
@@ -12245,7 +12266,7 @@ export type PanelOverlayConfig = Config & {
 };
 /**
  * What a store hands `ModalStore.openScreen` — the programmatic counterpart of
- * `mModal` / `mSidePanel` (CONTEXT.md OverlayTrigger).
+ * `mModal` / `mSidePanel` (GLOSSARY.md OverlayTrigger).
  *
  * One shape for both overlays rather than two: `as` says which, and the caller
  * is one generated `tap` that has already drawn the answer. A directive resolves
@@ -12686,7 +12707,7 @@ export type BreadcrumbTrail = {
   /**
    * NavRef — names the target by NavId only. The NavKind on the target decides
    * whether following it routes or opens a panel, so a link can never pick the
-   * wrong kind. See libs/one/CONTEXT.md (NavRef) and ADR 0014.
+   * wrong kind. See libs/one/GLOSSARY.md (NavRef) and ADR 0014.
    */
   nav?: string;
   /**
@@ -12703,7 +12724,7 @@ export type BreadcrumbTrail = {
   href?: string;
   /**
    * A menu row whose Nav would draw rows of its own: it carries a chevron that
-   * Browses into it while the row itself follows it (CONTEXT.md Browse).
+   * Browses into it while the row itself follows it (GLOSSARY.md Browse).
    */
   browsable?: boolean;
 };
@@ -12712,7 +12733,7 @@ export type BreadCrumb = {
   header: BreadcrumbTrail;
 };
 /**
- * Nav model — see libs/one/CONTEXT.md (NavId, NavKind, Address, Anchor, NavRef)
+ * Nav model — see libs/one/GLOSSARY.md (NavId, NavKind, Address, Anchor, NavRef)
  * and docs/adr/0014.
  */
 /** How a Nav is reached. A property of the node, never of the link. */
@@ -12741,7 +12762,7 @@ export type Nav = {
    */
   param?: string;
   /**
-   * A NavTail's parameter name (m-one-ui CONTEXT.md NavTail): every segment
+   * A NavTail's parameter name (m-one-ui GLOSSARY.md NavTail): every segment
    * below the Nav's own path is one value under this name, separators kept —
    * `code/<path>` with `path` = `src/app/x.ts`. Routed by `navTailMatcher`.
    */
@@ -12755,7 +12776,7 @@ export type Nav = {
   seeded?: boolean;
 };
 /**
- * One row a `dynamic` Nav resolves to at runtime (CONTEXT.md NavRow).
+ * One row a `dynamic` Nav resolves to at runtime (GLOSSARY.md NavRow).
  *
  * `value` is the [NavParam] value and never a NavId — a NavRef names a node
  * and the instance rides alongside as params, so a row can never disagree with
@@ -12830,7 +12851,7 @@ interface NavMenuConfig {
 }
 /**
  * What a `dynamic` Nav registers instead of a panel: the rows it resolves at
- * runtime (CONTEXT.md NavRowSource). Registered under the dynamic Nav's own
+ * runtime (GLOSSARY.md NavRowSource). Registered under the dynamic Nav's own
  * NavId, but drawn in *its parent's* panel — the rows are spliced where its
  * own row stood, the transparency a Default Nav already has, because a row
  * labelled `with-category` names nothing a User recognises.
@@ -12870,7 +12891,7 @@ interface NavRowsConfig {
 /**
  * What a `dynamic` Nav registers to answer *which instance the User is standing
  * on*, as against `NavRowsConfig`, which answers *where they may go*
- * (CONTEXT.md NavInstanceSource, ADR 0030). Registered under the dynamic Nav's
+ * (GLOSSARY.md NavInstanceSource, ADR 0030). Registered under the dynamic Nav's
  * own NavId, and read by the trail and the panel header rather than by any
  * menu: a row list is a menu answer, and one deep link into `/app/:id/about`
  * needs a name for `:id` whether or not a menu of every app would even be
@@ -12900,7 +12921,7 @@ interface NavInstanceConfig {
   navInstanceLoad?: (params: Record<string, string>) => void;
 }
 /**
- * What a gate answers (m-one-ui CONTEXT.md NavVisibilitySource).
+ * What a gate answers (m-one-ui GLOSSARY.md NavVisibilitySource).
  *
  * **Three states, and one of them is a promise.** `true` / `false` are the
  * answer; `undefined` is *not answerable yet* — the state the gate reads has
@@ -12915,7 +12936,7 @@ interface NavInstanceConfig {
  */
 type NavVisibleAnswer = boolean | undefined | Promise<boolean>;
 /**
- * Whether one Nav is shown and reachable at all (m-one-ui CONTEXT.md
+ * Whether one Nav is shown and reachable at all (m-one-ui GLOSSARY.md
  * NavVisibilitySource). Registered under that Nav's own NavId beside whatever
  * else it registers — the configs are not exclusive, which is why every guard
  * here tests for its own key rather than for the absence of another's.
@@ -12938,7 +12959,7 @@ interface NavVisibilityConfig {
   navVisible: (params: Record<string, string>) => NavVisibleAnswer;
   /**
    * Fired before the gate is believed, so a gate reading state the store does
-   * not hold yet has something filling it (m-one-ui CONTEXT.md
+   * not hold yet has something filling it (m-one-ui GLOSSARY.md
    * NavVisibilitySource).
    *
    * This is what makes *is this app's uid the signed-in user* answerable on a
@@ -13329,19 +13350,19 @@ interface NavState {
   navOpenedByUser: boolean;
   /**
    * The Nav a Browse moved the panel onto — up, down or sideways — while the
-   * Address, and the Page, stay put (CONTEXT.md Browse).
+   * Address, and the Page, stay put (GLOSSARY.md Browse).
    */
   menuNavId: string | undefined;
   /**
    * The instances the Browse names — a `dynamic` Nav is a node, and which book
-   * the User is looking into is data (CONTEXT.md Browse). Read only while
+   * the User is looking into is data (GLOSSARY.md Browse). Read only while
    * `menuNavId` is set.
    */
   menuParams: Record<string, string | number> | undefined;
   /**
    * The app whose menu an App Rail AppLogo Browsed onto, and the slot it held
    * then. That Browse belongs to the app: it survives an Address change that
-   * only moved the app to another slot (CONTEXT.md Browse).
+   * only moved the app to another slot (GLOSSARY.md Browse).
    */
   browsedApp: {
     name: string;
@@ -13676,7 +13697,7 @@ export declare class MurlUrlSerializer implements UrlSerializer {
 }
 export declare const provideMurlUrlSerializer: () => Provider;
 /**
- * NavId <-> Address. See libs/one/CONTEXT.md and docs/adr/0014.
+ * NavId <-> Address. See libs/one/GLOSSARY.md and docs/adr/0014.
  *
  * A NavId is the full path joined with `_`, always rooted: `root`,
  * `root_settings_user`. It is separator-blind — the `/` vs `|` of an Address
@@ -13741,7 +13762,7 @@ declare const fillParams: (path: string, params?: Record<string, string | number
 /**
  * A Url NavId's route path with its params filled — and, for a NavTail, the
  * rest appended as its tail value names it, separators kept, since the tail is
- * every segment below the Nav and not one (m-one-ui CONTEXT.md NavTail). No
+ * every segment below the Nav and not one (m-one-ui GLOSSARY.md NavTail). No
  * tail value is no rest: the Nav's own address.
  */
 declare const fillRoutePath: (navId: string, navMap: NavMap, params?: Record<string, string | number>) => string;
@@ -13766,7 +13787,7 @@ export declare const toHostNavId: (localNavId: string, hostNavId: string) => str
 export declare const toLocalNavId: (hostScopedNavId: string, hostNavId: string) => string | undefined;
 export declare const navVisibilityGuard: CanActivateFn;
 /**
- * The route a NavTail emits (m-one-ui CONTEXT.md NavTail): its own prefix, then
+ * The route a NavTail emits (m-one-ui GLOSSARY.md NavTail): its own prefix, then
  * every segment below it joined into one `name` parameter. Angular's `**`
  * binds to no input, which is why this is a matcher and not a path. A `:x`
  * segment of the prefix is filled the way a path would fill it.
@@ -13793,7 +13814,7 @@ export declare class NavComponent {
     app: undefined;
   } | undefined>;
   /**
-   * The App Rail below the AppLogo (CONTEXT.md App Rail): the Main Slot's App,
+   * The App Rail below the AppLogo (GLOSSARY.md App Rail): the Main Slot's App,
    * standing where the apps button would, then each Side App. Selecting one
    * opens the panel on that app's menu; the open panel rings whose menu it is.
    */
@@ -14038,7 +14059,7 @@ export declare class NavTrailComponent {
   constructor();
   /**
    * Moves the panel onto the entry's Nav and leaves the Address, and the Page
-   * behind the panel, where they are (CONTEXT.md Browse).
+   * behind the panel, where they are (GLOSSARY.md Browse).
    */
   protected browse: (navId: string, params?: Record<string, string | number>) => void;
   protected onOverflow(item: MenuItem): void;
@@ -14064,7 +14085,7 @@ export declare class NavMenuComponent {
   filterBySearch: import("@angular/core").InputSignal<boolean>;
   size: typeof Size;
   navList: import("@angular/core").Signal<BreadcrumbTrail[] | undefined>;
-  /** Looks inside the row's Nav without following it (CONTEXT.md Browse). */
+  /** Looks inside the row's Nav without following it (GLOSSARY.md Browse). */
   browse: (item: BreadcrumbTrail) => void;
   rows: import("@angular/core").Signal<ListItem[]>;
   static ɵfac: i0.ɵɵFactoryDeclaration<NavMenuComponent, never>;
@@ -14421,7 +14442,7 @@ export declare class NotificationService {
 /**
  * Browser clipboard writes a gesture may fire. Takes one object so a designed
  * Screen's call site builds it the way it builds every GlobalMethod's
- * (CONTEXT.md GlobalMethod), and reports the outcome itself — a template call
+ * (GLOSSARY.md GlobalMethod), and reports the outcome itself — a template call
  * has nowhere to await the write.
  */
 export declare class ClipboardService {
@@ -16009,4 +16030,214 @@ interface AuthResult {
   tokens: SharedToken;
 }
 export declare function injectAuthenticate(): () => Promise<AuthResult>;
-export type { Accordion, AccordionGroup, AccordionVariant, AppCardData, AppCardInputs, AppCardVariant, AppManifest, AppTileData, AssetOption, AuthResult, Badge, BadgePosition, BadgeVariant, Button, ButtonGroup, CellChangeEvent, CellClickEvent, ColBreakpoint, ColSpan, ColorPallet, ColumnDef, Comment, CommentItem, Config, ContextMenu, ContextMenuEvent, Cursor, CustomIcon, DragListReorder, Draggable, DraggableState, FileUploadConfig, FileUploadEvent, FilterGroupContext, FilterGroupMember, FilterOption, FilterPanel, FilterPanelIo, FilterRangeMode, FilterSelectionMap, FilterValue, FilterVariant, FilteredTreeGrid, FlatTreeGridRow, FlexAlign, FlexAlignSelf, FlexConfig, FlexDirection, FlexItemConfig, FlexJustify, FlexVariant, GridAlignX, GridAlignY, Header, HeaderLevel, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, SectionTableSortDirection, SectionTableVariant, SectionToggleItem, SectionToggleItemContext, SelectionAction, SelectionActionEvent, SelectionChangeEvent, SelectorConfig, SocketMessage, Sort, SortChange, SortChangeEvent, SortOption, SortOrder, SpacingInward, SqueezeMode, StatAlign, StatCornerEdge, StatCornerPosition, StatCornerSide, StatSurface, StatVariant, TabGroup, TableConfig, TableFilterCondition, TableFilterDef, TextOrNumberInput, Timeline, TimelineItem, TreeGridCellClickEvent, TreeGridLoadChildrenEvent, TreeGridRow, TreeGridRowSelectEvent, TreeGridToggleEvent, User };
+/** Who may see a Source — the four Audience Levels of the Sharing context. */
+type AudienceLevel = 'public' | 'private' | 'with' | 'without';
+export declare const AUDIENCE_LEVELS: readonly AudienceLevel[];
+/**
+ * One Source's Audience as the picker edits it. `uids` and `groupIds` only
+ * mean something for `with` (who is let in) and `without` (who is kept out).
+ */
+interface Audience {
+  level: AudienceLevel;
+  uids: string[];
+  groupIds: string[];
+}
+type GroupKind = 'friends' | 'followers' | 'custom';
+/** A named list of Users one Owner keeps for their own Audiences. */
+interface SharingGroup {
+  id: string;
+  kind: GroupKind;
+  name: string;
+  members: string[];
+}
+/** The slice of a User the picker draws: enough to name them. */
+interface AudienceMember {
+  id: string;
+  firstName?: string;
+  lastName?: string;
+  username?: string;
+}
+/** A Source's stored Audience and whether its context Locked it. */
+interface SourceAudience {
+  audience: Audience;
+  locked: boolean;
+}
+/**
+ * The picker's config bag (`audience_picker/<name>.yml`). Scalars ride the tag
+ * (ADR 0010); the asset holds the one list — which Audience Levels to offer.
+ */
+type AudiencePicker = Config & {
+  levels?: AudienceLevel[];
+  labelled?: boolean;
+  align?: 'left' | 'right';
+  width?: string;
+};
+/**
+ * Everything the Audience picker reads or writes. A token rather than a
+ * concrete service so a host can stand a stub in while the Sharing api does
+ * not answer yet, or route the calls through its own store.
+ */
+interface SharingClient {
+  /** The caller's own Groups. */
+  groups(): Observable<SharingGroup[]>;
+  /** Users whose first or last name starts with every word of `q`. */
+  searchUsers(q: string): Observable<AudienceMember[]>;
+  /** Names for Users already picked, so a chip reads as a person, not an id. */
+  users(ids: string[]): Observable<AudienceMember[]>;
+  /** A Source's stored Audience. */
+  audience(source: string): Observable<SourceAudience>;
+  /** Replaces an existing Source's Audience; the Owner only, never Locked. */
+  saveAudience(source: string, audience: Audience): Observable<SourceAudience>;
+}
+export declare class HttpSharingClient implements SharingClient {
+  private readonly http;
+  groups: () => Observable<SharingGroup[]>;
+  searchUsers: (q: string) => Observable<AudienceMember[]>;
+  users: (ids: string[]) => Observable<AudienceMember[]>;
+  audience: (source: string) => Observable<SourceAudience>;
+  saveAudience: (source: string, audience: Audience) => Observable<SourceAudience>;
+}
+export declare const SHARING_CLIENT: InjectionToken<SharingClient>;
+/**
+ * The popover an Audience picker opens: the Audience Levels on offer, then —
+ * for `with` / `without` — the caller's Groups and a people search. Emits
+ * every change at once; the picker decides whether it is kept or saved.
+ */
+export declare class AudiencePickerBoxComponent {
+  readonly audience: import("@angular/core").InputSignal<Audience>;
+  readonly levels: import("@angular/core").InputSignal<readonly AudienceLevel[]>;
+  readonly locked: import("@angular/core").InputSignal<boolean>;
+  readonly client: import("@angular/core").InputSignal<SharingClient>;
+  readonly changed: import("@angular/core").OutputEmitterRef<Audience>;
+  readonly done: import("@angular/core").OutputEmitterRef<void>;
+  private readonly i18n;
+  protected readonly query: import("@angular/core").WritableSignal<string>;
+  private readonly known;
+  protected readonly icons: Record<AudienceLevel, string>;
+  protected readonly picksMembers: import("@angular/core").Signal<boolean>;
+  private readonly groupsResource;
+  protected readonly groups: import("@angular/core").Signal<import("@magmonium/one").SharingGroup[]>;
+  private readonly searchResource;
+  protected readonly results: import("@angular/core").Signal<AudienceMember[]>;
+  protected readonly searchConfig: import("@angular/core").Signal<Partial<TextInput>>;
+  constructor();
+  protected readonly name: (id: string) => string;
+  protected readonly isPicked: (id: string) => boolean;
+  protected readonly hasGroup: (id: string) => boolean;
+  protected readonly setLevel: (level: AudienceLevel) => void;
+  protected readonly flipUser: (uid: string) => void;
+  protected readonly flipGroup: (groupId: string) => void;
+  private readonly remember;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AudiencePickerBoxComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<AudiencePickerBoxComponent, "m-audience-picker-box", never, {
+    "audience": {
+      "alias": "audience";
+      "required": false;
+      "isSignal": true;
+    };
+    "levels": {
+      "alias": "levels";
+      "required": false;
+      "isSignal": true;
+    };
+    "locked": {
+      "alias": "locked";
+      "required": false;
+      "isSignal": true;
+    };
+    "client": {
+      "alias": "client";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {
+    "changed": "changed";
+    "done": "done";
+  }, never, never, true, never>;
+}
+/**
+ * Who may see a thing, picked from one icon — the context-menu gesture: the
+ * trigger draws the current Audience Level, a click opens the levels, Groups
+ * and people beside it.
+ *
+ * Controlled: `[(audience)]` — the host keeps the value and sends it with its
+ * own save (a thing being created has no Audience to edit yet).
+ * Bound: `source="<id>"` — the picker loads and saves that Source's Audience
+ * itself, and a Locked one opens read-only.
+ */
+export declare class AudiencePickerComponent extends ConfigComponent<AudiencePicker> {
+  readonly audience: import("@angular/core").ModelSignal<Audience | undefined>;
+  readonly source: import("@angular/core").InputSignal<string | undefined>;
+  readonly locked: import("@angular/core").InputSignal<boolean>;
+  readonly labelled: import("@angular/core").InputSignal<boolean | undefined>;
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  readonly align: import("@angular/core").InputSignal<"left" | "right" | undefined>;
+  protected readonly subFolder = "audience_picker";
+  protected readonly open: import("@angular/core").WritableSignal<boolean>;
+  private readonly client;
+  private readonly i18n;
+  private readonly selectorDir;
+  private readonly sourceLocked;
+  private readonly pickerConfig;
+  protected readonly current: import("@angular/core").Signal<Audience>;
+  protected readonly levels: import("@angular/core").Signal<readonly AudienceLevel[]>;
+  protected readonly isLocked: import("@angular/core").Signal<boolean>;
+  private readonly stored;
+  protected readonly summary: import("@angular/core").Signal<string>;
+  protected readonly triggerConfig: import("@angular/core").Signal<Partial<Button>>;
+  protected readonly selectorConfig: import("@angular/core").Signal<SelectorConfig<AudiencePickerBoxComponent> | undefined>;
+  constructor();
+  private readonly apply;
+  private readonly levelTitle;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AudiencePickerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<AudiencePickerComponent, "m-audience-picker, m-one-audience-picker", never, {
+    "audience": {
+      "alias": "audience";
+      "required": false;
+      "isSignal": true;
+    };
+    "source": {
+      "alias": "source";
+      "required": false;
+      "isSignal": true;
+    };
+    "locked": {
+      "alias": "locked";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelled": {
+      "alias": "labelled";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "align": {
+      "alias": "align";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "audience": "audienceChange";
+  }, never, never, true, never>;
+}
+/** Deny by default: an Audience nobody has chosen yet is the Owner's alone. */
+export declare const DEFAULT_AUDIENCE: Audience;
+export declare const AUDIENCE_ICONS: Record<AudienceLevel, string>;
+/** Whether a level is followed by a pick of Users and Groups. */
+export declare const picksMembers: (level: AudienceLevel) => boolean;
+/**
+ * Moves an Audience to `level`. A level that picks nobody drops the picks,
+ * so a stored `public` never carries a stale list; switching between `with`
+ * and `without` keeps them, since the same people are usually meant.
+ */
+export declare const withLevel: (audience: Audience, level: AudienceLevel) => Audience;
+export declare const toggleUid: (audience: Audience, uid: string) => Audience;
+export declare const toggleGroup: (audience: Audience, groupId: string) => Audience;
+/** How many Users and Groups an Audience names. */
+export declare const pickCount: (audience: Audience) => number;
+export type { Accordion, AccordionGroup, AccordionVariant, AppCardData, AppCardInputs, AppCardVariant, AppManifest, AppTileData, AssetOption, Audience, AudienceLevel, AudienceMember, AudiencePicker, AuthResult, Badge, BadgePosition, BadgeVariant, Button, ButtonGroup, CellChangeEvent, CellClickEvent, ColBreakpoint, ColSpan, ColorPallet, ColumnDef, Comment, CommentItem, Config, ContextMenu, ContextMenuEvent, Cursor, CustomIcon, DragListReorder, Draggable, DraggableState, FileUploadConfig, FileUploadEvent, FilterGroupContext, FilterGroupMember, FilterOption, FilterPanel, FilterPanelIo, FilterRangeMode, FilterSelectionMap, FilterValue, FilterVariant, FilteredTreeGrid, FlatTreeGridRow, FlexAlign, FlexAlignSelf, FlexConfig, FlexDirection, FlexItemConfig, FlexJustify, FlexVariant, GridAlignX, GridAlignY, GroupKind, Header, HeaderLevel, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, SectionTableSortDirection, SectionTableVariant, SectionToggleItem, SectionToggleItemContext, SelectionAction, SelectionActionEvent, SelectionChangeEvent, SelectorConfig, SharingClient, SharingGroup, SocketMessage, Sort, SortChange, SortChangeEvent, SortOption, SortOrder, SourceAudience, SpacingInward, SqueezeMode, StatAlign, StatCornerEdge, StatCornerPosition, StatCornerSide, StatSurface, StatVariant, TabGroup, TableConfig, TableFilterCondition, TableFilterDef, TextOrNumberInput, Timeline, TimelineItem, TreeGridCellClickEvent, TreeGridLoadChildrenEvent, TreeGridRow, TreeGridRowSelectEvent, TreeGridToggleEvent, User };