@dynamicforms/vue-forms 3.0.0-alpha.1 → 3.0.0-alpha.3

package/dist/index.d.ts

@@ -117,10 +117,21 @@ declare type ActionExecutor = (field: FieldBase, supr: FieldActionExecute, ...pa
  */
 export declare class ActionsMap {
     /**
-     * Every action registered here, in registration order. Unregistering replaces the array instead of modifying it,
-     * so a run in progress finishes on the array it started with and the removal takes effect from the next trigger.
+     * Every action registered here, in registration order. Registering and unregistering replace the array instead of
+     * modifying it, so a run in progress finishes on the array it started with, the change takes effect from the next
+     * trigger, and an array read through `registrations` never changes.
      */
     private actions;
+    /**
+     * The registered actions, in registration order. The array is not modified later, so it records the
+     * registrations at the time of the read; `restore()` reinstates them.
+     */
+    get registrations(): readonly FieldActionBase[];
+    /**
+     * Replaces the registered actions with `registrations`, an array `registrations` returned earlier. The order of
+     * the handlers and every duplicate registration are restored with it.
+     */
+    restore(registrations: readonly FieldActionBase[]): void;
     /**
      * Registers `action`. It becomes the outermost handler of its identifier, or, if `before` is given, is inserted
      * at the position of `before`, so `before` wraps it and calls it through `supr`. This adds an action to an
@@ -128,6 +139,8 @@ export declare class ActionsMap {
      * same identifier, and a TypeError for an `ErrorPolicy` naming an origin another one registered here names.
      */
     register(action: FieldActionBase, before?: FieldActionBase): void;
+    /** A copy of `actions` with `action` inserted at `index`. */
+    private static inserted;
     /** Unregisters `action` and returns whether it was registered here. */
     unregister(action: FieldActionBase): boolean;
     /** True if any action is registered under `identifier`. */
@@ -253,16 +266,23 @@ declare class CompareTo<T = any> extends Validator {
      */
     private readonly registrations;
     /**
-     * The elements this validator has installed its listener on. A binding of such an element has the listener too
-     * (a binding uses the actions of its declaration), so the declaration is checked as well, and a list of N rows
-     * installs one listener, not N.
+     * The declarations of the elements this validator has installed its listener on. A registration goes into the map
+     * of the element's declaration, which every binding of it uses, so a list of N rows installs one listener, not N.
      */
     private readonly listening;
     /**
-     * The declarations of the fields this validator was registered on. One entry covers every binding of such a
+     * The declarations of the fields this validator is registered on. One entry covers every binding of such a
      * field, so a change of a compared element finds the fields of its record without this set holding every row.
+     * They are held weakly: the listener on the compared element keeps this validator reachable, and a form dropped
+     * without unregistering the validator is released all the same.
      */
     private readonly declarations;
+    /**
+     * The listener on the compared elements, one instance for all of them. It is removed when the validator is taken
+     * off its last declaration, or, once its declarations are collected, when an element it is registered on asks it
+     * to release itself.
+     */
+    private readonly relay;
     constructor(otherField: CompareToTarget, isValidComparison: (myValue: T, otherValue: T) => boolean, options?: ValidationErrorOptions);
     /** The element `field` is compared against, within the record `field` belongs to. */
     private resolve;
@@ -272,6 +292,8 @@ declare class CompareTo<T = any> extends Validator {
      * declaration applies to that row; it re-runs only this validator, not the whole chain.
      */
     private listenOn;
+    /** Removes the listener from every compared element; a rollback restores it and the record of the elements. */
+    private stopListening;
     boundToBinding(binding: FieldBase): void;
     private comparisonState;
     protected newBindingState(): CompareToBindingState<T>;
@@ -304,9 +326,10 @@ export declare class ConditionalStatementAction extends ValueChangedAction {
     private readonly statement;
     private readonly conditionalExecutor;
     /**
-     * The declarations of the elements this action was registered on. It holds declarations, not the elements, so one
+     * The declarations of the elements this action is registered on. It holds declarations, not the elements, so one
      * entry covers every row of a list; a result is applied to the element that corresponds to the declaration within
-     * the record the change happened in.
+     * the record the change happened in. They are held weakly: the relay on a field the statement reads keeps this
+     * action reachable, and a form dropped without unregistering the action is released all the same.
      */
     private readonly declarations;
     /**
@@ -318,13 +341,16 @@ export declare class ConditionalStatementAction extends ValueChangedAction {
     constructor(statement: Statement, executorFn: ConditionalExecutorFn);
     /**
      * The listener on the fields the statement reads. The constructor installs it; it is removed when the action is
-     * taken off its last element and installed again when the action is next registered.
+     * taken off its last element or its elements are collected, and installed again when the action is next
+     * registered.
      */
     private readonly relay;
-    /** The number of elements the action is registered on; the relay is removed when it drops to zero. */
-    private registered;
     private listening;
+    /** Whether the action has been registered on an element; until then the relay waits for its first element. */
+    private bound;
     private listen;
+    /** Removes the relay from the fields the statement reads; a rollback restores it with the flag. */
+    private stopListening;
     static get classIdentifier(): symbol;
     get eager(): boolean;
     boundToBinding(binding: FieldBase): void;
@@ -576,8 +602,6 @@ declare interface ElementSlots<T = any> {
     parent: Container | undefined;
     /** the name the containing Group holds this element under; undefined for a List row */
     fieldName: string | undefined;
-    /** generation of the validators attached to the element; clearValidators() raises it */
-    validationEpoch: number;
     /**
      * The element's extended properties, typed by the element's X parameter. A write replaces the object instead of
      * modifying it, so an effect that read the slot re-runs on the write, and a rollback restores the object the
@@ -631,15 +655,24 @@ export declare class EnabledChangingAction extends FieldActionBase {
     execute(field: FieldBase, supr: FieldActionExecute, newValue: boolean, oldValue: boolean): boolean;
 }
 
+/**
+ * The namespace of the error codes this library declares. A code the library raises is `${ERROR_NAMESPACE}.<code>`,
+ * such as `vue-forms.required`.
+ */
+export declare const ERROR_NAMESPACE = "vue-forms";
+
 /**
  * The content of an error: what failed, the values it failed with, an English sentence describing it, and its
  * origin. An error the application builds from a server's response has the same content, so a renderer converts
  * validator and server errors to text with one function.
  */
 export declare interface ErrorDescription {
-    /** Machine-readable identifier of what failed, in snake_case. */
+    /**
+     * Machine-readable identifier of what failed: `<namespace>.<code>`, such as `vue-forms.min_value`. The namespace
+     * names the package that declared the code.
+     */
     readonly code: string;
-    /** The values of the failure, such as `minValue` for `min_value`. */
+    /** The values of the failure, such as `minValue` for `vue-forms.min_value`. */
     readonly params: Readonly<Record<string, unknown>>;
     /** The failure in English, plain text, with `params` substituted. */
     readonly detail: string;
@@ -1112,10 +1145,7 @@ export declare abstract class FieldBase<T = any, X extends object = Extras> {
     protected get boundActions(): ActionsMap | undefined;
     /** Records that `binding` was made from this element, so a later registration can reach it. */
     protected noteBinding(binding: FieldBase): void;
-    /**
-     * The live bindings made from this element's declaration, and the declaration itself. Dead references are removed
-     * when found, so the set does not grow over the life of a long-lived declaration.
-     */
+    /** The live bindings made from this element's declaration and the declaration; removes the dead references. */
     protected get boundElements(): FieldBase[];
     /**
      * The map registrations go into: the declaration's. The map is created on the first registration and assigned to
@@ -1185,8 +1215,9 @@ export declare abstract class FieldBase<T = any, X extends object = Extras> {
      * Makes this element the container of `child`: it sets the back-reference, records the name a Group holds the
      * child under, and adds the child to the invalid count. An element belongs to one container at a time, so a
      * child that already has a parent throws a TypeError; releaseChild() removes the link, after which the element
-     * can be taken by another container. The child's state is private to FieldBase, so a container writes the two
-     * slots through this method.
+     * can be taken by another container. A container cannot take itself or a container above it, which also throws a
+     * TypeError: the parent links would form a cycle, and a walk up them would not end. The child's state is private
+     * to FieldBase, so a container writes the two slots through this method.
      */
     protected takeChild(child: FieldBase, fieldName?: string): void;
     /** Adds a child to this element's invalid count; a container calls it after setting the child's parent link. */
@@ -1399,19 +1430,19 @@ export declare abstract class FieldBase<T = any, X extends object = Extras> {
      */
     unregisterAction(action: FieldActionBase): boolean;
     /**
-     * Binds a newly registered `action` to the existing bindings and registers an undo for a rollback. The
-     * registration is not in the state slots the snapshot covers, so it registers its own undo.
+     * Registers `action` on the declaration, binds it to the existing bindings and registers an undo for a rollback.
+     * The registration is not in the state slots the snapshot covers, so it registers its own undo, before any call
+     * that can throw: a registration that fails part way is undone with the transaction.
+     */
+    private register;
+    /**
+     * Asks the actions of `actions` to release themselves if abandoned (see `ReleaseIfAbandoned`), if a minute or more
+     * has passed since the last time. A map is checked only when an action is registered on it, with no timer.
      */
-    private registered;
+    private releaseAbandoned;
     triggerAction<T2 extends FieldActionBase>(actionClass: (abstract new (...args: any[]) => T2) & {
         classIdentifier: symbol;
     }, ...params: any[]): any;
-    /**
-     * Generation counter of the validators attached to this field. A Validator reads it when a run starts and drops
-     * a result whose epoch no longer matches, so a validation still in flight when clearValidators() is called
-     * cannot push an error onto a field that no longer has the validator that produced it.
-     */
-    get [ValidationEpoch](): number;
     clearValidators(): void;
 }
 
@@ -1521,6 +1552,7 @@ declare namespace Form {
         ListItemInput,
         List,
         NullableList,
+        ERROR_NAMESPACE,
         ErrorPolicies,
         ErrorPolicy,
         ErrorPolicyRule,
@@ -1591,6 +1623,8 @@ export declare class Group<T extends GenericFieldsInterface = GenericFieldsInter
     private static setEntry;
     /** Removes one entry from the member map. */
     private static dropEntry;
+    /** Replaces the entries of the member map with `entries`, in their order. */
+    private static restoreEntries;
     private static isValidFields;
     /**
      * Builds a group from plain data, so that its `fullValue` is `data`: a plain object becomes a `Group`, an array a
@@ -1727,7 +1761,7 @@ declare class InAllowedValues<T = any> extends Validator {
 /**
  * Installs `plugin` for every element, including the ones already built: a hook runs on the next write. A plugin
  * installed twice runs twice. Returns a function that uninstalls it; values stored while it was installed are kept
- * as they are.
+ * as they are. Where `setup` throws, the plugin is not installed and the exception is rethrown.
  */
 export declare function installPlugin(plugin: Plugin_2): () => void;
 
@@ -2248,7 +2282,7 @@ declare class Transaction {
     /**
      * Registers work that runs after the transaction commits, and not at all if it is rolled back. An operation uses
      * it to defer a step that cannot be undone (for example, cancelling work in flight) until its change is
-     * committed.
+     * committed. The work runs after the transaction is closed, so a write it makes opens a transaction of its own.
      */
     whenCommitted(work: () => void): void;
     /**
@@ -2273,6 +2307,12 @@ declare class Transaction {
      * is dirty.
      */
     commit(): void;
+    /**
+     * Runs the work registered with whenCommitted, then the `onCommit` hooks. It is called after the transaction is
+     * closed, so a write made here opens a transaction of its own and is announced, and an exception does not roll
+     * back the committed change. Every step runs; the first exception thrown is rethrown after the last one.
+     */
+    settle(): void;
     /**
      * The dirty participants a pass visits, one bucket per nesting depth; within a depth they keep enrolment order.
      * A nesting depth is a small integer, so bucketing replaces a comparison sort: a whole-list assignment enrols one
@@ -2356,9 +2396,6 @@ declare interface TxStructuralEvent {
     index: number;
 }
 
-/** Key of the `FieldBase` getter for the generation counter of its validators; the package does not export it. */
-declare const ValidationEpoch: unique symbol;
-
 /**
  * An error on an element. It is data: the library does not render it. A renderer chooses the text for `code` and
  * `params` and falls back to `detail`.
@@ -2369,8 +2406,8 @@ export declare class ValidationError implements ErrorDescription {
     readonly detail: string;
     private readonly statedOrigin?;
     /**
-     * @param code Machine-readable identifier of what failed, in snake_case.
-     * @param params The values of the failure, such as `minValue` for `min_value`.
+     * @param code Machine-readable identifier of what failed, `<namespace>.<code>`. Stored as given.
+     * @param params The values of the failure, such as `minValue` for `vue-forms.min_value`.
      * @param detail The failure in English, plain text. Stored as given.
      * @param statedOrigin The origin of the error, if its author sets it; see `origin`.
      */
@@ -2394,11 +2431,14 @@ export declare class ValidationError implements ErrorDescription {
  * renderer has a text for that code.
  */
 declare type ValidationErrorOptions = {
-    /** The error's `code`. Defaults to the validator's own, such as `required`. */
+    /**
+     * The error's `code`, used as given. Defaults to the validator's own, such as `vue-forms.required`. The
+     * application prefixes its own codes with a namespace of its own.
+     */
     code?: string;
     detail?: never;
 } | {
-    /** The error's `code`. */
+    /** The error's `code`, used as given. */
     code: string;
     /** The error's English `detail`, plain text. `{name}` placeholders are replaced with the error's `params`. */
     detail?: string;
@@ -2440,13 +2480,15 @@ declare class Validator<T = any> extends ValueChangedAction {
      * remaining validators. Otherwise the field would stay invalid on an error no validator removes.
      *
      * A run in flight over the field is cancelled when the removal is committed, not earlier: a rollback restores the
-     * validator and its epoch, and the run, still active, then applies its result. Cancelling at the removal would
-     * leave the field valid over an unchecked value after a rollback.
+     * validator, and the run, still active, then applies its result. Cancelling at the removal would leave the field
+     * valid over an unchecked value after a rollback. A run started after the removal, by registering the validator
+     * again in the same transaction, is not cancelled.
      */
     unregisterFrom(field: FieldBase): void;
     /**
-     * Cancels the asynchronous run in flight over `field`, if any. It is called after the validator is removed from
-     * the field: the field's validation epoch has changed, so the run's result is discarded and its signal aborts.
+     * Cancels the asynchronous run in flight over `field`, if any. It is called once the validator's removal from the
+     * field is committed: the run number advances, so the run's result is discarded and its signal aborts. The other
+     * validators of the field keep their runs.
      */
     protected abandonRun(field: FieldBase): void;
     /**
@@ -2463,7 +2505,8 @@ declare class Validator<T = any> extends ValueChangedAction {
     protected newBindingState(): ValidatorBindingState;
     /**
      * Returns the error a built-in validator reports: `code` and `detail` from `options` if set, the validator's own
-     * otherwise, with `params` substituted into the detail.
+     * otherwise, with `params` substituted into the detail. Both codes are used as given: a built-in validator passes
+     * its own code as `vue-forms.<code>`, and a subclass of the application passes a code in a namespace of its own.
      */
     protected errorFor(options: ValidationErrorOptions | undefined, code: string, detail: string, params: Record<string, unknown>): ValidationError;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dynamicforms/vue-forms",
   "private": false,
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.3",
   "type": "module",
   "sideEffects": false,
   "description": "Reactive forms and application state for Vue.js: validation, rules between fields, transactions and lists. UI-agnostic and TypeScript-first.",
@@ -28,8 +28,7 @@
     "build": "vite build",
     "prepack": "npm run build",
     "test": "vitest run --coverage",
-    "lint": "eslint src --fix && vue-tsc --noEmit",
-    "lint:ci": "eslint src && vue-tsc --noEmit",
+    "lint": "node scripts/lint.mjs",
     "docs:dev": "npm run docs:dev -w docs",
     "docs:build": "npm run docs:build -w docs",
     "docs:preview": "npm run docs:preview -w docs"
@@ -77,6 +76,7 @@
     "@vue/test-utils": "^2.2.4",
     "@vue/tsconfig": "^0.7.0",
     "baseline-browser-mapping": "^2.8.31",
+    "esbuild": "^0.28.2",
     "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-config-velis": "^3.0.0",
@@ -86,6 +86,7 @@
     "eslint-plugin-unicorn": "^73.0.0",
     "eslint-plugin-vue": "^10.10.0",
     "jsdom": "^26.0.0",
+    "markdownlint-cli2": "^0.18.1",
     "prettier": "^3.9.6",
     "rollup-plugin-visualizer": "^5.14.0",
     "typescript": "^5",

package/readme.md

@@ -60,7 +60,8 @@ npm install @dynamicforms/vue-forms
 ```
 
 The package is ESM-only and requires Node 22 or newer. A CommonJS consumer reaches it through `require()` of an ES
-module, which Node supports without a flag from 22.12; on 22.0–22.11 it needs `--experimental-require-module`. Type definitions ship with the build. The package ships no components and no styles.
+module, which Node supports without a flag from 22.12; on 22.0–22.11 it needs `--experimental-require-module`. Type
+definitions ship with the build. The package ships no components and no styles.
 
 ## Basic Usage Example
 
@@ -185,7 +186,7 @@ import { Field, Group, Validators } from '@dynamicforms/vue-forms';
 const validatedForm = new Group({
   // Required field
   username: new Field({ 
-    validators: [new Validators.Required({ code: 'username_required', detail: 'Username is required' })] 
+    validators: [new Validators.Required({ code: 'app.username_required', detail: 'Username is required' })] 
   }),
   
   // Email validation with pattern
@@ -193,7 +194,7 @@ const validatedForm = new Group({
     validators: [
       new Validators.Pattern(
         /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
-        { code: 'invalid_email', detail: 'Please enter a valid email address' }
+        { code: 'app.invalid_email', detail: 'Please enter a valid email address' }
       )
     ] 
   }),
@@ -202,7 +203,7 @@ const validatedForm = new Group({
   age: new Field({ 
     value: 25, 
     validators: [
-      new Validators.ValueInRange(18, 100, { code: 'age_range', detail: 'Age must be between {minValue} and {maxValue}' })
+      new Validators.ValueInRange(18, 100, { code: 'app.age_range', detail: 'Age must be between {minValue} and {maxValue}' })
     ] 
   }),
   
@@ -216,7 +217,7 @@ const validatedForm = new Group({
   // Text length validation
   bio: new Field({
     validators: [
-      new Validators.LengthInRange(10, 200, { code: 'bio_length', detail: 'Bio must be between 10 and 200 characters' })
+      new Validators.LengthInRange(10, 200, { code: 'app.bio_length', detail: 'Bio must be between 10 and 200 characters' })
     ]
   })
 });
@@ -227,10 +228,12 @@ invalid immediately. `field.touched` determines when the UI shows the errors. `R
 measuring it, so a value of only spaces counts as empty; `new Validators.Required({ trim: false })` keeps spaces as
 part of the value.
 
-An error is data: a `code` (`required`, `pattern`, `min_length`, …), the `params` it failed with, and an English
-`detail`. The library does not render it. The application, or a UI library such as `@dynamicforms/vuetify-inputs`,
-converts it into text, translated by its code. A validator's last argument, `{ code, detail }`, replaces the
-validator's default code and English detail.
+An error is data: a `code` (`vue-forms.required`, `vue-forms.pattern`, `vue-forms.min_length`, …), the `params` it
+failed with, and an English `detail`. A code is `<namespace>.<code>`; the library's namespace is `vue-forms`,
+exported as `ERROR_NAMESPACE`. The library does not render an error. The application, or a UI library such as
+`@dynamicforms/vuetify-inputs`, converts it into text, translated by its code. A validator's last argument,
+`{ code, detail }`, replaces the validator's default code and English detail; the library uses that code as given,
+and the application prefixes its own codes with a namespace of its own.
 
 A validation function may return a `Promise`; `field.validating` is `true` while it runs, and only the newest run
 determines the result. [Asynchronous validation](https://docs.velis.si/dynamicforms/vue-forms/api/validators#asynchronous-validation)

package/dist/chunks/registry-_vVZW3p9.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry-_vVZW3p9.js","names":[],"sources":["../../src/plugins/devtools/registry.ts"],"sourcesContent":["import { type ComponentInternalInstance, getCurrentInstance, getCurrentScope, onScopeDispose } from 'vue';\n\nimport type { FieldBase } from '../../field-base';\nimport type { PluginContext } from '../../plugins';\n\n/** Which elements the devtools list: every root element except the hidden ones, or only the described ones. */\nexport type DevtoolsRegistration = 'opt-out' | 'opt-in';\n\n/** What an application states about an element for the devtools. */\nexport interface StateDescription {\n  /** The name the devtools show; defaults to the element's class and a number. */\n  name?: string;\n  /** The file the element is defined in; defaults to the file of the code that constructed it. */\n  file?: string;\n}\n\n/** What the registry knows about one element. */\nexport interface Entry {\n  id: string;\n  element: WeakRef<FieldBase>;\n  /** the stack at construction; its text is built on the first read, when the devtools show the entry */\n  created?: Error;\n  /** the component whose setup constructed the element */\n  instance?: WeakRef<ComponentInternalInstance>;\n  description: StateDescription;\n  hidden: boolean;\n  described: boolean;\n}\n\nconst entries = new Map<string, Entry>();\nconst byElement = new WeakMap<FieldBase, Entry>();\nlet nextId = 1;\nlet registration: DevtoolsRegistration = 'opt-out';\nlet enabled = true;\nlet changed: (() => void) | undefined;\nlet context: PluginContext | undefined;\n\n/** Records the context the devtools plugin received; it tells a binding or an item template from a root. */\nexport function useContext(installed: PluginContext): void {\n  context = installed;\n}\n\n/** Called by the devtools plugin; runs after a change the devtools show. */\nexport function onRegistryChanged(listener: () => void): void {\n  changed = listener;\n}\n\n/**\n * Records an element at construction: the component that constructs it and, where `location` is true, the stack\n * that leads to it.\n */\nexport function noteElement(element: FieldBase, location: boolean): void {\n  let created: Error | undefined;\n  if (location) {\n    const limit = Error.stackTraceLimit;\n    Error.stackTraceLimit = 20;\n    created = new Error();\n    Error.stackTraceLimit = limit;\n  }\n  const instance = getCurrentInstance();\n  const entry: Entry = {\n    id: String(nextId++),\n    element: new WeakRef(element),\n    created,\n    instance: instance ? new WeakRef(instance) : undefined,\n    description: {},\n    hidden: false,\n    described: false,\n  };\n  entries.set(entry.id, entry);\n  byElement.set(element, entry);\n  // state a component constructs is listed while the component is mounted: an element is collected only when the\n  // garbage collector runs, which can be long after the component was unmounted\n  if (instance && getCurrentScope()) {\n    onScopeDispose(() => {\n      entries.delete(entry.id);\n      changed?.();\n    });\n  }\n}\n\nexport function describe(element: FieldBase, description: StateDescription): void {\n  const entry = byElement.get(element);\n  if (!entry) return;\n  entry.description = { ...entry.description, ...description };\n  entry.described = true;\n  entry.hidden = false;\n  // an element its component handed on before unmounting is listed again, as global state\n  if (!entries.has(entry.id)) {\n    entry.instance = undefined;\n    entries.set(entry.id, entry);\n  }\n  changed?.();\n}\n\n/**\n * Drops the stack captured for an element a container took: a member is shown inside its container, and its own\n * file is shown again only if the container releases it.\n */\nexport function forgetLocation(element: FieldBase): void {\n  const entry = byElement.get(element);\n  if (entry) entry.created = undefined;\n}\n\nexport function setHidden(element: FieldBase, hidden: boolean): void {\n  const entry = byElement.get(element);\n  if (!entry) return;\n  entry.hidden = hidden;\n  changed?.();\n}\n\nexport function setRegistration(mode: DevtoolsRegistration): void {\n  registration = mode;\n  changed?.();\n}\n\n/** Lists nothing while `on` is false. */\nexport function setEnabled(on: boolean): void {\n  enabled = on;\n  changed?.();\n}\n\n/** Reports a committed change. */\nexport function noteChange(): void {\n  changed?.();\n}\n\n/** The entry of an element, where it has one. */\nexport function entryOf(element: FieldBase): Entry | undefined {\n  return byElement.get(element);\n}\n\nexport function entryById(id: string): Entry | undefined {\n  return entries.get(id);\n}\n\n/**\n * The listed elements: alive, not held by a container, not a binding or an item template, not hidden, and in\n * opt-in mode described. Entries whose element was collected are dropped here. Nothing is listed while the devtools\n * are turned off.\n */\nexport function listed(): { entry: Entry; element: FieldBase }[] {\n  const out: { entry: Entry; element: FieldBase }[] = [];\n  if (!enabled) return out;\n  entries.forEach((entry, id) => {\n    const element = entry.element.deref();\n    if (!element) {\n      entries.delete(id);\n      return;\n    }\n    if (entry.hidden || element.parent || context?.isInternal(element)) return;\n    if (registration === 'opt-in' && !entry.described) return;\n    out.push({ entry, element });\n  });\n  return out;\n}\n\n/**\n * The path prefix of the library's own files: `…/src/` where the source is served, or `…/dist/` where the build is.\n * Frames from it are skipped when the caller's file is looked up.\n */\nfunction libraryPrefix(): string {\n  // the first frame of a stack taken here is this module, served from the library's source or from a chunk of its\n  // build, which lives in dist/ beside the entry files\n  const own = /(?:https?:\\/\\/[^/\\s]+|file:\\/\\/)?(\\/[^\\s?):]+\\.[cm]?[jt]s)/.exec(new Error().stack ?? '')?.[1] ?? '';\n  if (own.includes('/src/plugins/devtools/')) return own.slice(0, own.indexOf('/src/') + 5);\n  if (own.includes('/dist/')) return own.slice(0, own.lastIndexOf('/dist/') + 6);\n  return own;\n}\n\n/** A frame of a stack: the function, where the stack names one, and the file, line and column. */\nexport interface StackFrame {\n  name?: string;\n  /** a path relative to the served root: Vite serves a project file at `/src/…` */\n  file: string;\n  line: number;\n  column: number;\n}\n\n// a Chrome frame is `    at name (url:line:column)` or `    at url:line:column`; a Firefox and a Safari frame is\n// `name@url:line:column`\nconst chromeFrame = /^\\s*at (?:(.*?) \\()?(\\S+?):(\\d+):(\\d+)\\)?$/;\nconst firefoxFrame = /^(.*?)@(\\S+?):(\\d+):(\\d+)$/;\nconst framePath = /^(?:[a-z]+:\\/\\/[^/\\s]*)?(\\/[^\\s?]+\\.(?:[cm]?[jt]sx?|vue))(?:\\?\\S*)?$/;\n\n/**\n * The frames of `stack` outside the library and `node_modules`, outermost last. A frame without a URL of a script\n * or a `.vue` file is left out.\n */\nexport function callerFrames(stack: string | undefined, library = libraryPrefix()): StackFrame[] {\n  const frames: StackFrame[] = [];\n  for (const text of stack?.split('\\n') ?? []) {\n    const match = chromeFrame.exec(text) ?? firefoxFrame.exec(text);\n    const path = match && framePath.exec(match[2])?.[1];\n    if (!path || path.startsWith(library) || path.includes('/node_modules/')) continue;\n    frames.push({\n      name: match[1] || undefined,\n      file: path.replace(/^\\//, ''),\n      line: Number(match[3]),\n      column: Number(match[4]),\n    });\n  }\n  return frames;\n}\n\n/** The file of the first frame of `stack` outside the library and `node_modules`; undefined where there is none. */\nexport function callerFile(stack: string | undefined, library = libraryPrefix()): string | undefined {\n  return callerFrames(stack, library)[0]?.file;\n}\n\n/** The names of the components from the root of the app to `instance`, joined by ` > `. */\nexport function componentPath(instance: ComponentInternalInstance): string {\n  const names: string[] = [];\n  for (let at: ComponentInternalInstance | null = instance; at; at = at.parent) {\n    const type = at.type as { name?: string; __name?: string; __file?: string };\n    names.unshift(type.name ?? type.__name ?? type.__file?.split('/').pop() ?? 'Anonymous');\n  }\n  return names.join(' > ');\n}\n"],"mappings":"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"}