@ng-doc/builder 22.0.0-beta.2 → 22.0.0

package/generator/worker/protocol.d.ts

@@ -0,0 +1,160 @@
+import type { ArtifactSnapshot, CompilationProgressUpdate, CompilationResult, CompilationRetention } from '../contracts.js';
+/** Strings are the only worker messages; executable and native objects cannot cross this port. */
+export declare function encode(value: unknown): string;
+export declare function decode(value: unknown): Record<string, unknown>;
+export declare function resultFrom(value: unknown): CompilationResult;
+export declare function errorMessage(error: unknown): string;
+/**
+ * A candidate snapshot as a patch of the snapshot it was compiled from.
+ *
+ * `keys` lists the candidate's keys in order (object keys whose value is not `undefined`, as JSON
+ * keeps them); a key is taken from `set` when present there, otherwise from the base object, so a
+ * patched object has exactly the candidate's keys, order and JSON values. `artifacts` is always
+ * rebuilt from the entries. Every other top-level key of the snapshot is always in `set`: they are
+ * small, and the snapshot revision does not cover all of them (`globalKeywords`, `remoteKeywords`),
+ * so they must never be taken from a base that only matches by revision.
+ */
+export interface SnapshotDelta {
+    /** Revision of the base snapshot; `null` for an empty base (no previous snapshot). */
+    base: string | null;
+    keys: string[];
+    set: Record<string, unknown>;
+    artifacts: DeltaArtifact[];
+}
+/**
+ * An artifact of the candidate, in candidate order: without `keys`, the base artifact with this id
+ * and revision (artifact revisions are content hashes, and the compiler keeps the previous revision
+ * only for a value-equal artifact); with `keys`, a changed artifact whose unlisted keys are copied
+ * from the base artifact with this id.
+ */
+export type DeltaArtifact = {
+    id: string;
+    revision: string;
+} | {
+    id: string;
+    revision: string;
+    keys: string[];
+    set: Record<string, unknown>;
+};
+/**
+ * Up to this many changed artifacts are also diffed key by key against their base artifact (an
+ * edit usually changes the aggregate's search index but not its program dependencies). Above it,
+ * changed artifacts are sent whole, so a large delta costs no comparison.
+ */
+export declare const FIELD_LEVEL_LIMIT = 16;
+/** The candidate as a delta of `base` (the snapshot it was compiled from). */
+export declare function snapshotDelta(base: ArtifactSnapshot | undefined, candidate: ArtifactSnapshot): SnapshotDelta;
+/**
+ * Rebuilds the candidate from `base` and a (JSON-decoded) delta. Both processes run exactly this
+ * function on equal bases, so the host's patched candidate and the runtime's retained working
+ * snapshot are equal by construction. Unchanged artifacts are the base's own objects. Any
+ * inconsistency throws; callers then fall back to the full transport.
+ */
+export declare function applySnapshotDelta(base: ArtifactSnapshot | undefined, value: unknown): ArtifactSnapshot;
+/** Freezes a JSON value in place (the delta transport's verification mode). */
+export declare function deepFreeze<T>(value: T): T;
+/**
+ * How a runtime's retention slot keeps the entry a compile offers for its candidate: `acknowledged`
+ * (a delta compile: the working entry, promoted only by the caller's commit acknowledgement) or
+ * `compile-end` (committed at once: warm-ups, full-transport compiles and full-candidate retries,
+ * which no acknowledgement follows).
+ */
+export type RetentionPromotion = 'acknowledged' | 'compile-end';
+/** A runtime slot's state and counters (instrumentation and tests). */
+export interface RuntimeRetentionState {
+    committed: string | null;
+    working: string | null;
+    /** While no committed entry is held: why the last one was invalidated, if known. */
+    invalidated: string | null;
+    /** Offers kept as working entries / working entries promoted / working entries dropped unpromoted. */
+    counters: {
+        offered: number;
+        promoted: number;
+        dropped: number;
+    };
+}
+/**
+ * The retention slot a long-lived runtime owns (see below). A compile never sees the slot itself:
+ * it gets a handle from `serve`, which exposes only the {@link CompilationRetention} operations.
+ */
+export interface RuntimeRetention {
+    /**
+     * Before a compile: a handle for that compile only, to pass in its context. Its offers are kept
+     * as `promotion` says, whatever other handles were served since: further compiles in one
+     * runtime (a verifying full compile, an idle confirmation) must never change where another
+     * compile's offer goes. The handle cannot promote, resync or change any policy.
+     */
+    serve(promotion: RetentionPromotion): CompilationRetention;
+    /**
+     * A compile message: the working entry becomes the committed one when the message promotes
+     * exactly its revision (`promote`, sent only after the caller acknowledged that commit); any
+     * other working entry is dropped.
+     */
+    promote(revision: unknown): void;
+    /**
+     * A resync to `base`: the working entry for exactly that revision becomes the committed one, any
+     * other is dropped. The host resyncs only to its caller's committed snapshot, so that revision
+     * was committed; this keeps the retained program when the identity rule forces a resync for a
+     * same-revision snapshot object the runtime did not return.
+     */
+    resync(base: unknown): void;
+    inspect(): RuntimeRetentionState;
+}
+/**
+ * The retention slot of a long-lived development runtime. It holds a **committed** entry, valid for
+ * the base the runtime's caller committed, and a **working** entry for the candidate of the last
+ * delta compile, and follows exactly the messages that move the runtime's snapshots: `promote` and
+ * `resync` promote or drop the working entry; a compile takes the committed entry for its whole run
+ * and restores it only when its program is still intact.
+ *
+ * Copy-on-write: an offer never changes the committed entry. The two entries may share a program
+ * that the working generation only read; a generation that consumed the committed program (a
+ * full rebuild) or mutated it (added source files) restores nothing and offers nothing that shares
+ * it, so both entries are invalid and the next generation rebuilds. The slot keeps why
+ * (`invalidate`) until it holds a committed entry again; a working entry dropped while none is
+ * held records `dropped unacknowledged` unless an earlier reason is already kept.
+ */
+export declare function createRuntimeRetention(): RuntimeRetention;
+/**
+ * Progress transport (advisory: it never changes a result). A compile message with
+ * `progress: true` asks the runtime for `{ type: 'progress', id, update }` messages, sent before
+ * the compile's reply on the same channel. Updates are JSON like every other message. `start`
+ * and `end` go out at once; `advance` updates are coalesced to at most one per
+ * {@link PROGRESS_INTERVAL_MS}, the latest winning, so a per-unit loop costs a few messages a
+ * second whatever its size.
+ */
+export declare const PROGRESS_INTERVAL_MS = 100;
+/** The runtime side: a sink for the compiler's updates that sends them, throttled. */
+export interface ProgressChannel {
+    sink(update: CompilationProgressUpdate): void;
+    /** No more messages: a pending advance is dropped (the phase end or the reply supersedes it). */
+    close(): void;
+}
+export declare function createProgressChannel(send: (update: CompilationProgressUpdate) => void, now?: () => number): ProgressChannel;
+/**
+ * A progress update received from a runtime, checked field by field, or `undefined`. A malformed
+ * update is dropped, never an error: progress must not break the transport it rides on.
+ */
+export declare function progressUpdate(value: unknown): CompilationProgressUpdate | undefined;
+/**
+ * The host side of one job's progress: it forwards the runtime's checked updates to the caller's
+ * sink while the job is live, and adds the phases only the host sees: `boot` (a runtime starting
+ * for this job) and `transfer` (from the compiler's last phase to the result the caller receives,
+ * including its encoding, the message and a delta's application). Nothing is forwarded once the
+ * job's signal aborted or its result was delivered, and a throwing sink is ignored.
+ */
+export declare class ProgressRelay {
+    private readonly sink;
+    private readonly signal;
+    private transferring;
+    private done;
+    /** A compiler update was relayed: a retry of the compile need not ask for progress again. */
+    reported: boolean;
+    constructor(sink: (update: CompilationProgressUpdate) => void, signal: AbortSignal);
+    boot(state: 'start' | 'end'): void;
+    /** A `progress` message's update, as received. */
+    forward(value: unknown): void;
+    /** The job's result is ready for the caller: the transfer ends and the relay goes quiet. */
+    settled(): void;
+    private emit;
+}

package/helpers/angular/get-component-decorator.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getComponentDecorator = getComponentDecorator;
 const ts_morph_1 = require("ts-morph");
 const string_expression_1 = require("../string-expression");
-const typescript_1 = require("../typescript");
+const get_property_assignment_1 = require("../typescript/property/get-property-assignment");
 /**
  *    Resolves the component decorator and return its properties.
  * @param cls - class declaration
@@ -18,11 +18,11 @@ function getComponentDecorator(cls) {
         const styleUrlProperty = decoratorArgument.getProperty('styleUrl');
         const styleUrlsProperty = decoratorArgument.getProperty('styleUrls');
         return {
-            standalone: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(standaloneProperty)),
-            selector: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(selectorProperty)),
-            templateUrl: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(templateProperty)),
-            styleUrl: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(styleUrlProperty)),
-            styleUrls: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(styleUrlsProperty)),
+            standalone: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(standaloneProperty)),
+            selector: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(selectorProperty)),
+            templateUrl: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(templateProperty)),
+            styleUrl: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(styleUrlProperty)),
+            styleUrls: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(styleUrlsProperty)),
         };
     }
     return undefined;

package/helpers/angular/get-component-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-component-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-component-decorator.ts"],"names":[],"mappings":";;AAUA,sDA0BC;AAnCD,uCAAuF;AAEvF,4DAAwD;AACxD,8CAAsD;AAEtD;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAqB;IACzD,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,kBAAkB,GACtB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GACrB,iBAAiB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO;YACL,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,gBAAgB,CAAC,CAAC;YACnE,WAAW,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,gBAAgB,CAAC,CAAC;YACtE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,gBAAgB,CAAC,CAAC;YACnE,SAAS,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,iBAAiB,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"get-component-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-component-decorator.ts"],"names":[],"mappings":";;AAUA,sDA0BC;AAnCD,uCAAuF;AAEvF,4DAAwD;AACxD,4FAAuF;AAEvF;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAqB;IACzD,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,kBAAkB,GACtB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GACrB,iBAAiB,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAE7C,OAAO;YACL,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,gBAAgB,CAAC,CAAC;YACnE,WAAW,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,gBAAgB,CAAC,CAAC;YACtE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,gBAAgB,CAAC,CAAC;YACnE,SAAS,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,iBAAiB,CAAC,CAAC;SACtE,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/helpers/angular/get-directive-decorator.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDirectiveDecorator = getDirectiveDecorator;
 const ts_morph_1 = require("ts-morph");
 const string_expression_1 = require("../string-expression");
-const typescript_1 = require("../typescript");
+const get_property_assignment_1 = require("../typescript/property/get-property-assignment");
 /**
  *    Resolves the directive decorator and return its properties.
  * @param cls - class declaration
@@ -15,8 +15,8 @@ function getDirectiveDecorator(cls) {
         const standaloneProperty = decoratorArgument.getProperty('standalone');
         const selectorProperty = decoratorArgument.getProperty('selector');
         return {
-            standalone: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(standaloneProperty)),
-            selector: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(selectorProperty)),
+            standalone: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(standaloneProperty)),
+            selector: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(selectorProperty)),
         };
     }
     return undefined;

package/helpers/angular/get-directive-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-directive-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-directive-decorator.ts"],"names":[],"mappings":";;AAUA,sDAiBC;AA1BD,uCAAuF;AAEvF,4DAAwD;AACxD,8CAAsD;AAEtD;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAqB;IAC1D,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvD,MAAM,kBAAkB,GACvB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GACrB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAE3C,OAAO;YACN,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,gBAAgB,CAAC,CAAC;SACnE,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}
+{"version":3,"file":"get-directive-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-directive-decorator.ts"],"names":[],"mappings":";;AAUA,sDAiBC;AA1BD,uCAAuF;AAEvF,4DAAwD;AACxD,4FAAuF;AAEvF;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAqB;IACzD,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,kBAAkB,GACtB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,gBAAgB,GACpB,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAE5C,OAAO;YACL,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,gBAAgB,CAAC,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/helpers/angular/get-pipe-decorator.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPipeDecorator = getPipeDecorator;
 const ts_morph_1 = require("ts-morph");
 const string_expression_1 = require("../string-expression");
-const typescript_1 = require("../typescript");
+const get_property_assignment_1 = require("../typescript/property/get-property-assignment");
 /**
  *    Resolves the pipe decorator and return its properties.
  * @param cls - class declaration
@@ -15,8 +15,8 @@ function getPipeDecorator(cls) {
         const standaloneProperty = decoratorArgument.getProperty('standalone');
         const nameProperty = decoratorArgument.getProperty('name');
         return {
-            standalone: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(standaloneProperty)),
-            name: (0, string_expression_1.stringExpression)((0, typescript_1.getPropertyAssignment)(nameProperty)),
+            standalone: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(standaloneProperty)),
+            name: (0, string_expression_1.stringExpression)((0, get_property_assignment_1.getPropertyAssignment)(nameProperty)),
         };
     }
     return undefined;

package/helpers/angular/get-pipe-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-pipe-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-pipe-decorator.ts"],"names":[],"mappings":";;AAUA,4CAiBC;AA1BD,uCAAuF;AAEvF,4DAAwD;AACxD,8CAAsD;AAEtD;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAAqB;IACrD,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvD,MAAM,kBAAkB,GACvB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,YAAY,GACjB,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEvC,OAAO;YACN,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,IAAI,EAAE,IAAA,oCAAgB,EAAC,IAAA,kCAAqB,EAAC,YAAY,CAAC,CAAC;SAC3D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}
+{"version":3,"file":"get-pipe-decorator.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/angular/get-pipe-decorator.ts"],"names":[],"mappings":";;AAUA,4CAiBC;AA1BD,uCAAuF;AAEvF,4DAAwD;AACxD,4FAAuF;AAEvF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAAqB;IACpD,MAAM,SAAS,GAA0B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAqB,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,eAAI,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtD,MAAM,kBAAkB,GACtB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,YAAY,GAChB,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAExC,OAAO;YACL,UAAU,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,kBAAkB,CAAC,CAAC;YACvE,IAAI,EAAE,IAAA,oCAAgB,EAAC,IAAA,+CAAqB,EAAC,YAAY,CAAC,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/helpers/build-indexes.js

@@ -36,8 +36,11 @@ async function buildIndexes(config) {
                 pages.push({
                     breadcrumbs: config.breadcrumbs,
                     pageType: config.pageType,
-                    title: config.title,
-                    section: section?.content ?? '',
+                    // Without the whitespace around them, a no-break space included: a heading's decorative
+                    // emoji is joined to its text with one. The new engine trims them the same way
+                    // (`generator/content/html-pipeline.ts`); keep both in step.
+                    title: config.title.trim(),
+                    section: (section?.content ?? '').trim(),
                     route: config.route,
                     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                     // @ts-ignore

package/helpers/build-indexes.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-indexes.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/build-indexes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-indexes.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/build-indexes.ts"],"names":[],"mappings":"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"}

package/helpers/construct-page-keyword.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.constructPageKeyword = constructPageKeyword;
+const keyword_heading_title_1 = require("./keyword-heading-title");
 /**
  *
  * @param key
@@ -12,7 +13,7 @@ function constructPageKeyword(key, title, path, anchor) {
     return anchor.type === 'heading'
         ? {
             key: `${key}#${anchor.anchor}`,
-            title: `${title} [${anchor.title}]`,
+            title: `${title} [${(0, keyword_heading_title_1.keywordHeadingTitle)(anchor.title)}]`,
             path: `${path}#${anchor.anchorId}`,
         }
         : {

package/helpers/construct-page-keyword.js.map

@@ -1 +1 @@
-{"version":3,"file":"construct-page-keyword.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/construct-page-keyword.ts"],"names":[],"mappings":";;AAUA,oDAiBC;AAxBD;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,GAAW,EACX,KAAa,EACb,IAAY,EACZ,MAAuB;IAEvB,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,GAAG,EAAE,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;YAC9B,KAAK,EAAE,GAAG,KAAK,KAAK,MAAM,CAAC,KAAK,GAAG;YACnC,IAAI,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE;SACnC;QACH,CAAC,CAAC;YACE,GAAG,EAAE,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;YAC9B,KAAK,EAAE,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE;YACjC,IAAI,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE;SACnC,CAAC;AACR,CAAC"}
+{"version":3,"file":"construct-page-keyword.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/construct-page-keyword.ts"],"names":[],"mappings":";;AAYA,oDAiBC;AA1BD,mEAA8D;AAE9D;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,GAAW,EACX,KAAa,EACb,IAAY,EACZ,MAAuB;IAEvB,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,GAAG,EAAE,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;YAC9B,KAAK,EAAE,GAAG,KAAK,KAAK,IAAA,2CAAmB,EAAC,MAAM,CAAC,KAAK,CAAC,GAAG;YACxD,IAAI,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE;SACnC;QACH,CAAC,CAAC;YACE,GAAG,EAAE,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;YAC9B,KAAK,EAAE,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE;YACjC,IAAI,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE;SACnC,CAAC;AACR,CAAC"}

package/helpers/extract-selectors.d.ts

@@ -1,4 +1,4 @@
-import { NgDocSupportedDeclaration } from '../types';
+import type { NgDocSupportedDeclaration } from '../types/supported-declaration';
 /**
  *
  * @param declaration

package/helpers/extract-selectors.js

@@ -3,14 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractSelectors = extractSelectors;
 exports.getPipeName = getPipeName;
 const ts_morph_1 = require("ts-morph");
-const angular_1 = require("./angular");
+const get_component_decorator_1 = require("./angular/get-component-decorator");
+const get_directive_decorator_1 = require("./angular/get-directive-decorator");
+const get_pipe_decorator_1 = require("./angular/get-pipe-decorator");
 /**
  *
  * @param declaration
  */
 function extractSelectors(declaration) {
     if (ts_morph_1.Node.isClassDeclaration(declaration)) {
-        const decorator = (0, angular_1.getComponentDecorator)(declaration) ?? (0, angular_1.getDirectiveDecorator)(declaration);
+        const decorator = (0, get_component_decorator_1.getComponentDecorator)(declaration) ?? (0, get_directive_decorator_1.getDirectiveDecorator)(declaration);
         if (decorator) {
             return decorator.selector?.split(',').map((s) => s.trim()) ?? [];
         }
@@ -23,7 +25,7 @@ function extractSelectors(declaration) {
  */
 function getPipeName(declaration) {
     if (ts_morph_1.Node.isClassDeclaration(declaration)) {
-        const decorator = (0, angular_1.getPipeDecorator)(declaration);
+        const decorator = (0, get_pipe_decorator_1.getPipeDecorator)(declaration);
         if (decorator) {
             return decorator.name;
         }

package/helpers/extract-selectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract-selectors.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/extract-selectors.ts"],"names":[],"mappings":";;AAUA,4CAWC;AAMD,kCAUC;AApCD,uCAAgC;AAGhC,uCAA2F;AAE3F;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,WAAsC;IACrE,IAAI,eAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GACb,IAAA,+BAAqB,EAAC,WAAW,CAAC,IAAI,IAAA,+BAAqB,EAAC,WAAW,CAAC,CAAC;QAE3E,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,WAAsC;IAChE,IAAI,eAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAqB,IAAA,0BAAgB,EAAC,WAAW,CAAC,CAAC;QAElE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"extract-selectors.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/extract-selectors.ts"],"names":[],"mappings":";;AAYA,4CAWC;AAMD,kCAUC;AAtCD,uCAAgC;AAGhC,+EAA0E;AAC1E,+EAA0E;AAC1E,qEAAgE;AAEhE;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,WAAsC;IACrE,IAAI,eAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GACb,IAAA,+CAAqB,EAAC,WAAW,CAAC,IAAI,IAAA,+CAAqB,EAAC,WAAW,CAAC,CAAC;QAE3E,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,WAAsC;IAChE,IAAI,eAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAqB,IAAA,qCAAgB,EAAC,WAAW,CAAC,CAAC;QAElE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/helpers/filter-useless-members.d.ts

@@ -1,4 +1,4 @@
-import { MemberType } from './typescript';
+import type { MemberType } from './typescript/member/member-type';
 /**
  * Excludes from the passed array members that have names that are not important to the end user
  * @param members - List of members

package/helpers/format-code.d.ts

@@ -3,5 +3,6 @@ import { NgDocCodeType } from '@ng-doc/core';
  *    Format code with Prettier
  * @param code - Code to format
  * @param codeType - Type of code
+ * @param configDirectory - Optional workspace directory; omitted preserves legacy cwd lookup.
  */
-export declare function formatCode(code: string, codeType?: NgDocCodeType | null): string;
+export declare function formatCode(code: string, codeType?: NgDocCodeType | null, configDirectory?: string): string;

package/helpers/format-code.js

@@ -1,18 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatCode = formatCode;
-const sync_1 = require("@prettier/sync");
+const tslib_1 = require("tslib");
+const sync_1 = tslib_1.__importDefault(require("@prettier/sync"));
+const node_path_1 = require("node:path");
 /**
  *    Format code with Prettier
  * @param code - Code to format
  * @param codeType - Type of code
+ * @param configDirectory - Optional workspace directory; omitted preserves legacy cwd lookup.
  */
-function formatCode(code, codeType = 'TypeScript') {
+function formatCode(code, codeType = 'TypeScript', configDirectory) {
     try {
         if (codeType) {
             const parser = getPrettierParserFromCodeType(codeType);
-            const config = (0, sync_1.resolveConfig)(process.cwd(), { editorconfig: true });
-            return (0, sync_1.format)(code, { ...config, parser, embeddedLanguageFormatting: 'auto' }).trim();
+            const config = sync_1.default.resolveConfig(
+            // Prettier searches from a file's parent, so use a synthetic path inside the directory.
+            configDirectory ? (0, node_path_1.join)(configDirectory, '__ng_doc_format__.ts') : process.cwd(), { editorconfig: true, useCache: false });
+            return sync_1.default.format(code, {
+                ...config,
+                parser,
+                embeddedLanguageFormatting: 'auto',
+            }).trim();
         }
         return code.trim();
     }

package/helpers/format-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-code.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/format-code.ts"],"names":[],"mappings":";;AASA,gCAeC;AAvBD,yCAAuD;AAGvD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,WAAiC,YAAY;IACpF,IAAI,CAAC;QACH,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAkC,6BAA6B,CAAC,QAAQ,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,IAAA,oBAAa,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpE,OACE,IAAA,aAAM,EAAC,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,CACvE,CAAC,IAAI,EAAE,CAAC;QACX,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,6BAA6B,CAAC,QAAuB;IAC5D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"format-code.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/format-code.ts"],"names":[],"mappings":";;AAWA,gCA2BC;;AArCD,kEAA0C;AAC1C,yCAAiC;AAGjC;;;;;GAKG;AACH,SAAgB,UAAU,CACxB,IAAY,EACZ,WAAiC,YAAY,EAC7C,eAAwB;IAExB,IAAI,CAAC;QACH,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAkC,6BAA6B,CAAC,QAAQ,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,cAAY,CAAC,aAAa;YACvC,wFAAwF;YACxF,eAAe,CAAC,CAAC,CAAC,IAAA,gBAAI,EAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAC/E,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CACxC,CAAC;YAEF,OACE,cAAY,CAAC,MAAM,CAAC,IAAI,EAAE;gBACxB,GAAG,MAAM;gBACT,MAAM;gBACN,0BAA0B,EAAE,MAAM;aACnC,CACF,CAAC,IAAI,EAAE,CAAC;QACX,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,6BAA6B,CAAC,QAAuB;IAC5D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/helpers/import-fresh-esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-fresh-esm.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/import-fresh-esm.ts"],"names":[],"mappings":";;AAaA,wCAcC;;AA3BD,+CAAyB;AACzB,mDAA6B;AAE7B,6CAAyC;AACzC,mCAAgC;AAEhC;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAAI,UAAkB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAE3E,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAI,IAAA,aAAK,EAAC,WAAW,CAAC,CAAC,CAAC;IAEtD,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"import-fresh-esm.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/import-fresh-esm.ts"],"names":[],"mappings":";;AAaA,wCAcC;;AA3BD,+CAAyB;AACzB,mDAA6B;AAE7B,6CAAyC;AACzC,mCAAgC;AAEhC;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAAI,UAAkB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAE3E,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAI,IAAA,aAAK,EAAC,WAAW,CAAC,CAAC,CAAC;IAEtD,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/helpers/index.d.ts

@@ -24,6 +24,7 @@ export * from './is-supported-declaration';
 export * from './markdown-to-html';
 export * from './mini-pattern';
 export * from './minify-html';
+export * from './navigation-title-order';
 export * from './no-empty';
 export * from './no-line-breaks';
 export * from './not-empty-assets';
@@ -38,6 +39,7 @@ export * from './repo-link';
 export * from './snippets-from-asset';
 export * from './sort-navigation-entities';
 export * from './string-expression';
+export * from './text-order';
 export * from './to-template-string';
 export * from './typescript';
 export * from './utils';

package/helpers/index.js

@@ -27,6 +27,7 @@ tslib_1.__exportStar(require("./is-supported-declaration"), exports);
 tslib_1.__exportStar(require("./markdown-to-html"), exports);
 tslib_1.__exportStar(require("./mini-pattern"), exports);
 tslib_1.__exportStar(require("./minify-html"), exports);
+tslib_1.__exportStar(require("./navigation-title-order"), exports);
 tslib_1.__exportStar(require("./no-empty"), exports);
 tslib_1.__exportStar(require("./no-line-breaks"), exports);
 tslib_1.__exportStar(require("./not-empty-assets"), exports);
@@ -41,6 +42,7 @@ tslib_1.__exportStar(require("./repo-link"), exports);
 tslib_1.__exportStar(require("./snippets-from-asset"), exports);
 tslib_1.__exportStar(require("./sort-navigation-entities"), exports);
 tslib_1.__exportStar(require("./string-expression"), exports);
+tslib_1.__exportStar(require("./text-order"), exports);
 tslib_1.__exportStar(require("./to-template-string"), exports);
 tslib_1.__exportStar(require("./typescript"), exports);
 tslib_1.__exportStar(require("./utils"), exports);

package/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,8DAAoC;AACpC,8DAAoC;AACpC,+DAAqC;AACrC,mEAAyC;AACzC,mEAAyC;AACzC,+DAAqC;AACrC,oEAA0C;AAC1C,iDAAuB;AACvB,8DAAoC;AACpC,8DAAoC;AACpC,mEAAyC;AACzC,wDAA8B;AAC9B,+DAAqC;AACrC,oEAA0C;AAC1C,oEAA0C;AAC1C,iEAAuC;AACvC,uDAA6B;AAC7B,0DAAgC;AAChC,uDAA6B;AAC7B,6DAAmC;AACnC,kEAAwC;AACxC,qEAA2C;AAC3C,6DAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,qDAA2B;AAC3B,2DAAiC;AACjC,6DAAmC;AACnC,uDAA6B;AAC7B,kDAAwB;AACxB,yDAA+B;AAC/B,kDAAwB;AACxB,oEAA0C;AAC1C,6DAAmC;AACnC,mEAAyC;AACzC,sDAA4B;AAC5B,gEAAsC;AACtC,qEAA2C;AAC3C,8DAAoC;AACpC,+DAAqC;AACrC,uDAA6B;AAC7B,kDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,8DAAoC;AACpC,8DAAoC;AACpC,+DAAqC;AACrC,mEAAyC;AACzC,mEAAyC;AACzC,+DAAqC;AACrC,oEAA0C;AAC1C,iDAAuB;AACvB,8DAAoC;AACpC,8DAAoC;AACpC,mEAAyC;AACzC,wDAA8B;AAC9B,+DAAqC;AACrC,oEAA0C;AAC1C,oEAA0C;AAC1C,iEAAuC;AACvC,uDAA6B;AAC7B,0DAAgC;AAChC,uDAA6B;AAC7B,6DAAmC;AACnC,kEAAwC;AACxC,qEAA2C;AAC3C,6DAAmC;AACnC,yDAA+B;AAC/B,wDAA8B;AAC9B,mEAAyC;AACzC,qDAA2B;AAC3B,2DAAiC;AACjC,6DAAmC;AACnC,uDAA6B;AAC7B,kDAAwB;AACxB,yDAA+B;AAC/B,kDAAwB;AACxB,oEAA0C;AAC1C,6DAAmC;AACnC,mEAAyC;AACzC,sDAA4B;AAC5B,gEAAsC;AACtC,qEAA2C;AAC3C,8DAAoC;AACpC,uDAA6B;AAC7B,+DAAqC;AACrC,uDAA6B;AAC7B,kDAAwB"}

package/helpers/keyword-heading-title.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The title of a heading as a keyword shows it: without a decorative leading emoji, which would
+ * otherwise appear in link titles and be read aloud. Both engines build heading keywords with it.
+ * @param title - The heading text.
+ * @returns The text without the leading emoji, or the text unchanged when nothing would remain.
+ */
+export declare function keywordHeadingTitle(title: string): string;

package/helpers/keyword-heading-title.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keywordHeadingTitle = keywordHeadingTitle;
+/**
+ * A leading emoji (one pictograph with its modifiers and joined parts, or a flag) and the
+ * whitespace after it, including the no-break space that keeps a heading's anchor unchanged.
+ * `libs/utils/html/plugins/slugger.plugin.ts` matches the same emoji to hide it from assistive
+ * technology; keep both patterns in step.
+ */
+const LEADING_EMOJI = /^(?:\p{Regional_Indicator}{2}|(?:\p{Emoji_Presentation}|\p{Extended_Pictographic}️)(?:\p{Emoji_Modifier}|️|‍\p{Extended_Pictographic}️?)*)\s*/u;
+/**
+ * The title of a heading as a keyword shows it: without a decorative leading emoji, which would
+ * otherwise appear in link titles and be read aloud. Both engines build heading keywords with it.
+ * @param title - The heading text.
+ * @returns The text without the leading emoji, or the text unchanged when nothing would remain.
+ */
+function keywordHeadingTitle(title) {
+    const stripped = title.replace(LEADING_EMOJI, '');
+    return stripped ? stripped : title;
+}
+//# sourceMappingURL=keyword-heading-title.js.map

package/helpers/keyword-heading-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-heading-title.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/keyword-heading-title.ts"],"names":[],"mappings":";;AAeA,kDAIC;AAnBD;;;;;GAKG;AACH,MAAM,aAAa,GACjB,gJAAgJ,CAAC;AAEnJ;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AACrC,CAAC"}

package/helpers/markdown-to-html.js

@@ -5,7 +5,6 @@ const tslib_1 = require("tslib");
 const core_1 = require("@ng-doc/core");
 const fs = tslib_1.__importStar(require("fs"));
 const marked_1 = require("marked");
-const node_os_1 = require("node:os");
 const path = tslib_1.__importStar(require("path"));
 const parsers_1 = require("../parsers");
 const remove_lines_from_code_1 = require("./remove-lines-from-code");
@@ -28,9 +27,10 @@ function markdownToHtml(markdown, context, addDependency) {
                 const relativeFilePath = path.join(context, file);
                 const fileContent = fs
                     .readFileSync(relativeFilePath ?? '', 'utf8')
-                    .split(node_os_1.EOL)
+                    // LF on every platform, as the new engine does, so both engines render the same lines.
+                    .split('\n')
                     .slice(fileLineStart, fileLineEnd)
-                    .join(node_os_1.EOL)
+                    .join('\n')
                     .trim();
                 addDependency && addDependency(relativeFilePath);
                 code = (0, remove_lines_from_code_1.removeLinesFromCode)(fileContent);

package/helpers/markdown-to-html.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-to-html.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/markdown-to-html.ts"],"names":[],"mappings":";;AAsBA,wCAsEC;;AA5FD,uCAA0C;AAC1C,+CAAyB;AACzB,mCAAgD;AAChD,qCAA8B;AAC9B,mDAA6B;AAG7B,wCAAkD;AAClD,qEAA+D;AAC/D,mCAAgC;AAEhC,MAAM,eAAe,GAAW,gCAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAgB,EAChB,aAAqC;IAErC,MAAM,QAAQ,GAAmB;QAC/B,IAAI,CAAC,IAAY,EAAE,IAAwB;YACzC,MAAM,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,KAAK,EACL,MAAM,EACN,IAAI,GACL,GAAyB,IAAA,8BAAoB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC;YAE7E,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1D,MAAM,WAAW,GAAW,EAAE;qBAC3B,YAAY,CAAC,gBAAgB,IAAI,EAAE,EAAE,MAAM,CAAC;qBAC5C,KAAK,CAAC,aAAG,CAAC;qBACV,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC;qBACjC,IAAI,CAAC,aAAG,CAAC;qBACT,IAAI,EAAE,CAAC;gBAEV,aAAa,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAAC;gBAEjD,IAAI,GAAG,IAAA,4CAAmB,EAAC,WAAW,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,UAAU,GAAG,aAAK,CAAC,iBAAiB,CACxC,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC/B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC/B,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;aACnD,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CACxB,CAAC;YAEF,MAAM,WAAW,GAAW,8BAA8B,QAAQ,IAAI,IAAI;eACjE,QAAQ;qBACF,UAAU,KAAK,IAAA,iBAAU,EAAC,IAAI,CAAC,eAAe,CAAC;YAE9D,OAAO,KAAK;gBACV,CAAC,CAAC,2BAA2B,KAAK,WAAW,IAAI,WAAW,IAAI,IAAI,EAAE,KAClE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EACtB,IAAI,WAAW,qBAAqB;gBACtC,CAAC,CAAC,WAAW,CAAC;QAClB,CAAC;QACD,UAAU,CAAC,KAAa;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAE3C,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,4BAA4B,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,CACzE,eAAe,EACf,KAAK,CACN,sBAAsB,CAAC;YAC1B,CAAC;YAED,OAAO,sBAAsB,KAAK,sBAAsB,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAY,EAAE,KAAe;YAChC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;IAEF,eAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzB,OAAO,eAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"markdown-to-html.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/markdown-to-html.ts"],"names":[],"mappings":";;AAqBA,wCAuEC;;AA5FD,uCAA0C;AAC1C,+CAAyB;AACzB,mCAAgD;AAChD,mDAA6B;AAG7B,wCAAkD;AAClD,qEAA+D;AAC/D,mCAAgC;AAEhC,MAAM,eAAe,GAAW,gCAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAgB,EAChB,aAAqC;IAErC,MAAM,QAAQ,GAAmB;QAC/B,IAAI,CAAC,IAAY,EAAE,IAAwB;YACzC,MAAM,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,KAAK,EACL,MAAM,EACN,IAAI,GACL,GAAyB,IAAA,8BAAoB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC;YAE7E,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,MAAM,gBAAgB,GAAW,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1D,MAAM,WAAW,GAAW,EAAE;qBAC3B,YAAY,CAAC,gBAAgB,IAAI,EAAE,EAAE,MAAM,CAAC;oBAC7C,uFAAuF;qBACtF,KAAK,CAAC,IAAI,CAAC;qBACX,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC;qBACjC,IAAI,CAAC,IAAI,CAAC;qBACV,IAAI,EAAE,CAAC;gBAEV,aAAa,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAAC;gBAEjD,IAAI,GAAG,IAAA,4CAAmB,EAAC,WAAW,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,UAAU,GAAG,aAAK,CAAC,iBAAiB,CACxC,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC/B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC/B,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;aACnD,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CACxB,CAAC;YAEF,MAAM,WAAW,GAAW,8BAA8B,QAAQ,IAAI,IAAI;eACjE,QAAQ;qBACF,UAAU,KAAK,IAAA,iBAAU,EAAC,IAAI,CAAC,eAAe,CAAC;YAE9D,OAAO,KAAK;gBACV,CAAC,CAAC,2BAA2B,KAAK,WAAW,IAAI,WAAW,IAAI,IAAI,EAAE,KAClE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EACtB,IAAI,WAAW,qBAAqB;gBACtC,CAAC,CAAC,WAAW,CAAC;QAClB,CAAC;QACD,UAAU,CAAC,KAAa;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAE3C,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,4BAA4B,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,CACzE,eAAe,EACf,KAAK,CACN,sBAAsB,CAAC;YAC1B,CAAC;YAED,OAAO,sBAAsB,KAAK,sBAAsB,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAY,EAAE,KAAe;YAChC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;IAEF,eAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzB,OAAO,eAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAW,CAAC;AAC5D,CAAC"}

package/helpers/navigation-title-order.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compares two navigation titles in the fixed navigation order, in both engines: the shared text
+ * order (`compareText`), so a sidebar does not depend on the process locale.
+ * @param left - A title.
+ * @param right - Another title.
+ * @returns A negative number, zero or a positive number, as `localeCompare` does.
+ */
+export declare function compareNavigationTitles(left: string, right: string): number;

package/helpers/navigation-title-order.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareNavigationTitles = compareNavigationTitles;
+const text_order_1 = require("./text-order");
+/**
+ * Compares two navigation titles in the fixed navigation order, in both engines: the shared text
+ * order (`compareText`), so a sidebar does not depend on the process locale.
+ * @param left - A title.
+ * @param right - Another title.
+ * @returns A negative number, zero or a positive number, as `localeCompare` does.
+ */
+function compareNavigationTitles(left, right) {
+    return (0, text_order_1.compareText)(left, right);
+}
+//# sourceMappingURL=navigation-title-order.js.map

package/helpers/navigation-title-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-title-order.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/navigation-title-order.ts"],"names":[],"mappings":";;AASA,0DAEC;AAXD,6CAA2C;AAE3C;;;;;;GAMG;AACH,SAAgB,uBAAuB,CAAC,IAAY,EAAE,KAAa;IACjE,OAAO,IAAA,wBAAW,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/helpers/playground/get-playground-inputs.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPlaygroundComponentInputs = getPlaygroundComponentInputs;
 exports.getPlaygroundPipeInputs = getPlaygroundPipeInputs;
 const ts_morph_1 = require("ts-morph");
-const angular_1 = require("../angular");
+// Not the `../angular` barrel: it re-exports get-component-assets, which imports the
+// @ng-doc/builder package itself, so this helper would need a built and linked package to load.
+const get_component_inputs_1 = require("../angular/get-component-inputs");
+const get_input_name_1 = require("../angular/get-input-name");
+const get_input_type_1 = require("../angular/get-input-type");
 const get_js_doc_1 = require("../get-js-doc");
 const typescript_1 = require("../typescript");
 /**
@@ -11,8 +15,8 @@ const typescript_1 = require("../typescript");
  * @param declaration
  */
 function getPlaygroundComponentInputs(declaration) {
-    return (0, angular_1.getComponentInputs)(declaration).reduce((properties, property) => {
-        const inputName = (0, angular_1.getInputName)(property);
+    return (0, get_component_inputs_1.getComponentInputs)(declaration).reduce((properties, property) => {
+        const inputName = (0, get_input_name_1.getInputName)(property);
         return { ...properties, ...propOrParamToPlaygroundProperty(property, inputName) };
     }, {});
 }
@@ -36,7 +40,7 @@ function getPlaygroundPipeInputs(declaration) {
  */
 function propOrParamToPlaygroundProperty(propOrParam, inputName) {
     const inputType = ts_morph_1.Node.isPropertyDeclaration(propOrParam)
-        ? (0, angular_1.getInputType)(propOrParam)
+        ? (0, get_input_type_1.getInputType)(propOrParam)
         : propOrParam.getType();
     const type = (0, typescript_1.formatType)(inputType, ts_morph_1.TypeFormatFlags.NoTruncation | ts_morph_1.TypeFormatFlags.UseSingleQuotesForStringLiteralType);
     return {

package/helpers/playground/get-playground-inputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-playground-inputs.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/playground/get-playground-inputs.ts"],"names":[],"mappings":";;AAkBA,oEAUC;AAMD,0DAQC;AAzCD,uCAOkB;AAElB,wCAAmG;AACnG,8CAAmE;AACnE,8CAA2C;AAE3C;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,WAA6B;IAE7B,OAAO,IAAA,4BAAkB,EAAC,WAAW,CAAC,CAAC,MAAM,CAC3C,CAAC,UAAqC,EAAE,QAA+B,EAAE,EAAE;QACzE,MAAM,SAAS,GAAW,IAAA,sBAAY,EAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,+BAA+B,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IACpF,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,WAA6B;IACnE,OAAO,WAAW;SACf,gBAAgB,CAAC,WAAW,CAAC;SAC7B,aAAa,EAAE;SACf,KAAK,CAAC,CAAC,CAAC;SACR,MAAM,CAAC,CAAC,UAAqC,EAAE,SAA+B,EAAE,EAAE;QACjF,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,+BAA+B,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1E,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,SAAS,+BAA+B,CACtC,WAAyD,EACzD,SAAkB;IAElB,MAAM,SAAS,GAAG,eAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC;QACvD,CAAC,CAAC,IAAA,sBAAY,EAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAW,IAAA,uBAAU,EAC7B,SAAS,EACT,0BAAe,CAAC,YAAY,GAAG,0BAAe,CAAC,mCAAmC,CACnF,CAAC;IAEF,OAAO;QACL,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE;YACvB,SAAS,EAAE,SAAS,IAAI,WAAW,CAAC,OAAO,EAAE;YAC7C,IAAI;YACJ,WAAW,EACT,eAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC;gBACvC,eAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC;gBAC1C,eAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC;gBACxC,CAAC,CAAC,IAAA,gCAAmB,EAAC,WAAW,CAAC;gBAClC,CAAC,CAAC,IAAA,0BAAa,EACX,WAAW,CAAC,sBAAsB,CAAC,qBAAU,CAAC,iBAAiB,CAAC,EAChE,WAAW,CAAC,OAAO,EAAE,CACtB;YACP,OAAO,EAAE,SAAS;iBACf,aAAa,EAAE;iBACf,GAAG,CAAC,CAAC,IAAU,EAAE,EAAE,CAClB,IAAI,CAAC,OAAO,CACV,SAAS,EACT,0BAAe,CAAC,YAAY,GAAG,0BAAe,CAAC,mCAAmC,CACnF,CACF;SACJ;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-playground-inputs.js","sourceRoot":"","sources":["../../../../../libs/builder/helpers/playground/get-playground-inputs.ts"],"names":[],"mappings":";;AAuBA,oEAUC;AAMD,0DAQC;AA9CD,uCAOkB;AAElB,qFAAqF;AACrF,gGAAgG;AAChG,0EAAqE;AACrE,8DAAyD;AACzD,8DAAyD;AAEzD,8CAAmE;AACnE,8CAA2C;AAE3C;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,WAA6B;IAE7B,OAAO,IAAA,yCAAkB,EAAC,WAAW,CAAC,CAAC,MAAM,CAC3C,CAAC,UAAqC,EAAE,QAA+B,EAAE,EAAE;QACzE,MAAM,SAAS,GAAW,IAAA,6BAAY,EAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,+BAA+B,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IACpF,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,WAA6B;IACnE,OAAO,WAAW;SACf,gBAAgB,CAAC,WAAW,CAAC;SAC7B,aAAa,EAAE;SACf,KAAK,CAAC,CAAC,CAAC;SACR,MAAM,CAAC,CAAC,UAAqC,EAAE,SAA+B,EAAE,EAAE;QACjF,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,+BAA+B,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1E,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,SAAS,+BAA+B,CACtC,WAAyD,EACzD,SAAkB;IAElB,MAAM,SAAS,GAAG,eAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC;QACvD,CAAC,CAAC,IAAA,6BAAY,EAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAW,IAAA,uBAAU,EAC7B,SAAS,EACT,0BAAe,CAAC,YAAY,GAAG,0BAAe,CAAC,mCAAmC,CACnF,CAAC;IAEF,OAAO;QACL,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE;YACvB,SAAS,EAAE,SAAS,IAAI,WAAW,CAAC,OAAO,EAAE;YAC7C,IAAI;YACJ,WAAW,EACT,eAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC;gBACvC,eAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC;gBAC1C,eAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC;gBACxC,CAAC,CAAC,IAAA,gCAAmB,EAAC,WAAW,CAAC;gBAClC,CAAC,CAAC,IAAA,0BAAa,EACX,WAAW,CAAC,sBAAsB,CAAC,qBAAU,CAAC,iBAAiB,CAAC,EAChE,WAAW,CAAC,OAAO,EAAE,CACtB;YACP,OAAO,EAAE,SAAS;iBACf,aAAa,EAAE;iBACf,GAAG,CAAC,CAAC,IAAU,EAAE,EAAE,CAClB,IAAI,CAAC,OAAO,CACV,SAAS,EACT,0BAAe,CAAC,YAAY,GAAG,0BAAe,CAAC,mCAAmC,CACnF,CACF;SACJ;KACF,CAAC;AACJ,CAAC"}