forty-cdk 0.2.0 → 0.3.0

package/fesm2022/forty-cdk-field.mjs

@@ -0,0 +1,425 @@
+import * as i0 from '@angular/core';
+import { inject, signal, computed, Directive, ElementRef, DestroyRef, input, booleanAttribute } from '@angular/core';
+import { FOR_FIELD_CONTEXT, IdGenerator, FOR_FIELDSET_CONTEXT, adoptHostId, injectFieldWiring, createDefaults } from 'forty-cdk/core';
+export { FOR_FIELD_CONTEXT, injectFieldWiring } from 'forty-cdk/core';
+
+/**
+ * Resolves the surrounding `ForField` context, throwing if the consumer
+ * placed the piece outside a `[forField]` element.
+ */
+function injectFieldContext(piece) {
+    const ctx = inject(FOR_FIELD_CONTEXT, { optional: true });
+    if (!ctx) {
+        throw new Error(`[forty-cdk/field] ${piece} must be used inside a [forField] element.`);
+    }
+    return ctx;
+}
+
+/**
+ * Headless form-field container that wires accessible labelling, description,
+ * and error association for a single control. It renders nothing and imposes no
+ * layout: its only job is to connect a `[forLabel]`, `[forFieldDescription]`,
+ * and `[forFieldError]` to the control via `id` / `aria-labelledby` /
+ * `aria-describedby` / `aria-errormessage`, and to reflect the control's
+ * validation state as `data-*` hooks for styling.
+ *
+ * Any forty-cdk form control (every `FormValueControl` / `FormCheckboxControl`
+ * primitive) auto-associates when wrapped — no extra markup. A plain native
+ * `<input>` opts in with `[forFieldControl]`.
+ *
+ * Host reflects `data-invalid` / `data-disabled` / `data-required` /
+ * `data-touched` from the registered control.
+ *
+ * @example
+ * ```html
+ * <div forField>
+ *   <label forLabel>Notifications</label>
+ *   <button forSwitch [formField]="settings.notify"></button>
+ *   <p forFieldDescription>We'll only email you about security.</p>
+ *   @if (settings.notify().invalid()) {
+ *     <p forFieldError #err="forFieldError">{{ err.messages().join(', ') }}</p>
+ *   }
+ * </div>
+ * ```
+ */
+class ForField {
+    #idGen = inject(IdGenerator);
+    #fieldset = inject(FOR_FIELDSET_CONTEXT, { optional: true });
+    #controlId = signal(this.#idGen.next('for-field-control'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#controlId" }] : /* istanbul ignore next */ []));
+    #control = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#control" }] : /* istanbul ignore next */ []));
+    #hasLabel = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#hasLabel" }] : /* istanbul ignore next */ []));
+    #hasDescription = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#hasDescription" }] : /* istanbul ignore next */ []));
+    #hasError = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#hasError" }] : /* istanbul ignore next */ []));
+    /**
+     * The element the field actually targets for `id` / `aria-*` association and
+     * focus: the control's nominated `labelledElement` (Select trigger / Combobox
+     * input) when present, else its host (Listbox, native `<input>`).
+     */
+    #targetEl = computed(() => {
+        const control = this.#control();
+        if (!control) {
+            return null;
+        }
+        return control.labelledElement?.() ?? control.host;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#targetEl" }] : /* istanbul ignore next */ []));
+    /**
+     * Id assigned to the control; a label's `for` points here. Adopts a
+     * nominated control's own id (`labelledElementId`) when present so the label
+     * and the primitive's internal `aria-labelledby` resolve to the same
+     * focusable element; otherwise the field's owned/host-adopted id.
+     */
+    controlId = computed(() => this.#control()?.labelledElementId?.() ?? this.#controlId(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "controlId" }] : /* istanbul ignore next */ []));
+    /** Id of the label element. */
+    labelId = signal(this.#idGen.next('for-field-label'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labelId" }] : /* istanbul ignore next */ []));
+    /** Id of the description element. */
+    descriptionId = signal(this.#idGen.next('for-field-description'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "descriptionId" }] : /* istanbul ignore next */ []));
+    /** Id of the error element. */
+    errorId = signal(this.#idGen.next('for-field-error'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "errorId" }] : /* istanbul ignore next */ []));
+    /** The currently registered control handle, or null. */
+    control = this.#control.asReadonly();
+    /** Whether the registered control is currently invalid. */
+    invalid = computed(() => this.#control()?.invalid?.() ?? false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "invalid" }] : /* istanbul ignore next */ []));
+    /** Whether the registered control is required. */
+    required = computed(() => this.#control()?.required?.() ?? false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "required" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether the field is disabled: the registered control's own disabled state
+     * OR'd with a surrounding `[forFieldset]`'s `disabled` (so a disabled group
+     * reaches custom-role controls a native `<fieldset disabled>` can't).
+     */
+    disabled = computed(() => (this.#control()?.disabled?.() ?? false) || (this.#fieldset?.disabled() ?? false), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Whether the registered control has been touched. */
+    touched = computed(() => this.#control()?.touched?.() ?? false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "touched" }] : /* istanbul ignore next */ []));
+    /** Resolved `aria-labelledby` for the control (label id, or null). */
+    labelledBy = computed(() => (this.#hasLabel() ? this.labelId() : null), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labelledBy" }] : /* istanbul ignore next */ []));
+    /**
+     * Resolved `aria-describedby`: the description id always, plus the error id
+     * when the control is invalid. The error id is included here (in addition to
+     * `aria-errormessage`) because assistive-tech support for `aria-errormessage`
+     * is uneven; doubling it up is the widely-used robust pattern.
+     */
+    describedBy = computed(() => {
+        const ids = [];
+        if (this.#hasDescription()) {
+            ids.push(this.descriptionId());
+        }
+        if (this.#hasError() && this.invalid()) {
+            ids.push(this.errorId());
+        }
+        return ids.length > 0 ? ids.join(' ') : null;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "describedBy" }] : /* istanbul ignore next */ []));
+    /** Resolved `aria-errormessage`: the error id when present and invalid, else null. */
+    errorMessageId = computed(() => this.#hasError() && this.invalid() ? this.errorId() : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "errorMessageId" }] : /* istanbul ignore next */ []));
+    /** Register the control whose state the field reflects. */
+    registerControl(handle) {
+        this.#control.set(handle);
+        // Adopt a consumer-set id on the host (the host-is-the-control case). When
+        // the control nominates a distinct labelled element it carries its own
+        // `labelledElementId`, which `controlId` prefers — so a wrapper-host id, if
+        // any, is harmlessly ignored there.
+        adoptHostId(handle.host, this.#controlId);
+    }
+    /** Remove a previously registered control. */
+    unregisterControl(handle) {
+        if (this.#control() === handle) {
+            this.#control.set(null);
+        }
+    }
+    /**
+     * Mark the label slot present; returns an unregister callback. The field
+     * targets a single label per slot — its `labelId` / `descriptionId` /
+     * `errorId` are single ids, not id lists — so one `[forLabel]`,
+     * `[forFieldDescription]`, and `[forFieldError]` per field is the supported
+     * shape. Presence is a boolean, not a count.
+     */
+    registerLabel() {
+        this.#hasLabel.set(true);
+        return () => this.#hasLabel.set(false);
+    }
+    /** Mark the description slot present; returns an unregister callback. See {@link registerLabel} for the single-instance-per-slot contract. */
+    registerDescription() {
+        this.#hasDescription.set(true);
+        return () => this.#hasDescription.set(false);
+    }
+    /** Mark the error slot present; returns an unregister callback. See {@link registerLabel} for the single-instance-per-slot contract. */
+    registerError() {
+        this.#hasError.set(true);
+        return () => this.#hasError.set(false);
+    }
+    /**
+     * Forward a click to the control's focusable element and focus it — matching
+     * the activation a native `<label for>` triggers via the browser, so a
+     * non-`<label>` `[forLabel]` toggles a custom-role control instead of only
+     * focusing it.
+     */
+    clickControl() {
+        const target = this.#targetEl();
+        if (!target) {
+            return;
+        }
+        target.click();
+        target.focus();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForField, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: ForField, isStandalone: true, selector: "[forField]", host: { properties: { "attr.data-invalid": "invalid() ? \"\" : null", "attr.data-disabled": "disabled() ? \"\" : null", "attr.data-required": "required() ? \"\" : null", "attr.data-touched": "touched() ? \"\" : null" } }, providers: [{ provide: FOR_FIELD_CONTEXT, useExisting: ForField }], exportAs: ["forField"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForField, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forField]',
+                    exportAs: 'forField',
+                    host: {
+                        '[attr.data-invalid]': 'invalid() ? "" : null',
+                        '[attr.data-disabled]': 'disabled() ? "" : null',
+                        '[attr.data-required]': 'required() ? "" : null',
+                        '[attr.data-touched]': 'touched() ? "" : null',
+                    },
+                    providers: [{ provide: FOR_FIELD_CONTEXT, useExisting: ForField }],
+                }]
+        }] });
+
+/**
+ * Accessible label for a form control. Inside a `[forField]` it auto-wires:
+ * it adopts the field's `labelId` and registers itself so the control gains
+ * `aria-labelledby`.
+ *
+ * Click-to-activate is consistent across both host shapes: a native `<label>`
+ * emits `for` and the browser forwards the click to the control (toggling a
+ * checkbox / switch, activating a button); a non-`<label>` host has no native
+ * `for` forwarding, so the directive forwards the click itself — clicking the
+ * label activates the control either way, not just focuses it. A click that
+ * originated on the control (when the control is nested inside the label host)
+ * is not re-forwarded, so a label-wrapping layout toggles once, matching native
+ * `<label>` semantics.
+ *
+ * Usable standalone outside a field — there it is an inert
+ * marker and the consumer wires native `for` themselves.
+ *
+ * @example
+ * ```html
+ * <div forField>
+ *   <label forLabel>Email</label>
+ *   <input forFieldControl type="email" />
+ * </div>
+ * ```
+ */
+class ForLabel {
+    ctx = inject(FOR_FIELD_CONTEXT, { optional: true });
+    #host = inject(ElementRef);
+    /** The label's id when inside a field, else null. */
+    labelId = computed(() => this.ctx?.labelId() ?? null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labelId" }] : /* istanbul ignore next */ []));
+    /** `for` is only meaningful on a native `<label>`; null otherwise. */
+    forAttr = computed(() => {
+        if (!this.ctx || this.#host.nativeElement.tagName !== 'LABEL') {
+            return null;
+        }
+        return this.ctx.controlId();
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "forAttr" }] : /* istanbul ignore next */ []));
+    constructor() {
+        const ctx = this.ctx;
+        if (ctx) {
+            const unregister = ctx.registerLabel();
+            inject(DestroyRef).onDestroy(unregister);
+        }
+    }
+    onClick(event) {
+        if (!this.ctx || this.#host.nativeElement.tagName === 'LABEL') {
+            return;
+        }
+        // When the control is nested inside the label host (label wraps control),
+        // a click on the control already activates it natively; forwarding again
+        // would double-toggle. Mirror native `<label>` semantics and bail when the
+        // click originated from the control (or anything inside it).
+        const control = this.ctx.control();
+        const controlEl = control?.labelledElement?.() ?? control?.host ?? null;
+        const target = event.target;
+        if (controlEl && target && controlEl.contains(target)) {
+            return;
+        }
+        this.ctx.clickControl();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForLabel, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: ForLabel, isStandalone: true, selector: "[forLabel]", host: { listeners: { "click": "onClick($event)" }, properties: { "attr.id": "labelId()", "attr.for": "forAttr()" } }, exportAs: ["forLabel"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForLabel, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forLabel]',
+                    exportAs: 'forLabel',
+                    host: {
+                        '[attr.id]': 'labelId()',
+                        '[attr.for]': 'forAttr()',
+                        '(click)': 'onClick($event)',
+                    },
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Supplementary description / hint for a form control. Adopts the field's
+ * `descriptionId` and registers itself so the control gains
+ * `aria-describedby`. Apply on a `<p>` / `<span>` inside a `[forField]`.
+ */
+class ForFieldDescription {
+    ctx = injectFieldContext('ForFieldDescription');
+    constructor() {
+        const unregister = this.ctx.registerDescription();
+        inject(DestroyRef).onDestroy(unregister);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldDescription, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: ForFieldDescription, isStandalone: true, selector: "[forFieldDescription]", host: { properties: { "attr.id": "ctx.descriptionId()" } }, exportAs: ["forFieldDescription"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldDescription, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forFieldDescription]',
+                    exportAs: 'forFieldDescription',
+                    host: {
+                        '[attr.id]': 'ctx.descriptionId()',
+                    },
+                }]
+        }], ctorParameters: () => [] });
+
+function extractMessage(error) {
+    if ('message' in error && typeof error.message === 'string' && error.message !== '') {
+        return error.message;
+    }
+    return error.kind;
+}
+/**
+ * Error region for a form control. Adopts the field's `errorId`, registers
+ * itself so the control gains `aria-errormessage` (and the id is folded into
+ * `aria-describedby`) while invalid, and **reads the control's Signal Forms
+ * validation errors automatically** — the consumer renders `messages()` (or
+ * the raw `errors()`) without any manual plumbing.
+ *
+ * Carries `role="alert"`. Drive its presence with `@if (err.shown())` (or the
+ * field's own `invalid()`); when unmounted the control's `aria-errormessage`
+ * drops automatically.
+ *
+ * @example
+ * ```html
+ * @if (err.shown()) {
+ *   <p forFieldError #err="forFieldError">{{ err.messages().join(', ') }}</p>
+ * }
+ * ```
+ */
+class ForFieldError {
+    ctx = injectFieldContext('ForFieldError');
+    /** The control's current validation errors (Signal Forms). */
+    errors = computed(() => this.ctx.control()?.errors?.() ?? [], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "errors" }] : /* istanbul ignore next */ []));
+    /** Human-readable messages derived from {@link errors}. */
+    messages = computed(() => this.errors().map((error) => extractMessage(error)), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "messages" }] : /* istanbul ignore next */ []));
+    /** Whether the control currently has at least one error. */
+    hasErrors = computed(() => this.errors().length > 0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "hasErrors" }] : /* istanbul ignore next */ []));
+    /** Whether the error region should be shown (control invalid and has errors). */
+    shown = computed(() => this.ctx.invalid() && this.hasErrors(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "shown" }] : /* istanbul ignore next */ []));
+    constructor() {
+        const unregister = this.ctx.registerError();
+        inject(DestroyRef).onDestroy(unregister);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldError, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: ForFieldError, isStandalone: true, selector: "[forFieldError]", host: { attributes: { "role": "alert" }, properties: { "attr.id": "ctx.errorId()" } }, exportAs: ["forFieldError"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldError, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forFieldError]',
+                    exportAs: 'forFieldError',
+                    host: {
+                        '[attr.id]': 'ctx.errorId()',
+                        role: 'alert',
+                    },
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Opt-in marker that wires a non-forty-cdk control — a native `<input>`,
+ * `<textarea>`, `<select>`, or any custom element — into its surrounding
+ * `[forField]`. forty-cdk form primitives (which extend the shared form base)
+ * auto-wire and do **not** need this; it exists for plain native controls that
+ * have no primitive of their own.
+ *
+ * Validation state is consumer-driven via the `invalid` / `required` /
+ * `disabled` / `touched` inputs (native controls have no Signal Forms errors
+ * to surface). Reflects `aria-invalid` on the host.
+ *
+ * @example
+ * ```html
+ * <div forField>
+ *   <label forLabel>Email</label>
+ *   <input forFieldControl type="email" [invalid]="emailInvalid()" />
+ * </div>
+ * ```
+ */
+class ForFieldControl {
+    /** Marks the control invalid — drives the field's error region and `aria-invalid`. */
+    invalid = input(false, { ...(ngDevMode ? { debugName: "invalid" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** Marks the control required — reflected by the field as `data-required`. */
+    required = input(false, { ...(ngDevMode ? { debugName: "required" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** Marks the control disabled — reflected by the field as `data-disabled`. */
+    disabled = input(false, { ...(ngDevMode ? { debugName: "disabled" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** Marks the control touched — reflected by the field as `data-touched`. */
+    touched = input(false, { ...(ngDevMode ? { debugName: "touched" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    constructor() {
+        injectFieldWiring({
+            invalid: this.invalid,
+            required: this.required,
+            disabled: this.disabled,
+            touched: this.touched,
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldControl, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.2", type: ForFieldControl, isStandalone: true, selector: "[forFieldControl]", inputs: { invalid: { classPropertyName: "invalid", publicName: "invalid", isSignal: true, isRequired: false, transformFunction: null }, required: { classPropertyName: "required", publicName: "required", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, touched: { classPropertyName: "touched", publicName: "touched", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.aria-invalid": "invalid() ? \"true\" : null" } }, exportAs: ["forFieldControl"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldControl, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forFieldControl]',
+                    exportAs: 'forFieldControl',
+                    host: {
+                        '[attr.aria-invalid]': 'invalid() ? "true" : null',
+                    },
+                }]
+        }], ctorParameters: () => [], propDecorators: { invalid: [{ type: i0.Input, args: [{ isSignal: true, alias: "invalid", required: false }] }], required: [{ type: i0.Input, args: [{ isSignal: true, alias: "required", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], touched: [{ type: i0.Input, args: [{ isSignal: true, alias: "touched", required: false }] }] } });
+
+const FALLBACK = {};
+const { token, provideDefaults } = createDefaults('FOR_FIELD_DEFAULTS', FALLBACK);
+/** Token holding the resolved field defaults for the current scope. */
+const FOR_FIELD_DEFAULTS = token;
+/**
+ * Configures forty-cdk field defaults for this injector scope. Partial
+ * overrides inherit unspecified keys from the parent scope (or library
+ * defaults at the root).
+ */
+function provideForFieldDefaults(defaults = {}) {
+    return provideDefaults(defaults);
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FOR_FIELD_DEFAULTS, ForField, ForFieldControl, ForFieldDescription, ForFieldError, ForLabel, provideForFieldDefaults };
+//# sourceMappingURL=forty-cdk-field.mjs.map

package/fesm2022/forty-cdk-field.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"forty-cdk-field.mjs","sources":["../../../projects/forty-cdk/field/src/field-context.ts","../../../projects/forty-cdk/field/src/field.ts","../../../projects/forty-cdk/field/src/label.ts","../../../projects/forty-cdk/field/src/field-description.ts","../../../projects/forty-cdk/field/src/field-error.ts","../../../projects/forty-cdk/field/src/field-control.ts","../../../projects/forty-cdk/field/src/field-defaults.ts","../../../projects/forty-cdk/field/src/forty-cdk-field.ts"],"sourcesContent":["import { inject } from '@angular/core';\n\nimport { FOR_FIELD_CONTEXT, type ForFieldContext } from 'forty-cdk/core';\n\nexport {\n  FOR_FIELD_CONTEXT,\n  injectFieldWiring,\n  type ForFieldContext,\n  type FieldControlHandle,\n} from 'forty-cdk/core';\n\n/**\n * Resolves the surrounding `ForField` context, throwing if the consumer\n * placed the piece outside a `[forField]` element.\n */\nexport function injectFieldContext(piece: string): ForFieldContext {\n  const ctx = inject(FOR_FIELD_CONTEXT, { optional: true });\n  if (!ctx) {\n    throw new Error(`[forty-cdk/field] ${piece} must be used inside a [forField] element.`);\n  }\n  return ctx;\n}\n","import { computed, Directive, inject, signal } from '@angular/core';\n\nimport { adoptHostId, IdGenerator, FOR_FIELDSET_CONTEXT } from 'forty-cdk/core';\nimport { FOR_FIELD_CONTEXT, type FieldControlHandle, type ForFieldContext } from './field-context';\n\n/**\n * Headless form-field container that wires accessible labelling, description,\n * and error association for a single control. It renders nothing and imposes no\n * layout: its only job is to connect a `[forLabel]`, `[forFieldDescription]`,\n * and `[forFieldError]` to the control via `id` / `aria-labelledby` /\n * `aria-describedby` / `aria-errormessage`, and to reflect the control's\n * validation state as `data-*` hooks for styling.\n *\n * Any forty-cdk form control (every `FormValueControl` / `FormCheckboxControl`\n * primitive) auto-associates when wrapped — no extra markup. A plain native\n * `<input>` opts in with `[forFieldControl]`.\n *\n * Host reflects `data-invalid` / `data-disabled` / `data-required` /\n * `data-touched` from the registered control.\n *\n * @example\n * ```html\n * <div forField>\n *   <label forLabel>Notifications</label>\n *   <button forSwitch [formField]=\"settings.notify\"></button>\n *   <p forFieldDescription>We'll only email you about security.</p>\n *   @if (settings.notify().invalid()) {\n *     <p forFieldError #err=\"forFieldError\">{{ err.messages().join(', ') }}</p>\n *   }\n * </div>\n * ```\n */\n@Directive({\n  selector: '[forField]',\n  exportAs: 'forField',\n  host: {\n    '[attr.data-invalid]': 'invalid() ? \"\" : null',\n    '[attr.data-disabled]': 'disabled() ? \"\" : null',\n    '[attr.data-required]': 'required() ? \"\" : null',\n    '[attr.data-touched]': 'touched() ? \"\" : null',\n  },\n  providers: [{ provide: FOR_FIELD_CONTEXT, useExisting: ForField }],\n})\nexport class ForField implements ForFieldContext {\n  readonly #idGen = inject(IdGenerator);\n  readonly #fieldset = inject(FOR_FIELDSET_CONTEXT, { optional: true });\n\n  readonly #controlId = signal(this.#idGen.next('for-field-control'));\n  readonly #control = signal<FieldControlHandle | null>(null);\n  readonly #hasLabel = signal(false);\n  readonly #hasDescription = signal(false);\n  readonly #hasError = signal(false);\n\n  /**\n   * The element the field actually targets for `id` / `aria-*` association and\n   * focus: the control's nominated `labelledElement` (Select trigger / Combobox\n   * input) when present, else its host (Listbox, native `<input>`).\n   */\n  readonly #targetEl = computed<HTMLElement | null>(() => {\n    const control = this.#control();\n    if (!control) {\n      return null;\n    }\n    return control.labelledElement?.() ?? control.host;\n  });\n\n  /**\n   * Id assigned to the control; a label's `for` points here. Adopts a\n   * nominated control's own id (`labelledElementId`) when present so the label\n   * and the primitive's internal `aria-labelledby` resolve to the same\n   * focusable element; otherwise the field's owned/host-adopted id.\n   */\n  readonly controlId = computed(() => this.#control()?.labelledElementId?.() ?? this.#controlId());\n  /** Id of the label element. */\n  readonly labelId = signal(this.#idGen.next('for-field-label'));\n  /** Id of the description element. */\n  readonly descriptionId = signal(this.#idGen.next('for-field-description'));\n  /** Id of the error element. */\n  readonly errorId = signal(this.#idGen.next('for-field-error'));\n  /** The currently registered control handle, or null. */\n  readonly control = this.#control.asReadonly();\n\n  /** Whether the registered control is currently invalid. */\n  readonly invalid = computed(() => this.#control()?.invalid?.() ?? false);\n  /** Whether the registered control is required. */\n  readonly required = computed(() => this.#control()?.required?.() ?? false);\n  /**\n   * Whether the field is disabled: the registered control's own disabled state\n   * OR'd with a surrounding `[forFieldset]`'s `disabled` (so a disabled group\n   * reaches custom-role controls a native `<fieldset disabled>` can't).\n   */\n  readonly disabled = computed(\n    () => (this.#control()?.disabled?.() ?? false) || (this.#fieldset?.disabled() ?? false),\n  );\n  /** Whether the registered control has been touched. */\n  readonly touched = computed(() => this.#control()?.touched?.() ?? false);\n\n  /** Resolved `aria-labelledby` for the control (label id, or null). */\n  readonly labelledBy = computed(() => (this.#hasLabel() ? this.labelId() : null));\n\n  /**\n   * Resolved `aria-describedby`: the description id always, plus the error id\n   * when the control is invalid. The error id is included here (in addition to\n   * `aria-errormessage`) because assistive-tech support for `aria-errormessage`\n   * is uneven; doubling it up is the widely-used robust pattern.\n   */\n  readonly describedBy = computed(() => {\n    const ids: string[] = [];\n    if (this.#hasDescription()) {\n      ids.push(this.descriptionId());\n    }\n    if (this.#hasError() && this.invalid()) {\n      ids.push(this.errorId());\n    }\n    return ids.length > 0 ? ids.join(' ') : null;\n  });\n\n  /** Resolved `aria-errormessage`: the error id when present and invalid, else null. */\n  readonly errorMessageId = computed(() =>\n    this.#hasError() && this.invalid() ? this.errorId() : null,\n  );\n\n  /** Register the control whose state the field reflects. */\n  registerControl(handle: FieldControlHandle): void {\n    this.#control.set(handle);\n    // Adopt a consumer-set id on the host (the host-is-the-control case). When\n    // the control nominates a distinct labelled element it carries its own\n    // `labelledElementId`, which `controlId` prefers — so a wrapper-host id, if\n    // any, is harmlessly ignored there.\n    adoptHostId(handle.host, this.#controlId);\n  }\n\n  /** Remove a previously registered control. */\n  unregisterControl(handle: FieldControlHandle): void {\n    if (this.#control() === handle) {\n      this.#control.set(null);\n    }\n  }\n\n  /**\n   * Mark the label slot present; returns an unregister callback. The field\n   * targets a single label per slot — its `labelId` / `descriptionId` /\n   * `errorId` are single ids, not id lists — so one `[forLabel]`,\n   * `[forFieldDescription]`, and `[forFieldError]` per field is the supported\n   * shape. Presence is a boolean, not a count.\n   */\n  registerLabel(): () => void {\n    this.#hasLabel.set(true);\n    return () => this.#hasLabel.set(false);\n  }\n\n  /** Mark the description slot present; returns an unregister callback. See {@link registerLabel} for the single-instance-per-slot contract. */\n  registerDescription(): () => void {\n    this.#hasDescription.set(true);\n    return () => this.#hasDescription.set(false);\n  }\n\n  /** Mark the error slot present; returns an unregister callback. See {@link registerLabel} for the single-instance-per-slot contract. */\n  registerError(): () => void {\n    this.#hasError.set(true);\n    return () => this.#hasError.set(false);\n  }\n\n  /**\n   * Forward a click to the control's focusable element and focus it — matching\n   * the activation a native `<label for>` triggers via the browser, so a\n   * non-`<label>` `[forLabel]` toggles a custom-role control instead of only\n   * focusing it.\n   */\n  clickControl(): void {\n    const target = this.#targetEl();\n    if (!target) {\n      return;\n    }\n    target.click();\n    target.focus();\n  }\n}\n","import { computed, DestroyRef, Directive, ElementRef, inject } from '@angular/core';\n\nimport { FOR_FIELD_CONTEXT } from './field-context';\n\n/**\n * Accessible label for a form control. Inside a `[forField]` it auto-wires:\n * it adopts the field's `labelId` and registers itself so the control gains\n * `aria-labelledby`.\n *\n * Click-to-activate is consistent across both host shapes: a native `<label>`\n * emits `for` and the browser forwards the click to the control (toggling a\n * checkbox / switch, activating a button); a non-`<label>` host has no native\n * `for` forwarding, so the directive forwards the click itself — clicking the\n * label activates the control either way, not just focuses it. A click that\n * originated on the control (when the control is nested inside the label host)\n * is not re-forwarded, so a label-wrapping layout toggles once, matching native\n * `<label>` semantics.\n *\n * Usable standalone outside a field — there it is an inert\n * marker and the consumer wires native `for` themselves.\n *\n * @example\n * ```html\n * <div forField>\n *   <label forLabel>Email</label>\n *   <input forFieldControl type=\"email\" />\n * </div>\n * ```\n */\n@Directive({\n  selector: '[forLabel]',\n  exportAs: 'forLabel',\n  host: {\n    '[attr.id]': 'labelId()',\n    '[attr.for]': 'forAttr()',\n    '(click)': 'onClick($event)',\n  },\n})\nexport class ForLabel {\n  protected readonly ctx = inject(FOR_FIELD_CONTEXT, { optional: true });\n  readonly #host = inject<ElementRef<HTMLElement>>(ElementRef);\n\n  /** The label's id when inside a field, else null. */\n  protected readonly labelId = computed(() => this.ctx?.labelId() ?? null);\n\n  /** `for` is only meaningful on a native `<label>`; null otherwise. */\n  protected readonly forAttr = computed(() => {\n    if (!this.ctx || this.#host.nativeElement.tagName !== 'LABEL') {\n      return null;\n    }\n    return this.ctx.controlId();\n  });\n\n  constructor() {\n    const ctx = this.ctx;\n    if (ctx) {\n      const unregister = ctx.registerLabel();\n      inject(DestroyRef).onDestroy(unregister);\n    }\n  }\n\n  protected onClick(event: MouseEvent): void {\n    if (!this.ctx || this.#host.nativeElement.tagName === 'LABEL') {\n      return;\n    }\n    // When the control is nested inside the label host (label wraps control),\n    // a click on the control already activates it natively; forwarding again\n    // would double-toggle. Mirror native `<label>` semantics and bail when the\n    // click originated from the control (or anything inside it).\n    const control = this.ctx.control();\n    const controlEl = control?.labelledElement?.() ?? control?.host ?? null;\n    const target = event.target as Node | null;\n    if (controlEl && target && controlEl.contains(target)) {\n      return;\n    }\n    this.ctx.clickControl();\n  }\n}\n","import { DestroyRef, Directive, inject } from '@angular/core';\n\nimport { injectFieldContext } from './field-context';\n\n/**\n * Supplementary description / hint for a form control. Adopts the field's\n * `descriptionId` and registers itself so the control gains\n * `aria-describedby`. Apply on a `<p>` / `<span>` inside a `[forField]`.\n */\n@Directive({\n  selector: '[forFieldDescription]',\n  exportAs: 'forFieldDescription',\n  host: {\n    '[attr.id]': 'ctx.descriptionId()',\n  },\n})\nexport class ForFieldDescription {\n  protected readonly ctx = injectFieldContext('ForFieldDescription');\n\n  constructor() {\n    const unregister = this.ctx.registerDescription();\n    inject(DestroyRef).onDestroy(unregister);\n  }\n}\n","import { computed, DestroyRef, Directive, inject } from '@angular/core';\nimport type { ValidationError } from '@angular/forms/signals';\n\nimport { injectFieldContext } from './field-context';\n\nfunction extractMessage(error: ValidationError.WithOptionalFieldTree): string {\n  if ('message' in error && typeof error.message === 'string' && error.message !== '') {\n    return error.message;\n  }\n  return error.kind;\n}\n\n/**\n * Error region for a form control. Adopts the field's `errorId`, registers\n * itself so the control gains `aria-errormessage` (and the id is folded into\n * `aria-describedby`) while invalid, and **reads the control's Signal Forms\n * validation errors automatically** — the consumer renders `messages()` (or\n * the raw `errors()`) without any manual plumbing.\n *\n * Carries `role=\"alert\"`. Drive its presence with `@if (err.shown())` (or the\n * field's own `invalid()`); when unmounted the control's `aria-errormessage`\n * drops automatically.\n *\n * @example\n * ```html\n * @if (err.shown()) {\n *   <p forFieldError #err=\"forFieldError\">{{ err.messages().join(', ') }}</p>\n * }\n * ```\n */\n@Directive({\n  selector: '[forFieldError]',\n  exportAs: 'forFieldError',\n  host: {\n    '[attr.id]': 'ctx.errorId()',\n    role: 'alert',\n  },\n})\nexport class ForFieldError {\n  protected readonly ctx = injectFieldContext('ForFieldError');\n\n  /** The control's current validation errors (Signal Forms). */\n  readonly errors = computed(() => this.ctx.control()?.errors?.() ?? []);\n\n  /** Human-readable messages derived from {@link errors}. */\n  readonly messages = computed<readonly string[]>(() =>\n    this.errors().map((error) => extractMessage(error)),\n  );\n\n  /** Whether the control currently has at least one error. */\n  readonly hasErrors = computed(() => this.errors().length > 0);\n\n  /** Whether the error region should be shown (control invalid and has errors). */\n  readonly shown = computed(() => this.ctx.invalid() && this.hasErrors());\n\n  constructor() {\n    const unregister = this.ctx.registerError();\n    inject(DestroyRef).onDestroy(unregister);\n  }\n}\n","import { booleanAttribute, Directive, input } from '@angular/core';\n\nimport { injectFieldWiring } from './field-context';\n\n/**\n * Opt-in marker that wires a non-forty-cdk control — a native `<input>`,\n * `<textarea>`, `<select>`, or any custom element — into its surrounding\n * `[forField]`. forty-cdk form primitives (which extend the shared form base)\n * auto-wire and do **not** need this; it exists for plain native controls that\n * have no primitive of their own.\n *\n * Validation state is consumer-driven via the `invalid` / `required` /\n * `disabled` / `touched` inputs (native controls have no Signal Forms errors\n * to surface). Reflects `aria-invalid` on the host.\n *\n * @example\n * ```html\n * <div forField>\n *   <label forLabel>Email</label>\n *   <input forFieldControl type=\"email\" [invalid]=\"emailInvalid()\" />\n * </div>\n * ```\n */\n@Directive({\n  selector: '[forFieldControl]',\n  exportAs: 'forFieldControl',\n  host: {\n    '[attr.aria-invalid]': 'invalid() ? \"true\" : null',\n  },\n})\nexport class ForFieldControl {\n  /** Marks the control invalid — drives the field's error region and `aria-invalid`. */\n  readonly invalid = input(false, { transform: booleanAttribute });\n  /** Marks the control required — reflected by the field as `data-required`. */\n  readonly required = input(false, { transform: booleanAttribute });\n  /** Marks the control disabled — reflected by the field as `data-disabled`. */\n  readonly disabled = input(false, { transform: booleanAttribute });\n  /** Marks the control touched — reflected by the field as `data-touched`. */\n  readonly touched = input(false, { transform: booleanAttribute });\n\n  constructor() {\n    injectFieldWiring({\n      invalid: this.invalid,\n      required: this.required,\n      disabled: this.disabled,\n      touched: this.touched,\n    });\n  }\n}\n","import { type Provider } from '@angular/core';\n\nimport { createDefaults } from 'forty-cdk/core';\n\n/**\n * Defaults inherited by descendant fields in the surrounding injector scope.\n * Configure with `provideForFieldDefaults`. The shape is a stub today —\n * present so future per-scope tuning can land without churning the public\n * surface.\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface ForFieldDefaults {}\n\nconst FALLBACK: ForFieldDefaults = {};\n\nconst { token, provideDefaults } = createDefaults<ForFieldDefaults>('FOR_FIELD_DEFAULTS', FALLBACK);\n\n/** Token holding the resolved field defaults for the current scope. */\nexport const FOR_FIELD_DEFAULTS = token;\n\n/**\n * Configures forty-cdk field defaults for this injector scope. Partial\n * overrides inherit unspecified keys from the parent scope (or library\n * defaults at the root).\n */\nexport function provideForFieldDefaults(defaults: Partial<ForFieldDefaults> = {}): Provider[] {\n  return provideDefaults(defaults);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/forty-cdk-fieldset.mjs

@@ -0,0 +1,164 @@
+import * as i0 from '@angular/core';
+import { inject, ElementRef, signal, input, booleanAttribute, computed, Directive, DestroyRef } from '@angular/core';
+import { IdGenerator, FOR_FIELDSET_CONTEXT, reflectDisabled, createDefaults } from 'forty-cdk/core';
+export { FOR_FIELDSET_CONTEXT } from 'forty-cdk/core';
+
+/**
+ * Headless grouping container that gives a set of related fields a shared
+ * accessible name — the styleless counterpart to a native `<fieldset>` +
+ * `<legend>`, and the grouping companion to `ForField`.
+ *
+ * On a native `<fieldset>` it relies on the implicit grouping and emits no
+ * role; on any other element it emits `role="group"` + `aria-labelledby`
+ * pointing at the `[forFieldsetLegend]` (same host-tag detection idiom as
+ * `ForLabel`'s `<label>` check).
+ *
+ * The `disabled` input reflects `data-disabled` and is provided via context so
+ * descendant `ForField` controls OR it into their own disabled state — native
+ * `<fieldset disabled>` does not reach custom-role controls like `forSwitch`.
+ *
+ * @example
+ * ```html
+ * <fieldset forFieldset [disabled]="locked()">
+ *   <legend forFieldsetLegend>Shipping address</legend>
+ *   <div forField>
+ *     <label forLabel>Street</label>
+ *     <input forFieldControl />
+ *   </div>
+ * </fieldset>
+ * ```
+ */
+class ForFieldset {
+    #idGen = inject(IdGenerator);
+    #host = inject(ElementRef);
+    #parent = inject(FOR_FIELDSET_CONTEXT, { optional: true, skipSelf: true });
+    #legends = signal(0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "#legends" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether the group is disabled, as bound by the consumer via `[disabled]`.
+     * The host reflection and descendant controls read the composed
+     * {@link disabled} signal below, which also folds in an enclosing disabled
+     * `[forFieldset]`.
+     */
+    disabledInput = input(false, { ...(ngDevMode ? { debugName: "disabledInput" } : /* istanbul ignore next */ {}), transform: booleanAttribute, alias: 'disabled' });
+    /**
+     * Effective disabled: the group's own `[disabled]` OR'd with an enclosing
+     * disabled `[forFieldset]`. Reflects `data-disabled`, emits the native
+     * `disabled` attribute on a `<fieldset>` (or `aria-disabled` elsewhere), and
+     * propagates to descendant controls via context — so a disabled fieldset
+     * reaches custom-role controls (`forSwitch`, `forCheckbox`, …) a native
+     * `<fieldset disabled>` can't, and nesting composes like native fieldsets
+     * (a disabled outer group cannot be re-enabled by an inner one).
+     */
+    disabled = computed(() => this.disabledInput() || (this.#parent?.disabled() ?? false), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "disabled" }] : /* istanbul ignore next */ []));
+    /** Id of the legend element; the group's `aria-labelledby` resolves here. */
+    legendId = signal(this.#idGen.next('for-fieldset-legend'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "legendId" }] : /* istanbul ignore next */ []));
+    /** Whether the host element is a native `<fieldset>` (no role/labelledby needed). */
+    isNativeFieldset = computed(() => this.#host.nativeElement.tagName === 'FIELDSET', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "isNativeFieldset" }] : /* istanbul ignore next */ []));
+    /**
+     * Native `disabled` is reflected only on a real `<fieldset>` (where it
+     * natively disables descendant controls); a non-`<fieldset>` host advertises
+     * its disabled state via `aria-disabled` instead.
+     */
+    nativeDisabled = computed(() => this.isNativeFieldset() && this.disabled(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "nativeDisabled" }] : /* istanbul ignore next */ []));
+    constructor() {
+        reflectDisabled(this.nativeDisabled);
+    }
+    /** `role="group"` on a non-`<fieldset>` element, else null. */
+    roleAttr = computed(() => (this.isNativeFieldset() ? null : 'group'), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "roleAttr" }] : /* istanbul ignore next */ []));
+    /**
+     * Resolved `aria-labelledby`: the legend id on a non-`<fieldset>` element when
+     * a legend is registered, else null (a native `<fieldset>`/`<legend>` groups
+     * implicitly and needs none).
+     */
+    labelledBy = computed(() => !this.isNativeFieldset() && this.#legends() > 0 ? this.legendId() : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labelledBy" }] : /* istanbul ignore next */ []));
+    /** Mark a legend present; returns an unregister callback. */
+    registerLegend() {
+        this.#legends.update((n) => n + 1);
+        return () => this.#legends.update((n) => n - 1);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldset, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.2", type: ForFieldset, isStandalone: true, selector: "[forFieldset]", inputs: { disabledInput: { classPropertyName: "disabledInput", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.role": "roleAttr()", "attr.aria-labelledby": "labelledBy()", "attr.aria-disabled": "!isNativeFieldset() && disabled() ? \"true\" : null", "attr.data-disabled": "disabled() ? \"\" : null" } }, providers: [{ provide: FOR_FIELDSET_CONTEXT, useExisting: ForFieldset }], exportAs: ["forFieldset"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldset, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forFieldset]',
+                    exportAs: 'forFieldset',
+                    host: {
+                        '[attr.role]': 'roleAttr()',
+                        '[attr.aria-labelledby]': 'labelledBy()',
+                        '[attr.aria-disabled]': '!isNativeFieldset() && disabled() ? "true" : null',
+                        '[attr.data-disabled]': 'disabled() ? "" : null',
+                    },
+                    providers: [{ provide: FOR_FIELDSET_CONTEXT, useExisting: ForFieldset }],
+                }]
+        }], ctorParameters: () => [], propDecorators: { disabledInput: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }] } });
+
+/**
+ * Accessible group label for a `[forFieldset]`. Inside a fieldset it adopts the
+ * fieldset's `legendId` and registers itself so the group's `aria-labelledby`
+ * resolves; on a native `<fieldset>`/`<legend>` the id is harmless extra wiring
+ * (the browser groups implicitly).
+ *
+ * Usable standalone outside a fieldset — there it is an inert marker.
+ *
+ * @example
+ * ```html
+ * <div forFieldset>
+ *   <span forFieldsetLegend>Notification preferences</span>
+ *   <!-- … fields … -->
+ * </div>
+ * ```
+ */
+class ForFieldsetLegend {
+    ctx = inject(FOR_FIELDSET_CONTEXT, { optional: true });
+    /** The legend's id when inside a fieldset, else null. */
+    legendId = computed(() => this.ctx?.legendId() ?? null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "legendId" }] : /* istanbul ignore next */ []));
+    constructor() {
+        const ctx = this.ctx;
+        if (ctx) {
+            const unregister = ctx.registerLegend();
+            inject(DestroyRef).onDestroy(unregister);
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldsetLegend, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.2", type: ForFieldsetLegend, isStandalone: true, selector: "[forFieldsetLegend]", host: { properties: { "attr.id": "legendId()" } }, exportAs: ["forFieldsetLegend"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.2", ngImport: i0, type: ForFieldsetLegend, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[forFieldsetLegend]',
+                    exportAs: 'forFieldsetLegend',
+                    host: {
+                        '[attr.id]': 'legendId()',
+                    },
+                }]
+        }], ctorParameters: () => [] });
+
+const FALLBACK = {};
+const { token, provideDefaults } = createDefaults('FOR_FIELDSET_DEFAULTS', FALLBACK);
+/** Token holding the resolved fieldset defaults for the current scope. */
+const FOR_FIELDSET_DEFAULTS = token;
+/**
+ * Configures forty-cdk fieldset defaults for this injector scope. Partial
+ * overrides inherit unspecified keys from the parent scope (or library
+ * defaults at the root).
+ */
+function provideForFieldsetDefaults(defaults = {}) {
+    return provideDefaults(defaults);
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FOR_FIELDSET_DEFAULTS, ForFieldset, ForFieldsetLegend, provideForFieldsetDefaults };
+//# sourceMappingURL=forty-cdk-fieldset.mjs.map