@dereekb/dbx-form 13.11.14 → 13.11.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-form",
-  "version": "13.11.14",
+  "version": "13.11.15",
   "sideEffects": [
     "*.scss",
     "*.css"
@@ -14,13 +14,13 @@
     "@angular/material-date-fns-adapter": "21.2.9",
     "@angular/platform-browser": "21.2.11",
     "@bobbyquantum/ngx-editor": "21.0.0",
-    "@dereekb/date": "13.11.14",
-    "@dereekb/dbx-core": "13.11.14",
-    "@dereekb/dbx-web": "13.11.14",
-    "@dereekb/model": "13.11.14",
-    "@dereekb/rxjs": "13.11.14",
-    "@dereekb/util": "13.11.14",
-    "@dereekb/vitest": "13.11.14",
+    "@dereekb/date": "13.11.15",
+    "@dereekb/dbx-core": "13.11.15",
+    "@dereekb/dbx-web": "13.11.15",
+    "@dereekb/model": "13.11.15",
+    "@dereekb/rxjs": "13.11.15",
+    "@dereekb/util": "13.11.15",
+    "@dereekb/vitest": "13.11.15",
     "@ng-forge/dynamic-forms": "0.9.0-next.10",
     "@ng-forge/dynamic-forms-material": "0.9.0-next.10",
     "@ng-web-apis/geolocation": "^5.2.0",

package/types/dereekb-dbx-form-calendar.d.ts

@@ -190,35 +190,35 @@ interface CalendarScheduleSelectionState extends PartialCalendarScheduleSelectio
  * Creates the default initial state for the calendar schedule selection store,
  * using the current system timezone and all days of the week enabled.
  *
- * @returns A fresh CalendarScheduleSelectionState with default values
+ * @returns A fresh CalendarScheduleSelectionState with default values.
  */
 declare function initialCalendarScheduleSelectionState(): CalendarScheduleSelectionState;
 /**
  * Computes the effective min and max date range by combining the filter and the explicit minMaxDateRange constraints.
  *
- * @param x - State containing filter and minMaxDateRange to compute from
- * @returns A partial date range with the effective start and end boundaries
+ * @param x - State containing filter and minMaxDateRange to compute from.
+ * @returns A partial date range with the effective start and end boundaries.
  */
 declare function calendarScheduleMinAndMaxDateRange(x: Pick<CalendarScheduleSelectionState, 'filter' | 'minMaxDateRange'>): Partial<DateRange>;
 /**
  * Returns the effective minimum date by taking the latest start date between the filter and minMaxDateRange.
  *
- * @param x - State containing filter and minMaxDateRange
- * @returns The latest start date, or undefined if none
+ * @param x - State containing filter and minMaxDateRange.
+ * @returns The latest start date, or undefined if none.
  */
 declare function calendarScheduleMinDate(x: Pick<CalendarScheduleSelectionState, 'filter' | 'minMaxDateRange'>): Maybe<Date>;
 /**
  * Returns the effective maximum date by taking the earliest end date between the filter and minMaxDateRange.
  *
- * @param x - State containing filter and minMaxDateRange
- * @returns The earliest end date, or undefined if none
+ * @param x - State containing filter and minMaxDateRange.
+ * @returns The earliest end date, or undefined if none.
  */
 declare function calendarScheduleMaxDate(x: Pick<CalendarScheduleSelectionState, 'filter' | 'minMaxDateRange'>): Maybe<Date>;
 /**
  * Returns whether the filter's start date is being used as the effective start for the selection result computation.
  *
- * @param x - State containing filter and computeSelectionResultRelativeToFilter
- * @returns True if the filter start is being used for the selection result
+ * @param x - State containing filter and computeSelectionResultRelativeToFilter.
+ * @returns True if the filter start is being used for the selection result.
  */
 declare function calendarScheduleStartBeingUsedFromFilter(x: Pick<CalendarScheduleSelectionState, 'filter' | 'computeSelectionResultRelativeToFilter'>): boolean | _dereekb_util.MaybeNot;
 declare class DbxCalendarScheduleSelectionStore extends ComponentStore<CalendarScheduleSelectionState> {
@@ -329,33 +329,33 @@ declare class DbxCalendarScheduleSelectionStore extends ComponentStore<CalendarS
 /**
  * Updates the state with an initial selection (all or none) and applies it when no dates are currently toggled.
  *
- * @param state - The current selection state
+ * @param state - The current selection state.
  * @param initialSelectionState - The initial selection mode ('all' or 'none')
- * @returns The updated selection state
+ * @returns The updated selection state.
  */
 declare function updateStateWithInitialSelectionState(state: CalendarScheduleSelectionState, initialSelectionState: Maybe<AllOrNoneSelection>): CalendarScheduleSelectionState;
 /**
  * Updates the computeSelectionResultRelativeToFilter flag and recalculates the state if the value changed.
  *
- * @param currentState - The current selection state
- * @param computeSelectionResultRelativeToFilter - Whether to compute results relative to the filter
- * @returns The updated selection state
+ * @param currentState - The current selection state.
+ * @param computeSelectionResultRelativeToFilter - Whether to compute results relative to the filter.
+ * @returns The updated selection state.
  */
 declare function updateStateWithComputeSelectionResultRelativeToFilter(currentState: CalendarScheduleSelectionState, computeSelectionResultRelativeToFilter: Maybe<boolean>): CalendarScheduleSelectionState;
 /**
  * Updates the state with date exclusions, converting input dates/ranges to cell indexes and reapplying the filter.
  *
- * @param state - The current selection state
- * @param inputExclusions - Dates, date ranges, or cell indexes to exclude
- * @returns The updated selection state with exclusions applied
+ * @param state - The current selection state.
+ * @param inputExclusions - Dates, date ranges, or cell indexes to exclude.
+ * @returns The updated selection state with exclusions applied.
  */
 declare function updateStateWithExclusions(state: CalendarScheduleSelectionState, inputExclusions: Maybe<ArrayOrValue<DateOrDateRangeOrDateCellIndexOrDateCellRange>>): CalendarScheduleSelectionState;
 /**
  * Sets the min/max date range constraint on the state, normalizing start to startOfDay and end to endOfDay.
  *
- * @param state - The current selection state
- * @param minMaxDateRange - The min/max boundary dates to enforce
- * @returns The updated selection state with the boundary applied
+ * @param state - The current selection state.
+ * @param minMaxDateRange - The min/max boundary dates to enforce.
+ * @returns The updated selection state with the boundary applied.
  */
 declare function updateStateWithMinMaxDateRange(state: CalendarScheduleSelectionState, minMaxDateRange: Maybe<Partial<DateRange>>): CalendarScheduleSelectionState;
 /**
@@ -370,58 +370,58 @@ declare function updateStateWithMinMaxDateRange(state: CalendarScheduleSelection
  * Applies a date cell schedule filter to the selection state, computing the enabled day function
  * from the filter, exclusions, and min/max date range constraints.
  *
- * @param currentState - The current selection state
- * @param inputFilter - The filter configuration to apply
- * @returns The updated selection state with the filter applied
+ * @param currentState - The current selection state.
+ * @param inputFilter - The filter configuration to apply.
+ * @returns The updated selection state with the filter applied.
  */
 declare function updateStateWithFilter(currentState: CalendarScheduleSelectionState, inputFilter: Maybe<DateCellScheduleDateFilterConfig>): CalendarScheduleSelectionState;
 /**
  * Updates the output timezone and transforms the current selection value to reflect the new timezone.
  *
- * @param state - The current selection state
- * @param timezone - The target timezone string
- * @returns The updated selection state with timezone-adjusted values
+ * @param state - The current selection state.
+ * @param timezone - The target timezone string.
+ * @returns The updated selection state with timezone-adjusted values.
  */
 declare function updateStateWithTimezoneValue(state: CalendarScheduleSelectionState, timezone: Maybe<TimezoneString>): CalendarScheduleSelectionState;
 /**
  * Updates the state from an external date cell schedule range value, converting timezone-aware inputs
  * to system time and synchronizing the internal selection indexes.
  *
- * @param state - The current selection state
- * @param inputChange - The date cell schedule range to apply
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param inputChange - The date cell schedule range to apply.
+ * @returns The updated selection state.
  */
 declare function updateStateWithDateCellScheduleRangeValue(state: CalendarScheduleSelectionState, inputChange: Maybe<FullDateCellScheduleRangeInputDateRange>): CalendarScheduleSelectionState;
 /**
  * Updates the default schedule day codes (used when no explicit schedule days are set) and recalculates allowed days.
  *
- * @param state - The current selection state
- * @param change - The new default schedule day codes
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param change - The new default schedule day codes.
+ * @returns The updated selection state.
  */
 declare function updateStateWithChangedDefaultScheduleDays(state: CalendarScheduleSelectionState, change: Maybe<Iterable<DateCellScheduleDayCode>>): CalendarScheduleSelectionState;
 /**
  * Updates the explicit schedule day codes override and recalculates allowed days of the week.
  *
- * @param state - The current selection state
- * @param change - The new schedule day codes, or null/undefined to clear the override
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param change - The new schedule day codes, or null/undefined to clear the override.
+ * @returns The updated selection state.
  */
 declare function updateStateWithChangedScheduleDays(state: CalendarScheduleSelectionState, change: Maybe<Iterable<DateCellScheduleDayCode>>): CalendarScheduleSelectionState;
 /**
  * Switches between single and multiple selection mode, trimming the selection to a single value when switching to single mode.
  *
- * @param state - The current selection state
- * @param selectionMode - The new selection mode
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param selectionMode - The new selection mode.
+ * @returns The updated selection state.
  */
 declare function updateStateWithSelectionMode(state: CalendarScheduleSelectionState, selectionMode: DbxCalendarScheduleSelectionStoreSelectionMode): CalendarScheduleSelectionState;
 /**
  * Finalizes a schedule days change by recalculating allowed days of the week and updating toggled indexes accordingly.
  *
- * @param previousState - The state before the schedule days change
- * @param nextState - The state with updated schedule day codes
- * @returns The finalized selection state with recalculated allowed days and toggled indexes
+ * @param previousState - The state before the schedule days change.
+ * @param nextState - The state with updated schedule day codes.
+ * @returns The finalized selection state with recalculated allowed days and toggled indexes.
  */
 declare function finalizeUpdateStateWithChangedScheduleDays(previousState: CalendarScheduleSelectionState, nextState: CalendarScheduleSelectionState): CalendarScheduleSelectionState;
 interface CalendarScheduleSelectionStateDatesChange {
@@ -450,46 +450,46 @@ interface CalendarScheduleSelectionStateDatesChange {
  * Applies date changes (toggle, add, remove, set, selectAll, or reset) to the calendar selection state,
  * updating toggled indexes and input start/end accordingly.
  *
- * @param state - The current selection state
- * @param change - The date changes to apply
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param change - The date changes to apply.
+ * @returns The updated selection state.
  */
 declare function updateStateWithChangedDates(state: CalendarScheduleSelectionState, change: CalendarScheduleSelectionStateDatesChange): CalendarScheduleSelectionState;
 /**
  * Clears all date selections from the state, retaining other configuration like schedule days and filter.
  *
- * @param state - The current selection state
- * @returns The state with all selections cleared
+ * @param state - The current selection state.
+ * @returns The state with all selections cleared.
  */
 declare function noSelectionCalendarScheduleSelectionState(state: CalendarScheduleSelectionState): CalendarScheduleSelectionState;
 /**
  * Updates the selection state with a new start/end date range, retaining toggled indexes within the new range bounds.
  *
- * @param state - The current selection state
- * @param change - The new input start and end dates
- * @returns The updated selection state
+ * @param state - The current selection state.
+ * @param change - The new input start and end dates.
+ * @returns The updated selection state.
  */
 declare function updateStateWithChangedRange(state: CalendarScheduleSelectionState, change: CalendarScheduleSelectionInputDateRange): CalendarScheduleSelectionState;
 /**
  * Finalizes a partially-built state by recomputing the isEnabledDay function and the current selection value.
  *
- * @param nextState - The partially-built selection state to finalize
- * @returns The finalized selection state
+ * @param nextState - The partially-built selection state to finalize.
+ * @returns The finalized selection state.
  */
 declare function finalizeNewCalendarScheduleSelectionState(nextState: Building<CalendarScheduleSelectionState>): CalendarScheduleSelectionState;
 /**
  * Builds a decision function that determines whether a given day index is enabled (selected) in the current state.
  *
- * @param state - The selection state to derive the enabled-day function from
- * @returns A function that returns true if the given day is enabled/selected
+ * @param state - The selection state to derive the enabled-day function from.
+ * @returns Returns true if the given day is enabled/selected.
  */
 declare function isEnabledDayInCalendarScheduleSelectionState(state: CalendarScheduleSelectionState): DecisionFunction<DateCellTimingRelativeIndexFactoryInput>;
 /**
  * Computes the output DateCellScheduleDateRange value from the current selection state,
  * applying timezone offsets and filter-relative computations as needed.
  *
- * @param state - The current selection state to compute from
- * @returns The computed selection value, or null if nothing is selected
+ * @param state - The current selection state to compute from.
+ * @returns The computed selection value, or null if nothing is selected.
  */
 declare function computeScheduleSelectionValue(state: CalendarScheduleSelectionState): Maybe<CalendarScheduleSelectionValue>;
 /**
@@ -509,22 +509,22 @@ interface CalendarScheduleSelectionRangeAndExclusion extends DateRange {
  * Computes the selected date range with its corresponding cell range and all excluded day indexes.
  * Returns null if no days are selected.
  *
- * @param state - The current selection state
- * @returns The range and exclusion data, or null if nothing is selected
+ * @param state - The current selection state.
+ * @returns The range and exclusion data, or null if nothing is selected.
  */
 declare function computeScheduleSelectionRangeAndExclusion(state: CalendarScheduleSelectionState): Maybe<CalendarScheduleSelectionRangeAndExclusion>;
 /**
  * Computes the selected date range (start and end dates) from the current selection state.
  *
- * @param state - The current selection state
- * @returns The selected date range, or undefined if nothing is selected
+ * @param state - The current selection state.
+ * @returns The selected date range, or undefined if nothing is selected.
  */
 declare function computeCalendarScheduleSelectionRange(state: CalendarScheduleSelectionState): Maybe<DateRange>;
 /**
  * Computes the date cell index range (i, to) that spans all selected and toggled days in the current state.
  *
- * @param state - The current selection state
- * @returns The cell range spanning all selected days, or undefined if nothing is selected
+ * @param state - The current selection state.
+ * @returns The cell range spanning all selected days, or undefined if nothing is selected.
  */
 declare function computeCalendarScheduleSelectionDateCellRange(state: CalendarScheduleSelectionState): Maybe<DateCellRangeWithRange>;
 
@@ -649,9 +649,10 @@ interface DateScheduleRangeFieldConfig extends Omit<LabeledBaseFieldConfig, 'key
 /**
  * Creates a Formly field configuration for a date schedule range picker with calendar-based selection.
  *
+ * @param config - Optional schedule range field configuration overrides.
+ * @returns A validated Formly field configuration for date schedule range selection.
+ *
  * @deprecated Use dbxForgeDateScheduleRangeField() from the forge API instead.
- * @param config - Optional schedule range field configuration overrides
- * @returns A validated Formly field configuration for date schedule range selection
  */
 declare function dateScheduleRangeField(config?: DateScheduleRangeFieldConfig): FormlyFieldConfig;
 
@@ -711,8 +712,8 @@ declare class DbxForgeCalendarDateScheduleRangeFieldComponent {
     private readonly _defaultWeekSub;
     private readonly _filterSub;
     private readonly _exclusionsSub;
-    readonly fieldValue: Signal<unknown>;
-    readonly isDisabled: Signal<boolean>;
+    readonly fieldValueSignal: Signal<unknown>;
+    readonly isDisabledSignal: Signal<boolean>;
     readonly isRequiredSignal: Signal<boolean>;
     readonly labelTextSignal: Signal<Maybe<string>>;
     readonly descriptionSignal: Signal<Maybe<string>>;
@@ -734,9 +735,9 @@ declare class DbxForgeCalendarDateScheduleRangeFieldComponent {
  * Uses the standard buildValueFieldInputs to bridge the ng-forge field definition
  * to the component's input signals.
  *
- * @param fieldDef - Field definition configuration
- * @param fieldDef.key - Form model key for the field
- * @returns Signal containing a Record of input names to values for ngComponentOutlet
+ * @param fieldDef - Field definition configuration.
+ * @param fieldDef.key - Form model key for the field.
+ * @returns Signal containing a Record of input names to values for ngComponentOutlet.
  */
 declare function calendarDateScheduleRangeFieldMapper(fieldDef: {
     key: string;
@@ -816,8 +817,8 @@ interface DbxForgeCalendarDateScheduleRangeFieldConfig extends Pick<CalendarSche
  *
  * This is the forge equivalent of {@link dateScheduleRangeField}.
  *
- * @param config - Optional schedule range field configuration overrides
- * @returns A validated forge field definition for date schedule range selection
+ * @param config - Optional schedule range field configuration overrides.
+ * @returns A validated forge field definition for date schedule range selection.
  */
 declare function dbxForgeDateScheduleRangeField(config?: DbxForgeCalendarDateScheduleRangeFieldConfig): DbxForgeCalendarDateScheduleRangeFieldDef;
 
@@ -825,15 +826,17 @@ declare function dbxForgeDateScheduleRangeField(config?: DbxForgeCalendarDateSch
  * Creates form fields for selecting which days of the week are enabled in a schedule selection calendar,
  * wrapped in a responsive flex layout.
  *
+ * @returns Array of Formly field configs with toggle fields for each day of the week.
+ *
  * @deprecated Use dbxScheduleSelectionCalendarDateDaysForgeFormFields() instead.
- * @returns An array of Formly field configs with toggle fields for each day of the week
  */
 declare function dbxScheduleSelectionCalendarDateDaysFormFields(): _ngx_formly_core.FormlyFieldConfig<i13.DbxFlexWrapperConfig>[];
 /**
  * Creates an array of toggle field configs, one for each day of the week, keyed by lowercase day name.
  *
+ * @returns The toggle Formly field configs for each day of the week.
+ *
  * @deprecated Use forge toggle fields directly.
- * @returns An array of toggle Formly field configs for each day of the week
  */
 declare function dbxScheduleSelectionCalendarDateDaysFormDayFields(): _ngx_formly_core.FormlyFieldConfig<_ngx_formly_core.FormlyFieldProps & {
     [additionalProperties: string]: any;
@@ -855,13 +858,13 @@ declare class DbxScheduleSelectionCalendarDateDaysFormComponent extends Abstract
  *
  * This is the forge equivalent of {@link dbxScheduleSelectionCalendarDateDaysFormFields}.
  *
- * @returns A FormConfig with toggle fields for each day of the week
+ * @returns A FormConfig with toggle fields for each day of the week.
  */
 declare function dbxScheduleSelectionCalendarDateDaysForgeFormFields(): FormConfig;
 /**
  * Creates an array of forge toggle field definitions, one for each day of the week, keyed by lowercase day name.
  *
- * @returns An array of forge toggle field definitions for each day of the week
+ * @returns The forge toggle field definitions for each day of the week.
  */
 declare function dbxScheduleSelectionCalendarDateDaysForgeFormDayFields(): FieldDef<unknown>[];
 
@@ -905,8 +908,8 @@ type DbxScheduleSelectionCalendarBeforeMonthViewRenderFunctionFactory = (state:
  * Creates a factory that produces a beforeMonthViewRender handler for the schedule selection calendar.
  * The handler applies CSS classes and metadata to each day cell based on the current selection state.
  *
- * @param inputModifyFn - Optional function to further customize each day cell after default processing
- * @returns A factory function that accepts a state observable and produces a render handler
+ * @param inputModifyFn - Optional function to further customize each day cell after default processing.
+ * @returns A factory function that accepts a state observable and produces a render handler.
  */
 declare function dbxScheduleSelectionCalendarBeforeMonthViewRenderFactory(inputModifyFn?: Maybe<DbxScheduleSelectionCalendarBeforeMonthViewRenderModifyDayFunction>): DbxScheduleSelectionCalendarBeforeMonthViewRenderFunctionFactory;
 declare class DbxScheduleSelectionCalendarComponent<T> implements OnInit {
@@ -985,7 +988,7 @@ declare class DbxScheduleSelectionCalendarDateRangeComponent implements OnInit {
     readonly isCustomizedSignal: i0.Signal<boolean>;
     readonly showCustomLabelSignal: i0.Signal<boolean>;
     readonly currentErrorMessageSignal: i0.Signal<string | undefined>;
-    readonly datePickerFilterSignal: i0.Signal<DateFilterFn<Date>>;
+    readonly datePickerFilterSignal: i0.Signal<DateFilterFn<Date> | (() => boolean)>;
     protected readonly _requiredUpdateValidatorsEffect: i0.EffectRef;
     ngOnInit(): void;
     clickedDateRangeInput(): void;
@@ -1023,8 +1026,8 @@ declare class DbxScheduleSelectionCalendarCellComponent {
 
 declare const DEFAULT_SCHEDULE_SELECTION_CALENDAR_DATE_POPOVER_KEY = "calendarselection";
 interface DbxScheduleSelectionCalendarDatePopoverConfig {
-    origin: ElementRef;
-    injector: Injector;
+    readonly origin: ElementRef;
+    readonly injector: Injector;
 }
 declare class DbxScheduleSelectionCalendarDatePopoverComponent extends AbstractPopoverDirective<void> {
     static openPopover(popoverService: DbxPopoverService, { origin, injector }: DbxScheduleSelectionCalendarDatePopoverConfig, popoverKey?: DbxPopoverKey): NgPopoverRef<any, number>;

package/types/dereekb-dbx-form-mapbox.d.ts

@@ -131,9 +131,10 @@ interface MapboxLatLngFieldConfig extends Omit<LabeledBaseFieldConfig, 'key'>, D
 /**
  * Creates a Formly field configuration for a Mapbox-powered latitude/longitude picker with optional map display.
  *
+ * @param config - Optional field configuration overrides.
+ * @returns A validated Formly field configuration for the Mapbox lat/lng picker.
+ *
  * @deprecated Use dbxForgeMapboxLatLngField() from the forge API instead.
- * @param config - Optional field configuration overrides
- * @returns A validated Formly field configuration for the Mapbox lat/lng picker
  */
 declare function mapboxLatLngField(config?: MapboxLatLngFieldConfig): FormlyFieldConfig;
 
@@ -214,8 +215,8 @@ declare class DbxForgeMapboxLatLngFieldComponent {
     readonly compactClass$: Observable<string>;
     private readonly _useCurrentLocationDisabled;
     readonly useCurrentLocationDisabled$: Observable<boolean>;
-    readonly fieldValue: Signal<unknown>;
-    readonly isDisabled: Signal<boolean>;
+    readonly fieldValueSignal: Signal<unknown>;
+    readonly isDisabledSignal: Signal<boolean>;
     readonly isReadonlyOrDisabledSignal: Signal<any>;
     readonly showMapSignal: Signal<boolean>;
     readonly selectLocationOnMapDragSignal: Signal<boolean>;
@@ -245,9 +246,9 @@ declare class DbxForgeMapboxLatLngFieldComponent {
 /**
  * Custom mapper for the forge mapbox lat/lng field.
  *
- * @param fieldDef - Field definition configuration
- * @param fieldDef.key - Form model key for the field
- * @returns Signal containing a Record of input names to values for ngComponentOutlet
+ * @param fieldDef - Field definition configuration.
+ * @param fieldDef.key - Form model key for the field.
+ * @returns Signal containing a Record of input names to values for ngComponentOutlet.
  */
 declare function mapboxLatLngFieldMapper(fieldDef: {
     key: string;
@@ -287,8 +288,8 @@ interface DbxForgeMapboxLatLngFieldConfig {
  *
  * This is the forge equivalent of {@link mapboxLatLngField}.
  *
- * @param config - Optional field configuration overrides
- * @returns A validated forge field definition for the Mapbox lat/lng picker
+ * @param config - Optional field configuration overrides.
+ * @returns A validated forge field definition for the Mapbox lat/lng picker.
  */
 declare function dbxForgeMapboxLatLngField(config?: DbxForgeMapboxLatLngFieldConfig): DbxForgeMapboxLatLngFieldDef;
 
@@ -371,9 +372,10 @@ interface MapboxZoomFieldConfig extends Omit<LabeledBaseFieldConfig, 'key'>, Des
 /**
  * Creates a Formly field configuration for a Mapbox-powered zoom level picker with optional map preview.
  *
+ * @param config - Optional field configuration overrides.
+ * @returns A validated Formly field configuration for the Mapbox zoom picker.
+ *
  * @deprecated Use dbxForgeMapboxZoomField() from the forge API instead.
- * @param config - Optional field configuration overrides
- * @returns A validated Formly field configuration for the Mapbox zoom picker
  */
 declare function mapboxZoomField(config?: MapboxZoomFieldConfig): FormlyFieldConfig;
 
@@ -422,15 +424,15 @@ declare class DbxForgeMapboxZoomFieldComponent implements OnDestroy {
     readonly meta: InputSignal<FieldMeta | undefined>;
     readonly validationMessages: InputSignal<ValidationMessages | undefined>;
     readonly defaultValidationMessages: InputSignal<ValidationMessages | undefined>;
-    readonly numberCtrl: FormControl<number | null>;
+    readonly numberCtrl: FormControl<Maybe<number>>;
     readonly placeholderText = "";
     private _undoZoomLimit;
     readonly compactClass$: Observable<string>;
     readonly compactClassSignal: Signal<string>;
     private readonly _sub;
     private readonly _center;
-    readonly fieldValue: Signal<unknown>;
-    readonly isDisabled: Signal<boolean>;
+    readonly fieldValueSignal: Signal<unknown>;
+    readonly isDisabledSignal: Signal<boolean>;
     readonly isReadonlyOrDisabledSignal: Signal<any>;
     readonly showMapSignal: Signal<boolean>;
     readonly lockMapToZoomLevelsSignal: Signal<boolean>;
@@ -451,9 +453,9 @@ declare class DbxForgeMapboxZoomFieldComponent implements OnDestroy {
 /**
  * Custom mapper for the forge mapbox zoom field.
  *
- * @param fieldDef - Field definition configuration
- * @param fieldDef.key - Form model key for the field
- * @returns Signal containing a Record of input names to values for ngComponentOutlet
+ * @param fieldDef - Field definition configuration.
+ * @param fieldDef.key - Form model key for the field.
+ * @returns Signal containing a Record of input names to values for ngComponentOutlet.
  */
 declare function mapboxZoomFieldMapper(fieldDef: {
     key: string;
@@ -489,8 +491,8 @@ interface DbxForgeMapboxZoomFieldConfig {
  *
  * This is the forge equivalent of {@link mapboxZoomField}.
  *
- * @param config - Optional field configuration overrides
- * @returns A validated forge field definition for the Mapbox zoom picker
+ * @param config - Optional field configuration overrides.
+ * @returns A validated forge field definition for the Mapbox zoom picker.
  */
 declare function dbxForgeMapboxZoomField(config?: DbxForgeMapboxZoomFieldConfig): DbxForgeMapboxZoomFieldDef;
 
@@ -512,7 +514,7 @@ declare const DBX_FORGE_MAPBOX_FIELD_TYPES: FieldTypeDefinition[];
  *
  * Add this to your app's providers alongside provideDbxForgeFormFieldDeclarations().
  *
- * @returns An array of providers that register the mapbox forge field types with ng-forge
+ * @returns The providers that register the mapbox forge field types with ng-forge.
  */
 declare function provideDbxForgeMapboxFieldDeclarations(): i0.EnvironmentProviders & {
     __fieldDefs?: any;

package/types/dereekb-dbx-form-quiz.d.ts

@@ -216,8 +216,9 @@ declare class QuizStore extends ComponentStore<QuizStoreState> {
     /**
      * Returns a reactive observable of the answer for a given question, looked up by id, index, or the current question.
      *
-     * @param lookupInput - Lookup criteria specifying which question's answer to retrieve
-     * @returns An observable that emits the current answer for the specified question, or undefined if not answered
+     * @param lookupInput - Lookup criteria specifying which question's answer to retrieve.
+     * @param lookupInput - Lookup criteria specifying which question's answer to retrieve.
+     * @returns An observable that emits the current answer for the specified question, or undefined if not answered.
      *
      * @example
      * ```ts
@@ -226,8 +227,6 @@ declare class QuizStore extends ComponentStore<QuizStoreState> {
      * // By question id:
      * store.answerForQuestion({ id: 'q1' }).subscribe(answer => console.log(answer));
      * ```
-     *
-     * @param lookupInput - Lookup criteria specifying which question's answer to retrieve
      */
     answerForQuestion(lookupInput: ObservableOrValue<QuizStoreAnswerLookupInput>): Observable<Maybe<QuizAnswer>>;
     readonly startQuiz: () => void;
@@ -286,11 +285,11 @@ declare abstract class QuizQuestionAccessor<T = unknown> {
 /**
  * Provides QuizQuestionAccessor bound to the current question in QuizStore.
  *
- * @returns An Angular provider that binds QuizQuestionAccessor to the current quiz question
+ * @returns An Angular provider that binds QuizQuestionAccessor to the current quiz question.
  *
  * @usage
  * ```typescript
- * @Component({
+ * @Component ({
  *   providers: [QuizStore, provideCurrentQuestionQuizQuestionAccessor()]
  * })
  * ```
@@ -650,31 +649,29 @@ declare class DbxQuizScoreComponent {
 /**
  * Creates a Likert scale question config with agreement prompt (Strongly Disagree to Strongly Agree).
  *
- * @param text - The statement to rate agreement on
- * @returns A quiz question config with an agreement-based prompt and guidance text
+ * @param text - The statement to rate agreement on.
+ * @param text - The statement to rate agreement on.
+ * @returns A quiz question config with an agreement-based prompt and guidance text.
  *
  * @example
  * ```ts
  * instance.config.set(quizAgreementPrompt('I feel confident leading under pressure.'));
  * // { prompt: 'Please rate how much you agree...', text: '...', guidance: '1 = Strongly Disagree, 5 = Strongly Agree' }
  * ```
- *
- * @param text - The statement to rate agreement on
  */
 declare function quizAgreementPrompt(text: string): QuizQuestionTextComponentConfig;
 /**
  * Creates a Likert scale question config with frequency prompt (Never to Always).
  *
- * @param text - The statement to rate frequency on
- * @returns A quiz question config with a frequency-based prompt and guidance text
+ * @param text - The statement to rate frequency on.
+ * @param text - The statement to rate frequency on.
+ * @returns A quiz question config with a frequency-based prompt and guidance text.
  *
  * @example
  * ```ts
  * instance.config.set(quizFrequencyPrompt('I break vague direction into first steps.'));
  * // { prompt: 'Please rate how much you agree...', text: '...', guidance: '1 = Never, 5 = Always' }
  * ```
- *
- * @param text - The statement to rate frequency on
  */
 declare function quizFrequencyPrompt(text: string): QuizQuestionTextComponentConfig;