@cdevhub/ngx-tw 0.4.0 → 0.6.0

package/types/cdevhub-ngx-tw-transfer.d.ts

@@ -135,13 +135,13 @@ declare class TransferComponent<T = unknown, K = unknown> extends FormFieldContr
     readonly requiredInput: _angular_core.InputSignal<boolean>;
     /** Reserved for control identification (e.g. analytics, future native-submission parity). The transfer has no single native value element, so it is not currently reflected to the DOM. Defaults to `undefined`. */
     readonly name: _angular_core.InputSignal<string | undefined>;
-    /** Id on the host element. Auto-generated as `tw-transfer-N` when unset. Used by the form-field's `<label for>` association. */
+    /** Id on the host element. Auto-generated as `tw-transfer-N` when unset. Used by the form-field's `<label for>` association. Alias: `id`. */
     readonly idInput: _angular_core.InputSignal<string | undefined>;
     /** Accessible name applied to the control when no visible label is wired. Mirrored to `aria-label`. Defaults to `undefined`. */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     /** ID of an external element that labels the control. Mirrored to `aria-labelledby`. Defaults to `undefined`. */
     readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
-    /** ID of an external element that describes the control. The form-field merges its hint / error ids alongside. Defaults to `undefined`. */
+    /** ID of an external element that describes the control. The form-field merges its hint / error ids alongside. Defaults to `undefined`. Alias: `aria-describedby`. */
     readonly ariaDescribedby: _angular_core.InputSignal<string | undefined>;
     /** Per-instance override of the {@link ErrorStateMatcher}. When omitted, uses the `TW_ERROR_STATE_MATCHER` token's value. Defaults to `undefined`. */
     readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
@@ -157,9 +157,6 @@ declare class TransferComponent<T = unknown, K = unknown> extends FormFieldContr
     private readonly focusMonitor;
     private readonly liveAnnouncer;
     private readonly ngControl;
-    private readonly parentForm;
-    private readonly parentFormGroup;
-    private readonly defaultMatcher;
     private readonly platform;
     private readonly uid;
     /** @internal Fallback id used when the consumer does not set `[id]`. */
@@ -173,16 +170,32 @@ declare class TransferComponent<T = unknown, K = unknown> extends FormFieldContr
     private readonly targetQuery;
     private readonly cvaDisabled;
     private readonly _focused;
-    private readonly _ngControlRev;
-    private readonly _formSubmitRev;
+    /** @internal Shared `errorState` / `required` / `errors` derivation — see `wireErrorState`. */
+    private readonly errorWiring;
     private readonly describedByIdsSignal;
     private readonly labelledByIdsSignal;
     private onChange;
     private onTouched;
     /** @internal Stable comparator for `[cdkListboxCompareWith]`. Keys are identity-comparable. */
     readonly compareKeys: (a: K, b: K) => boolean;
-    /** @internal */
+    /**
+     * @internal Resolved label record.
+     *
+     * Explicitly-undefined keys are dropped before merging. Root `tsconfig.json`
+     * does not set `exactOptionalPropertyTypes`, so
+     * `[labels]="{ moveAnnouncement: i18n.moved }"` type-checks even when the
+     * i18n bundle has no such key — and a plain spread would then overwrite the
+     * default with `undefined`, which reaches `formatLabel()` and throws
+     * `Cannot read properties of undefined (reading 'replace')`. Same filter
+     * `table.ts` and `timeline.ts` already use; the `Required<>` annotation only
+     * tells the truth once the filter is in place.
+     */
     readonly resolvedLabels: Signal<Required<TwTransferLabels>>;
+    /**
+     * @internal Resolved display config. Same explicitly-undefined filter as
+     * `resolvedLabels` — a plain spread let `[display]="{ listHeight: undefined }"`
+     * reach the list's inline `height` as `undefined`, collapsing the panes.
+     */
     private readonly resolvedDisplay;
     private readonly resolvedBehavior;
     /** @internal */

package/types/cdevhub-ngx-tw-tree.d.ts

@@ -108,6 +108,11 @@ declare class TreeComponent<T = unknown> {
     readonly spacerClasses: _angular_core.Signal<string>;
     readonly contentClasses: _angular_core.Signal<string>;
     constructor();
+    /**
+     * @internal Drives CDK's expansion model to match `wanted`. Idempotent — every
+     * node is compared against `tree.isExpanded` before being touched.
+     */
+    private applyExpansion;
     /** @internal Resolves a node's identity key via `trackBy`, falling back to the node itself. */
     private keyOf;
     /** @internal Direct children of a node (always a fresh mutable array). */
@@ -177,7 +182,7 @@ declare class TreeComponent<T = unknown> {
 /** Attribute directive (`[twTreeNodeToggle]="node"`) that toggles the given node's expansion on click. */
 declare class TreeNodeToggleDirective<T = unknown> {
     private readonly tree;
-    /** The node whose expansion this control toggles. */
+    /** The node whose expansion this control toggles. Alias: `twTreeNodeToggle`. */
     readonly node: _angular_core.InputSignal<T>;
     /** @internal Toggles the node and stops the click from bubbling to row activation. */
     onClick(event: Event): void;