@malva-ui/core 0.1.12 → 0.1.14

package/fesm2022/malva-ui-core-title.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"malva-ui-core-title.mjs","sources":["../../../../libs/core/title/src/lib/title/title.ts","../../../../libs/core/title/src/lib/title/title.html","../../../../libs/core/title/src/malva-ui-core-title.ts"],"sourcesContent":["import type { BooleanInput } from '@angular/cdk/coercion';\nimport { coerceBooleanProperty } from '@angular/cdk/coercion';\nimport {\n  afterNextRender,\n  ChangeDetectionStrategy,\n  Component,\n  computed,\n  effect,\n  ElementRef,\n  forwardRef,\n  inject,\n  input,\n  model,\n  signal,\n  viewChild,\n  ViewEncapsulation,\n} from '@angular/core';\nimport type { MlvFormControl } from '@malva-ui/core/form-utils';\nimport {\n  MlvSignalFormControlBase,\n  MLV_FORM_CONTROL,\n} from '@malva-ui/core/form-utils';\n\nexport type MlvTitleLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\nfunction coerceTitleLevel(\n  value: MlvTitleLevel | string | number | null | undefined,\n): MlvTitleLevel | undefined {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 6) {\n    return undefined;\n  }\n\n  return parsed as MlvTitleLevel;\n}\n\nfunction inferTitleLevel(tagName: string): MlvTitleLevel {\n  const match = /^h([1-6])$/.exec(tagName.toLowerCase());\n  return match ? (Number(match[1]) as MlvTitleLevel) : 2;\n}\n\n/**\n * Inline title component that decorates the host element with Malva UI heading\n * typography. It can render projected content, bind to a model, or act as an\n * editable control through signal, reactive, and template-driven forms.\n */\n@Component({\n  // Attribute-selector component — camelCase [mlvX] is the documented pattern\n  // (see .claude/rules/angular-component.md); the rule only models kebab-case.\n  // eslint-disable-next-line @angular-eslint/component-selector\n  selector: '[mlvTitle]',\n  templateUrl: './title.html',\n  styleUrl: './title.scss',\n  encapsulation: ViewEncapsulation.None,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  providers: [\n    {\n      provide: MLV_FORM_CONTROL,\n      useExisting: forwardRef(() => MlvTitle),\n    },\n  ],\n  host: {\n    class: 'mlv-title',\n    '[attr.data-level]': '_resolvedLevel()',\n    '[attr.role]': '_isNativeHeading() ? null : \"heading\"',\n    '[attr.aria-level]': '_isNativeHeading() ? null : _resolvedLevel()',\n    '[class.mlv-title--editable]': 'editable()',\n    '[class.mlv-title--disabled]': 'computedDisabled()',\n    '[class.mlv-title--focused]': 'focused()',\n  },\n})\nexport class MlvTitle\n  extends MlvSignalFormControlBase<string | null>\n  implements MlvFormControl\n{\n  /** Explicit visual title level. Falls back to the host heading tag. */\n  readonly level = input<\n    MlvTitleLevel | undefined,\n    MlvTitleLevel | string | number | null | undefined\n  >(undefined, {\n    transform: coerceTitleLevel,\n  });\n\n  /** Enables the auto-sizing editable textarea overlay. */\n  readonly editable = input<boolean, BooleanInput>(false, {\n    transform: coerceBooleanProperty,\n  });\n\n  /** Placeholder displayed when the editable field is empty. */\n  readonly placeholder = input('');\n\n  /** Signal-model API for directly binding the title text. */\n  readonly value = model<string | null>(null);\n\n  /** @private Host element ref, used to read the host tag name for level inference. */\n  private readonly _hostElement = inject<ElementRef<HTMLElement>>(ElementRef);\n  /** @private Reference to the projected-content span, used to hydrate text from projected content. */\n  private readonly _projectionElement =\n    viewChild<ElementRef<HTMLElement>>('projectionContent');\n  /** @private Trimmed text extracted from projected content. */\n  private readonly _projectedText = signal('');\n  /** @private Whether the component is currently driven by its internal editable value. */\n  private readonly _usesInternalValue = signal(false);\n  /** @private Tracks whether internal state was last synced from an external `value`. */\n  private _syncedFromExternalValue = false;\n\n  /** @protected Whether the host element is a native `h1`–`h6` heading. */\n  protected readonly _isNativeHeading = computed(() =>\n    /^h[1-6]$/.test(this._hostTagName),\n  );\n  /** @protected Resolved visual heading level — explicit `level` input or inferred from the host tag. */\n  protected readonly _resolvedLevel = computed<MlvTitleLevel>(\n    () => this.level() ?? inferTitleLevel(this._hostTagName),\n  );\n  /** @protected The effective title text: bound `value`, internal editable value, or projected content. */\n  protected readonly currentText = computed(() => {\n    const explicitValue = this.value();\n    if (explicitValue !== null && explicitValue !== undefined) {\n      return explicitValue;\n    }\n\n    if (this._usesInternalValue()) {\n      return this.internalValue();\n    }\n\n    return this._projectedText();\n  });\n  /** @protected Whether the projected `<ng-content>` should be shown (no value, not editable). */\n  protected readonly showProjectedContent = computed(\n    () =>\n      !this.editable() &&\n      !this._usesInternalValue() &&\n      (this.value() === null || this.value() === undefined),\n  );\n  /** @protected Whether the bound value text should be shown (not editable, not projected). */\n  protected readonly showValueText = computed(\n    () => !this.editable() && !this.showProjectedContent(),\n  );\n  /** @protected Sizing text for the editable `<pre>` mirror (trailing newline keeps a blank line tall). */\n  protected readonly editorMeasureText = computed(() => {\n    const text = this.currentText() || this.placeholder();\n    return text ? `${text}\\n` : ' ';\n  });\n  /** @protected Whether the editable field is empty and a placeholder should be shown. */\n  protected readonly editorShowsPlaceholder = computed(\n    () => !this.currentText() && !!this.placeholder(),\n  );\n  /** @protected Current value bound to the editable `<textarea>`. */\n  protected readonly textareaValue = computed(() => this.currentText());\n\n  /** Internal text state used by editable mode and forms APIs. */\n  readonly internalValue = signal('');\n\n  /** @private The lowercased tag name of the host element (e.g. `h2`, `div`). */\n  private get _hostTagName(): string {\n    return this._hostElement.nativeElement.tagName.toLowerCase();\n  }\n\n  constructor() {\n    super();\n\n    effect(() => {\n      const externalValue = this.value();\n\n      if (externalValue === null || externalValue === undefined) {\n        if (this._syncedFromExternalValue) {\n          this.internalValue.set('');\n          this._usesInternalValue.set(false);\n        }\n\n        this._syncedFromExternalValue = false;\n        return;\n      }\n\n      this._syncedFromExternalValue = true;\n      this.internalValue.set(externalValue);\n      this._usesInternalValue.set(true);\n    });\n\n    afterNextRender(() => {\n      this._hydrateProjectedText();\n    });\n  }\n\n  /** Handles interactive edits from the textarea overlay. */\n  onInput(event: Event): void {\n    const value = (event.target as HTMLTextAreaElement).value;\n    this.internalValue.set(value);\n    this._usesInternalValue.set(true);\n    // The `value` model is the signal-forms transport: setting it propagates\n    // the edit to the bound field ([formField]/[formControl]/ngModel).\n    this.value.set(value);\n  }\n\n  /** Tracks focus state for form-field styling. */\n  onFocus(): void {\n    this.setFocused(true);\n  }\n\n  /** Tracks blur state for form-field styling and touched state. */\n  onBlur(): void {\n    this.setFocused(false);\n    this._markTouched();\n  }\n\n  /** Whether the control holds a clearable value — Non-empty text present. */\n  readonly hasValue = computed(() => this.internalValue().length > 0);\n\n  /** @private Reads projected text after render and seeds the editable value from it when appropriate. */\n  private _hydrateProjectedText(): void {\n    const projectedText =\n      this._projectionElement()?.nativeElement.textContent?.trim() ?? '';\n\n    this._projectedText.set(projectedText);\n\n    if (\n      this.editable() &&\n      !this._usesInternalValue() &&\n      (this.value() === null || this.value() === undefined) &&\n      projectedText\n    ) {\n      this.internalValue.set(projectedText);\n      this._usesInternalValue.set(true);\n    }\n  }\n}\n","<span\n  #projectionContent\n  class=\"mlv-title__projection\"\n  [class.mlv-title__projection--hidden]=\"!showProjectedContent()\"\n  [attr.aria-hidden]=\"showProjectedContent() ? null : 'true'\"\n>\n  <ng-content />\n</span>\n\n@if (showValueText()) {\n<span class=\"mlv-title__value\">{{ currentText() }}</span>\n} @if (editable()) {\n<span class=\"mlv-title__editor\">\n  <pre\n    class=\"mlv-title__pre\"\n    [class.mlv-title__pre--placeholder]=\"editorShowsPlaceholder()\"\n    aria-hidden=\"true\"\n  >\n{{ editorMeasureText() }}</pre\n  >\n  <textarea\n    class=\"mlv-title__textarea\"\n    rows=\"1\"\n    [value]=\"textareaValue()\"\n    [placeholder]=\"placeholder()\"\n    [readonly]=\"readonly()\"\n    [disabled]=\"computedDisabled()\"\n    [attr.aria-label]=\"ariaLabel()\"\n    [attr.aria-required]=\"required() || null\"\n    (input)=\"onInput($event)\"\n    (focus)=\"onFocus()\"\n    (blur)=\"onBlur()\"\n  ></textarea>\n</span>\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}