ng-primitives 0.124.0 → 0.125.0

package/date-time-date-fns/README.md

@@ -0,0 +1,3 @@
+# ng-primitives/date-time-date-fns
+
+Secondary entry point of `ng-primitives`. It can be used by importing from `ng-primitives/date-time-date-fns`.

package/fesm2022/ng-primitives-avatar.mjs

@@ -100,8 +100,10 @@ const [NgpAvatarImageStateToken, ngpAvatarImage, injectAvatarImageState, provide
     if (!element.nativeElement.src) {
         setStatus(NgpAvatarStatus.Error);
     }
-    // if the image has already loaded, we can report this to the avatar
-    if (element.nativeElement.complete) {
+    // if the image has already loaded, we can report this to the avatar. `complete` is also true
+    // for an image with no src or one that failed to load, so we additionally require a decoded
+    // image (naturalWidth > 0) to distinguish a genuine load from an error state.
+    if (element.nativeElement.complete && element.nativeElement.naturalWidth > 0) {
         setStatus(NgpAvatarStatus.Loaded);
     }
     // host listeners

package/fesm2022/ng-primitives-avatar.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-primitives-avatar.mjs","sources":["../../../../packages/ng-primitives/avatar/src/config/avatar-config.ts","../../../../packages/ng-primitives/avatar/src/avatar/avatar-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-fallback/avatar-fallback-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-fallback/avatar-fallback.ts","../../../../packages/ng-primitives/avatar/src/avatar-image/avatar-image-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-image/avatar-image.ts","../../../../packages/ng-primitives/avatar/src/avatar/avatar.ts","../../../../packages/ng-primitives/avatar/src/ng-primitives-avatar.ts"],"sourcesContent":["import { InjectionToken, Provider, inject } from '@angular/core';\n\nexport interface NgpAvatarConfig {\n  /**\n   * Define a delay before the fallback is shown. This is useful to only show the fallback for those with slower connections.\n   * @default 0\n   */\n  delay: number;\n}\n\nexport const defaultAvatarConfig: NgpAvatarConfig = {\n  delay: 0,\n};\n\nexport const NgpAvatarConfigToken = new InjectionToken<NgpAvatarConfig>('NgpAvatarConfigToken');\n\n/**\n * Provide the avatar config\n * @param config The avatar config\n * @returns The provider\n */\nexport function provideAvatarConfig(config: Partial<NgpAvatarConfig>): Provider[] {\n  return [\n    {\n      provide: NgpAvatarConfigToken,\n      useValue: { ...defaultAvatarConfig, ...config },\n    },\n  ];\n}\n\n/**\n * Inject the avatar config\n * @returns The global avatar config\n */\nexport function injectAvatarConfig(): NgpAvatarConfig {\n  return inject(NgpAvatarConfigToken, { optional: true }) ?? defaultAvatarConfig;\n}\n","import { signal, Signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, dataBinding } from 'ng-primitives/state';\n\nexport interface NgpAvatarState {\n  /**\n   * The avatar status.\n   */\n  status: Signal<NgpAvatarStatus>;\n\n  /**\n   * Set the avatar status.\n   */\n  setStatus(status: NgpAvatarStatus): void;\n}\n\nexport interface NgpAvatarProps {}\n\nexport const [NgpAvatarStateToken, ngpAvatar, injectAvatarState, provideAvatarState] =\n  createPrimitive('NgpAvatar', ({}: NgpAvatarProps) => {\n    const element = injectElementRef();\n    const status = signal(NgpAvatarStatus.Idle);\n\n    // Host bindings\n    dataBinding(element, 'data-status', status);\n\n    function setStatus(newStatus: NgpAvatarStatus): void {\n      status.set(newStatus);\n    }\n\n    return {\n      status,\n      setStatus,\n    } satisfies NgpAvatarState;\n  });\n\nexport enum NgpAvatarStatus {\n  Idle = 'idle',\n  Loading = 'loading',\n  Loaded = 'loaded',\n  Error = 'error',\n}\n","import { computed, signal, Signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, styleBinding } from 'ng-primitives/state';\nimport { injectDisposables } from 'ng-primitives/utils';\nimport { injectAvatarState, NgpAvatarStatus } from '../avatar/avatar-state';\n\nexport interface NgpAvatarFallbackState {}\n\nexport interface NgpAvatarFallbackProps {\n  /**\n   * The delay before showing the fallback.\n   */\n  delay?: Signal<number>;\n}\n\nexport const [\n  NgpAvatarFallbackStateToken,\n  ngpAvatarFallback,\n  injectAvatarFallbackState,\n  provideAvatarFallbackState,\n] = createPrimitive('NgpAvatarFallback', ({ delay = signal(0) }: NgpAvatarFallbackProps) => {\n  const avatar = injectAvatarState();\n  const element = injectElementRef();\n  const disposables = injectDisposables();\n\n  const delayElapsed = signal(false);\n  const visible = computed(() => delayElapsed() && avatar().status() !== NgpAvatarStatus.Loaded);\n\n  disposables.setTimeout(() => delayElapsed.set(true), delay());\n\n  styleBinding(element, 'display', () => (visible() ? null : 'none'));\n\n  return {} satisfies NgpAvatarFallbackState;\n});\n","import { NumberInput } from '@angular/cdk/coercion';\nimport { Directive, input, numberAttribute } from '@angular/core';\nimport { injectAvatarConfig } from '../config/avatar-config';\nimport { ngpAvatarFallback } from './avatar-fallback-state';\n\n/**\n * Apply the `ngpAvatarFallback` directive to an element that represents the user in the absence of an image. This is typically the user's initials.\n */\n@Directive({\n  selector: '[ngpAvatarFallback]',\n  exportAs: 'ngpAvatarFallback',\n})\nexport class NgpAvatarFallback {\n  /**\n   * Access the global configuration.\n   */\n  private readonly config = injectAvatarConfig();\n\n  /**\n   * Define a delay before the fallback is shown. This is useful to only show the fallback for those with slower connections.\n   * @default 0\n   */\n  readonly delay = input<number, NumberInput>(this.config.delay, {\n    alias: 'ngpAvatarFallbackDelay',\n    transform: numberAttribute,\n  });\n\n  constructor() {\n    ngpAvatarFallback({ delay: this.delay });\n  }\n}\n","import { ngpVisuallyHidden } from 'ng-primitives/a11y';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, listener } from 'ng-primitives/state';\nimport { injectAvatarState, NgpAvatarStatus } from '../avatar/avatar-state';\n\nexport interface NgpAvatarImageState {}\n\nexport interface NgpAvatarImageProps {}\n\nexport const [\n  NgpAvatarImageStateToken,\n  ngpAvatarImage,\n  injectAvatarImageState,\n  provideAvatarImageState,\n] = createPrimitive('NgpAvatarImage', ({}: NgpAvatarImageProps) => {\n  const avatar = injectAvatarState();\n  const element = injectElementRef<HTMLImageElement>();\n  const visuallyHidden = ngpVisuallyHidden({});\n\n  // initially mark the avatar as loading\n  setStatus(NgpAvatarStatus.Loading);\n\n  // if there is no src, we can report this as an error\n  if (!element.nativeElement.src) {\n    setStatus(NgpAvatarStatus.Error);\n  }\n\n  // if the image has already loaded, we can report this to the avatar\n  if (element.nativeElement.complete) {\n    setStatus(NgpAvatarStatus.Loaded);\n  }\n\n  // host listeners\n  listener(element, 'load', () => setStatus(NgpAvatarStatus.Loaded));\n  listener(element, 'error', () => setStatus(NgpAvatarStatus.Error));\n\n  function setStatus(state: NgpAvatarStatus) {\n    avatar().setStatus(state);\n    visuallyHidden.setVisibility(state === NgpAvatarStatus.Loaded);\n  }\n\n  return {} satisfies NgpAvatarImageState;\n});\n","import { Directive } from '@angular/core';\nimport { ngpAvatarImage } from './avatar-image-state';\n\n/**\n * Apply the `ngpAvatarImage` directive to an element that represents the avatar image. This would typically be an `img` element or a `div` with a background image.\n */\n@Directive({\n  selector: 'img[ngpAvatarImage]',\n  exportAs: 'ngpAvatarImage',\n})\nexport class NgpAvatarImage {\n  constructor() {\n    ngpAvatarImage({});\n  }\n}\n","import { Directive } from '@angular/core';\nimport { ngpAvatar, NgpAvatarStatus, provideAvatarState } from './avatar-state';\n\n/**\n * Apply the `ngpAvatar` directive to an element that represents the avatar. This directive is a container for the image and/or fallback.\n */\n@Directive({\n  selector: '[ngpAvatar]',\n  exportAs: 'ngpAvatar',\n  providers: [provideAvatarState()],\n})\nexport class NgpAvatar {\n  /**\n   * The avatar state.\n   */\n  private readonly state = ngpAvatar({});\n\n  /**\n   * Set the avatar status.\n   * @param status The status to set.\n   * @internal\n   */\n  setStatus(status: NgpAvatarStatus): void {\n    this.state.setStatus(status);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-primitives-avatar.mjs","sources":["../../../../packages/ng-primitives/avatar/src/config/avatar-config.ts","../../../../packages/ng-primitives/avatar/src/avatar/avatar-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-fallback/avatar-fallback-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-fallback/avatar-fallback.ts","../../../../packages/ng-primitives/avatar/src/avatar-image/avatar-image-state.ts","../../../../packages/ng-primitives/avatar/src/avatar-image/avatar-image.ts","../../../../packages/ng-primitives/avatar/src/avatar/avatar.ts","../../../../packages/ng-primitives/avatar/src/ng-primitives-avatar.ts"],"sourcesContent":["import { InjectionToken, Provider, inject } from '@angular/core';\n\nexport interface NgpAvatarConfig {\n  /**\n   * Define a delay before the fallback is shown. This is useful to only show the fallback for those with slower connections.\n   * @default 0\n   */\n  delay: number;\n}\n\nexport const defaultAvatarConfig: NgpAvatarConfig = {\n  delay: 0,\n};\n\nexport const NgpAvatarConfigToken = new InjectionToken<NgpAvatarConfig>('NgpAvatarConfigToken');\n\n/**\n * Provide the avatar config\n * @param config The avatar config\n * @returns The provider\n */\nexport function provideAvatarConfig(config: Partial<NgpAvatarConfig>): Provider[] {\n  return [\n    {\n      provide: NgpAvatarConfigToken,\n      useValue: { ...defaultAvatarConfig, ...config },\n    },\n  ];\n}\n\n/**\n * Inject the avatar config\n * @returns The global avatar config\n */\nexport function injectAvatarConfig(): NgpAvatarConfig {\n  return inject(NgpAvatarConfigToken, { optional: true }) ?? defaultAvatarConfig;\n}\n","import { signal, Signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, dataBinding } from 'ng-primitives/state';\n\nexport interface NgpAvatarState {\n  /**\n   * The avatar status.\n   */\n  status: Signal<NgpAvatarStatus>;\n\n  /**\n   * Set the avatar status.\n   */\n  setStatus(status: NgpAvatarStatus): void;\n}\n\nexport interface NgpAvatarProps {}\n\nexport const [NgpAvatarStateToken, ngpAvatar, injectAvatarState, provideAvatarState] =\n  createPrimitive('NgpAvatar', ({}: NgpAvatarProps) => {\n    const element = injectElementRef();\n    const status = signal(NgpAvatarStatus.Idle);\n\n    // Host bindings\n    dataBinding(element, 'data-status', status);\n\n    function setStatus(newStatus: NgpAvatarStatus): void {\n      status.set(newStatus);\n    }\n\n    return {\n      status,\n      setStatus,\n    } satisfies NgpAvatarState;\n  });\n\nexport enum NgpAvatarStatus {\n  Idle = 'idle',\n  Loading = 'loading',\n  Loaded = 'loaded',\n  Error = 'error',\n}\n","import { computed, signal, Signal } from '@angular/core';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, styleBinding } from 'ng-primitives/state';\nimport { injectDisposables } from 'ng-primitives/utils';\nimport { injectAvatarState, NgpAvatarStatus } from '../avatar/avatar-state';\n\nexport interface NgpAvatarFallbackState {}\n\nexport interface NgpAvatarFallbackProps {\n  /**\n   * The delay before showing the fallback.\n   */\n  delay?: Signal<number>;\n}\n\nexport const [\n  NgpAvatarFallbackStateToken,\n  ngpAvatarFallback,\n  injectAvatarFallbackState,\n  provideAvatarFallbackState,\n] = createPrimitive('NgpAvatarFallback', ({ delay = signal(0) }: NgpAvatarFallbackProps) => {\n  const avatar = injectAvatarState();\n  const element = injectElementRef();\n  const disposables = injectDisposables();\n\n  const delayElapsed = signal(false);\n  const visible = computed(() => delayElapsed() && avatar().status() !== NgpAvatarStatus.Loaded);\n\n  disposables.setTimeout(() => delayElapsed.set(true), delay());\n\n  styleBinding(element, 'display', () => (visible() ? null : 'none'));\n\n  return {} satisfies NgpAvatarFallbackState;\n});\n","import { NumberInput } from '@angular/cdk/coercion';\nimport { Directive, input, numberAttribute } from '@angular/core';\nimport { injectAvatarConfig } from '../config/avatar-config';\nimport { ngpAvatarFallback } from './avatar-fallback-state';\n\n/**\n * Apply the `ngpAvatarFallback` directive to an element that represents the user in the absence of an image. This is typically the user's initials.\n */\n@Directive({\n  selector: '[ngpAvatarFallback]',\n  exportAs: 'ngpAvatarFallback',\n})\nexport class NgpAvatarFallback {\n  /**\n   * Access the global configuration.\n   */\n  private readonly config = injectAvatarConfig();\n\n  /**\n   * Define a delay before the fallback is shown. This is useful to only show the fallback for those with slower connections.\n   * @default 0\n   */\n  readonly delay = input<number, NumberInput>(this.config.delay, {\n    alias: 'ngpAvatarFallbackDelay',\n    transform: numberAttribute,\n  });\n\n  constructor() {\n    ngpAvatarFallback({ delay: this.delay });\n  }\n}\n","import { ngpVisuallyHidden } from 'ng-primitives/a11y';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport { createPrimitive, listener } from 'ng-primitives/state';\nimport { injectAvatarState, NgpAvatarStatus } from '../avatar/avatar-state';\n\nexport interface NgpAvatarImageState {}\n\nexport interface NgpAvatarImageProps {}\n\nexport const [\n  NgpAvatarImageStateToken,\n  ngpAvatarImage,\n  injectAvatarImageState,\n  provideAvatarImageState,\n] = createPrimitive('NgpAvatarImage', ({}: NgpAvatarImageProps) => {\n  const avatar = injectAvatarState();\n  const element = injectElementRef<HTMLImageElement>();\n  const visuallyHidden = ngpVisuallyHidden({});\n\n  // initially mark the avatar as loading\n  setStatus(NgpAvatarStatus.Loading);\n\n  // if there is no src, we can report this as an error\n  if (!element.nativeElement.src) {\n    setStatus(NgpAvatarStatus.Error);\n  }\n\n  // if the image has already loaded, we can report this to the avatar. `complete` is also true\n  // for an image with no src or one that failed to load, so we additionally require a decoded\n  // image (naturalWidth > 0) to distinguish a genuine load from an error state.\n  if (element.nativeElement.complete && element.nativeElement.naturalWidth > 0) {\n    setStatus(NgpAvatarStatus.Loaded);\n  }\n\n  // host listeners\n  listener(element, 'load', () => setStatus(NgpAvatarStatus.Loaded));\n  listener(element, 'error', () => setStatus(NgpAvatarStatus.Error));\n\n  function setStatus(state: NgpAvatarStatus) {\n    avatar().setStatus(state);\n    visuallyHidden.setVisibility(state === NgpAvatarStatus.Loaded);\n  }\n\n  return {} satisfies NgpAvatarImageState;\n});\n","import { Directive } from '@angular/core';\nimport { ngpAvatarImage } from './avatar-image-state';\n\n/**\n * Apply the `ngpAvatarImage` directive to an element that represents the avatar image. This would typically be an `img` element or a `div` with a background image.\n */\n@Directive({\n  selector: 'img[ngpAvatarImage]',\n  exportAs: 'ngpAvatarImage',\n})\nexport class NgpAvatarImage {\n  constructor() {\n    ngpAvatarImage({});\n  }\n}\n","import { Directive } from '@angular/core';\nimport { ngpAvatar, NgpAvatarStatus, provideAvatarState } from './avatar-state';\n\n/**\n * Apply the `ngpAvatar` directive to an element that represents the avatar. This directive is a container for the image and/or fallback.\n */\n@Directive({\n  selector: '[ngpAvatar]',\n  exportAs: 'ngpAvatar',\n  providers: [provideAvatarState()],\n})\nexport class NgpAvatar {\n  /**\n   * The avatar state.\n   */\n  private readonly state = ngpAvatar({});\n\n  /**\n   * Set the avatar status.\n   * @param status The status to set.\n   * @internal\n   */\n  setStatus(status: NgpAvatarStatus): void {\n    this.state.setStatus(status);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ng-primitives-checkbox.mjs

@@ -6,7 +6,7 @@ import { ngpInteractions } from 'ng-primitives/interactions';
 import { injectElementRef } from 'ng-primitives/internal';
 import { createPrimitive, controlled, controlledState, emitter, attrBinding, dataBinding, listener, deprecatedSetter } from 'ng-primitives/state';
 
-const [NgpCheckboxStateToken, ngpCheckbox, injectCheckboxState, provideCheckboxState] = createPrimitive('NgpCheckbox', ({ id = signal(uniqueId('ngp-checkbox')), checked: _checked = signal(undefined), defaultChecked: _defaultChecked, indeterminate: _indeterminate = signal(false), disabled: _disabled = signal(false), onCheckedChange, onIndeterminateChange, }) => {
+const [NgpCheckboxStateToken, ngpCheckbox, injectCheckboxState, provideCheckboxState] = createPrimitive('NgpCheckbox', ({ id = signal(uniqueId('ngp-checkbox')), checked: _checked = signal(undefined), defaultChecked: _defaultChecked, indeterminate: _indeterminate = signal(false), disabled: _disabled = signal(false), required: _required = signal(false), onCheckedChange, onIndeterminateChange, }) => {
     const element = injectElementRef();
     const defaultChecked = controlled(_defaultChecked, false);
     const [checked, setChecked, checkedChange] = controlledState({
@@ -23,10 +23,11 @@ const [NgpCheckboxStateToken, ngpCheckbox, injectCheckboxState, provideCheckboxS
     ngpFormControl({ id, disabled });
     // Host bindings
     attrBinding(element, 'role', 'checkbox');
-    attrBinding(element, 'aria-checked', () => (indeterminate() ? 'mixed' : checked()));
+    attrBinding(element, 'aria-checked', () => indeterminate() ? 'mixed' : checked() ? 'true' : 'false');
     dataBinding(element, 'data-checked', checked);
     dataBinding(element, 'data-indeterminate', indeterminate);
     attrBinding(element, 'aria-disabled', disabled);
+    attrBinding(element, 'aria-required', () => (_required() ? 'true' : null));
     attrBinding(element, 'tabindex', () => tabindex().toString());
     // Event listeners
     listener(element, 'click', event => toggle(event));
@@ -133,6 +134,7 @@ class NgpCheckbox {
             defaultChecked: this.defaultChecked,
             indeterminate: this.indeterminate,
             disabled: this.disabled,
+            required: this.required,
             onCheckedChange: value => this.checkedChange.emit(value),
             onIndeterminateChange: value => this.indeterminateChange.emit(value),
         });

package/fesm2022/ng-primitives-checkbox.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ng-primitives-checkbox.mjs","sources":["../../../../packages/ng-primitives/checkbox/src/checkbox/checkbox-state.ts","../../../../packages/ng-primitives/checkbox/src/checkbox/checkbox.ts","../../../../packages/ng-primitives/checkbox/src/ng-primitives-checkbox.ts"],"sourcesContent":["import { computed, Signal, signal, WritableSignal } from '@angular/core';\nimport { ngpFormControl } from 'ng-primitives/form-field';\nimport { ngpInteractions } from 'ng-primitives/interactions';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport {\n  attrBinding,\n  controlled,\n  controlledState,\n  createPrimitive,\n  dataBinding,\n  deprecatedSetter,\n  emitter,\n  listener,\n  SetterOptions,\n} from 'ng-primitives/state';\nimport { uniqueId } from 'ng-primitives/utils';\nimport { Observable } from 'rxjs';\n\n/**\n * Public state surface for the Checkbox primitive.\n */\nexport interface NgpCheckboxState {\n  /**\n   * The id of the checkbox.\n   */\n  readonly id: Signal<string>;\n  /**\n   * Whether the checkbox is checked.\n   */\n  readonly checked: WritableSignal<boolean>;\n  /**\n   * Whether the checkbox is indeterminate.\n   */\n  readonly indeterminate: WritableSignal<boolean>;\n  /**\n   * Whether the checkbox is disabled.\n   */\n  readonly disabled: WritableSignal<boolean>;\n  /**\n   * Emits when the checked state changes.\n   */\n  readonly checkedChange: Observable<boolean>;\n  /**\n   * Emits when the indeterminate state changes.\n   */\n  readonly indeterminateChange: Observable<boolean>;\n  /**\n   * Toggle the checkbox value.\n   */\n  toggle(event?: Event): void;\n  /**\n   * Update the checked value.\n   */\n  setChecked(value: boolean, options?: SetterOptions): void;\n  /**\n   * Set the default checked state.\n   */\n  setDefaultChecked(value: boolean): void;\n  /**\n   * Update the indeterminate value.\n   */\n  setIndeterminate(value: boolean): void;\n  /**\n   * Set the disabled value.\n   */\n  setDisabled(value: boolean): void;\n}\n\n/**\n * Inputs for configuring the Checkbox primitive.\n */\nexport interface NgpCheckboxProps {\n  /**\n   * The id of the checkbox.\n   */\n  readonly id?: Signal<string>;\n  /**\n   * Whether the checkbox is checked.\n   */\n  readonly checked?: Signal<boolean | undefined>;\n  /**\n   * The default checked state for uncontrolled usage.\n   */\n  readonly defaultChecked?: Signal<boolean>;\n  /**\n   * Whether the checkbox is indeterminate.\n   */\n  readonly indeterminate?: Signal<boolean>;\n  /**\n   * Whether the checkbox is disabled.\n   */\n  readonly disabled?: Signal<boolean>;\n  /**\n   * Callback fired when the checked state changes.\n   */\n  readonly onCheckedChange?: (checked: boolean) => void;\n  /**\n   * Callback fired when the indeterminate state changes.\n   */\n  readonly onIndeterminateChange?: (indeterminate: boolean) => void;\n}\n\nexport const [NgpCheckboxStateToken, ngpCheckbox, injectCheckboxState, provideCheckboxState] =\n  createPrimitive(\n    'NgpCheckbox',\n    ({\n      id = signal(uniqueId('ngp-checkbox')),\n      checked: _checked = signal<boolean | undefined>(undefined),\n      defaultChecked: _defaultChecked,\n      indeterminate: _indeterminate = signal(false),\n      disabled: _disabled = signal(false),\n      onCheckedChange,\n      onIndeterminateChange,\n    }: NgpCheckboxProps): NgpCheckboxState => {\n      const element = injectElementRef();\n      const defaultChecked = controlled(_defaultChecked, false);\n      const [checked, setChecked, checkedChange] = controlledState({\n        value: _checked,\n        defaultValue: defaultChecked,\n        onChange: onCheckedChange,\n      });\n      const indeterminate = controlled(_indeterminate);\n      const disabled = controlled(_disabled);\n      const indeterminateChange = emitter<boolean>();\n      const tabindex = computed(() => (disabled() ? -1 : 0));\n\n      // Setup interactions and form control hooks\n      ngpInteractions({ hover: true, press: true, focusVisible: true, disabled });\n      ngpFormControl({ id, disabled });\n\n      // Host bindings\n      attrBinding(element, 'role', 'checkbox');\n      attrBinding(element, 'aria-checked', () => (indeterminate() ? 'mixed' : checked()));\n      dataBinding(element, 'data-checked', checked);\n      dataBinding(element, 'data-indeterminate', indeterminate);\n      attrBinding(element, 'aria-disabled', disabled);\n      attrBinding(element, 'tabindex', () => tabindex().toString());\n\n      // Event listeners\n      listener(element, 'click', event => toggle(event));\n      listener(element, 'keydown', (event: KeyboardEvent) => {\n        if (event.key === 'Enter') {\n          // According to WAI ARIA, checkboxes don't activate on enter keypress\n          event.preventDefault();\n          return;\n        }\n\n        if (event.key === ' ' || event.key === 'Spacebar') {\n          toggle(event);\n        }\n      });\n\n      function toggle(event?: Event): void {\n        if (disabled()) {\n          return;\n        }\n\n        // prevent this firing twice in cases where the label is clicked and the checkbox is clicked by the one event\n        event?.preventDefault();\n\n        const nextChecked = indeterminate() ? true : !checked();\n        setChecked(nextChecked);\n\n        // if the checkbox was indeterminate, it isn't anymore\n        if (indeterminate()) {\n          setIndeterminate(false);\n        }\n      }\n\n      function setIndeterminate(value: boolean): void {\n        indeterminate.set(value);\n        onIndeterminateChange?.(value);\n        indeterminateChange.emit(value);\n      }\n\n      function setDisabled(value: boolean): void {\n        disabled.set(value);\n      }\n\n      return {\n        id,\n        checked: deprecatedSetter(checked, 'setChecked', setChecked),\n        indeterminate: deprecatedSetter(indeterminate, 'setIndeterminate'),\n        disabled: deprecatedSetter(disabled, 'setDisabled'),\n        checkedChange,\n        indeterminateChange: indeterminateChange.asObservable(),\n        toggle,\n        setChecked,\n        setDefaultChecked: defaultChecked.set,\n        setIndeterminate,\n        setDisabled,\n      } satisfies NgpCheckboxState;\n    },\n  );\n","import { BooleanInput } from '@angular/cdk/coercion';\nimport { Directive, booleanAttribute, input, output } from '@angular/core';\nimport { SetterOptions } from 'ng-primitives/state';\nimport { uniqueId } from 'ng-primitives/utils';\nimport { ngpCheckbox, provideCheckboxState } from './checkbox-state';\n\n/**\n * Apply the `ngpCheckbox` directive to an element to that represents the checkbox, such as a `button`.\n */\n@Directive({\n  selector: '[ngpCheckbox]',\n  providers: [provideCheckboxState({ inherit: false })],\n})\nexport class NgpCheckbox {\n  /**\n   * The id of the checkbox.\n   * @internal\n   */\n  readonly id = input(uniqueId('ngp-checkbox'));\n\n  /**\n   * Defines whether the checkbox is checked.\n   */\n  readonly checked = input<boolean | undefined, BooleanInput>(undefined, {\n    alias: 'ngpCheckboxChecked',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The default checked state for uncontrolled usage.\n   * @default false\n   */\n  readonly defaultChecked = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxDefaultChecked',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The event that is emitted when the checkbox value changes.\n   */\n  readonly checkedChange = output<boolean>({\n    alias: 'ngpCheckboxCheckedChange',\n  });\n\n  /**\n   * Defines whether the checkbox is indeterminate.\n   */\n  readonly indeterminate = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxIndeterminate',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The event that is emitted when the indeterminate value changes.\n   */\n  readonly indeterminateChange = output<boolean>({\n    alias: 'ngpCheckboxIndeterminateChange',\n  });\n\n  /**\n   * Whether the checkbox is required.\n   */\n  readonly required = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxRequired',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * Defines whether the checkbox is disabled.\n   */\n  readonly disabled = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxDisabled',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The state of the checkbox.\n   */\n  protected readonly state = ngpCheckbox({\n    id: this.id,\n    checked: this.checked,\n    defaultChecked: this.defaultChecked,\n    indeterminate: this.indeterminate,\n    disabled: this.disabled,\n    onCheckedChange: value => this.checkedChange.emit(value),\n    onIndeterminateChange: value => this.indeterminateChange.emit(value),\n  });\n\n  toggle(event?: Event): void {\n    this.state.toggle(event);\n  }\n\n  /**\n   * Update the checked value.\n   */\n  setChecked(value: boolean, options?: SetterOptions): void {\n    this.state.setChecked(value, options);\n  }\n\n  /**\n   * Set the default checked state.\n   */\n  setDefaultChecked(value: boolean): void {\n    this.state.setDefaultChecked(value);\n  }\n\n  /**\n   * Update the indeterminate value.\n   */\n  setIndeterminate(value: boolean): void {\n    this.state.setIndeterminate(value);\n  }\n\n  /**\n   * Set the disabled value.\n   */\n  setDisabled(value: boolean): void {\n    this.state.setDisabled(value);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ng-primitives-checkbox.mjs","sources":["../../../../packages/ng-primitives/checkbox/src/checkbox/checkbox-state.ts","../../../../packages/ng-primitives/checkbox/src/checkbox/checkbox.ts","../../../../packages/ng-primitives/checkbox/src/ng-primitives-checkbox.ts"],"sourcesContent":["import { computed, Signal, signal, WritableSignal } from '@angular/core';\nimport { ngpFormControl } from 'ng-primitives/form-field';\nimport { ngpInteractions } from 'ng-primitives/interactions';\nimport { injectElementRef } from 'ng-primitives/internal';\nimport {\n  attrBinding,\n  controlled,\n  controlledState,\n  createPrimitive,\n  dataBinding,\n  deprecatedSetter,\n  emitter,\n  listener,\n  SetterOptions,\n} from 'ng-primitives/state';\nimport { uniqueId } from 'ng-primitives/utils';\nimport { Observable } from 'rxjs';\n\n/**\n * Public state surface for the Checkbox primitive.\n */\nexport interface NgpCheckboxState {\n  /**\n   * The id of the checkbox.\n   */\n  readonly id: Signal<string>;\n  /**\n   * Whether the checkbox is checked.\n   */\n  readonly checked: WritableSignal<boolean>;\n  /**\n   * Whether the checkbox is indeterminate.\n   */\n  readonly indeterminate: WritableSignal<boolean>;\n  /**\n   * Whether the checkbox is disabled.\n   */\n  readonly disabled: WritableSignal<boolean>;\n  /**\n   * Emits when the checked state changes.\n   */\n  readonly checkedChange: Observable<boolean>;\n  /**\n   * Emits when the indeterminate state changes.\n   */\n  readonly indeterminateChange: Observable<boolean>;\n  /**\n   * Toggle the checkbox value.\n   */\n  toggle(event?: Event): void;\n  /**\n   * Update the checked value.\n   */\n  setChecked(value: boolean, options?: SetterOptions): void;\n  /**\n   * Set the default checked state.\n   */\n  setDefaultChecked(value: boolean): void;\n  /**\n   * Update the indeterminate value.\n   */\n  setIndeterminate(value: boolean): void;\n  /**\n   * Set the disabled value.\n   */\n  setDisabled(value: boolean): void;\n}\n\n/**\n * Inputs for configuring the Checkbox primitive.\n */\nexport interface NgpCheckboxProps {\n  /**\n   * The id of the checkbox.\n   */\n  readonly id?: Signal<string>;\n  /**\n   * Whether the checkbox is checked.\n   */\n  readonly checked?: Signal<boolean | undefined>;\n  /**\n   * The default checked state for uncontrolled usage.\n   */\n  readonly defaultChecked?: Signal<boolean>;\n  /**\n   * Whether the checkbox is indeterminate.\n   */\n  readonly indeterminate?: Signal<boolean>;\n  /**\n   * Whether the checkbox is disabled.\n   */\n  readonly disabled?: Signal<boolean>;\n  /**\n   * Whether the checkbox is required.\n   */\n  readonly required?: Signal<boolean>;\n  /**\n   * Callback fired when the checked state changes.\n   */\n  readonly onCheckedChange?: (checked: boolean) => void;\n  /**\n   * Callback fired when the indeterminate state changes.\n   */\n  readonly onIndeterminateChange?: (indeterminate: boolean) => void;\n}\n\nexport const [NgpCheckboxStateToken, ngpCheckbox, injectCheckboxState, provideCheckboxState] =\n  createPrimitive(\n    'NgpCheckbox',\n    ({\n      id = signal(uniqueId('ngp-checkbox')),\n      checked: _checked = signal<boolean | undefined>(undefined),\n      defaultChecked: _defaultChecked,\n      indeterminate: _indeterminate = signal(false),\n      disabled: _disabled = signal(false),\n      required: _required = signal(false),\n      onCheckedChange,\n      onIndeterminateChange,\n    }: NgpCheckboxProps): NgpCheckboxState => {\n      const element = injectElementRef();\n      const defaultChecked = controlled(_defaultChecked, false);\n      const [checked, setChecked, checkedChange] = controlledState({\n        value: _checked,\n        defaultValue: defaultChecked,\n        onChange: onCheckedChange,\n      });\n      const indeterminate = controlled(_indeterminate);\n      const disabled = controlled(_disabled);\n      const indeterminateChange = emitter<boolean>();\n      const tabindex = computed(() => (disabled() ? -1 : 0));\n\n      // Setup interactions and form control hooks\n      ngpInteractions({ hover: true, press: true, focusVisible: true, disabled });\n      ngpFormControl({ id, disabled });\n\n      // Host bindings\n      attrBinding(element, 'role', 'checkbox');\n      attrBinding(element, 'aria-checked', () =>\n        indeterminate() ? 'mixed' : checked() ? 'true' : 'false',\n      );\n      dataBinding(element, 'data-checked', checked);\n      dataBinding(element, 'data-indeterminate', indeterminate);\n      attrBinding(element, 'aria-disabled', disabled);\n      attrBinding(element, 'aria-required', () => (_required() ? 'true' : null));\n      attrBinding(element, 'tabindex', () => tabindex().toString());\n\n      // Event listeners\n      listener(element, 'click', event => toggle(event));\n      listener(element, 'keydown', (event: KeyboardEvent) => {\n        if (event.key === 'Enter') {\n          // According to WAI ARIA, checkboxes don't activate on enter keypress\n          event.preventDefault();\n          return;\n        }\n\n        if (event.key === ' ' || event.key === 'Spacebar') {\n          toggle(event);\n        }\n      });\n\n      function toggle(event?: Event): void {\n        if (disabled()) {\n          return;\n        }\n\n        // prevent this firing twice in cases where the label is clicked and the checkbox is clicked by the one event\n        event?.preventDefault();\n\n        const nextChecked = indeterminate() ? true : !checked();\n        setChecked(nextChecked);\n\n        // if the checkbox was indeterminate, it isn't anymore\n        if (indeterminate()) {\n          setIndeterminate(false);\n        }\n      }\n\n      function setIndeterminate(value: boolean): void {\n        indeterminate.set(value);\n        onIndeterminateChange?.(value);\n        indeterminateChange.emit(value);\n      }\n\n      function setDisabled(value: boolean): void {\n        disabled.set(value);\n      }\n\n      return {\n        id,\n        checked: deprecatedSetter(checked, 'setChecked', setChecked),\n        indeterminate: deprecatedSetter(indeterminate, 'setIndeterminate'),\n        disabled: deprecatedSetter(disabled, 'setDisabled'),\n        checkedChange,\n        indeterminateChange: indeterminateChange.asObservable(),\n        toggle,\n        setChecked,\n        setDefaultChecked: defaultChecked.set,\n        setIndeterminate,\n        setDisabled,\n      } satisfies NgpCheckboxState;\n    },\n  );\n","import { BooleanInput } from '@angular/cdk/coercion';\nimport { Directive, booleanAttribute, input, output } from '@angular/core';\nimport { SetterOptions } from 'ng-primitives/state';\nimport { uniqueId } from 'ng-primitives/utils';\nimport { ngpCheckbox, provideCheckboxState } from './checkbox-state';\n\n/**\n * Apply the `ngpCheckbox` directive to an element to that represents the checkbox, such as a `button`.\n */\n@Directive({\n  selector: '[ngpCheckbox]',\n  providers: [provideCheckboxState({ inherit: false })],\n})\nexport class NgpCheckbox {\n  /**\n   * The id of the checkbox.\n   * @internal\n   */\n  readonly id = input(uniqueId('ngp-checkbox'));\n\n  /**\n   * Defines whether the checkbox is checked.\n   */\n  readonly checked = input<boolean | undefined, BooleanInput>(undefined, {\n    alias: 'ngpCheckboxChecked',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The default checked state for uncontrolled usage.\n   * @default false\n   */\n  readonly defaultChecked = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxDefaultChecked',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The event that is emitted when the checkbox value changes.\n   */\n  readonly checkedChange = output<boolean>({\n    alias: 'ngpCheckboxCheckedChange',\n  });\n\n  /**\n   * Defines whether the checkbox is indeterminate.\n   */\n  readonly indeterminate = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxIndeterminate',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The event that is emitted when the indeterminate value changes.\n   */\n  readonly indeterminateChange = output<boolean>({\n    alias: 'ngpCheckboxIndeterminateChange',\n  });\n\n  /**\n   * Whether the checkbox is required.\n   */\n  readonly required = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxRequired',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * Defines whether the checkbox is disabled.\n   */\n  readonly disabled = input<boolean, BooleanInput>(false, {\n    alias: 'ngpCheckboxDisabled',\n    transform: booleanAttribute,\n  });\n\n  /**\n   * The state of the checkbox.\n   */\n  protected readonly state = ngpCheckbox({\n    id: this.id,\n    checked: this.checked,\n    defaultChecked: this.defaultChecked,\n    indeterminate: this.indeterminate,\n    disabled: this.disabled,\n    required: this.required,\n    onCheckedChange: value => this.checkedChange.emit(value),\n    onIndeterminateChange: value => this.indeterminateChange.emit(value),\n  });\n\n  toggle(event?: Event): void {\n    this.state.toggle(event);\n  }\n\n  /**\n   * Update the checked value.\n   */\n  setChecked(value: boolean, options?: SetterOptions): void {\n    this.state.setChecked(value, options);\n  }\n\n  /**\n   * Set the default checked state.\n   */\n  setDefaultChecked(value: boolean): void {\n    this.state.setDefaultChecked(value);\n  }\n\n  /**\n   * Update the indeterminate value.\n   */\n  setIndeterminate(value: boolean): void {\n    this.state.setIndeterminate(value);\n  }\n\n  /**\n   * Set the disabled value.\n   */\n  setDisabled(value: boolean): void {\n    this.state.setDisabled(value);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ng-primitives-date-picker.mjs

@@ -1,9 +1,9 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, inject, TemplateRef, ViewContainerRef, Injector, Directive, contentChild, computed, ElementRef, HostListener, input, numberAttribute, booleanAttribute, output, signal, afterNextRender } from '@angular/core';
-import { createStateToken, createStateProvider, createStateInjector, createState } from 'ng-primitives/state';
+import { InjectionToken, inject, TemplateRef, ViewContainerRef, Injector, Directive, contentChild, ElementRef, computed, HostListener, input, numberAttribute, booleanAttribute, output, signal, afterNextRender } from '@angular/core';
 import { FocusMonitor } from '@angular/cdk/a11y';
 import { ngpButton } from 'ng-primitives/button';
 import { injectDateAdapter } from 'ng-primitives/date-time';
+import { createStateToken, createStateProvider, createStateInjector, createState } from 'ng-primitives/state';
 import { uniqueId } from 'ng-primitives/utils';
 import { explicitEffect } from 'ng-primitives/internal';
 
@@ -133,6 +133,38 @@ function injectDatePickerDateButton() {
     return inject(NgpDatePickerDateButtonToken);
 }
 
+/**
+ * A cell in the date picker grid.
+ */
+class NgpDatePickerCell {
+    constructor() {
+        /**
+         * Access the child date picker date button.
+         * The cell's accessible name comes from this button's day content, not the
+         * shared month/year label (which would make every cell announce the month).
+         */
+        this.datePickerButton = contentChild(NgpDatePickerDateButtonToken, { ...(ngDevMode ? { debugName: "datePickerButton" } : /* istanbul ignore next */ {}), descendants: true });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: NgpDatePickerCell, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.2.0", version: "21.2.14", type: NgpDatePickerCell, isStandalone: true, selector: "[ngpDatePickerCell]", host: { attributes: { "role": "gridcell" }, properties: { "attr.data-selected": "datePickerButton()?.selected() ? \"\" : null", "attr.aria-selected": "datePickerButton()?.selected()", "attr.aria-disabled": "datePickerButton()?.disabled()", "attr.data-disabled": "datePickerButton()?.disabled() ? \"\" : null" } }, queries: [{ propertyName: "datePickerButton", first: true, predicate: NgpDatePickerDateButtonToken, descendants: true, isSignal: true }], exportAs: ["ngpDatePickerCell"], ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: NgpDatePickerCell, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[ngpDatePickerCell]',
+                    exportAs: 'ngpDatePickerCell',
+                    host: {
+                        role: 'gridcell',
+                        '[attr.data-selected]': 'datePickerButton()?.selected() ? "" : null',
+                        '[attr.aria-selected]': 'datePickerButton()?.selected()',
+                        '[attr.aria-disabled]': 'datePickerButton()?.disabled()',
+                        '[attr.data-disabled]': 'datePickerButton()?.disabled() ? "" : null',
+                    },
+                }]
+        }], propDecorators: { datePickerButton: [{ type: i0.ContentChild, args: [i0.forwardRef(() => NgpDatePickerDateButtonToken), { ...{
+                            descendants: true,
+                        }, isSignal: true }] }] } });
+
 /**
  * The state token  for the DateRangePicker primitive.
  */
@@ -168,45 +200,6 @@ function injectDateControllerState() {
     }
 }
 
-/**
- * A cell in the date picker grid.
- */
-class NgpDatePickerCell {
-    constructor() {
-        /**
-         * Access the date picker.
-         */
-        this.state = injectDateControllerState();
-        /**
-         * Access the child date picker date button.
-         */
-        this.datePickerButton = contentChild(NgpDatePickerDateButtonToken, { ...(ngDevMode ? { debugName: "datePickerButton" } : /* istanbul ignore next */ {}), descendants: true });
-        /**
-         * Access the label id.
-         */
-        this.labelId = computed(() => this.state().label()?.id(), ...(ngDevMode ? [{ debugName: "labelId" }] : /* istanbul ignore next */ []));
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: NgpDatePickerCell, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.2.0", version: "21.2.14", type: NgpDatePickerCell, isStandalone: true, selector: "[ngpDatePickerCell]", host: { attributes: { "role": "gridcell" }, properties: { "attr.data-selected": "datePickerButton()?.selected() ? \"\" : null", "attr.aria-selected": "datePickerButton()?.selected()", "attr.aria-disabled": "datePickerButton()?.disabled()", "attr.data-disabled": "datePickerButton()?.disabled() ? \"\" : null", "attr.aria-labelledby": "labelId()" } }, queries: [{ propertyName: "datePickerButton", first: true, predicate: NgpDatePickerDateButtonToken, descendants: true, isSignal: true }], exportAs: ["ngpDatePickerCell"], ngImport: i0 }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: NgpDatePickerCell, decorators: [{
-            type: Directive,
-            args: [{
-                    selector: '[ngpDatePickerCell]',
-                    exportAs: 'ngpDatePickerCell',
-                    host: {
-                        role: 'gridcell',
-                        '[attr.data-selected]': 'datePickerButton()?.selected() ? "" : null',
-                        '[attr.aria-selected]': 'datePickerButton()?.selected()',
-                        '[attr.aria-disabled]': 'datePickerButton()?.disabled()',
-                        '[attr.data-disabled]': 'datePickerButton()?.disabled() ? "" : null',
-                        '[attr.aria-labelledby]': 'labelId()',
-                    },
-                }]
-        }], propDecorators: { datePickerButton: [{ type: i0.ContentChild, args: [i0.forwardRef(() => NgpDatePickerDateButtonToken), { ...{
-                            descendants: true,
-                        }, isSignal: true }] }] } });
-
 /**
  * A button that represents a date in the date picker grid.
  */
@@ -1028,11 +1021,14 @@ class NgpDatePicker {
      * Select a date.
      * @param date The date to select.
      * @param preserveTime Whether to preserve time components from existing selected date.
+     * @param options Options for the selection. Set `emit` to false to update the state without
+     * emitting `dateChange` (e.g. when writing a value from a form model).
      * @internal
      */
-    select(date, preserveTime = false) {
+    select(date, preserveTime = false, options = {}) {
+        const emit = options.emit ?? true;
         let selectedDate = date;
-        if (preserveTime) {
+        if (preserveTime && date != null) {
             const existingDate = this.state.date();
             if (existingDate) {
                 selectedDate = this.dateAdapter.set(existingDate, {
@@ -1043,7 +1039,9 @@ class NgpDatePicker {
             }
         }
         this.state.date.set(selectedDate);
-        this.dateChange.emit(selectedDate);
+        if (emit) {
+            this.dateChange.emit(selectedDate);
+        }
     }
     /**
      * Determine if a date is selected.