@gtkx/gir 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -1,28 +1,41 @@
 /**
  * @gtkx/gir - GObject Introspection Repository
  *
- * Pure GIR data layer with normalized types and a queryable API.
- * All type references use fully qualified names (Namespace.TypeName).
+ * Parses GIR files and exposes a fully queryable registry of namespaces
+ * with resolved type references.
  *
  * @example
  * ```typescript
  * import { GirRepository } from "@gtkx/gir";
  *
- * const repo = new GirRepository();
- * await repo.loadFromDirectory("./girs");
- * repo.resolve();
+ * const repo = await GirRepository.load(["Gtk-4.0"], {
+ *     girPath: ["/usr/share/gir-1.0"]
+ * });
  *
- * const button = repo.resolveClass("Gtk.Button" as QualifiedName);
- * button.isSubclassOf("Gtk.Widget" as QualifiedName); // true
- * button.getInheritanceChain();
- * // ["Gtk.Button", "Gtk.Widget", "GObject.InitiallyUnowned", "GObject.Object"]
+ * const button = repo.resolveClass("Gtk.Button");
+ * button.isSubclassOf("Gtk.Widget"); // true
  * ```
  *
  * @packageDocumentation
  */
 export { INTRINSIC_TYPES, isIntrinsicType, isNumericType, isStringType, isVoidType, NUMERIC_TYPES, STRING_TYPES, VOID_TYPES, } from "./intrinsics.js";
-export { GirRepository, type RepositoryOptions } from "./repository.js";
-export type { ContainerType, DefaultValue, QualifiedName, TypeKind, } from "./types.js";
-export { GirAlias, GirCallback, GirClass, GirConstant, GirConstructor, GirEnumeration, GirEnumerationMember, GirField, GirFunction, GirInterface, GirMethod, GirNamespace, GirParameter, GirProperty, GirRecord, GirSignal, GirType, parseDefaultValue, parseQualifiedName, qualifiedName, } from "./types.js";
+export { GirAlias } from "./model/alias.js";
+export { GirConstructor, GirFunction, GirMethod } from "./model/callables.js";
+export { GirCallback } from "./model/callback.js";
+export { GirClass } from "./model/class.js";
+export { GirConstant } from "./model/constant.js";
+export { GirEnumeration, GirEnumerationMember } from "./model/enumeration.js";
+export { GirField } from "./model/field.js";
+export { GirInterface } from "./model/interface.js";
+export { GirNamespace } from "./model/namespace.js";
+export { GirParameter } from "./model/parameter.js";
+export type { DefaultValue } from "./model/property.js";
+export { GirProperty, parseDefaultValue } from "./model/property.js";
+export { GirRecord } from "./model/record.js";
+export type { RepositoryLike, TypeKind } from "./model/repository-like.js";
+export { GirSignal } from "./model/signal.js";
+export type { ContainerType } from "./model/type.js";
+export { GirType } from "./model/type.js";
+export { type DependencyGraph, GirRepository, type RepositoryOptions } from "./repository.js";
 export { toCamelCase, toPascalCase } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,QAAQ,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,27 +1,38 @@
 /**
  * @gtkx/gir - GObject Introspection Repository
  *
- * Pure GIR data layer with normalized types and a queryable API.
- * All type references use fully qualified names (Namespace.TypeName).
+ * Parses GIR files and exposes a fully queryable registry of namespaces
+ * with resolved type references.
  *
  * @example
  * ```typescript
  * import { GirRepository } from "@gtkx/gir";
  *
- * const repo = new GirRepository();
- * await repo.loadFromDirectory("./girs");
- * repo.resolve();
+ * const repo = await GirRepository.load(["Gtk-4.0"], {
+ *     girPath: ["/usr/share/gir-1.0"]
+ * });
  *
- * const button = repo.resolveClass("Gtk.Button" as QualifiedName);
- * button.isSubclassOf("Gtk.Widget" as QualifiedName); // true
- * button.getInheritanceChain();
- * // ["Gtk.Button", "Gtk.Widget", "GObject.InitiallyUnowned", "GObject.Object"]
+ * const button = repo.resolveClass("Gtk.Button");
+ * button.isSubclassOf("Gtk.Widget"); // true
  * ```
  *
  * @packageDocumentation
  */
 export { INTRINSIC_TYPES, isIntrinsicType, isNumericType, isStringType, isVoidType, NUMERIC_TYPES, STRING_TYPES, VOID_TYPES, } from "./intrinsics.js";
+export { GirAlias } from "./model/alias.js";
+export { GirConstructor, GirFunction, GirMethod } from "./model/callables.js";
+export { GirCallback } from "./model/callback.js";
+export { GirClass } from "./model/class.js";
+export { GirConstant } from "./model/constant.js";
+export { GirEnumeration, GirEnumerationMember } from "./model/enumeration.js";
+export { GirField } from "./model/field.js";
+export { GirInterface } from "./model/interface.js";
+export { GirNamespace } from "./model/namespace.js";
+export { GirParameter } from "./model/parameter.js";
+export { GirProperty, parseDefaultValue } from "./model/property.js";
+export { GirRecord } from "./model/record.js";
+export { GirSignal } from "./model/signal.js";
+export { GirType } from "./model/type.js";
 export { GirRepository } from "./repository.js";
-export { GirAlias, GirCallback, GirClass, GirConstant, GirConstructor, GirEnumeration, GirEnumerationMember, GirField, GirFunction, GirInterface, GirMethod, GirNamespace, GirParameter, GirProperty, GirRecord, GirSignal, GirType, parseDefaultValue, parseQualifiedName, qualifiedName, } from "./types.js";
 export { toCamelCase, toPascalCase } from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AAOxE,OAAO,EACH,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACH,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAwB,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/internal/loader.d.ts

@@ -0,0 +1,30 @@
+import type { RawNamespace } from "./raw-types.js";
+/**
+ * Handles GIR file discovery, dependency graph resolution, and loading.
+ *
+ * Given a list of root namespace keys (e.g., `["Gtk-4.0"]`) and search paths,
+ * discovers all transitive dependencies via `<include>` tags, topologically
+ * sorts them, and returns fully parsed raw namespaces in dependency order.
+ */
+export declare class GirLoader {
+    private readonly girPath;
+    private readonly parser;
+    constructor(girPath: string[]);
+    /**
+     * Loads all GIR namespaces required by the given roots, including
+     * all transitive dependencies discovered via `<include>` tags.
+     *
+     * @returns Raw namespaces keyed by namespace name, in dependency order.
+     */
+    loadAll(roots: string[]): Promise<Map<string, {
+        raw: RawNamespace;
+        xml: string;
+    }>>;
+    discoverDependencies(roots: string[]): Promise<Map<string, {
+        filePath: string;
+        dependencies: string[];
+    }>>;
+    private findGirFile;
+    private topologicalSort;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/internal/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/internal/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,OAAO,EAAE,MAAM,EAAE;IAK7B;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,YAAY,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiBlF,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IA0B/G,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,eAAe;CA4C1B"}

package/dist/internal/loader.js

@@ -0,0 +1,109 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { GirParser } from "./parser.js";
+/**
+ * Handles GIR file discovery, dependency graph resolution, and loading.
+ *
+ * Given a list of root namespace keys (e.g., `["Gtk-4.0"]`) and search paths,
+ * discovers all transitive dependencies via `<include>` tags, topologically
+ * sorts them, and returns fully parsed raw namespaces in dependency order.
+ */
+export class GirLoader {
+    girPath;
+    parser;
+    constructor(girPath) {
+        this.girPath = girPath;
+        this.parser = new GirParser();
+    }
+    /**
+     * Loads all GIR namespaces required by the given roots, including
+     * all transitive dependencies discovered via `<include>` tags.
+     *
+     * @returns Raw namespaces keyed by namespace name, in dependency order.
+     */
+    async loadAll(roots) {
+        const fileMap = await this.discoverDependencies(roots);
+        const sorted = this.topologicalSort(fileMap);
+        const result = new Map();
+        for (const key of sorted) {
+            const entry = fileMap.get(key);
+            if (!entry)
+                continue;
+            const filePath = entry.filePath;
+            const xml = await readFile(filePath, "utf-8");
+            const raw = this.parser.parseNamespace(xml);
+            result.set(raw.name, { raw, xml });
+        }
+        return result;
+    }
+    async discoverDependencies(roots) {
+        const graph = new Map();
+        const queue = [...roots];
+        while (queue.length > 0) {
+            const key = queue.shift();
+            if (key === undefined || graph.has(key))
+                continue;
+            const filePath = this.findGirFile(key);
+            const xml = await readFile(filePath, "utf-8");
+            const header = this.parser.parseHeader(xml);
+            const dependencies = header.dependencies.map((dep) => `${dep.name}-${dep.version}`);
+            graph.set(key, { filePath, dependencies });
+            for (const dep of dependencies) {
+                if (!graph.has(dep)) {
+                    queue.push(dep);
+                }
+            }
+        }
+        return graph;
+    }
+    findGirFile(namespaceKey) {
+        const filename = `${namespaceKey}.gir`;
+        for (const dir of this.girPath) {
+            const filePath = join(dir, filename);
+            if (existsSync(filePath)) {
+                return filePath;
+            }
+        }
+        throw new Error(`GIR file not found for "${namespaceKey}" in paths: [${this.girPath.join(", ")}]`);
+    }
+    topologicalSort(graph) {
+        const inDegree = new Map();
+        const dependents = new Map();
+        for (const key of graph.keys()) {
+            dependents.set(key, []);
+        }
+        for (const [key, { dependencies }] of graph) {
+            inDegree.set(key, dependencies.filter((d) => graph.has(d)).length);
+            for (const dep of dependencies) {
+                dependents.get(dep)?.push(key);
+            }
+        }
+        const queue = [];
+        for (const [key, degree] of inDegree) {
+            if (degree === 0) {
+                queue.push(key);
+            }
+        }
+        const sorted = [];
+        while (queue.length > 0) {
+            const key = queue.shift();
+            if (key === undefined)
+                break;
+            sorted.push(key);
+            for (const dependent of dependents.get(key) ?? []) {
+                const newDegree = (inDegree.get(dependent) ?? 0) - 1;
+                inDegree.set(dependent, newDegree);
+                if (newDegree === 0) {
+                    queue.push(dependent);
+                }
+            }
+        }
+        if (sorted.length !== graph.size) {
+            const remaining = [...graph.keys()].filter((k) => !sorted.includes(k));
+            throw new Error(`Circular GIR dependency detected involving: ${remaining.join(", ")}`);
+        }
+        return sorted;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/internal/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/internal/loader.ts"],"names":[],"mappings":"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"}

package/dist/internal/normalizer.d.ts

@@ -1,23 +1,106 @@
+import { GirAlias } from "../model/alias.js";
+import { GirConstructor, GirFunction, GirMethod } from "../model/callables.js";
+import { GirCallback } from "../model/callback.js";
+import { GirConstant } from "../model/constant.js";
+import { GirEnumeration } from "../model/enumeration.js";
+import { GirProperty } from "../model/property.js";
+import { GirRecord } from "../model/record.js";
+import { GirSignal } from "../model/signal.js";
+import type { RawNamespace } from "./raw-types.js";
 /**
- * Normalizer that converts raw GIR types to normalized types.
- *
- * The key job is to qualify all type references with their namespace,
- * except for intrinsic types which remain unqualified.
- *
- * @internal
+ * Data produced for a class before the repository exists.
+ * Used to defer GirClass construction until the repo is available.
  */
-import { GirNamespace } from "../types.js";
-import type { RawNamespace } from "./raw-types.js";
+export type GirClassData = {
+    name: string;
+    qualifiedName: string;
+    cType: string;
+    parent: string | null;
+    abstract: boolean;
+    glibTypeName?: string;
+    glibGetType?: string;
+    cSymbolPrefix?: string;
+    fundamental?: boolean;
+    refFunc?: string;
+    unrefFunc?: string;
+    implements: string[];
+    methods: GirMethod[];
+    constructors: GirConstructor[];
+    staticFunctions: GirFunction[];
+    properties: GirProperty[];
+    signals: GirSignal[];
+    doc?: string;
+};
 /**
- * Context for normalization - provides access to all loaded namespaces
- * for resolving cross-namespace references.
+ * Data produced for an interface before the repository exists.
  */
-export type NormalizerContext = {
-    /** All raw namespaces that have been loaded */
-    rawNamespaces: Map<string, RawNamespace>;
+export type GirInterfaceData = {
+    name: string;
+    qualifiedName: string;
+    cType: string;
+    glibTypeName?: string;
+    prerequisites: string[];
+    methods: GirMethod[];
+    properties: GirProperty[];
+    signals: GirSignal[];
+    doc?: string;
 };
 /**
- * Normalizes a raw namespace into a normalized namespace.
+ * Intermediate namespace data produced by the normalizer.
+ *
+ * Classes and interfaces are stored as plain data because they need
+ * the repository reference at construction time (which doesn't exist yet).
+ * All other types are fully constructed model instances.
+ */
+export type GirNamespaceIntermediate = {
+    name: string;
+    version: string;
+    sharedLibrary: string;
+    cPrefix: string;
+    classes: Map<string, GirClassData>;
+    interfaces: Map<string, GirInterfaceData>;
+    records: Map<string, GirRecord>;
+    enumerations: Map<string, GirEnumeration>;
+    bitfields: Map<string, GirEnumeration>;
+    callbacks: Map<string, GirCallback>;
+    functions: Map<string, GirFunction>;
+    constants: Map<string, GirConstant>;
+    aliases: Map<string, GirAlias>;
+    doc?: string;
+};
+/**
+ * Converts raw parsed GIR data into model instances with fully qualified
+ * type names.
+ *
+ * Uses indexed lookups for O(1) type name resolution and strict error
+ * handling (throws on unresolvable type references).
  */
-export declare const normalizeNamespace: (raw: RawNamespace, ctx: NormalizerContext) => GirNamespace;
+export declare class GirNormalizer {
+    private typeIndex;
+    /**
+     * Normalizes all raw namespaces into intermediate namespace data.
+     *
+     * @param rawNamespaces - Raw namespaces keyed by name, in dependency order
+     * @returns Intermediate namespace data keyed by name, in the same order
+     */
+    normalize(rawNamespaces: Map<string, RawNamespace>): Map<string, GirNamespaceIntermediate>;
+    private buildTypeIndex;
+    private normalizeNamespace;
+    private qualifyTypeName;
+    private normalizeType;
+    private normalizeClass;
+    private normalizeInterface;
+    private normalizeRecord;
+    private normalizeEnumeration;
+    private normalizeCallback;
+    private normalizeConstant;
+    private normalizeAlias;
+    private normalizeMethod;
+    private normalizeConstructor;
+    private normalizeFunction;
+    private normalizeParameter;
+    private normalizeProperty;
+    private normalizeSignal;
+    private normalizeField;
+}
 //# sourceMappingURL=normalizer.d.ts.map

package/dist/internal/normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/internal/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAYH,YAAY,EASf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAWR,YAAY,EAMf,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,+CAA+C;IAC/C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,YAAY,EAAE,KAAK,iBAAiB,KAAG,YA0E9E,CAAC"}
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/internal/normalizer.ts"],"names":[],"mappings":"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"}