@boundaries/elements 1.1.2 → 2.0.0-beta.1

package/dist/index.d.ts

@@ -2,6 +2,23 @@
  * Type representing a micromatch pattern, which can be a string or an array of strings.
  */
 type MicromatchPattern = string | string[];
+/**
+ * Type representing a micromatch pattern supporting null values
+ */
+type MicromatchPatternNullable = string | null | (string | null)[];
+/**
+ * Configuration options for categorizing dependencies as external or local.
+ */
+type FlagAsExternalOptions = {
+    /** When true, non-relative dependencies whose path cannot be resolved are categorized as external (default: true) */
+    unresolvableAlias?: boolean;
+    /** When true, non-relative paths that include node_modules are categorized as external (default: true) */
+    inNodeModules?: boolean;
+    /** When true, dependencies whose resolved path is outside the configured root path are categorized as external (default: false) */
+    outsideRootPath?: boolean;
+    /** List of patterns (using micromatch syntax) that, when matching the source of the dependency, categorize it as external (default: []) */
+    customSourcePatterns?: string[];
+};
 /** Configuration options for the Config class */
 type ConfigOptions = {
     /** An array of path patterns to include when resolving elements. Defaults to all files if not specified */
@@ -15,15 +32,33 @@ type ConfigOptions = {
     legacyTemplates?: boolean;
     /** Whether to enable caching */
     cache?: boolean;
+    /** Configuration for categorizing dependencies as external or local */
+    flagAsExternal?: FlagAsExternalOptions;
+    /** Root path of the project, used for determining if dependencies are outside the project */
+    rootPath?: string;
+};
+type FlagAsExternalOptionsNormalized = {
+    /** When true, non-relative dependencies whose path cannot be resolved are categorized as external */
+    unresolvableAlias: boolean;
+    /** When true, non-relative paths that include node_modules are categorized as external */
+    inNodeModules: boolean;
+    /** When true, dependencies whose resolved path is outside the configured root path are categorized as external */
+    outsideRootPath: boolean;
+    /** List of patterns (using micromatch syntax) that, when matching the source of the dependency, categorize it as external */
+    customSourcePatterns: string[];
 };
-type ConfigOptionsNormalized = Omit<ConfigOptions, "legacyTemplates" | "cache"> & {
+type ConfigOptionsNormalized = Omit<ConfigOptions, "legacyTemplates" | "cache" | "flagAsExternal"> & {
     /** Whether to enable legacy template support */
     legacyTemplates: boolean;
     /** Cache configuration options */
     cache: boolean;
+    /** Configuration for categorizing dependencies as external or local */
+    flagAsExternal: FlagAsExternalOptionsNormalized;
+    /** Root path of the project, already normalized, and finishing with a slash, used for determining if dependencies are outside the project */
+    rootPath: string | undefined;
 };
 /** Options for descriptors */
-type DescriptorOptionsNormalized = Pick<ConfigOptionsNormalized, "includePaths" | "ignorePaths" | "cache">;
+type DescriptorOptionsNormalized = Pick<ConfigOptionsNormalized, "includePaths" | "ignorePaths" | "cache" | "flagAsExternal" | "rootPath">;
 /** Options for element matchers */
 type MatchersOptionsNormalized = Pick<ConfigOptionsNormalized, "legacyTemplates">;
 
@@ -119,14 +154,17 @@ type ElementDescriptor = ElementDescriptorWithType | ElementDescriptorWithCatego
  * Array of element descriptors.
  */
 type ElementDescriptors = ElementDescriptor[];
+type ElementDescriptionWithSource = ElementDescription & {
+    module?: string | null;
+};
 /**
  * Serialized cache of element descriptions.
  */
-type DescriptionsSerializedCache = Record<string, ElementDescription>;
+type DescriptionsSerializedCache = Record<string, ElementDescription | ElementDescriptionWithSource>;
 /**
  * Serialized cache of file elements.
  */
-type FileElementsSerializedCache = Record<string, FileElement>;
+type FileElementsSerializedCache = Record<string, ElementDescription>;
 /**
  * Serialized cache for ElementsDescriptor class.
  */
@@ -158,17 +196,13 @@ type ElementOrigin = (typeof ELEMENT_ORIGINS_MAP)[keyof typeof ELEMENT_ORIGINS_M
 /**
  * Base element properties related to captured values
  */
-type BaseElement = {
+type BaseElementDescription = {
     /** Absolute path of the file. It might be null when a dependency path can't be resolved */
     path: string | null;
     /** Path of the file relative to the element, or null if the element is ignored or unknown */
     elementPath: string | null;
     /** Internal path of the file relative to the elementPath, or null if the element is ignored or unknown */
     internalPath: string | null;
-    /** Source of the element when it is a dependency, or null if the element is not a dependency, or it is ignored or unknown */
-    source: string | null;
-    /** Base source of the element when it is an external or core dependency, null otherwise */
-    baseSource: string | null;
     /** Type of the element, or null if the element is ignored or unknown */
     type: string | null;
     /** Category of the element, or null if the element is ignored or unknown */
@@ -200,7 +234,7 @@ type ElementParent = {
 /**
  * Description of an ignored element
  */
-type IgnoredElement = BaseElement & {
+type IgnoredElement = BaseElementDescription & {
     /** Type of the element */
     type: null;
     /** Category of the element */
@@ -217,7 +251,7 @@ type IgnoredElement = BaseElement & {
 /**
  * Description of an unknown local element
  */
-type LocalElementUnknown = BaseElement & {
+type LocalElementUnknown = BaseElementDescription & {
     /** Type of the element */
     type: null;
     /** Category of the element */
@@ -234,7 +268,7 @@ type LocalElementUnknown = BaseElement & {
 /**
  * Description of a local element (file)
  */
-type LocalElementKnown = BaseElement & {
+type LocalElementKnown = BaseElementDescription & {
     /** Path of the element */
     path: string;
     /** Captured values from the parent element */
@@ -253,65 +287,23 @@ type LocalElementKnown = BaseElement & {
     isUnknown: false;
 };
 /**
- * Base description of a dependency
- */
-type BaseDependencyElement = BaseElement & {
-    /** Dependency source */
-    source: string;
-    /** Indicates that dependencies are not ignored */
-    isIgnored: false;
-};
-/**
- * Description of a local dependency (known)
+ * Description of an unknown external element.
  */
-type LocalDependencyElementKnown = LocalElementKnown & BaseDependencyElement;
-/**
- * Description of a local dependency (unknown)
- */
-type LocalDependencyElementUnknown = LocalElementUnknown & BaseDependencyElement;
-/**
- * Description of a local dependency
- */
-type LocalDependencyElement = LocalDependencyElementKnown | LocalDependencyElementUnknown;
-/**
- * Description of an external dependency
- */
-type ExternalDependencyElement = BaseDependencyElement & {
-    /** Path of the dependency relative to the base module */
-    internalPath: string;
-    /** Base module of the external dependency */
-    baseSource: string;
-    /** Indicates that the dependency is external */
+type ExternalElementDescription = BaseElementDescription & {
     origin: typeof ELEMENT_ORIGINS_MAP.EXTERNAL;
+    isIgnored: false;
 };
 /**
- * Description of a core dependency
+ * Description of an unknown core element.
  */
-type CoreDependencyElement = BaseDependencyElement & {
-    /** Base module of the core dependency */
-    baseSource: string;
-    /** Indicates that the dependency is core */
+type CoreElementDescription = BaseElementDescription & {
     origin: typeof ELEMENT_ORIGINS_MAP.CORE;
+    isIgnored: false;
 };
-/**
- * Description of an ignored dependency element
- */
-type IgnoredDependencyElement = IgnoredElement & {
-    /** The source of the dependency */
-    source: string;
-};
-/**
- * Description of a file
- */
-type FileElement = IgnoredElement | LocalElementKnown | LocalElementUnknown;
-/**
- * Description of a dependency
- */
-type DependencyElementDescription = IgnoredDependencyElement | CoreDependencyElement | LocalDependencyElement | ExternalDependencyElement;
 /**
  * Description of an element, either local or dependency
  */
-type ElementDescription = FileElement | DependencyElementDescription;
+type ElementDescription = LocalElementKnown | LocalElementUnknown | IgnoredElement | ExternalElementDescription | CoreElementDescription;
 
 /**
  * Determines if the given value is a valid element descriptor mode.
@@ -354,7 +346,7 @@ declare function isElementDescriptor(value: unknown): value is ElementDescriptor
  * @param value The value to check
  * @returns True if the value is a valid BaseElement, false otherwise
  */
-declare function isBaseElement(value: unknown): value is BaseElement;
+declare function isBaseElement(value: unknown): value is BaseElementDescription;
 /**
  * Determines if the given value is an ignored element.
  * @param value The element to check.
@@ -379,36 +371,30 @@ declare function isUnknownLocalElement(value: unknown): value is LocalElementUnk
  * @returns True if the element is an unknown element, false otherwise.
  */
 declare function isKnownLocalElement(value: unknown): value is LocalElementKnown;
-/**
- * Determines if the given value is a dependency element.
- * @param value The element to check.
- * @returns True if the element is a dependency element, false otherwise.
- */
-declare function isDependencyElementDescription(value: unknown): value is DependencyElementDescription;
-/**
- * Determines if the given value is an element (local or dependency).
- * @param value The value to check.
- * @returns True if the value is an element, false otherwise.
- */
-declare function isElementDescription(value: unknown): value is ElementDescription;
 /**
  * Determines if the given value is a local dependency element.
  * @param value The value to check.
  * @returns True if the element is a local dependency element, false otherwise.
  */
-declare function isLocalDependencyElement(value: unknown): value is LocalDependencyElement;
+declare function isLocalDependencyElement(value: unknown): value is LocalElementKnown | LocalElementUnknown;
 /**
  * Determines if the given value is an external element.
  * @param value The value to check.
  * @returns True if the element is an external dependency element, false otherwise.
  */
-declare function isExternalDependencyElement(value: unknown): value is ExternalDependencyElement;
+declare function isExternalDependencyElement(value: unknown): value is ElementDescription;
 /**
  * Determines if the given value is a core element.
  * @param value The value to check.
  * @returns True if the element is a core dependency element, false otherwise.
  */
-declare function isCoreDependencyElement(value: unknown): value is CoreDependencyElement;
+declare function isCoreDependencyElement(value: unknown): value is ElementDescription;
+/**
+ * Determines if the given value is an element (local or dependency).
+ * @param value The value to check.
+ * @returns True if the value is an element, false otherwise.
+ */
+declare function isElementDescription(value: unknown): value is ElementDescription;
 
 declare const DEPENDENCY_KIND_TYPE: "type";
 declare const DEPENDENCY_KIND_VALUE: "value";
@@ -457,6 +443,10 @@ declare const DEPENDENCY_RELATIONSHIPS_INVERTED_MAP: {
 type DependencyRelationship = (typeof DEPENDENCY_RELATIONSHIPS_MAP)[keyof typeof DEPENDENCY_RELATIONSHIPS_MAP];
 /** Information about a dependency between two elements */
 type ElementsDependencyInfo = {
+    /** Source of the dependency (import/export path) */
+    source: string;
+    /** Base source of the dependency for external/core modules */
+    module: string | null;
     /** Kind of the dependency */
     kind: DependencyKind;
     /** Type of the node creating the dependency in the dependent element */
@@ -476,9 +466,9 @@ type ElementsDependencyInfo = {
  */
 type DependencyDescription = {
     /** Source element of the dependency */
-    from: FileElement;
+    from: ElementDescription;
     /** Target element of the dependency */
-    to: DependencyElementDescription;
+    to: ElementDescription;
     /** Information about the dependency */
     dependency: ElementsDependencyInfo;
 };
@@ -554,16 +544,18 @@ type DescriptorsSerializedCache = {
  */
 type DependencyMatchResult = {
     /** The selector matching result for the 'from' element. */
-    from: ElementSelectorData | null;
+    from: BaseElementSelectorData | null;
     /** The selector matching result for the 'to' element. */
-    to: ElementSelectorData | null;
+    to: BaseElementSelectorData | null;
+    /** The selector matching result for the dependency metadata. */
+    dependency: DependencyDataSelectorData | null;
     /** Whether the dependency matches all the selector properties provided */
     isMatch: boolean;
 };
 /**
  * Serialized cache of elements matcher.
  */
-type ElementsMatcherSerializedCache = Record<string, ElementSelectorData | null>;
+type ElementsMatcherSerializedCache = Record<string, BaseElementSelectorData | null>;
 /**
  * Serialized cache of dependencies matcher.
  */
@@ -584,34 +576,36 @@ type MicromatchSerializedCache = {
 /**
  * Elements that can return a match when using an element selector.
  */
-type SelectableElement = IgnoredElement | LocalElementKnown | LocalElementUnknown | CoreDependencyElement | ExternalDependencyElement | LocalDependencyElementKnown;
+type SelectableElement = ElementDescription;
 /**
  * Selector for matching captured values in element selectors.
  * It is a record where the keys are the names of the captured values and the values are the patterns to match on those captured values.
+ * When provided as an array, each element in the array represents an alternative (OR logic) - the selector matches if any of the array elements matches.
  */
-type CapturedValuesSelector = Record<string, MicromatchPattern>;
+type CapturedValuesSelector = Record<string, MicromatchPatternNullable> | Array<Record<string, MicromatchPatternNullable>>;
 /**
- * Data to pass to selector templates when they are rendered before matching.
+ * Selector for matching the first parent element.
  */
-type TemplateData = Record<string, unknown>;
+type ParentElementSelectorData = {
+    /** Type of the first parent element */
+    type?: MicromatchPatternNullable;
+    /** Category of the first parent element */
+    category?: MicromatchPatternNullable;
+    /** Path of the first parent element */
+    elementPath?: MicromatchPatternNullable;
+    /** Captured values from the first parent element */
+    captured?: CapturedValuesSelector;
+};
 /**
- * Options for elements and dependencies matchers.
+ * Data to pass to selector templates when they are rendered before matching.
  */
-type MatcherOptionsDependencySelectorsGlobals = {
-    /** The kind of the dependency */
-    kind?: MicromatchPattern;
-};
+type TemplateData = Record<string, unknown>;
 /**
  * Options for elements and dependencies matchers.
  */
 type MatcherOptions = {
     /** Extra data to pass to captured values templates. By default, data from the element and dependency being matched is passed as to/from. */
     extraTemplateData?: TemplateData;
-    /**
-     * Properties to add to all dependency selectors used in the matcher. Added for backwards compatibility, because eslint-plugin rules defined importKind at the top level of the rule options.
-     * @deprecated Use 'kind' property directly in the dependency element selectors instead.
-     **/
-    dependencySelectorsGlobals?: MatcherOptionsDependencySelectorsGlobals;
 };
 /**
  * Simple element selector by type, represented as a string matching the element type.
@@ -623,40 +617,47 @@ type SimpleElementSelectorByType = string;
  */
 type BaseElementSelectorData = {
     /** Micromatch pattern(s) to match the path of the element */
-    path?: MicromatchPattern;
+    path?: MicromatchPatternNullable;
     /** Micromatch pattern(s) to match the path of the element containing the file */
-    elementPath?: MicromatchPattern;
+    elementPath?: MicromatchPatternNullable;
     /** Micromatch pattern(s) to match internal paths within the file or dependency, relative to the element path */
-    internalPath?: MicromatchPattern;
+    internalPath?: MicromatchPatternNullable;
     /** Type of the element */
-    type?: MicromatchPattern;
+    type?: MicromatchPatternNullable;
     /** Category of the element */
-    category?: MicromatchPattern;
+    category?: MicromatchPatternNullable;
     /** Captured values selector for dynamic matching */
     captured?: CapturedValuesSelector;
+    /** Selector for matching the first parent element */
+    parent?: ParentElementSelectorData | null;
     /** Origin of the element */
-    origin?: MicromatchPattern;
-    /** Micromatch pattern(s) to match the source of the dependency */
-    source?: MicromatchPattern;
-    /** Base source of the element, e.g., the import path of a dependency */
-    baseSource?: MicromatchPattern;
+    origin?: MicromatchPatternNullable;
     /** Whether the element is ignored */
     isIgnored?: boolean;
     /** Whether the element is unknown */
     isUnknown?: boolean;
 };
 /**
- * Selector for dependency elements, including kind, specifier, and node kind filters.
+ * Selector for dependency metadata.
  */
-type DependencyElementSelectorData = BaseElementSelectorData & {
-    /** Relationship of the file element with the dependency declared in it */
-    relationship?: MicromatchPattern;
+type DependencyDataSelectorData = {
+    /** Relationship between both elements, from both perspectives */
+    relationship?: {
+        /** Relationship from dependant element perspective */
+        from?: MicromatchPatternNullable;
+        /** Relationship from dependency element perspective */
+        to?: MicromatchPatternNullable;
+    };
     /** Dependency kind to filter elements */
-    kind?: MicromatchPattern;
+    kind?: MicromatchPatternNullable;
     /** Micromatch pattern(s) to match only specific imports/exports */
-    specifiers?: MicromatchPattern;
+    specifiers?: MicromatchPatternNullable;
     /** Node kind to filter elements */
-    nodeKind?: MicromatchPattern;
+    nodeKind?: MicromatchPatternNullable;
+    /** Dependency source used in import/export statements */
+    source?: MicromatchPatternNullable;
+    /** Base source of the dependency for external/core modules */
+    module?: MicromatchPatternNullable;
 };
 /**
  * File Element selector with options, including captured values for dynamic matching.
@@ -668,32 +669,16 @@ type BaseElementSelectorWithOptions = [
     SimpleElementSelectorByType,
     CapturedValuesSelector
 ];
-/**
- * Dependency Element selector with options, including captured values for dynamic matching.
- * It is represented as a tuple where the first element is the element type (string)
- * and the second element is an object containing a selector for captured values.
- * @deprecated Use DependencyElementSelectorData defining an object with type and/or category and the rest of properties directly instead.
- */
-type DependencyElementSelectorWithOptions = [
-    SimpleElementSelectorByType,
-    CapturedValuesSelector
-];
 /**
  * Base Element selector, which can be a simple string, object with type and/or category, or a base element selector with options.
  */
 type BaseElementSelector = SimpleElementSelectorByType | BaseElementSelectorData | BaseElementSelectorWithOptions;
 /**
- * Dependency Element selector, which can be a simple string, object with type and/or category, or a dependency element selector with options.
+ * Base elements selector, which can be a single base element selector or an array of base element selectors.
  */
-type DependencyElementSelector = SimpleElementSelectorByType | DependencyElementSelectorData | DependencyElementSelectorWithOptions;
-/** Base elements selector, which can be a single base element selector or an array of base element selectors. */
 type BaseElementsSelector = BaseElementSelector | BaseElementSelector[];
-/** Dependency elements selector, which can be a single dependency element selector or an array of dependency element selectors. */
-type DependencyElementsSelector = DependencyElementSelector | DependencyElementSelector[];
-/**
- * Element selector data, which may be a base element selector or a dependency element selector.
- */
-type ElementSelectorData = BaseElementSelectorData | DependencyElementSelectorData;
+/** Dependency metadata selector, which can be a single selector or an array of selectors. */
+type DependencyDataSelector = DependencyDataSelectorData | DependencyDataSelectorData[];
 /**
  * Generic Element selector with options, including captured values for dynamic matching.
  * It is represented as a tuple where the first element is the element type (string)
@@ -707,11 +692,11 @@ type ElementSelectorWithOptions = [
 /**
  * Element selector, which can be a simple string, object with type and/or category, or an element selector with options.
  */
-type ElementSelector = SimpleElementSelectorByType | ElementSelectorData | ElementSelectorWithOptions;
+type ElementSelector = SimpleElementSelectorByType | BaseElementSelectorData | ElementSelectorWithOptions;
 /**
  * Elements selector, which can be a single element selector or an array of element selectors.
  */
-type ElementsSelector = BaseElementsSelector | DependencyElementsSelector;
+type ElementsSelector = BaseElementsSelector;
 /**
  * Element selectors, which can be a single element selector or an array of element selectors.
  * @deprecated Use ElementsSelector instead.
@@ -724,7 +709,9 @@ type DependencySelector = {
     /** Selector for the dependant elements. The file originating the dependency */
     from?: BaseElementsSelector;
     /** Selector for the dependency elements. The element being imported/exported */
-    to?: DependencyElementsSelector;
+    to?: BaseElementsSelector;
+    /** Selector for dependency metadata */
+    dependency?: DependencyDataSelector;
 };
 /**
  * Normalized dependency selector, where 'from' and 'to' are always arrays or null.
@@ -733,40 +720,14 @@ type DependencySelectorNormalized = {
     /** Selector for the dependant elements. The file originating the dependency */
     from: BaseElementSelectorData[] | null;
     /** Selector for the dependency elements. The element being imported/exported */
-    to: DependencyElementSelectorData[] | null;
+    to: BaseElementSelectorData[] | null;
+    /** Selector for dependency metadata */
+    dependency: DependencyDataSelectorData[] | null;
 };
 /**
- * Options for selecting external libraries, including path patterns and optional specifiers.
- * If specifiers are provided, they will be used to match specific imports from the external library.
+ * @deprecated Use DependencySelectorDependencyData instead.
  */
-type ExternalLibrarySelectorOptions = {
-    /**
-     * Micromatch pattern(s) to match only one or more specific subpaths of the external library.
-     */
-    path?: MicromatchPattern;
-    /** Micromatch pattern(s) to match only specific imports/exports */
-    specifiers?: string[];
-};
-/**
- * External library selector with options, represented as a tuple where the first element is the import path of the external library, and the second element is an object containing options for selecting only specific paths or specifiers from that library.
- */
-type ExternalLibrarySelectorWithOptions = [
-    SimpleElementSelectorByType,
-    ExternalLibrarySelectorOptions
-];
-/**
- * External library selector, which can be a simple string (the import path) or an external library selector with options.
- */
-type ExternalLibrarySelector = SimpleElementSelectorByType | ExternalLibrarySelectorWithOptions;
-/**
- * External library selectors, which can be a single external library selector or an array of external library selectors.
- * @deprecated Use ExternalLibrariesSelector instead.
- */
-type ExternalLibrarySelectors = ExternalLibrariesSelector;
-/**
- * External libraries selector, which can be a single external library selector or an array of external library selectors.
- */
-type ExternalLibrariesSelector = ExternalLibrarySelector | ExternalLibrarySelector[];
+type DependencyElementSelectorData = DependencyDataSelectorData;
 
 /**
  * Micromatch wrapper class with caching capabilities.
@@ -825,13 +786,6 @@ declare class Micromatch {
     makeRe(pattern: string): RegExp;
 }
 
-/**
- * Normalizes an ElementsSelector into an array of ElementSelectorData.
- * @param elementsSelector The elements selector, in any supported format.
- * @returns The normalized array of selector data.
- */
-declare function normalizeElementsSelector(elementsSelector: BaseElementsSelector): BaseElementSelectorData[];
-declare function normalizeElementsSelector(elementsSelector: DependencyElementsSelector): DependencyElementSelectorData[];
 /**
  * Base matcher class to determine if elements or dependencies match a given selector.
  */
@@ -876,7 +830,13 @@ declare class BaseElementsMatcher {
      * @param extraTemplateData The data to use for replace in the templates.
      * @returns The rendered templates.
      */
-    protected getRenderedTemplates(template: MicromatchPattern, templateData: TemplateData): MicromatchPattern;
+    protected getRenderedTemplates(template: MicromatchPatternNullable, templateData: TemplateData): MicromatchPatternNullable;
+    /**
+     * Cleans a micromatch pattern by removing falsy values from arrays.
+     * @param pattern The micromatch pattern(s) to clean.
+     * @returns The cleaned pattern. If an array is provided, falsy entries are removed and the resulting array may be empty. If null is provided, null is returned unchanged.
+     */
+    protected cleanMicromatchPattern(pattern: MicromatchPatternNullable): string | string[] | null;
     /**
      * Returns whether the given value matches the micromatch pattern, converting non-string values to strings.
      * Optimized version with caching for better performance.
@@ -884,7 +844,7 @@ declare class BaseElementsMatcher {
      * @param pattern The micromatch pattern to match against.
      * @returns Whether the value matches the pattern.
      */
-    protected isMicromatchMatch(value: unknown, pattern: MicromatchPattern): boolean;
+    protected isMicromatchMatch(value: unknown, pattern: MicromatchPatternNullable): boolean;
     /**
      * Returns whether the given value matches the micromatch pattern after rendering it as a template.
      * @param pattern The micromatch pattern to render and match against.
@@ -892,13 +852,13 @@ declare class BaseElementsMatcher {
      * @param value The value to check.
      * @returns Whether the value matches the rendered pattern.
      */
-    protected isTemplateMicromatchMatch(pattern: MicromatchPattern, templateData: TemplateData, value?: unknown): boolean;
+    protected isTemplateMicromatchMatch(pattern: MicromatchPatternNullable, templateData: TemplateData, value?: unknown): boolean;
     /**
      * Whether the given element key matches the selector key as booleans.
      * @param param0 The parameters object.
      * @returns Whether the element key matches the selector key.
      */
-    protected isElementKeyBooleanMatch<T extends BaseElement, S extends BaseElementSelectorData>({ 
+    protected isElementKeyBooleanMatch<T extends BaseElementDescription, S extends BaseElementSelectorData>({ 
     /** The element to check. */
     element, 
     /** The selector to check against. */
@@ -921,17 +881,17 @@ declare class BaseElementsMatcher {
      * @param param0 The parameters object.
      * @returns Whether the element key matches the selector key.
      */
-    protected isElementKeyMicromatchMatch<T extends SelectableElement, S extends BaseElementSelectorData | DependencyElementSelectorData>({ element, selector, elementKey, selectorKey, selectorValue, templateData, }: {
+    protected isElementKeyMicromatchMatch<T extends SelectableElement, S extends BaseElementSelectorData>({ element, selector, elementKey, selectorKey, selectorValue, templateData, }: {
         /** The element to check. */
         element: T;
         /** The selector to check against. */
         selector: S;
         /** The key of the element to check. */
-        elementKey: T extends LocalElementKnown ? keyof LocalElementKnown : T extends CoreDependencyElement ? keyof CoreDependencyElement : T extends ExternalDependencyElement ? keyof ExternalDependencyElement : T extends IgnoredElement ? keyof IgnoredElement : keyof LocalDependencyElementKnown;
+        elementKey: keyof T;
         /** The key of the selector to check against. */
-        selectorKey: S extends DependencyElementSelectorData ? keyof DependencyElementSelectorData : keyof BaseElementSelectorData;
+        selectorKey: keyof BaseElementSelectorData;
         /** The value of the selector key to check against. */
-        selectorValue?: MicromatchPattern;
+        selectorValue?: MicromatchPatternNullable;
         /** Data to pass when the selector value is rendered as a template */
         templateData: TemplateData;
     }): boolean;
@@ -941,8 +901,6 @@ declare class BaseElementsMatcher {
  * Matcher class to determine if elements match a given selector.
  */
 declare class ElementsMatcher extends BaseElementsMatcher {
-    /** Whether the cache is enabled or not */
-    private readonly _cacheIsEnabled;
     /**
      * Creates a new ElementsSelectorMatcher.
      * @param config Configuration options for the matcher.
@@ -999,29 +957,38 @@ declare class ElementsMatcher extends BaseElementsMatcher {
      */
     private _isOriginMatch;
     /**
-     * Whether the given element baseSource matches the selector baseSource
-     * @param element The element to check.
-     * @param selector The selector to check against.
-     * @param templateData The data to use for replace in selector value
-     * @returns Whether the element baseSource matches the selector baseSource.
-     */
-    private _isBaseSourceMatch;
-    /**
-     * Whether the given element source matches the selector source
-     * @param element The element to check.
-     * @param selector The selector to check against.
-     * @param templateData The data to use for replace in selector value
-     * @returns Whether the element source matches the selector source.
+     * Checks if a single captured values object matches the element.
+     * @param capturedValues The captured values to check.
+     * @param capturedSelector The captured values selector object to check against
+     * @param templateData The data to use for replace in selector values
+     * @returns True if all captured values in the selector match those in the element, false otherwise.
      */
-    private _isSourceMatch;
+    private _checkCapturedValuesObject;
     /**
      * Determines if the captured values of the element match those in the selector.
+     * When the selector is an array, the element matches if it matches any of the array elements (OR logic).
      * @param element The element to check.
      * @param selector The selector to check against
      * @param templateData The data to use for replace in selector values
      * @returns True if the captured values match, false otherwise.
      */
     private _isCapturedValuesMatch;
+    /**
+     * Determines if the parent captured values match the selector.
+     * @param parentSelector The parent selector to match.
+     * @param parentCaptured The captured values from first parent.
+     * @param templateData The data to use for replace in selector values
+     * @returns True if the captured values match, false otherwise.
+     */
+    private _isParentCapturedValuesMatch;
+    /**
+     * Whether the given element first parent matches the selector parent.
+     * @param element The element to check.
+     * @param selector The selector to check against.
+     * @param templateData The data to use for replace in selector values
+     * @returns Whether the first parent matches the selector parent.
+     */
+    private _isParentMatch;
     /**
      * Determines if the isIgnored property of the element matches that in the selector.
      * @param element The element to check.
@@ -1049,16 +1016,16 @@ declare class ElementsMatcher extends BaseElementsMatcher {
      * It omits checks in keys applying only to dependency between elements, such as relationship.
      * @param element The element to check.
      * @param selector The selector to check against.
-     * @param options Extra options for matching, such as templates data, globals for dependency selectors, etc.
+     * @param options Extra options for matching, such as templates data, etc.
      * @returns The selector matching result for the given element, or null if none matches.
      */
-    getSelectorMatching(element: ElementDescription, selector: BaseElementsSelector, { extraTemplateData }?: MatcherOptions): ElementSelectorData | null;
+    getSelectorMatching(element: ElementDescription, selector: BaseElementsSelector, { extraTemplateData }?: MatcherOptions): BaseElementSelectorData | null;
     /**
      * Returns whether the given element matches the selector.
      * It omits checks in keys applying only to dependency between elements, such as relationship.
      * @param element The element to check.
      * @param selector The selector to check against.
-     * @param options Extra options for matching, such as templates data, globals for dependency selectors, etc.
+     * @param options Extra options for matching, such as templates data, etc.
      * @returns Whether the element matches the selector properties applying to elements.
      */
     isElementMatch(element: ElementDescription, selector: BaseElementsSelector, options?: MatcherOptions): boolean;
@@ -1086,12 +1053,6 @@ declare class DependenciesMatcher extends BaseElementsMatcher {
      * @returns The normalized dependency selector.
      */
     private _normalizeDependencySelector;
-    /**
-     * Converts a DependencyElementSelectorData to a BaseElementSelectorData, by removing dependency-specific properties.
-     * @param selector The dependency element selector data.
-     * @returns The base element selector data.
-     */
-    private _convertDependencyElementSelectorDataToBaseElementSelectorData;
     /**
      * Returns the selectors matching result for the given dependency.
      * @param dependency The dependency description.
@@ -1099,14 +1060,22 @@ declare class DependenciesMatcher extends BaseElementsMatcher {
      * @param extraTemplateData The extra template data for selector values.
      * @returns The selectors matching result for the given dependency.
      */
-    private _getSelectorMatching;
+    private _getSelectorsMatching;
     /**
      * Determines if the dependency relationship matches the selector.
      * @param dependency The dependency description.
      * @param selector The data of an element selector.
      * @returns Whether the dependency relationship matches the selector.
      */
-    private _relationshipMatches;
+    private _relationshipFromMatches;
+    /**
+     * Determines if the dependency origin relationship matches the selector.
+     * @param selector The dependency selector data.
+     * @param relationship The relationship from origin element to target element.
+     * @param templateData The template data for rendering selector values.
+     * @returns Whether the dependency origin relationship matches.
+     */
+    private _relationshipToMatches;
     /**
      * Determines if the selector matches an specific kind
      * @param selector The dependency selector data
@@ -1132,34 +1101,42 @@ declare class DependenciesMatcher extends BaseElementsMatcher {
      */
     private _nodeKindMatches;
     /**
-     * Determines if the dependency description matches the selector for 'from'.
+     * Determines if the dependency description matches the selector for 'to'.
      * @param dependency The dependency description.
-     * @param fromSelector The selector for 'from' elements.
+     * @param toSelector The selector for 'to' elements.
      * @param templateData The template data for rendering selector values
-     * @returns Whether the dependency properties match the selector for 'from'.
+     * @returns Whether the dependency properties match the selector for 'to'.
      */
-    private _dependencyFromPropertiesMatch;
+    private _sourceMatches;
     /**
-     * Determines if the dependency description matches the selector for 'to'.
+     * Determines if the selector matches the module
+     * @param selector The dependency selector data
+     * @param module The module to check
+     * @param templateData The template data for rendering selector values
+     * @returns Whether the selector matches the module
+     */
+    private _moduleMatches;
+    /**
+     * Determines if the dependency description matches the selector for dependency metadata.
      * @param dependency The dependency description.
-     * @param toSelector The selector for 'to' elements.
+     * @param selectorData The selector for dependency metadata.
      * @param templateData The template data for rendering selector values
-     * @returns Whether the dependency properties match the selector for 'to'.
+     * @returns Whether the dependency properties match the selector.
      */
-    private _dependencyToPropertiesMatch;
+    private _dependencyPropertiesMatch;
     /**
      * Returns the selectors matching result for the given dependency.
      * @param dependency The dependency to check.
      * @param selector The selector to check against.
-     * @param options Extra options for matching, such as templates data, globals for dependency selectors, etc.
+     * @param options Extra options for matching, such as templates data, etc.
      * @returns The matching result for the dependency against the selector.
      */
-    getSelectorsMatching(dependency: DependencyDescription, selector: DependencySelector, { extraTemplateData, dependencySelectorsGlobals, }?: MatcherOptions): DependencyMatchResult;
+    getSelectorsMatching(dependency: DependencyDescription, selector: DependencySelector, { extraTemplateData }?: MatcherOptions): DependencyMatchResult;
     /**
      * Returns whether the given dependency matches the selector.
      * @param dependency The dependency to check.
      * @param selector The selector to check against.
-     * @param options Extra options for matching, such as templates data, globals for dependency selectors, etc.
+     * @param options Extra options for matching, such as templates data, etc.
      * @returns Whether the dependency matches the selector properties.
      */
     isDependencyMatch(dependency: DependencyDescription, selector: DependencySelector, options?: MatcherOptions): boolean;
@@ -1182,13 +1159,13 @@ declare function isSimpleElementSelectorByType(value: unknown): value is SimpleE
  * @param value The value to check.
  * @returns True if the selector is a base element selector
  */
-declare function isBaseElementSelectorData(value: unknown): value is ElementSelectorData;
+declare function isBaseElementSelectorData(value: unknown): value is BaseElementSelectorData;
 /**
  * Determines if the given selector is an element or dependency element selector data.
  * @param value The value to check.
  * @returns True if the selector is an element or dependency element selector data, false otherwise.
  */
-declare function isElementSelectorData(value: unknown): value is ElementSelectorData;
+declare function isElementSelectorData(value: unknown): value is BaseElementSelectorData;
 /**
  * Determines if the given selector is an element selector with options.
  * @param value The value to check.
@@ -1208,51 +1185,35 @@ declare function isElementSelector(value: unknown): value is ElementSelector;
  */
 declare function isElementsSelector(value: unknown): value is ElementSelectors;
 /**
- * Determines if the given value is a dependency selector.
- * @param value The value to check
- * @returns True if the value is a dependency selector, false otherwise.
- */
-declare function isDependencySelector(value: unknown): value is DependencySelector;
-/**
- * Determines if the given value is external library selector options with a path.
- * @param value The value to check.
- * @returns True if the value is external library selector options with a path, false otherwise.
- */
-declare function isExternalLibrarySelectorOptionsWithPath(value: unknown): value is ExternalLibrarySelectorOptions & {
-    path: string | string[];
-};
-/**
- * Determines if the given value is external library selector options with specifiers.
- * @param value The value to check.
- * @returns True if the value is external library selector options with specifiers, false otherwise.
+ * Normalizes a selector into ElementSelectorData format.
+ * @param selector The selector to normalize.
+ * @returns The normalized selector data.
  */
-declare function isExternalLibrarySelectorOptionsWithSpecifiers(value: unknown): value is ExternalLibrarySelectorOptions & {
-    specifiers: string[];
-};
+declare function normalizeElementSelector(selector: BaseElementSelector): BaseElementSelectorData;
 /**
- * Determines if the given value is external library selector options.
- * @param value The value to check.
- * @returns True if the value is external library selector options, false otherwise.
+ * Normalizes an ElementsSelector into an array of ElementSelectorData.
+ * @param elementsSelector The elements selector, in any supported format.
+ * @returns The normalized array of selector data.
  */
-declare function isExternalLibrarySelectorOptions(value: unknown): value is ExternalLibrarySelectorOptions;
+declare function normalizeElementsSelector(elementsSelector: BaseElementsSelector): BaseElementSelectorData[];
 /**
- * Determines if the given value is an external library selector with options.
- * @param value The value to check.
- * @returns True if the value is an external library selector with options, false otherwise.
+ * Determines if the given value is a dependency selector.
+ * @param value The value to check
+ * @returns True if the value is a dependency selector, false otherwise.
  */
-declare function isExternalLibrarySelectorWithOptions(value: unknown): value is ExternalLibrarySelectorWithOptions;
+declare function isDependencySelector(value: unknown): value is DependencySelector;
 /**
- * Determines if the given value is an external library selector.
+ * Determines if the given value is dependency metadata selector data.
  * @param value The value to check.
- * @returns True if the value is an external library selector, false otherwise.
+ * @returns True if the value is dependency metadata selector data, false otherwise.
  */
-declare function isExternalLibrarySelector(value: unknown): value is ExternalLibrarySelector;
+declare function isDependencyDataSelectorData(value: unknown): value is DependencyDataSelectorData;
 /**
- * Determines if the given value is an external libraries selector.
+ * Determines if the given value is dependency metadata selector(s).
  * @param value The value to check.
- * @returns True if the value is an external libraries selector, false otherwise.
+ * @returns True if the value is dependency metadata selector(s), false otherwise.
  */
-declare function isExternalLibrariesSelector(value: unknown): value is ExternalLibrariesSelector;
+declare function isDependencyDataSelector(value: unknown): value is DependencyDataSelector;
 
 /**
  * Matcher class to evaluate if elements or dependencies match given selectors.
@@ -1270,6 +1231,18 @@ declare class Matcher {
      * @param globalCache Global cache instance.
      */
     constructor(descriptors: ElementDescriptors, elementsMatcher: ElementsMatcher, dependenciesMatcher: DependenciesMatcher, config: DescriptorOptionsNormalized, micromatch: Micromatch);
+    /**
+     * Describes an element given its file path.
+     * @param filePath The path of the file to describe.
+     * @returns The description of the element.
+     */
+    describeElement(filePath: string): ElementDescription;
+    /**
+     * Describes elements in a dependency relationship, and provides additional information about the dependency itself.
+     * @param options The options for describing the elements and the dependency details.
+     * @returns The description of the dependency between the elements.
+     */
+    describeDependency(options: DescribeDependencyOptions): DependencyDescription;
     /**
      * Determines if an element matches a given selector.
      * @param filePath The file path of the element
@@ -1277,7 +1250,7 @@ declare class Matcher {
      * @param options Extra matcher options
      * @returns True if the element matches the selector, false otherwise
      */
-    private _isElementMatch;
+    isElementMatch(filePath: string, selector: ElementsSelector, options?: MatcherOptions): boolean;
     /**
      * Determines if a dependency matches a given selector.
      * @param dependencyData The data describing the dependency
@@ -1285,15 +1258,7 @@ declare class Matcher {
      * @param options Extra matcher options
      * @returns True if the dependency matches the selector, false otherwise
      */
-    private _isDependencyMatch;
-    /**
-     * Determines if the given element or dependency matches the provided selector.
-     * @param descriptorOptions The file path or dependency options to describe the element or dependency
-     * @param selector The selector to match against
-     * @param options Extra matcher options
-     */
-    isMatch(descriptorOptions: string, selector: ElementsSelector, options?: MatcherOptions): boolean;
-    isMatch(descriptorOptions: DescribeDependencyOptions, selector: DependencySelector, options?: MatcherOptions): boolean;
+    isDependencyMatch(dependencyData: DescribeDependencyOptions, selector: DependencySelector, options?: MatcherOptions): boolean;
     /**
      * Determines the selector matching for an element.
      * @param filePath The file path of the element
@@ -1301,7 +1266,7 @@ declare class Matcher {
      * @param options Extra options for matching
      * @returns The matching selector data or null if no match is found
      */
-    private _getElementSelectorMatching;
+    getElementSelectorMatching(filePath: string, selector: ElementsSelector, options?: MatcherOptions): BaseElementSelectorData | null;
     /**
      * Determines the selector matching for a dependency.
      * @param dependencyData The data describing the dependency
@@ -1309,44 +1274,23 @@ declare class Matcher {
      * @param options Extra options for matching
      * @returns The matching dependency result or null if no match is found
      */
-    private _getDependencySelectorMatching;
-    /**
-     * Determines the selector matching for a dependency or element.
-     * @param descriptorOptions The file path or dependency options to describe the element or dependency
-     * @param selector The selectors to match against
-     * @param options Extra options for matching
-     * @returns The matching dependency result or element selector data, or null if no match is found
-     */
-    getSelectorMatching(descriptorOptions: string, selector: ElementsSelector, options?: MatcherOptions): ElementSelectorData | null;
-    getSelectorMatching(descriptorOptions: DescribeDependencyOptions, selector: DependencySelector, options?: MatcherOptions): DependencyMatchResult | null;
+    getDependencySelectorMatching(dependencyData: DescribeDependencyOptions, selector: DependencySelector, options?: MatcherOptions): DependencyMatchResult;
     /**
      * Returns the selectors matching result for the given element or dependency description.
      * @param description The element or dependency  description to check.
      * @param selector The selector to check against.
-     * @param options Extra options for matching, such as templates data, globals for dependency selectors, etc.
+     * @param options Extra options for matching, such as templates data, etc.
      * @returns The selectors matching result for the given description, and whether it matches or not.
      */
-    getSelectorMatchingDescription(description: DependencyDescription, selector: DependencySelector, options?: MatcherOptions): DependencyMatchResult;
-    getSelectorMatchingDescription(description: ElementDescription, selector: ElementsSelector, options?: MatcherOptions): ElementSelectorData;
+    getDependencySelectorMatchingDescription(description: DependencyDescription, selector: DependencySelector, options?: MatcherOptions): DependencyMatchResult;
     /**
-     * Describes an element given its file path.
-     * @param filePath The path of the file to describe.
-     * @returns The description of the element.
-     */
-    describeElement(filePath: string): FileElement;
-    /**
-     * Describes a dependency element given its dependency source and file path.
-     * @param dependencySource The source of the dependency.
-     * @param filePath The path of the file being the dependency, if known.
-     * @returns The description of the dependency element.
-     */
-    describeDependencyElement(dependencySource: string, filePath?: string): DependencyElementDescription;
-    /**
-     * Describes elements in a dependency relationship, and provides additional information about the dependency itself.
-     * @param options The options for describing the elements and the dependency details.
-     * @returns The description of the dependency between the elements.
+     * Returns the first element selector matching result for the given element description.
+     * @param description The element description to check.
+     * @param selector The selector to check against.
+     * @param options Extra options for matching, such as templates data, etc.
+     * @returns The first matching selector result for the given description, or null if no match is found.
      */
-    describeDependency(options: DescribeDependencyOptions): DependencyDescription;
+    getElementSelectorMatchingDescription(description: ElementDescription, selector: ElementsSelector, options?: MatcherOptions): BaseElementSelectorData | null;
     /**
      * Clears all caches.
      */
@@ -1396,14 +1340,7 @@ declare class Descriptors {
      * @param filePath The path of the file to describe.
      * @returns The description of the element.
      */
-    describeElement(filePath?: string): FileElement;
-    /**
-     * Describes a dependency element given its dependency source and file path.
-     * @param dependencySource The source of the dependency.
-     * @param filePath The path of the file being the dependency, if known.
-     * @returns The description of the dependency element.
-     */
-    describeDependencyElement(dependencySource: string, filePath?: string): DependencyElementDescription;
+    describeElement(filePath?: string): ElementDescription;
     /**
      * Describes elements in a dependency relationship, and provides additional information about the dependency itself.
      * @param options The options for describing the elements and the dependency details.
@@ -1543,15 +1480,38 @@ declare class ElementsDescriptor {
      * @param dependencySource The source of the dependency to check.
      * @returns The base source of the external module. (e.g., for "@scope/package/submodule", it returns "@scope/package")
      */
-    private _getExternalOrCoreModuleBaseSource;
+    private _getExternalOrCoreModuleModule;
+    /**
+     * Determines if a file path is outside the configured root path.
+     * @param filePath The file path to check.
+     * @returns True if the file path is outside the root path, false otherwise.
+     */
+    private _isOutsideRootPath;
+    /**
+     * Converts an absolute file path to a relative path if rootPath is configured.
+     * If rootPath is not configured, returns the path as-is (maintains backward compatibility).
+     * @param filePath The file path to convert (can be absolute or relative)
+     * @returns The relative path if rootPath is configured and path is absolute, otherwise the original path
+     */
+    private _toRelativePath;
+    /**
+     * Checks if a source string matches any of the provided patterns using micromatch.
+     * @param patterns - Array of micromatch patterns
+     * @param source - The source string to match against patterns
+     * @returns True if the source matches any pattern, false otherwise
+     */
+    private _matchesAnyPattern;
     /**
      * Determines if an element is external based on its file path and dependency source.
-     * Files inside "node_modules" are considered external.
-     * If the dependency source is not provided, only the file path is considered.
-     * If the dependency source is provided, it must not be a local path (i.e, it should start by "./", "../", or "/").
-     * @param filePath
-     * @param dependencySource
-     * @returns
+     * Uses the flagAsExternal configuration to evaluate multiple conditions with OR logic:
+     * - unresolvableAlias: Files whose path cannot be resolved (filePath is null)
+     * - inNodeModules: Non-relative paths that include "node_modules"
+     * - outsideRootPath: Resolved path is outside the configured root path (only if rootPath is configured)
+     * - customSourcePatterns: Source matches any of the configured patterns
+     * @param filePath The resolved file path (null if unresolved). Can be absolute if rootPath is configured, or relative if rootPath is not configured.
+     * @param isOutsideRootPath Whether the file path is outside the configured root path.
+     * @param dependencySource The import/export source string
+     * @returns True if any of the configured conditions is met, false otherwise
      */
     private _isExternalDependency;
     /**
@@ -1599,30 +1559,31 @@ declare class ElementsDescriptor {
     /**
      * Returns an external or core dependency element given its dependency source and file path.
      * @param dependencySource The source of the dependency.
-     * @param filePath The resolved file path of the dependency, if known.
+     * @param isOutsideRootPath Whether the file path is outside the configured root path.
+     * @param filePath The resolved file path of the dependency, if known. Can be absolute if rootPath is configured.
      * @returns The external or core dependency element, or null if it is a local dependency.
      */
     private _getExternalOrCoreDependencyElement;
     /**
      * Describes an element given its file path and dependency source, if any.
-     * @param filePath The path of the file to describe.
+     * @param filePath The path of the file to describe. Can be absolute if rootPath is configured, or relative if not.
      * @param dependencySource The source of the dependency, if the element to describe is so. It refers to the import/export path used to reference the file or external module.
      * @returns The description of the element. A dependency element if dependency source is provided, otherwise a file element.
      */
     private _describeElement;
     /**
      * Describes an element given its file path.
-     * @param filePath The path of the file to describe.
+     * @param filePath The path of the file to describe. Can be absolute if rootPath is configured, or relative if not.
      * @returns The description of the element.
      */
-    describeElement(filePath?: string): FileElement;
+    describeElement(filePath?: string): ElementDescription;
     /**
-     * Describes a dependency element given its dependency source and file path.
+     * Describes a dependency target element given dependency source and target file path.
+     * @param filePath The path of the dependency target file, if known. Can be absolute if rootPath is configured, or relative if not.
      * @param dependencySource The source of the dependency.
-     * @param filePath The path of the file being the dependency, if known.
      * @returns The description of the dependency element.
      */
-    describeDependencyElement(dependencySource: string, filePath?: string): DependencyElementDescription;
+    describeElement(filePath: string | undefined, dependencySource: string): ElementDescriptionWithSource;
 }
 
 /**
@@ -1791,4 +1752,4 @@ declare class CacheManager<CacheKey extends NotUndefined, CachedValue> {
     setFromSerialized(serializedCache: Record<string, CachedValue>): void;
 }
 
-export { type BaseDependencyElement, type BaseElement, type BaseElementDescriptor, type BaseElementSelector, type BaseElementSelectorData, type BaseElementSelectorWithOptions, type BaseElementsSelector, CacheManager, type CapturedValues, type CapturedValuesSelector, type ConfigOptions, type ConfigOptionsNormalized, type CoreDependencyElement, DEPENDENCY_KINDS_MAP, DEPENDENCY_KIND_TYPE, DEPENDENCY_KIND_TYPEOF, DEPENDENCY_KIND_VALUE, DEPENDENCY_RELATIONSHIPS_INVERTED_MAP, DEPENDENCY_RELATIONSHIPS_MAP, DependenciesDescriptor, type DependenciesDescriptorSerializedCache, DependenciesMatcher, type DependenciesMatcherSerializedCache, type DependencyDescription, type DependencyElementDescription, type DependencyElementSelector, type DependencyElementSelectorData, type DependencyElementSelectorWithOptions, type DependencyElementsSelector, type DependencyKind, type DependencyMatchResult, type DependencyRelationship, type DependencySelector, type DependencySelectorNormalized, type DescribeDependencyOptions, type DescriptionsSerializedCache, type DescriptorOptionsNormalized, Descriptors, type DescriptorsSerializedCache, ELEMENT_DESCRIPTOR_MODES_MAP, ELEMENT_ORIGINS_MAP, type ElementDescription, type ElementDescriptor, type ElementDescriptorMode, type ElementDescriptorPattern, type ElementDescriptorWithCategory, type ElementDescriptorWithType, type ElementDescriptorWithTypeAndCategory, type ElementDescriptors, type ElementOrigin, type ElementParent, type ElementSelector, type ElementSelectorData, type ElementSelectorWithOptions, type ElementSelectors, Elements, type ElementsDependencyInfo, ElementsDescriptor, type ElementsDescriptorSerializedCache, ElementsMatcher, type ElementsMatcherSerializedCache, type ElementsSelector, type ElementsSerializedCache, type ExternalDependencyElement, type ExternalLibrariesSelector, type ExternalLibrarySelector, type ExternalLibrarySelectorOptions, type ExternalLibrarySelectorWithOptions, type ExternalLibrarySelectors, type FileElement, type FileElementsSerializedCache, type IgnoredDependencyElement, type IgnoredElement, type LocalDependencyElement, type LocalDependencyElementKnown, type LocalDependencyElementUnknown, type LocalElementKnown, type LocalElementUnknown, Matcher, type MatcherOptions, type MatcherOptionsDependencySelectorsGlobals, type MatcherSerializedCache, type MatchersOptionsNormalized, type MicromatchPattern, type MicromatchSerializedCache, type NotUndefined, type ObjectCacheKey, type SelectableElement, type SimpleElementSelectorByType, type TemplateData, isBaseElement, isBaseElementDescriptor, isBaseElementSelectorData, isCapturedValuesSelector, isCoreDependencyElement, isDependencyDescription, isDependencyElementDescription, isDependencyKind, isDependencyRelationship, isDependencyRelationshipDescription, isDependencySelector, isElementDescription, isElementDescriptor, isElementDescriptorMode, isElementDescriptorPattern, isElementDescriptorWithCategory, isElementDescriptorWithType, isElementSelector, isElementSelectorData, isElementSelectorWithLegacyOptions, isElementsDependencyInfo, isElementsSelector, isExternalDependencyElement, isExternalLibrariesSelector, isExternalLibrarySelector, isExternalLibrarySelectorOptions, isExternalLibrarySelectorOptionsWithPath, isExternalLibrarySelectorOptionsWithSpecifiers, isExternalLibrarySelectorWithOptions, isIgnoredElement, isInternalDependency, isKnownLocalElement, isLocalDependencyElement, isLocalElement, isSimpleElementSelectorByType, isUnknownLocalElement, normalizeElementsSelector };
+export { type BaseElementDescription, type BaseElementDescriptor, type BaseElementSelector, type BaseElementSelectorData, type BaseElementSelectorWithOptions, type BaseElementsSelector, CacheManager, type CapturedValues, type CapturedValuesSelector, type ConfigOptions, type ConfigOptionsNormalized, type CoreElementDescription, DEPENDENCY_KINDS_MAP, DEPENDENCY_KIND_TYPE, DEPENDENCY_KIND_TYPEOF, DEPENDENCY_KIND_VALUE, DEPENDENCY_RELATIONSHIPS_INVERTED_MAP, DEPENDENCY_RELATIONSHIPS_MAP, DependenciesDescriptor, type DependenciesDescriptorSerializedCache, DependenciesMatcher, type DependenciesMatcherSerializedCache, type DependencyDataSelector, type DependencyDataSelectorData, type DependencyDescription, type DependencyElementSelectorData, type DependencyKind, type DependencyMatchResult, type DependencyRelationship, type DependencySelector, type DependencySelectorNormalized, type DescribeDependencyOptions, type DescriptionsSerializedCache, type DescriptorOptionsNormalized, Descriptors, type DescriptorsSerializedCache, ELEMENT_DESCRIPTOR_MODES_MAP, ELEMENT_ORIGINS_MAP, type ElementDescription, type ElementDescriptionWithSource, type ElementDescriptor, type ElementDescriptorMode, type ElementDescriptorPattern, type ElementDescriptorWithCategory, type ElementDescriptorWithType, type ElementDescriptorWithTypeAndCategory, type ElementDescriptors, type ElementOrigin, type ElementParent, type ElementSelector, type ElementSelectorWithOptions, type ElementSelectors, Elements, type ElementsDependencyInfo, ElementsDescriptor, type ElementsDescriptorSerializedCache, ElementsMatcher, type ElementsMatcherSerializedCache, type ElementsSelector, type ElementsSerializedCache, type ExternalElementDescription, type FileElementsSerializedCache, type FlagAsExternalOptions, type FlagAsExternalOptionsNormalized, type IgnoredElement, type LocalElementKnown, type LocalElementUnknown, Matcher, type MatcherOptions, type MatcherSerializedCache, type MatchersOptionsNormalized, type MicromatchPattern, type MicromatchPatternNullable, type MicromatchSerializedCache, type NotUndefined, type ObjectCacheKey, type ParentElementSelectorData, type SelectableElement, type SimpleElementSelectorByType, type TemplateData, isBaseElement, isBaseElementDescriptor, isBaseElementSelectorData, isCapturedValuesSelector, isCoreDependencyElement, isDependencyDataSelector, isDependencyDataSelectorData, isDependencyDescription, isDependencyKind, isDependencyRelationship, isDependencyRelationshipDescription, isDependencySelector, isElementDescription, isElementDescriptor, isElementDescriptorMode, isElementDescriptorPattern, isElementDescriptorWithCategory, isElementDescriptorWithType, isElementSelector, isElementSelectorData, isElementSelectorWithLegacyOptions, isElementsDependencyInfo, isElementsSelector, isExternalDependencyElement, isIgnoredElement, isInternalDependency, isKnownLocalElement, isLocalDependencyElement, isLocalElement, isSimpleElementSelectorByType, isUnknownLocalElement, normalizeElementSelector, normalizeElementsSelector };