@alloy-js/core 0.23.0-dev.8 → 0.23.0

package/dist/src/binder.d.ts

@@ -71,7 +71,9 @@ export interface Binder {
  * * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference.
  * * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope.
  * * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration
- * * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.
+ * * **memberPath**: [bar]
+ * * **lexicalDeclaration**: foo
+ * For deeper chains (e.g., foo.bar.baz where bar and baz are member symbols, foo is not): memberPath = [bar, baz], lexicalDeclaration = foo.
  */
 export interface ResolutionResult<TScope extends OutputScope, TSymbol extends OutputSymbol> {
     /**
@@ -108,8 +110,8 @@ export interface ResolutionResult<TScope extends OutputScope, TSymbol extends Ou
      */
     commonScope: TScope | undefined;
     /**
-     * When resolving a member symbol, this is the path of symbols that lead from
-     * the lexical declaration to the member symbol.
+     * Member symbols from the lexical declaration (exclusive) to the resolved symbol
+     * (inclusive). Empty when resolving a non-member symbol.
      */
     memberPath: TSymbol[];
 }
@@ -121,6 +123,36 @@ export interface MemberDescriptor {
     symbol: OutputSymbol;
     isMemberAccess: boolean;
 }
+/**
+ * A callable interface invoked by the binder when two or more symbols in the
+ * same scope share a name. The resolver mutates symbol names to eliminate
+ * conflicts (e.g., appending `_2`, `_3`).
+ *
+ * @remarks
+ * The resolver is called with the shared `name` and all symbols in the scope
+ * that have that original name. Rename a symbol by assigning to `symbol.name`.
+ * Symbols with `ignoreNameConflict: true` are excluded. The default resolver
+ * keeps the first symbol unchanged and renames subsequent ones
+ * `originalName + "_2"`, `originalName + "_3"`, etc.
+ *
+ * Assigned names pass through the active name policy before being stored;
+ * design suffixes to produce the correct final name after policy
+ * transformation, or set `ignoreNamePolicy` on the symbol after resolution.
+ *
+ * Conflict detection is keyed on `originalName`
+ * (see {@link OutputSymbol.originalName}). Symbols that differ in original
+ * name but normalize to the same policy-applied name are never detected as
+ * conflicting.
+ *
+ * @example
+ * ```ts
+ * const resolver: NameConflictResolver = (name, symbols) => {
+ *   for (let i = 1; i < symbols.length; i++) {
+ *     symbols[i].name = symbols[i].originalName + "_" + (i + 1);
+ *   }
+ * };
+ * ```
+ */
 export interface NameConflictResolver {
     (name: string, symbols: OutputSymbol[]): void;
 }
@@ -141,7 +173,28 @@ export interface MemberResolutionContext<TScope extends OutputScope> {
     isMemberAccess: boolean;
 }
 /**
+ * A callback that performs access-control filtering during member resolution.
  *
+ * @remarks
+ *
+ * When provided to {@link ResolveDeclarationByKeyOptions}, it entirely replaces
+ * the default checks (ownership assertion and `isMemberSymbol` assertion).
+ *
+ * **Contract:**
+ * - **Return `void`** to accept the member.
+ * - **Throw an error** to reject the member — the error propagates to the caller,
+ *   matching the behavior of the default checks.
+ *
+ * @example
+ * ```ts
+ * const resolver: MemberResolver<MyScope, MySymbol> = (owner, member, ctx) => {
+ *   if (member.isPrivate && !ctx.isMemberAccess) {
+ *     throw new Error(`${member.name} is not accessible here`);
+ *   }
+ * };
+ * ```
+ *
+ * @see {@link MemberResolutionContext} for available context properties.
  */
 export interface MemberResolver<TScope extends OutputScope, TSymbol extends OutputSymbol> {
     (owner: TSymbol, member: TSymbol, context: MemberResolutionContext<TScope>): void;
@@ -152,7 +205,44 @@ export interface ResolveDeclarationByKeyOptions<TScope extends OutputScope, TSym
 export interface BinderOptions {
     nameConflictResolver?: NameConflictResolver;
 }
+/**
+ * Construct a scope instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the scope.
+ *
+ * @remarks
+ *
+ * Inside a component, obtain the current scope with `useScope()` and pass it
+ * as the `parentScope` constructor argument so the new scope is wired into
+ * the scope tree.
+ *
+ * @example
+ * ```tsx
+ * function MyScope(props) {
+ *   const parentScope = useScope();
+ *   const scope = createScope(MyScope, "scope-name", parentScope);
+ *   return <Scope value={scope}>{props.children}</Scope>;
+ * }
+ * ```
+ *
+ * @param ctor - The scope subclass constructor.
+ * @param args - Positional arguments forwarded directly to the scope
+ * constructor; see {@link OutputScope} for the base-class constructor
+ * signature.
+ */
 export declare function createScope<TScope extends OutputScope, Args extends unknown[]>(ctor: new (...args: Args) => TScope, ...args: Args): TScope;
+/**
+ * Construct a symbol instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the symbol.
+ *
+ * @remarks
+ *
+ * Binder registration (via `useBinder()` + `notifySymbolCreated()`) happens
+ * inside the `OutputSymbol` constructor regardless of whether you use
+ * `createSymbol` or `new`. This helper only adds devtools registration.
+ *
+ * @param ctor - The symbol subclass constructor.
+ * @param args - Arguments forwarded to the constructor.
+ */
 export declare function createSymbol<TSymbol extends OutputSymbol, Args extends unknown[]>(ctor: new (...args: Args) => TSymbol, ...args: Args): TSymbol;
 export declare function createOutputBinder(options?: BinderOptions): Binder;
 /**
@@ -181,6 +271,20 @@ export declare function symbolForRefkey(refkey: Refkeyable): Ref<OutputSymbol |
 declare const createSymbolsSymbol: unique symbol;
 export declare function getSymbolCreator(creator: SymbolCreator): SymbolCreator[typeof createSymbolsSymbol];
 export declare function getSymbolCreatorSymbol(): typeof createSymbolsSymbol;
+/**
+ * An object that can register symbols into a binder. Pass instances to the
+ * `externals` prop of `<Output>` to make library symbols resolvable.
+ *
+ * @remarks
+ * `SymbolCreator` is a low-level core mechanism for eager symbol registration.
+ * The recommended pattern for language packages is lazy self-registration:
+ * implement `[TO_SYMBOL]()` on descriptors to call `useBinder()`, create and
+ * cache symbols per binder via a `WeakMap`, and register them into the
+ * appropriate scope automatically. This approach does not require `externals`.
+ * See the C# package's `createLibrary()` for a reference implementation.
+ *
+ * See {@link TO_SYMBOL} and {@link REFKEYABLE}.
+ */
 export interface SymbolCreator {
     [createSymbolsSymbol](binder: Binder): void;
 }

package/dist/src/binder.d.ts.map

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

package/dist/src/binder.js

@@ -46,7 +46,9 @@ import { formatRefkeys, formatSymbolName } from "./tracer.js";
  * * **commonScope**: global scope, because this is the most specific scope that contains both the declaration and the reference.
  * * **pathUp**: [namespace scope 2], because this is the scope between the reference and the common scope.
  * * **pathDown**: [namespace scope 1], because this is the scope between the common scope and the declaration
- * * **memberPath**: [foo, bar], because we resolved a member symbol and these are the symbols that lead from the base declaration to the member symbol.
+ * * **memberPath**: [bar]
+ * * **lexicalDeclaration**: foo
+ * For deeper chains (e.g., foo.bar.baz where bar and baz are member symbols, foo is not): memberPath = [bar, baz], lexicalDeclaration = foo.
  */
 
 /**
@@ -54,20 +56,110 @@ import { formatRefkeys, formatSymbolName } from "./tracer.js";
  * and whether this specific member was accessed via a memberRefkey.
  */
 
+/**
+ * A callable interface invoked by the binder when two or more symbols in the
+ * same scope share a name. The resolver mutates symbol names to eliminate
+ * conflicts (e.g., appending `_2`, `_3`).
+ *
+ * @remarks
+ * The resolver is called with the shared `name` and all symbols in the scope
+ * that have that original name. Rename a symbol by assigning to `symbol.name`.
+ * Symbols with `ignoreNameConflict: true` are excluded. The default resolver
+ * keeps the first symbol unchanged and renames subsequent ones
+ * `originalName + "_2"`, `originalName + "_3"`, etc.
+ *
+ * Assigned names pass through the active name policy before being stored;
+ * design suffixes to produce the correct final name after policy
+ * transformation, or set `ignoreNamePolicy` on the symbol after resolution.
+ *
+ * Conflict detection is keyed on `originalName`
+ * (see {@link OutputSymbol.originalName}). Symbols that differ in original
+ * name but normalize to the same policy-applied name are never detected as
+ * conflicting.
+ *
+ * @example
+ * ```ts
+ * const resolver: NameConflictResolver = (name, symbols) => {
+ *   for (let i = 1; i < symbols.length; i++) {
+ *     symbols[i].name = symbols[i].originalName + "_" + (i + 1);
+ *   }
+ * };
+ * ```
+ */
+
 /**
  * The context for a member resolution. This is used to properly resolve a
  * member in the MemberResolver.
  */
 
 /**
+ * A callback that performs access-control filtering during member resolution.
  *
+ * @remarks
+ *
+ * When provided to {@link ResolveDeclarationByKeyOptions}, it entirely replaces
+ * the default checks (ownership assertion and `isMemberSymbol` assertion).
+ *
+ * **Contract:**
+ * - **Return `void`** to accept the member.
+ * - **Throw an error** to reject the member — the error propagates to the caller,
+ *   matching the behavior of the default checks.
+ *
+ * @example
+ * ```ts
+ * const resolver: MemberResolver<MyScope, MySymbol> = (owner, member, ctx) => {
+ *   if (member.isPrivate && !ctx.isMemberAccess) {
+ *     throw new Error(`${member.name} is not accessible here`);
+ *   }
+ * };
+ * ```
+ *
+ * @see {@link MemberResolutionContext} for available context properties.
  */
 
+/**
+ * Construct a scope instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the scope.
+ *
+ * @remarks
+ *
+ * Inside a component, obtain the current scope with `useScope()` and pass it
+ * as the `parentScope` constructor argument so the new scope is wired into
+ * the scope tree.
+ *
+ * @example
+ * ```tsx
+ * function MyScope(props) {
+ *   const parentScope = useScope();
+ *   const scope = createScope(MyScope, "scope-name", parentScope);
+ *   return <Scope value={scope}>{props.children}</Scope>;
+ * }
+ * ```
+ *
+ * @param ctor - The scope subclass constructor.
+ * @param args - Positional arguments forwarded directly to the scope
+ * constructor; see {@link OutputScope} for the base-class constructor
+ * signature.
+ */
 export function createScope(ctor, ...args) {
   const scope = new ctor(...args);
   debug.symbols.registerScope(scope);
   return scope;
 }
+
+/**
+ * Construct a symbol instance and register it with devtools. Prefer this over
+ * calling `new` directly so that debugging tools can track the symbol.
+ *
+ * @remarks
+ *
+ * Binder registration (via `useBinder()` + `notifySymbolCreated()`) happens
+ * inside the `OutputSymbol` constructor regardless of whether you use
+ * `createSymbol` or `new`. This helper only adds devtools registration.
+ *
+ * @param ctor - The symbol subclass constructor.
+ * @param args - Arguments forwarded to the constructor.
+ */
 export function createSymbol(ctor, ...args) {
   const symbol = new ctor(...args);
   debug.symbols.registerSymbol(symbol);
@@ -401,6 +493,11 @@ export function createOutputBinder(options = {}) {
         }
       }
       return [...symbol.refkeys];
+    }, undefined, {
+      debug: {
+        name: "binder:notifySymbolCreated",
+        type: "binder"
+      }
     });
   }
 }
@@ -480,4 +577,19 @@ export function getSymbolCreator(creator) {
 export function getSymbolCreatorSymbol() {
   return createSymbolsSymbol;
 }
+
+/**
+ * An object that can register symbols into a binder. Pass instances to the
+ * `externals` prop of `<Output>` to make library symbols resolvable.
+ *
+ * @remarks
+ * `SymbolCreator` is a low-level core mechanism for eager symbol registration.
+ * The recommended pattern for language packages is lazy self-registration:
+ * implement `[TO_SYMBOL]()` on descriptors to call `useBinder()`, create and
+ * cache symbols per binder via a `WeakMap`, and register them into the
+ * appropriate scope automatically. This approach does not require `externals`.
+ * See the C# package's `createLibrary()` for a reference implementation.
+ *
+ * See {@link TO_SYMBOL} and {@link REFKEYABLE}.
+ */
 //# sourceMappingURL=binder.js.map

package/dist/src/binder.js.map

@@ -1 +1 @@
-{"version":3,"names":["computed","shallowRef","useBinder","useMemberContext","useScope","debug","TracePhase","emitDiagnostic","effect","onCleanup","inspectRefkey","isMemberRefkey","refkey","toRefkey","formatRefkeys","formatSymbolName","createScope","ctor","args","scope","symbols","registerScope","createSymbol","symbol","registerSymbol","createOutputBinder","options","binder","resolveDeclarationByKey","getSymbolForRefkey","notifyScopeCreated","notifySymbolCreated","notifySymbolDeleted","nameConflictResolver","knownDeclarations","Map","waitingDeclarations","waitingSymbolNames","waitingScopeNames","parent","has","waiting","get","name","ref","value","unregisterSymbol","refkeys","resolution","undefined","buildResult","currentScope","targetDeclarationBase","memberPath","targetMemberPath","scopeChain","targetChain","scopeAndMemberChain","targetLexicalDeclaration","length","ownerSymbol","referenceChain","inScopeSymbols","isMemberScope","set","push","shift","index","entries","commonMemberContainer","findIndex","sourceLocation","splice","slice","diffStart","pathUp","pathDown","commonScope","lexicalDeclaration","fullSymbolPath","fullReferencePath","result","currentSymbol","isMemberSymbol","unshift","startScope","chain","refkeyable","symbolRef","baseSymbolRef","base","memberSymbolRef","getMemberSymbolFromMemberRefkey","baseSymbol","memberSymbol","resolvedSymbol","trace","resolve","pending","failure","isTransient","some","memberDescriptorsFromRefkey","getMemberPathFromRefkey","newMemberPathDescriptors","allDescriptors","map","s","isMemberAccess","descriptor","at","currentBase","member","isTyped","hasTypeSymbol","resolveMember","memberResolver","referencePath","success","resolveMemberByName","context","Error","memberOwner","type","dealias","oldRefkeys","includes","delete","signal","waitingScope","waitingName","memberScope","diagnosticHandle","severity","message","dismiss","symbolForRefkey","createSymbolsSymbol","Symbol","getSymbolCreator","creator","getSymbolCreatorSymbol"],"sources":["../../src/binder.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["computed","shallowRef","useBinder","useMemberContext","useScope","debug","TracePhase","emitDiagnostic","effect","onCleanup","inspectRefkey","isMemberRefkey","refkey","toRefkey","formatRefkeys","formatSymbolName","createScope","ctor","args","scope","symbols","registerScope","createSymbol","symbol","registerSymbol","createOutputBinder","options","binder","resolveDeclarationByKey","getSymbolForRefkey","notifyScopeCreated","notifySymbolCreated","notifySymbolDeleted","nameConflictResolver","knownDeclarations","Map","waitingDeclarations","waitingSymbolNames","waitingScopeNames","parent","has","waiting","get","name","ref","value","unregisterSymbol","refkeys","resolution","undefined","buildResult","currentScope","targetDeclarationBase","memberPath","targetMemberPath","scopeChain","targetChain","scopeAndMemberChain","targetLexicalDeclaration","length","ownerSymbol","referenceChain","inScopeSymbols","isMemberScope","set","push","shift","index","entries","commonMemberContainer","findIndex","sourceLocation","splice","slice","diffStart","pathUp","pathDown","commonScope","lexicalDeclaration","fullSymbolPath","fullReferencePath","result","currentSymbol","isMemberSymbol","unshift","startScope","chain","refkeyable","symbolRef","baseSymbolRef","base","memberSymbolRef","getMemberSymbolFromMemberRefkey","baseSymbol","memberSymbol","resolvedSymbol","trace","resolve","pending","failure","isTransient","some","memberDescriptorsFromRefkey","getMemberPathFromRefkey","newMemberPathDescriptors","allDescriptors","map","s","isMemberAccess","descriptor","at","currentBase","member","isTyped","hasTypeSymbol","resolveMember","memberResolver","referencePath","success","resolveMemberByName","context","Error","memberOwner","type","dealias","oldRefkeys","includes","delete","signal","waitingScope","waitingName","memberScope","diagnosticHandle","severity","message","dismiss","symbolForRefkey","createSymbolsSymbol","Symbol","getSymbolCreator","creator","getSymbolCreatorSymbol"],"sources":["../../src/binder.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAQ,EAAmBC,UAAU,QAAQ,iBAAiB;AACvE,SAASC,SAAS,QAAQ,qBAAqB;AAC/C,SAASC,gBAAgB,QAAQ,2BAA2B;AAC5D,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,KAAK,EAAEC,UAAU,QAAQ,kBAAkB;AACpD,SAASC,cAAc,QAA+B,kBAAkB;AACxE,SAASC,MAAM,EAAEC,SAAS,QAAQ,iBAAiB;AACnD,SACEC,aAAa,EACbC,cAAc,EAEdC,MAAM,EAGNC,QAAQ,QACH,aAAa;AAGpB,SAASC,aAAa,EAAEC,gBAAgB,QAAQ,aAAa;;AAG7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA+CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoDA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CACzBC,IAAmC,EACnC,GAAGC,IAAU,EACL;EACR,MAAMC,KAAK,GAAG,IAAIF,IAAI,CAAC,GAAGC,IAAI,CAAC;EAC/Bb,KAAK,CAACe,OAAO,CAACC,aAAa,CAACF,KAAK,CAAC;EAClC,OAAOA,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AA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","ignoreList":[]}

package/dist/src/components/AccessExpression.d.ts

@@ -0,0 +1,78 @@
+import { Children, ComponentDefinition, OutputSymbol, Refkeyable } from "../index.js";
+/**
+ * Base props that all language-specific Part components must include.
+ * Language packages extend this with additional props.
+ */
+export interface BasePartProps {
+    refkey?: Refkeyable;
+    symbol?: OutputSymbol;
+}
+/**
+ * Configuration for creating a language-specific access expression component.
+ *
+ * @typeParam TPartProps - The Part component's props type (extends BasePartProps)
+ * @typeParam TPart - The descriptor type that formatPart receives
+ */
+export interface AccessExpressionConfig<TPartProps extends BasePartProps, TPart> {
+    /**
+     * Convert Part props + resolved symbol into a plain descriptor object.
+     * Called once per Part during children processing. The returned descriptor
+     * is wrapped in a computed + getter delegation for reactive optimization.
+     */
+    createDescriptor(props: TPartProps, symbol: OutputSymbol | undefined, first: boolean): TPart;
+    /**
+     * Extract the base content from the first part (the leftmost identifier).
+     */
+    getBase(part: TPart): Children;
+    /**
+     * Format a non-first part given its descriptor and the previous part.
+     * Returns JSX children for that segment (e.g., `.foo`, `?.bar`, `[idx]`, `(args)`).
+     * `inCallChain` is true when rendering inside a chunked call chain.
+     */
+    formatPart(part: TPart, prevPart: TPart, inCallChain: boolean): Children;
+    /**
+     * Identify which parts are function calls, for call chain detection.
+     * When provided, the factory uses the chunked call chain algorithm
+     * (line breaks after each call group) when more than one call is detected.
+     * When omitted, the expression is always formatted linearly.
+     */
+    isCallPart?(part: TPart): boolean;
+    /**
+     * Additional check for whether call chain formatting should be used.
+     * Called only when `isCallPart` is provided and more than one call is detected.
+     * Return false to force linear formatting (e.g., TypeScript disables call
+     * chains when any part has `await`).
+     * Defaults to `() => true`.
+     */
+    canUseCallChains?(parts: TPart[]): boolean;
+    /**
+     * Post-process the accumulated expression after each part in linear
+     * (non-call-chain) mode. Use this for language-specific wrapping like
+     * TypeScript's `await` which wraps the entire expression so far.
+     * Defaults to identity (returns expression unchanged).
+     */
+    wrapPartResult?(expression: Children, part: TPart, index: number, isLast: boolean): Children;
+}
+/**
+ * Create a language-specific access/member expression component pair.
+ *
+ * Returns `{ Expression, Part }` where:
+ * - `Expression` is the main component that collects Part children and renders the chain
+ * - `Part` is a no-op component whose props are consumed by Expression
+ *
+ * The factory handles:
+ * - Children collection and Part filtering
+ * - Symbol resolution (refkey → symbol via binder, single computed per part)
+ * - Reactive optimization (getter delegation over single computed per part)
+ * - Flattening nested Expression instances
+ * - `takeSymbols()` to prevent symbol leakage
+ * - Call chain detection and chunked formatting algorithm
+ */
+export declare function createAccessExpression<TPartProps extends BasePartProps, TPart extends Record<string, unknown>>(config: AccessExpressionConfig<TPartProps, TPart>): {
+    Expression: (props: {
+        children: Children;
+    }) => Children;
+    Part: (_props: TPartProps) => void;
+    registerOuterComponent: (component: ComponentDefinition<any>) => void;
+};
+//# sourceMappingURL=AccessExpression.d.ts.map

package/dist/src/components/AccessExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessExpression.d.ts","sourceRoot":"","sources":["../../../src/components/AccessExpression.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAGR,mBAAmB,EAGnB,YAAY,EACZ,UAAU,EAGX,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB,CACrC,UAAU,SAAS,aAAa,EAChC,KAAK;IAEL;;;;OAIG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,KAAK,EAAE,OAAO,GACb,KAAK,CAAC;IAET;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAE/B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAEzE;;;;;OAKG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE3C;;;;;OAKG;IACH,cAAc,CAAC,CACb,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,QAAQ,CAAC;CACb;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,SAAS,aAAa,EAChC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC;wBAMtB;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,KAAG,QAAQ;mBAiCtC,UAAU;wCAyEW,mBAAmB,CAAC,GAAG,CAAC;EAKpE"}