@luzmo/ngx-lucero 1.0.1-alpha.78

package/esm/components/search.js

@@ -0,0 +1,351 @@
+import { ChangeDetectionStrategy, Component, DestroyRef, ElementRef, forwardRef, inject, Input, output, Renderer2 } from '@angular/core';
+import { NG_VALUE_ACCESSOR } from '@angular/forms';
+import '@luzmo/lucero/search';
+import * as i0 from "@angular/core";
+const _c0 = ["*"];
+/**
+ * Angular wrapper component for <luzmo-search>
+ *
+ * @slot help-text - default or non-negative help text to associate to your form element
+ * @slot negative-help-text - negative help text to associate to your form element when `invalid`
+ */
+export class LuzmoSearch {
+    elementRef = inject(ElementRef);
+    renderer = inject(Renderer2);
+    destroyRef = inject(DestroyRef);
+    host = this.elementRef.nativeElement;
+    listenerCleanup = [];
+    /** The underlying custom element instance. Use to call imperative methods. */
+    get nativeElement() {
+        return this.host;
+    }
+    action;
+    /** A string applied via `aria-label` to the form control when a user visible label is not provided. */
+    label;
+    border;
+    method;
+    /** Text that appears in the form control when it has no value set */
+    placeholder;
+    holdValueOnEscape;
+    form;
+    /** The value held by the form control */
+    value;
+    helpTextManager;
+    /** A regular expression outlining the keys that will be allowed to update the value of the form control. */
+    allowedKeys;
+    /** Whether the `value` held by the form control is invalid. */
+    invalid;
+    /** Name of the form control. */
+    name;
+    type;
+    /** Pattern the `value` must match to be valid */
+    pattern;
+    /** Whether a form control delivered with the `multiline` attribute will change size vertically to accomodate longer input */
+    grows;
+    /** Defines the maximum string length that the user can enter */
+    maxlength;
+    /** Defines the minimum string length that the user can enter */
+    minlength;
+    /** Whether the form control should accept a value longer than one line */
+    multiline;
+    /** Whether a user can interact with the value of the form control */
+    readonly;
+    /** The specific number of rows the form control should provide in the user interface */
+    rows;
+    /** The maximum number of rows the form control should grow to when `grows` is enabled. When content exceeds this limit, the textarea will show a scrollbar. A value of -1 means no maximum (unlimited growth). When set, the value must be >= 1; values < 1 will be disregarded. */
+    maxRows;
+    /** Whether the `value` held by the form control is valid. */
+    valid;
+    /** Whether to hide the validation state icons (valid/invalid icons). */
+    hideValidationIcons;
+    /** Whether to display the form control with no visible background */
+    quiet;
+    /** Whether the form control will be found to be invalid when it holds no `value` */
+    required;
+    /** What form of assistance should be provided when attempting to supply a value to the form control */
+    autocomplete;
+    /** The search form has been submitted. */
+    submitEvent = output({ alias: 'submit' });
+    /** An alteration to the value of the element has been committed by the user. */
+    changeEvent = output({ alias: 'change' });
+    /** The value of the element has changed. */
+    inputEvent = output({ alias: 'input' });
+    /** A key has been pressed. */
+    keypressEvent = output({ alias: 'keypress' });
+    constructor() {
+        this.bindEvents();
+        this.destroyRef.onDestroy(() => {
+            for (const cleanup of this.listenerCleanup) {
+                cleanup();
+            }
+        });
+    }
+    ngOnChanges(changes) {
+        for (const key of Object.keys(changes)) {
+            switch (key) {
+                case 'action':
+                    this.setHostProperty('action', changes['action'].currentValue);
+                    break;
+                case 'label':
+                    this.setHostProperty('label', changes['label'].currentValue);
+                    break;
+                case 'border':
+                    this.setHostProperty('border', changes['border'].currentValue);
+                    break;
+                case 'method':
+                    this.setHostProperty('method', changes['method'].currentValue);
+                    break;
+                case 'placeholder':
+                    this.setHostProperty('placeholder', changes['placeholder'].currentValue);
+                    break;
+                case 'holdValueOnEscape':
+                    this.setHostProperty('holdValueOnEscape', changes['holdValueOnEscape'].currentValue);
+                    break;
+                case 'form':
+                    this.setHostProperty('form', changes['form'].currentValue);
+                    break;
+                case 'value':
+                    this.setHostProperty('value', changes['value'].currentValue);
+                    break;
+                case 'helpTextManager':
+                    this.setHostProperty('helpTextManager', changes['helpTextManager'].currentValue);
+                    break;
+                case 'allowedKeys':
+                    this.setHostProperty('allowedKeys', changes['allowedKeys'].currentValue);
+                    break;
+                case 'invalid':
+                    this.setHostProperty('invalid', changes['invalid'].currentValue);
+                    break;
+                case 'name':
+                    this.setHostProperty('name', changes['name'].currentValue);
+                    break;
+                case 'type':
+                    this.setHostProperty('type', changes['type'].currentValue);
+                    break;
+                case 'pattern':
+                    this.setHostProperty('pattern', changes['pattern'].currentValue);
+                    break;
+                case 'grows':
+                    this.setHostProperty('grows', changes['grows'].currentValue);
+                    break;
+                case 'maxlength':
+                    this.setHostProperty('maxlength', changes['maxlength'].currentValue);
+                    break;
+                case 'minlength':
+                    this.setHostProperty('minlength', changes['minlength'].currentValue);
+                    break;
+                case 'multiline':
+                    this.setHostProperty('multiline', changes['multiline'].currentValue);
+                    break;
+                case 'readonly':
+                    this.setHostProperty('readonly', changes['readonly'].currentValue);
+                    break;
+                case 'rows':
+                    this.setHostProperty('rows', changes['rows'].currentValue);
+                    break;
+                case 'maxRows':
+                    this.setHostProperty('maxRows', changes['maxRows'].currentValue);
+                    break;
+                case 'valid':
+                    this.setHostProperty('valid', changes['valid'].currentValue);
+                    break;
+                case 'hideValidationIcons':
+                    this.setHostProperty('hideValidationIcons', changes['hideValidationIcons'].currentValue);
+                    break;
+                case 'quiet':
+                    this.setHostProperty('quiet', changes['quiet'].currentValue);
+                    break;
+                case 'required':
+                    this.setHostProperty('required', changes['required'].currentValue);
+                    break;
+                case 'autocomplete':
+                    this.setHostProperty('autocomplete', changes['autocomplete'].currentValue);
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+    /**
+     * Forward a wrapper @Input to the underlying host element via Renderer2 so
+     * the wrapper stays compatible with non-DOM Angular platforms (SSR, tests).
+     * Unlike a "skip undefined" guard, this lets consumers reset values back to
+     * undefined / null by clearing their bindings.
+     */
+    setHostProperty(key, value) {
+        this.renderer.setProperty(this.host, key, value);
+    }
+    bindEvents() {
+        this.listenerCleanup.push(this.renderer.listen(this.host, 'submit', (event) => {
+            this.submitEvent.emit(event);
+        }));
+        this.listenerCleanup.push(this.renderer.listen(this.host, 'change', (event) => {
+            this.changeEvent.emit(event);
+            if (!this.isWritingValue) {
+                const eventWithDetail = event;
+                const eventTarget = event.target;
+                const detail = 'detail' in eventWithDetail ? eventWithDetail.detail : undefined;
+                const hostRecord = this.host;
+                const nextValue = (detail
+                    ?? eventTarget?.['value']
+                    ?? hostRecord['value']);
+                if (Object.is(this.lastCvaValue, nextValue)) {
+                    return;
+                }
+                this.lastCvaValue = nextValue;
+                this.setHostProperty('value', nextValue);
+                this.onChange(nextValue);
+            }
+        }));
+        this.listenerCleanup.push(this.renderer.listen(this.host, 'input', (event) => {
+            this.inputEvent.emit(event);
+        }));
+        this.listenerCleanup.push(this.renderer.listen(this.host, 'keypress', (event) => {
+            this.keypressEvent.emit(event);
+        }));
+        this.listenerCleanup.push(this.renderer.listen(this.host, 'blur', () => {
+            this.onTouched();
+        }));
+    }
+    onChange = () => { };
+    onTouched = () => { };
+    isWritingValue = false;
+    lastCvaValue;
+    writeValue(value) {
+        this.isWritingValue = true;
+        this.lastCvaValue = value;
+        this.setHostProperty('value', value);
+        this.isWritingValue = false;
+    }
+    registerOnChange(fn) {
+        this.onChange = fn;
+    }
+    registerOnTouched(fn) {
+        this.onTouched = fn;
+    }
+    setDisabledState(isDisabled) {
+        // Underlying element does not declare a 'disabled' field; nothing to do.
+        void isDisabled;
+    }
+    reset() {
+        return this.host.reset();
+    }
+    /** Sets the start and end positions of the current selection. */
+    setSelectionRange(selectionStart, selectionEnd, selectionDirection) {
+        return this.host.setSelectionRange(selectionStart, selectionEnd, selectionDirection);
+    }
+    /** Selects all the text. */
+    select() {
+        return this.host.select();
+    }
+    checkValidity() {
+        return this.host.checkValidity();
+    }
+    static ɵfac = function LuzmoSearch_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || LuzmoSearch)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: LuzmoSearch, selectors: [["luzmo-search"]], inputs: { action: "action", label: "label", border: "border", method: "method", placeholder: "placeholder", holdValueOnEscape: [0, "hold-value-on-escape", "holdValueOnEscape"], form: "form", value: "value", helpTextManager: [0, "help-text-manager", "helpTextManager"], allowedKeys: [0, "allowed-keys", "allowedKeys"], invalid: "invalid", name: "name", type: "type", pattern: "pattern", grows: "grows", maxlength: "maxlength", minlength: "minlength", multiline: "multiline", readonly: "readonly", rows: "rows", maxRows: [0, "max-rows", "maxRows"], valid: "valid", hideValidationIcons: [0, "hide-validation-icons", "hideValidationIcons"], quiet: "quiet", required: "required", autocomplete: "autocomplete" }, outputs: { submitEvent: "submit", changeEvent: "change", inputEvent: "input", keypressEvent: "keypress" }, exportAs: ["luzmoSearch"], features: [i0.ɵɵProvidersFeature([
+                {
+                    provide: NG_VALUE_ACCESSOR,
+                    useExisting: forwardRef(() => LuzmoSearch),
+                    multi: true
+                }
+            ]), i0.ɵɵNgOnChangesFeature], ngContentSelectors: _c0, decls: 1, vars: 0, template: function LuzmoSearch_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵprojectionDef();
+            i0.ɵɵprojection(0);
+        } }, encapsulation: 2, changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(LuzmoSearch, [{
+        type: Component,
+        args: [{
+                selector: 'luzmo-search',
+                exportAs: 'luzmoSearch',
+                standalone: true,
+                changeDetection: ChangeDetectionStrategy.OnPush,
+                template: '<ng-content />',
+                providers: [
+                    {
+                        provide: NG_VALUE_ACCESSOR,
+                        useExisting: forwardRef(() => LuzmoSearch),
+                        multi: true
+                    }
+                ]
+            }]
+    }], () => [], { action: [{
+            type: Input,
+            args: [{ alias: 'action' }]
+        }], label: [{
+            type: Input,
+            args: [{ alias: 'label' }]
+        }], border: [{
+            type: Input,
+            args: [{ alias: 'border' }]
+        }], method: [{
+            type: Input,
+            args: [{ alias: 'method' }]
+        }], placeholder: [{
+            type: Input,
+            args: [{ alias: 'placeholder' }]
+        }], holdValueOnEscape: [{
+            type: Input,
+            args: [{ alias: 'hold-value-on-escape' }]
+        }], form: [{
+            type: Input,
+            args: [{ alias: 'form' }]
+        }], value: [{
+            type: Input,
+            args: [{ alias: 'value' }]
+        }], helpTextManager: [{
+            type: Input,
+            args: [{ alias: 'help-text-manager' }]
+        }], allowedKeys: [{
+            type: Input,
+            args: [{ alias: 'allowed-keys' }]
+        }], invalid: [{
+            type: Input,
+            args: [{ alias: 'invalid' }]
+        }], name: [{
+            type: Input,
+            args: [{ alias: 'name' }]
+        }], type: [{
+            type: Input,
+            args: [{ alias: 'type' }]
+        }], pattern: [{
+            type: Input,
+            args: [{ alias: 'pattern' }]
+        }], grows: [{
+            type: Input,
+            args: [{ alias: 'grows' }]
+        }], maxlength: [{
+            type: Input,
+            args: [{ alias: 'maxlength' }]
+        }], minlength: [{
+            type: Input,
+            args: [{ alias: 'minlength' }]
+        }], multiline: [{
+            type: Input,
+            args: [{ alias: 'multiline' }]
+        }], readonly: [{
+            type: Input,
+            args: [{ alias: 'readonly' }]
+        }], rows: [{
+            type: Input,
+            args: [{ alias: 'rows' }]
+        }], maxRows: [{
+            type: Input,
+            args: [{ alias: 'max-rows' }]
+        }], valid: [{
+            type: Input,
+            args: [{ alias: 'valid' }]
+        }], hideValidationIcons: [{
+            type: Input,
+            args: [{ alias: 'hide-validation-icons' }]
+        }], quiet: [{
+            type: Input,
+            args: [{ alias: 'quiet' }]
+        }], required: [{
+            type: Input,
+            args: [{ alias: 'required' }]
+        }], autocomplete: [{
+            type: Input,
+            args: [{ alias: 'autocomplete' }]
+        }], submitEvent: [{ type: i0.Output, args: ["submit"] }], changeEvent: [{ type: i0.Output, args: ["change"] }], inputEvent: [{ type: i0.Output, args: ["input"] }], keypressEvent: [{ type: i0.Output, args: ["keypress"] }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(LuzmoSearch, { className: "LuzmoSearch", filePath: "components/search.ts", lineNumber: 26 }); })();

package/esm/components/select.d.ts

@@ -0,0 +1,82 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import '@luzmo/lucero/select';
+import type { LuzmoSelect as LuzmoSelectHostElement } from '@luzmo/lucero/select';
+import * as i0 from "@angular/core";
+export declare class LuzmoSelect implements OnChanges, ControlValueAccessor {
+    private readonly elementRef;
+    private readonly renderer;
+    private readonly destroyRef;
+    private readonly host;
+    private readonly listenerCleanup;
+    /** The underlying custom element instance. Use to call imperative methods. */
+    get nativeElement(): LuzmoSelectHostElement;
+    disabled?: boolean;
+    focused?: boolean;
+    icons?: 'only' | 'none';
+    variant?: 'checkmarks' | 'checkboxes' | 'highlight';
+    emphasized?: boolean;
+    invalid?: boolean;
+    search?: 'on' | 'off' | 'auto';
+    noWrap?: boolean;
+    retrieving?: boolean;
+    pending?: boolean;
+    clearable?: boolean;
+    hideDropdownIcon?: boolean;
+    /** Defines a string value that labels the Picker while it is in pending state. */
+    pendingLabel?: string;
+    /** Defines a string value that labels the search input field. */
+    searchLabel?: string;
+    /** Defines a string value that is displayed when no results are found. */
+    noResultsLabel?: string;
+    noDataLabel?: string;
+    multipleLabelTemplate?: string;
+    label?: string;
+    open?: boolean;
+    readonly?: boolean;
+    labelAlignment?: 'inline';
+    placement?: "top" | "top-start" | "top-end" | "right" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end";
+    quiet?: boolean;
+    /** The value of the select. */
+    value?: (string | number | null)[];
+    /** The options of the select. */
+    options?: any[];
+    /** Optional icon renderer callback forwarded to luzmo-options. Return null to use the default icon/imgSrc rendering. */
+    optionIconRenderer?: unknown;
+    selects?: never | 'single' | 'multiple';
+    /** Announces that the `value` of the element has changed */
+    readonly changeEvent: import("@angular/core").OutputEmitterRef<CustomEvent<unknown>>;
+    /** Announces that the user has scrolled within the options menu. Only fires when the options menu is virtualized. */
+    readonly luzmoScrolledEvent: import("@angular/core").OutputEmitterRef<CustomEvent<unknown>>;
+    /** Announces that the search has been updated */
+    readonly luzmoSearchEvent: import("@angular/core").OutputEmitterRef<CustomEvent<unknown>>;
+    /** Announces that the overlay has been opened */
+    readonly luzmoOpenedEvent: import("@angular/core").OutputEmitterRef<CustomEvent<unknown>>;
+    /** Announces that the overlay has been closed */
+    readonly luzmoClosedEvent: import("@angular/core").OutputEmitterRef<CustomEvent<unknown>>;
+    constructor();
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Forward a wrapper @Input to the underlying host element via Renderer2 so
+     * the wrapper stays compatible with non-DOM Angular platforms (SSR, tests).
+     * Unlike a "skip undefined" guard, this lets consumers reset values back to
+     * undefined / null by clearing their bindings.
+     */
+    private setHostProperty;
+    private bindEvents;
+    private onChange;
+    private onTouched;
+    private isWritingValue;
+    private lastCvaValue;
+    writeValue(value: (string | number | null)[]): void;
+    registerOnChange(fn: (value: (string | number | null)[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    focus(options?: FocusOptions): void;
+    toggle(target?: boolean): void;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LuzmoSelect, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LuzmoSelect, "luzmo-select", ["luzmoSelect"], { "disabled": { "alias": "disabled"; "required": false; }; "focused": { "alias": "focused"; "required": false; }; "icons": { "alias": "icons"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "emphasized": { "alias": "emphasized"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "search": { "alias": "search"; "required": false; }; "noWrap": { "alias": "no-wrap"; "required": false; }; "retrieving": { "alias": "retrieving"; "required": false; }; "pending": { "alias": "pending"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "hideDropdownIcon": { "alias": "hide-dropdown-icon"; "required": false; }; "pendingLabel": { "alias": "pending-label"; "required": false; }; "searchLabel": { "alias": "search-label"; "required": false; }; "noResultsLabel": { "alias": "no-results-label"; "required": false; }; "noDataLabel": { "alias": "no-data-label"; "required": false; }; "multipleLabelTemplate": { "alias": "multiple-label-template"; "required": false; }; "label": { "alias": "label"; "required": false; }; "open": { "alias": "open"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "labelAlignment": { "alias": "label-alignment"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "quiet": { "alias": "quiet"; "required": false; }; "value": { "alias": "value"; "required": false; }; "options": { "alias": "options"; "required": false; }; "optionIconRenderer": { "alias": "option-icon-renderer"; "required": false; }; "selects": { "alias": "selects"; "required": false; }; }, { "changeEvent": "change"; "luzmoScrolledEvent": "luzmo-scrolled"; "luzmoSearchEvent": "luzmo-search"; "luzmoOpenedEvent": "luzmo-opened"; "luzmoClosedEvent": "luzmo-closed"; }, never, ["*"], true, never>;
+}
+/** The underlying custom element type for LuzmoSelect */
+export type LuzmoSelectElement = LuzmoSelectHostElement;