igniteui-webcomponents 7.3.1 → 7.4.0

package/components/mask-input/mask-parser.d.ts

@@ -46,9 +46,9 @@ export declare class MaskParser {
     /** Cached array of required non-literal positions for validation */
     protected _requiredPositions: number[];
     /**
-     * Declared without an initializer on purpose. With `useDefineForClassFields: false`
-     * nothing is emitted for it, so {@link _invalidate} can safely run from the
-     * constructor - before subclass fields exist.
+     * Declared with no initializer. `useDefineForClassFields: false` emits nothing
+     * for it, so {@link _invalidate} can run from the constructor, before the
+     * subclass fields exist.
      */
     private _emptyMask?;
     /**
@@ -87,25 +87,23 @@ export declare class MaskParser {
     constructor(options?: MaskOptions);
     private _isEscapedFlag;
     /**
-     * The pattern the literal parser consumes. Subclasses whose public format is not itself
-     * a mask pattern - date formats, for instance - translate it here.
+     * The pattern for the literal parser. A subclass whose public format is not a
+     * mask pattern, such as a date format, converts it here.
      */
     protected _toMaskFormat(format: string): string;
     /**
-     * Drops everything derived from the mask. Runs on every mask *and* prompt change, and
-     * from the constructor, so overrides must not touch fields with initializers.
+     * Drops all that comes from the mask. Runs on each mask and prompt change, and
+     * from the constructor, so an override must not touch an initialized field.
      */
     protected _invalidate(): void;
     /**
-     * Parses the mask format string to identify literal characters and
-     * create the escaped mask. This method is called whenever the mask format changes.
+     * Finds the literal characters of the mask format and builds the escaped
+     * mask. Runs on each mask format change.
      */
     protected _parseMaskLiterals(): void;
     /**
-     * Computes an array of positions in the escaped mask that correspond to
-     * required input flags (e.g., '0', 'L') and are not literal characters.
-     *
-     * These positions must be filled for the masked string to be valid.
+     * The positions of the escaped mask that hold a required input flag, such as
+     * '0' or 'L', and are not literals. A valid masked string fills them all.
      */
     protected _computeRequiredPositions(): number[];
     /**

package/components/mask-input/mask-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"mask-parser.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/** Options for the {@link MaskParser} */\nexport interface MaskOptions {\n  /**\n   * The mask format string (e.g., '00/00/0000' for dates, 'AAA-000' for custom IDs).\n   *\n   * Supported flags: a, A, C, L, 0, 9, #, &, ?.\n   *\n   * Use `'\\'` to escape a flag character if it should be treated as a literal.\n   * @default 'CCCCCCCCCC'\n   */\n  format?: string;\n\n  /**\n   * The character used to prompt for input in unfilled mask positions.\n   *\n   * Only the first character is used, and a mask flag is rejected in favor of the\n   * default - the same rules the `prompt` accessor applies.\n   * @default '_'\n   */\n  promptCharacter?: string;\n}\n\n/** Internal options with all required fields */\ninterface MaskOptionsInternal {\n  format: string;\n  promptCharacter: string;\n}\n\n/**\n * Result type for the replace operation, containing the new masked value and the\n * ideal cursor position.\n */\ntype MaskReplaceResult = {\n  value: string;\n  end: number;\n};\n\nconst MASK_FLAGS = new Set('aACL09#&?');\nconst MASK_REQUIRED_FLAGS = new Set('0#LA&');\n\nconst ESCAPE_CHAR = '\\\\';\nconst DEFAULT_FORMAT = 'CCCCCCCCCC';\nconst DEFAULT_PROMPT = '_';\n\nconst ASCII_ZERO = 0x0030;\nconst DIGIT_ZERO_CODEPOINTS = [\n  ASCII_ZERO, // ASCII\n  0x0660, // Arabic-Indic\n  0x06f0, // Extended Arabic-Indic\n  0x0966, // Devanagari\n  0x09e6, // Bengali\n  0x0a66, // Gurmukhi\n  0x0ae6, // Gujarati\n  0x0b66, // Oriya\n  0x0c66, // Telugu\n  0x0ce6, // Kannada\n  0x0d66, // Malayalam\n  0x0e50, // Thai\n  0x0ed0, // Lao\n  0x0f20, // Tibetan\n  0x1040, // Myanmar\n  0x17e0, // Khmer\n  0x1810, // Mongolian\n  0xff10, // Full-width\n] as const;\n\n/**\n * Precomputed map of Unicode digit codepoints to their ASCII equivalents.\n * This eliminates the need for iteration during conversion.\n */\nconst UNICODE_DIGIT_TO_ASCII = new Map<number, string>(\n  DIGIT_ZERO_CODEPOINTS.flatMap((zeroCodePoint) =>\n    Array.from({ length: 10 }, (_, i) => [\n      zeroCodePoint + i,\n      String.fromCharCode(ASCII_ZERO + i),\n    ])\n  )\n);\n\n/**\n * Narrows a prompt down to the single character the parser will actually use.\n *\n * Falls back to `current` when the prompt is empty or collides with a mask flag - a flag\n * standing in for an unfilled position could not be told apart from one the user typed.\n */\nfunction normalizePrompt(value: string | undefined, current: string): string {\n  const char = value ? value.substring(0, 1) : current;\n  return MASK_FLAGS.has(char) ? current : char;\n}\n\nfunction replaceUnicodeNumbers(text: string): string {\n  const matcher = /\\p{Nd}/gu;\n\n  return text.replace(matcher, (digit) => {\n    return UNICODE_DIGIT_TO_ASCII.get(digit.charCodeAt(0)) ?? digit;\n  });\n}\n\nconst MASK_PATTERNS = new Map<string, RegExp>([\n  ['C', /[\\s\\S]/u], // Any single character (including newlines)\n  ['&', /[^\\p{Separator}]/u], // Any non-separator character (excludes spaces, line/paragraph separators)\n  ['a', /[\\p{Letter}\\p{Number}\\p{Separator}]/u], // Alphanumeric and separator characters (Unicode-aware)\n  ['A', /[\\p{Letter}\\p{Number}]/u], // Alphanumeric (Unicode-aware)\n  ['?', /[\\p{Letter}\\p{Separator}]/u], // Alphabetic and separator characters (Unicode-aware)\n  ['L', /\\p{Letter}/u], // Alphabetic (Unicode-aware)\n  ['0', /\\p{Number}/u], // Numeric (Unicode-aware, converted to ASCII 0-9 during processing)\n  ['9', /[\\p{Number}\\p{Separator}]/u], // Numeric and separator characters (Unicode-aware)\n  ['#', /[\\p{Number}\\-+]/u], // Numeric and sign characters (+, -)\n]);\n\nfunction validate(char: string, flag: string): boolean {\n  return MASK_PATTERNS.get(flag)?.test(char) ?? false;\n}\n\n/**\n * A class for parsing and applying masks to strings, typically for input fields.\n * It handles mask definitions, literals, character validation, and cursor positioning.\n */\nexport class MaskParser {\n  protected readonly _options: MaskOptionsInternal;\n\n  /** Stores literal characters and their original positions in the mask (e.g., '(', ')', '-'). */\n  protected readonly _literals = new Map<number, string>();\n\n  /** A Set of positions where literals occur in the `_escapedMask`. */\n  protected _literalPositions = new Set<number>();\n\n  /** The mask format after processing escape characters */\n  protected _escapedMask = '';\n\n  /** Cached array of required non-literal positions for validation */\n  protected _requiredPositions: number[] = [];\n\n  /**\n   * Declared without an initializer on purpose. With `useDefineForClassFields: false`\n   * nothing is emitted for it, so {@link _invalidate} can safely run from the\n   * constructor - before subclass fields exist.\n   */\n  private _emptyMask?: string;\n\n  /**\n   * Returns a set of the all the literal positions in the mask.\n   * These positions are fixed characters that are not part of the input.\n   */\n  public get literalPositions(): ReadonlySet<number> {\n    return this._literalPositions;\n  }\n\n  /**\n   * Returns the escaped mask string.\n   * This is the mask after processing any escape sequences.\n   */\n  public get escapedMask(): string {\n    return this._escapedMask;\n  }\n\n  /**\n   * Returns the result of applying an empty string over the mask pattern.\n   */\n  public get emptyMask(): string {\n    this._emptyMask ??= this.apply();\n    return this._emptyMask;\n  }\n\n  /**\n   * Gets the unescaped mask string (the original format string).\n   * If the mask has no escape sequences, then `mask === escapedMask`.\n   */\n  public get mask(): string {\n    return this._options.format;\n  }\n\n  /**\n   * Sets the mask of the parser.\n   * When the mask is set, it triggers a re-parsing of the mask literals and escaped mask.\n   */\n  public set mask(value: string) {\n    this._options.format = value || this._options.format;\n    this._parseMaskLiterals();\n  }\n\n  /**\n   * Gets the prompt character used for unfilled mask positions.\n   */\n  public get prompt(): string {\n    return this._options.promptCharacter;\n  }\n\n  /**\n   * Sets the prompt character. Only the first character of the provided string is used.\n   * @remarks The prompt character cannot be a mask flag character.\n   */\n  public set prompt(value: string) {\n    this._options.promptCharacter = normalizePrompt(\n      value,\n      this._options.promptCharacter\n    );\n    this._invalidate();\n  }\n\n  constructor(options?: MaskOptions) {\n    this._options = {\n      format: options?.format || DEFAULT_FORMAT,\n      promptCharacter: normalizePrompt(\n        options?.promptCharacter,\n        DEFAULT_PROMPT\n      ),\n    };\n    this._parseMaskLiterals();\n  }\n\n  private _isEscapedFlag(char: string, nextChar: string): boolean {\n    return char === ESCAPE_CHAR && MASK_FLAGS.has(nextChar);\n  }\n\n  /**\n   * The pattern the literal parser consumes. Subclasses whose public format is not itself\n   * a mask pattern - date formats, for instance - translate it here.\n   */\n  protected _toMaskFormat(format: string): string {\n    return format;\n  }\n\n  /**\n   * Drops everything derived from the mask. Runs on every mask *and* prompt change, and\n   * from the constructor, so overrides must not touch fields with initializers.\n   */\n  protected _invalidate(): void {\n    this._emptyMask = undefined;\n  }\n\n  /**\n   * Parses the mask format string to identify literal characters and\n   * create the escaped mask. This method is called whenever the mask format changes.\n   */\n  protected _parseMaskLiterals(): void {\n    const mask = this._toMaskFormat(this._options.format);\n    const length = mask.length;\n    const escapedMaskChars: string[] = [];\n\n    let currentPos = 0;\n\n    this._literals.clear();\n\n    for (let i = 0; i < length; i++) {\n      const [current, next] = [mask.charAt(i), mask.charAt(i + 1)];\n\n      if (this._isEscapedFlag(current, next)) {\n        // Escaped character - push next as a literal character and skip processing it\n        this._literals.set(currentPos, next);\n        escapedMaskChars.push(next);\n        i++;\n      } else if (MASK_FLAGS.has(current)) {\n        // Regular flag character\n        escapedMaskChars.push(current);\n      } else {\n        // Literal character\n        this._literals.set(currentPos, current);\n        escapedMaskChars.push(current);\n      }\n\n      currentPos++;\n    }\n\n    this._escapedMask = escapedMaskChars.join('');\n    this._literalPositions = new Set(this._literals.keys());\n    this._requiredPositions = this._computeRequiredPositions();\n    this._invalidate();\n  }\n\n  /**\n   * Computes an array of positions in the escaped mask that correspond to\n   * required input flags (e.g., '0', 'L') and are not literal characters.\n   *\n   * These positions must be filled for the masked string to be valid.\n   */\n  protected _computeRequiredPositions(): number[] {\n    const literalPositions = this._literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const result: number[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = escapedMask[i];\n      if (MASK_REQUIRED_FLAGS.has(char) && !literalPositions.has(i)) {\n        result.push(i);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *before* the given start position.\n   * Useful for backward navigation (e.g., backspace).\n   *\n   * @remarks\n   * If no non-literal is found before `start`, return 0.\n   */\n  public getPreviousNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n\n    for (let i = start - 1; i >= 0; i--) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return 0;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *after* the given start position.\n   * Useful for forward navigation (e.g., arrow keys, delete key or initial cursor placement).\n   *\n   * @remarks\n   * If no non-literal is found after `start`, return the mask length.\n   */\n  public getNextNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n    const length = this._escapedMask.length;\n\n    for (let i = Math.max(0, start); i < length; i++) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return length;\n  }\n\n  /**\n   * Replaces a segment of the masked string with new input, simulating typing or pasting.\n   * It handles clearing the selected range and inserting new characters according to the mask.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * const current = '__/__/____';\n   * const result = parser.replace(current, '12', 0, 0);\n   * // result.value = '12/__/____', result.end = 2\n   * ```\n   */\n  public replace(\n    maskString: string,\n    value: string,\n    start: number,\n    end: number\n  ): MaskReplaceResult {\n    const literalPositions = this.literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const prompt = this.prompt;\n    const endBoundary = Math.min(end, length);\n\n    // Initialize the array for the masked string or get a fresh mask with prompts and/or literals\n    const maskedChars = maskString ? [...maskString] : [...this.emptyMask];\n\n    const inputChars = Array.from(replaceUnicodeNumbers(value));\n    const inputLength = inputChars.length;\n\n    // Clear any non-literal positions from `start` to `endBoundary`\n    for (let i = start; i < endBoundary; i++) {\n      if (!literalPositions.has(i)) {\n        maskedChars[i] = prompt;\n      }\n    }\n\n    let cursor = start;\n    let inputIndex = 0;\n    let maskPosition = start;\n\n    // Iterate through the mask starting at `start` as long as there are input characters and mask positions available\n    // and start placing characters or skipping literals and invalid characters\n    for (; maskPosition < length && inputIndex < inputLength; maskPosition++) {\n      if (literalPositions.has(maskPosition)) {\n        cursor = maskPosition + 1;\n        continue;\n      }\n\n      const char = inputChars[inputIndex];\n\n      if (validate(char, escapedMask[maskPosition]) && char !== prompt) {\n        maskedChars[maskPosition] = char;\n        cursor = maskPosition + 1;\n        inputIndex++;\n      } else {\n        inputIndex++;\n        maskPosition--;\n      }\n    }\n\n    // Move the cursor to the next non-literal position or the end of the mask\n    while (cursor < length && literalPositions.has(cursor)) {\n      cursor++;\n    }\n\n    return {\n      value: maskedChars.join(''),\n      end: cursor,\n    };\n  }\n\n  /**\n   * Parses the masked string, extracting only the valid input characters.\n   * This effectively \"unmasks\" the string, removing prompts and literals.\n   */\n  public parse(masked = ''): string {\n    const literalPositions = this.literalPositions;\n    const prompt = this.prompt;\n    const length = masked.length;\n    const result: string[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = masked[i];\n      if (!literalPositions.has(i) && char !== prompt) {\n        result.push(char);\n      }\n    }\n\n    return result.join('');\n  }\n\n  /**\n   * Checks if the masked string is valid, specifically if all required mask positions are filled\n   * with valid, non-prompt characters.\n   */\n  public isValidString(input = ''): boolean {\n    const prompt = this.prompt;\n\n    return this._requiredPositions.every((position) => {\n      const char = input[position];\n      return validate(char, this._escapedMask[position]) && char !== prompt;\n    });\n  }\n\n  /**\n   * Applies the mask format to an input string. This attempts to fit the input\n   * into the mask from left to right, filling valid positions and skipping invalid\n   * input characters.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * parser.apply('12252023'); // Returns '12/25/2023'\n   * ```\n   */\n  public apply(input = ''): string {\n    const literals = this._literals;\n    const prompt = this.prompt;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n\n    // Initialize the result array with prompt characters\n    const result = new Array(length).fill(prompt);\n\n    // Place all literal characters into the result array\n    for (const [position, literal] of literals.entries()) {\n      result[position] = literal;\n    }\n\n    if (!input) {\n      return result.join('');\n    }\n\n    // Normalize Unicode digits to ASCII\n    const normalizedInput = replaceUnicodeNumbers(input);\n    const inputLength = normalizedInput.length;\n    let inputIndex = 0;\n\n    // Iterate through the mask placing input characters skipping literals and invalid ones\n    for (let i = 0; i < length; i++) {\n      if (inputIndex >= inputLength) {\n        break;\n      }\n\n      if (literals.has(i)) {\n        continue;\n      }\n\n      if (validate(normalizedInput[inputIndex], escapedMask[i])) {\n        result[i] = normalizedInput[inputIndex];\n      }\n\n      // Always advance - invalid characters are consumed/skipped\n      inputIndex++;\n    }\n\n    return result.join('');\n  }\n}\n"]}
+{"version":3,"file":"mask-parser.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/** Options for the {@link MaskParser} */\nexport interface MaskOptions {\n  /**\n   * The mask format string (e.g., '00/00/0000' for dates, 'AAA-000' for custom IDs).\n   *\n   * Supported flags: a, A, C, L, 0, 9, #, &, ?.\n   *\n   * Use `'\\'` to escape a flag character if it should be treated as a literal.\n   * @default 'CCCCCCCCCC'\n   */\n  format?: string;\n\n  /**\n   * The character used to prompt for input in unfilled mask positions.\n   *\n   * Only the first character is used, and a mask flag is rejected in favor of the\n   * default - the same rules the `prompt` accessor applies.\n   * @default '_'\n   */\n  promptCharacter?: string;\n}\n\n/** Internal options with all required fields */\ninterface MaskOptionsInternal {\n  format: string;\n  promptCharacter: string;\n}\n\n/**\n * Result type for the replace operation, containing the new masked value and the\n * ideal cursor position.\n */\ntype MaskReplaceResult = {\n  value: string;\n  end: number;\n};\n\nconst MASK_FLAGS = new Set('aACL09#&?');\nconst MASK_REQUIRED_FLAGS = new Set('0#LA&');\n\nconst ESCAPE_CHAR = '\\\\';\nconst DEFAULT_FORMAT = 'CCCCCCCCCC';\nconst DEFAULT_PROMPT = '_';\n\nconst ASCII_ZERO = 0x0030;\nconst DIGIT_ZERO_CODEPOINTS = [\n  ASCII_ZERO, // ASCII\n  0x0660, // Arabic-Indic\n  0x06f0, // Extended Arabic-Indic\n  0x0966, // Devanagari\n  0x09e6, // Bengali\n  0x0a66, // Gurmukhi\n  0x0ae6, // Gujarati\n  0x0b66, // Oriya\n  0x0c66, // Telugu\n  0x0ce6, // Kannada\n  0x0d66, // Malayalam\n  0x0e50, // Thai\n  0x0ed0, // Lao\n  0x0f20, // Tibetan\n  0x1040, // Myanmar\n  0x17e0, // Khmer\n  0x1810, // Mongolian\n  0xff10, // Full-width\n] as const;\n\n/**\n * Precomputed map of Unicode digit codepoints to their ASCII equivalents.\n * This eliminates the need for iteration during conversion.\n */\nconst UNICODE_DIGIT_TO_ASCII = new Map<number, string>(\n  DIGIT_ZERO_CODEPOINTS.flatMap((zeroCodePoint) =>\n    Array.from({ length: 10 }, (_, i) => [\n      zeroCodePoint + i,\n      String.fromCharCode(ASCII_ZERO + i),\n    ])\n  )\n);\n\n/**\n * Narrows a prompt down to the single character the parser will actually use.\n *\n * Falls back to `current` when the prompt is empty or collides with a mask flag - a flag\n * standing in for an unfilled position could not be told apart from one the user typed.\n */\nfunction normalizePrompt(value: string | undefined, current: string): string {\n  const char = value ? value.substring(0, 1) : current;\n  return MASK_FLAGS.has(char) ? current : char;\n}\n\nfunction replaceUnicodeNumbers(text: string): string {\n  const matcher = /\\p{Nd}/gu;\n\n  return text.replace(matcher, (digit) => {\n    return UNICODE_DIGIT_TO_ASCII.get(digit.charCodeAt(0)) ?? digit;\n  });\n}\n\nconst MASK_PATTERNS = new Map<string, RegExp>([\n  ['C', /[\\s\\S]/u], // Any single character (including newlines)\n  ['&', /[^\\p{Separator}]/u], // Any non-separator character (excludes spaces, line/paragraph separators)\n  ['a', /[\\p{Letter}\\p{Number}\\p{Separator}]/u], // Alphanumeric and separator characters (Unicode-aware)\n  ['A', /[\\p{Letter}\\p{Number}]/u], // Alphanumeric (Unicode-aware)\n  ['?', /[\\p{Letter}\\p{Separator}]/u], // Alphabetic and separator characters (Unicode-aware)\n  ['L', /\\p{Letter}/u], // Alphabetic (Unicode-aware)\n  ['0', /\\p{Number}/u], // Numeric (Unicode-aware, converted to ASCII 0-9 during processing)\n  ['9', /[\\p{Number}\\p{Separator}]/u], // Numeric and separator characters (Unicode-aware)\n  ['#', /[\\p{Number}\\-+]/u], // Numeric and sign characters (+, -)\n]);\n\nfunction validate(char: string, flag: string): boolean {\n  return MASK_PATTERNS.get(flag)?.test(char) ?? false;\n}\n\n/**\n * A class for parsing and applying masks to strings, typically for input fields.\n * It handles mask definitions, literals, character validation, and cursor positioning.\n */\nexport class MaskParser {\n  protected readonly _options: MaskOptionsInternal;\n\n  /** Stores literal characters and their original positions in the mask (e.g., '(', ')', '-'). */\n  protected readonly _literals = new Map<number, string>();\n\n  /** A Set of positions where literals occur in the `_escapedMask`. */\n  protected _literalPositions = new Set<number>();\n\n  /** The mask format after processing escape characters */\n  protected _escapedMask = '';\n\n  /** Cached array of required non-literal positions for validation */\n  protected _requiredPositions: number[] = [];\n\n  /**\n   * Declared with no initializer. `useDefineForClassFields: false` emits nothing\n   * for it, so {@link _invalidate} can run from the constructor, before the\n   * subclass fields exist.\n   */\n  private _emptyMask?: string;\n\n  /**\n   * Returns a set of the all the literal positions in the mask.\n   * These positions are fixed characters that are not part of the input.\n   */\n  public get literalPositions(): ReadonlySet<number> {\n    return this._literalPositions;\n  }\n\n  /**\n   * Returns the escaped mask string.\n   * This is the mask after processing any escape sequences.\n   */\n  public get escapedMask(): string {\n    return this._escapedMask;\n  }\n\n  /**\n   * Returns the result of applying an empty string over the mask pattern.\n   */\n  public get emptyMask(): string {\n    this._emptyMask ??= this.apply();\n    return this._emptyMask;\n  }\n\n  /**\n   * Gets the unescaped mask string (the original format string).\n   * If the mask has no escape sequences, then `mask === escapedMask`.\n   */\n  public get mask(): string {\n    return this._options.format;\n  }\n\n  /**\n   * Sets the mask of the parser.\n   * When the mask is set, it triggers a re-parsing of the mask literals and escaped mask.\n   */\n  public set mask(value: string) {\n    this._options.format = value || this._options.format;\n    this._parseMaskLiterals();\n  }\n\n  /**\n   * Gets the prompt character used for unfilled mask positions.\n   */\n  public get prompt(): string {\n    return this._options.promptCharacter;\n  }\n\n  /**\n   * Sets the prompt character. Only the first character of the provided string is used.\n   * @remarks The prompt character cannot be a mask flag character.\n   */\n  public set prompt(value: string) {\n    this._options.promptCharacter = normalizePrompt(\n      value,\n      this._options.promptCharacter\n    );\n    this._invalidate();\n  }\n\n  constructor(options?: MaskOptions) {\n    this._options = {\n      format: options?.format || DEFAULT_FORMAT,\n      promptCharacter: normalizePrompt(\n        options?.promptCharacter,\n        DEFAULT_PROMPT\n      ),\n    };\n    this._parseMaskLiterals();\n  }\n\n  private _isEscapedFlag(char: string, nextChar: string): boolean {\n    return char === ESCAPE_CHAR && MASK_FLAGS.has(nextChar);\n  }\n\n  /**\n   * The pattern for the literal parser. A subclass whose public format is not a\n   * mask pattern, such as a date format, converts it here.\n   */\n  protected _toMaskFormat(format: string): string {\n    return format;\n  }\n\n  /**\n   * Drops all that comes from the mask. Runs on each mask and prompt change, and\n   * from the constructor, so an override must not touch an initialized field.\n   */\n  protected _invalidate(): void {\n    this._emptyMask = undefined;\n  }\n\n  /**\n   * Finds the literal characters of the mask format and builds the escaped\n   * mask. Runs on each mask format change.\n   */\n  protected _parseMaskLiterals(): void {\n    const mask = this._toMaskFormat(this._options.format);\n    const length = mask.length;\n    const escapedMaskChars: string[] = [];\n\n    let currentPos = 0;\n\n    this._literals.clear();\n\n    for (let i = 0; i < length; i++) {\n      const [current, next] = [mask.charAt(i), mask.charAt(i + 1)];\n\n      if (this._isEscapedFlag(current, next)) {\n        // Escaped character - push next as a literal character and skip processing it\n        this._literals.set(currentPos, next);\n        escapedMaskChars.push(next);\n        i++;\n      } else if (MASK_FLAGS.has(current)) {\n        // Regular flag character\n        escapedMaskChars.push(current);\n      } else {\n        // Literal character\n        this._literals.set(currentPos, current);\n        escapedMaskChars.push(current);\n      }\n\n      currentPos++;\n    }\n\n    this._escapedMask = escapedMaskChars.join('');\n    this._literalPositions = new Set(this._literals.keys());\n    this._requiredPositions = this._computeRequiredPositions();\n    this._invalidate();\n  }\n\n  /**\n   * The positions of the escaped mask that hold a required input flag, such as\n   * '0' or 'L', and are not literals. A valid masked string fills them all.\n   */\n  protected _computeRequiredPositions(): number[] {\n    const literalPositions = this._literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const result: number[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = escapedMask[i];\n      if (MASK_REQUIRED_FLAGS.has(char) && !literalPositions.has(i)) {\n        result.push(i);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *before* the given start position.\n   * Useful for backward navigation (e.g., backspace).\n   *\n   * @remarks\n   * If no non-literal is found before `start`, return 0.\n   */\n  public getPreviousNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n\n    for (let i = start - 1; i >= 0; i--) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return 0;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *after* the given start position.\n   * Useful for forward navigation (e.g., arrow keys, delete key or initial cursor placement).\n   *\n   * @remarks\n   * If no non-literal is found after `start`, return the mask length.\n   */\n  public getNextNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n    const length = this._escapedMask.length;\n\n    for (let i = Math.max(0, start); i < length; i++) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return length;\n  }\n\n  /**\n   * Replaces a segment of the masked string with new input, simulating typing or pasting.\n   * It handles clearing the selected range and inserting new characters according to the mask.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * const current = '__/__/____';\n   * const result = parser.replace(current, '12', 0, 0);\n   * // result.value = '12/__/____', result.end = 2\n   * ```\n   */\n  public replace(\n    maskString: string,\n    value: string,\n    start: number,\n    end: number\n  ): MaskReplaceResult {\n    const literalPositions = this.literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const prompt = this.prompt;\n    const endBoundary = Math.min(end, length);\n\n    // Initialize the array for the masked string or get a fresh mask with prompts and/or literals\n    const maskedChars = maskString ? [...maskString] : [...this.emptyMask];\n\n    const inputChars = Array.from(replaceUnicodeNumbers(value));\n    const inputLength = inputChars.length;\n\n    // Clear any non-literal positions from `start` to `endBoundary`\n    for (let i = start; i < endBoundary; i++) {\n      if (!literalPositions.has(i)) {\n        maskedChars[i] = prompt;\n      }\n    }\n\n    let cursor = start;\n    let inputIndex = 0;\n    let maskPosition = start;\n\n    // Iterate through the mask starting at `start` as long as there are input characters and mask positions available\n    // and start placing characters or skipping literals and invalid characters\n    for (; maskPosition < length && inputIndex < inputLength; maskPosition++) {\n      if (literalPositions.has(maskPosition)) {\n        cursor = maskPosition + 1;\n        continue;\n      }\n\n      const char = inputChars[inputIndex];\n\n      if (validate(char, escapedMask[maskPosition]) && char !== prompt) {\n        maskedChars[maskPosition] = char;\n        cursor = maskPosition + 1;\n        inputIndex++;\n      } else {\n        inputIndex++;\n        maskPosition--;\n      }\n    }\n\n    // Move the cursor to the next non-literal position or the end of the mask\n    while (cursor < length && literalPositions.has(cursor)) {\n      cursor++;\n    }\n\n    return {\n      value: maskedChars.join(''),\n      end: cursor,\n    };\n  }\n\n  /**\n   * Parses the masked string, extracting only the valid input characters.\n   * This effectively \"unmasks\" the string, removing prompts and literals.\n   */\n  public parse(masked = ''): string {\n    const literalPositions = this.literalPositions;\n    const prompt = this.prompt;\n    const length = masked.length;\n    const result: string[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = masked[i];\n      if (!literalPositions.has(i) && char !== prompt) {\n        result.push(char);\n      }\n    }\n\n    return result.join('');\n  }\n\n  /**\n   * Checks if the masked string is valid, specifically if all required mask positions are filled\n   * with valid, non-prompt characters.\n   */\n  public isValidString(input = ''): boolean {\n    const prompt = this.prompt;\n\n    return this._requiredPositions.every((position) => {\n      const char = input[position];\n      return validate(char, this._escapedMask[position]) && char !== prompt;\n    });\n  }\n\n  /**\n   * Applies the mask format to an input string. This attempts to fit the input\n   * into the mask from left to right, filling valid positions and skipping invalid\n   * input characters.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * parser.apply('12252023'); // Returns '12/25/2023'\n   * ```\n   */\n  public apply(input = ''): string {\n    const literals = this._literals;\n    const prompt = this.prompt;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n\n    // Initialize the result array with prompt characters\n    const result = new Array(length).fill(prompt);\n\n    // Place all literal characters into the result array\n    for (const [position, literal] of literals.entries()) {\n      result[position] = literal;\n    }\n\n    if (!input) {\n      return result.join('');\n    }\n\n    // Normalize Unicode digits to ASCII\n    const normalizedInput = replaceUnicodeNumbers(input);\n    const inputLength = normalizedInput.length;\n    let inputIndex = 0;\n\n    // Iterate through the mask placing input characters skipping literals and invalid ones\n    for (let i = 0; i < length; i++) {\n      if (inputIndex >= inputLength) {\n        break;\n      }\n\n      if (literals.has(i)) {\n        continue;\n      }\n\n      if (validate(normalizedInput[inputIndex], escapedMask[i])) {\n        result[i] = normalizedInput[inputIndex];\n      }\n\n      // Always advance - invalid characters are consumed/skipped\n      inputIndex++;\n    }\n\n    return result.join('');\n  }\n}\n"]}

package/components/nav-drawer/themes/item.base.css.js

@@ -1,3 +1,3 @@
 import { css } from 'lit';
-export const styles = css `:host{--is-large: clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-large, 3), 1);--is-medium: min( clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-medium, 2), 1), clamp(0, var(--ig-size-large, 3) - var(--component-size, 1), 1) );--is-small: clamp(0, var(--ig-size-medium) - var(--component-size, 1), 1);position:relative;box-sizing:border-box;scrollbar-width:var(--ig-scrollbar-size, var(--sb-size));scrollbar-color:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color)) var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar{width:var(--ig-scrollbar-size, var(--sb-size));height:var(--ig-scrollbar-size, var(--sb-size));background:var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar-thumb{background:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color))}:host *,:host *::before,:host *::after{box-sizing:border-box}:host([hidden]),[hidden]{display:none !important}[part~=base]{display:flex;align-items:center;flex-flow:row nowrap;position:relative;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;outline:rgba(0,0,0,0);white-space:nowrap;text-decoration:none;border:none;justify-content:flex-start;transition:background .15s ease-out}[part~=base] ::slotted(igc-icon){--ig-size: 3;display:flex;font:inherit}[part=content]{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}[part="base mini"]{display:block}[part="base mini"] [part=content]{display:none}:host([disabled]){-webkit-user-select:none;-moz-user-select:none;user-select:none;cursor:initial;pointer-events:none}`;
+export const styles = css `:host{--is-large: clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-large, 3), 1);--is-medium: min( clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-medium, 2), 1), clamp(0, var(--ig-size-large, 3) - var(--component-size, 1), 1) );--is-small: clamp(0, var(--ig-size-medium) - var(--component-size, 1), 1);position:relative;box-sizing:border-box;scrollbar-width:var(--ig-scrollbar-size, var(--sb-size));scrollbar-color:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color)) var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar{width:var(--ig-scrollbar-size, var(--sb-size));height:var(--ig-scrollbar-size, var(--sb-size));background:var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar-thumb{background:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color))}:host *,:host *::before,:host *::after{box-sizing:border-box}:host([hidden]),[hidden]{display:none !important}[part~=base]{display:flex;align-items:center;flex-flow:row nowrap;position:relative;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;outline:rgba(0,0,0,0);white-space:nowrap;text-decoration:none;border:none;justify-content:flex-start;transition:background .15s ease-out}[part~=base] ::slotted(igc-icon){--ig-size: 3;display:flex;font:inherit}[part=content]{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}[part="base mini"]{display:block}[part="base mini"] [part=content]{display:none}:host([disabled]){-webkit-user-select:none;-moz-user-select:none;user-select:none;cursor:initial;pointer-events:none}@media(forced-colors: active){[part~=base]:hover,[part~=base]:focus-within{outline:.0625rem solid CanvasText;outline-offset:-0.0625rem}:host([active]) [part~=base]{--item-active-icon-color: Highlight;--item-active-text-color: Highlight}}`;
 //# sourceMappingURL=item.base.css.js.map

package/components/nav-drawer/themes/item.base.css.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.base.css.js","sourceRoot":"","sources":["../../../../src/components/nav-drawer/themes/item.base.css.ts"],"names":[],"mappings":"AACE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA,4kDAA4kD,CAAC","sourcesContent":["\n  import { css } from 'lit';\n  export const styles = css`:host{--is-large: clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-large, 3), 1);--is-medium: min( clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-medium, 2), 1), clamp(0, var(--ig-size-large, 3) - var(--component-size, 1), 1) );--is-small: clamp(0, var(--ig-size-medium) - var(--component-size, 1), 1);position:relative;box-sizing:border-box;scrollbar-width:var(--ig-scrollbar-size, var(--sb-size));scrollbar-color:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color)) var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar{width:var(--ig-scrollbar-size, var(--sb-size));height:var(--ig-scrollbar-size, var(--sb-size));background:var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar-thumb{background:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color))}:host *,:host *::before,:host *::after{box-sizing:border-box}:host([hidden]),[hidden]{display:none !important}[part~=base]{display:flex;align-items:center;flex-flow:row nowrap;position:relative;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;outline:rgba(0,0,0,0);white-space:nowrap;text-decoration:none;border:none;justify-content:flex-start;transition:background .15s ease-out}[part~=base] ::slotted(igc-icon){--ig-size: 3;display:flex;font:inherit}[part=content]{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}[part=\"base mini\"]{display:block}[part=\"base mini\"] [part=content]{display:none}:host([disabled]){-webkit-user-select:none;-moz-user-select:none;user-select:none;cursor:initial;pointer-events:none}`;\n  "]}
+{"version":3,"file":"item.base.css.js","sourceRoot":"","sources":["../../../../src/components/nav-drawer/themes/item.base.css.ts"],"names":[],"mappings":"AACE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA,yzDAAyzD,CAAC","sourcesContent":["\n  import { css } from 'lit';\n  export const styles = css`:host{--is-large: clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-large, 3), 1);--is-medium: min( clamp(0, (var(--component-size, 1) + 1) - var(--ig-size-medium, 2), 1), clamp(0, var(--ig-size-large, 3) - var(--component-size, 1), 1) );--is-small: clamp(0, var(--ig-size-medium) - var(--component-size, 1), 1);position:relative;box-sizing:border-box;scrollbar-width:var(--ig-scrollbar-size, var(--sb-size));scrollbar-color:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color)) var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar{width:var(--ig-scrollbar-size, var(--sb-size));height:var(--ig-scrollbar-size, var(--sb-size));background:var(--ig-scrollbar-track-background, var(--sb-track-bg-color))}:host ::-webkit-scrollbar-thumb{background:var(--ig-scrollbar-thumb-background, var(--sb-thumb-bg-color))}:host *,:host *::before,:host *::after{box-sizing:border-box}:host([hidden]),[hidden]{display:none !important}[part~=base]{display:flex;align-items:center;flex-flow:row nowrap;position:relative;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;outline:rgba(0,0,0,0);white-space:nowrap;text-decoration:none;border:none;justify-content:flex-start;transition:background .15s ease-out}[part~=base] ::slotted(igc-icon){--ig-size: 3;display:flex;font:inherit}[part=content]{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}[part=\"base mini\"]{display:block}[part=\"base mini\"] [part=content]{display:none}:host([disabled]){-webkit-user-select:none;-moz-user-select:none;user-select:none;cursor:initial;pointer-events:none}@media(forced-colors: active){[part~=base]:hover,[part~=base]:focus-within{outline:.0625rem solid CanvasText;outline-offset:-0.0625rem}:host([active]) [part~=base]{--item-active-icon-color: Highlight;--item-active-text-color: Highlight}}`;\n  "]}

package/components/popover/popover.d.ts

@@ -1,4 +1,5 @@
 import { LitElement, type PropertyValues } from 'lit';
+import type { PopoverScrollStrategy } from '../types.js';
 /**
  * Describes the preferred placement of a toggle component.
  */
@@ -9,29 +10,24 @@ export type PopoverPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bot
  * @slot - Content of the popover.
  * @slot anchor - The element the popover will be anchored to.
  *
+ * @fires igcPopoverScrollClose - The popover emits this event on each document scroll,
+ * but only while it shows against its anchor and the scroll strategy is `close`.
+ * The popover does not control its own `open` state, so the component that owns that state must close it.
+ * The event does not bubble, so add the listener on the popover element.
+ *
  * @csspart container - The container wrapping the slotted content in the popover.
  */
 export default class IgcPopoverComponent extends LitElement {
     static readonly tagName = "igc-popover";
     static styles: import("lit").CSSResult;
     static register(): void;
-    private _dispose?;
     private _target?;
-    private _middleware?;
-    private _positionId;
-    /**
-     * The positioning strategy resolved when the popover is opened. The `fixed`
-     * strategy is used when the anchor has a `position: sticky` ancestor, otherwise
-     * the default `absolute` strategy is used. Cached here to avoid repeated DOM
-     * traversals and style reflows on every scroll/resize reposition.
-     *
-     * Also, time to migrate to CSS Anchor positioning!!!
-     */
-    private _strategy;
+    private _positionStrategy?;
+    private _positionMode?;
     private readonly _slots;
     private readonly _container;
     /**
-     * Pass an IDREF or an DOM element reference to use as the
+     * Pass an IDREF or a DOM element reference to use as the
      * anchor target for the floating element.
      */
     anchor?: Element | string;
@@ -41,11 +37,6 @@ export default class IgcPopoverComponent extends LitElement {
     arrow: HTMLElement | null;
     /** Additional offset to apply to the arrow element if enabled. */
     arrowOffset: number;
-    /**
-     * Improves positioning for inline reference elements that span over multiple lines.
-     * Useful for tooltips or similar components.
-     */
-    inline: boolean;
     /**
      * When enabled this changes the placement of the floating element in order to keep it
      * in view along the main axis.
@@ -68,34 +59,54 @@ export default class IgcPopoverComponent extends LitElement {
      */
     sameWidth: boolean;
     /**
-     * When enabled this tries to shift the floating element along the main axis
-     * keeping it in view, preventing overflow while maintaining the desired placement.
-     */
-    shift: boolean;
-    /**
-     * Virtual padding for the resolved overflow detection offsets in pixels.
+     * Sets the behavior of the popover when an ancestor scroll container
+     * scrolls and the popover is open.
+     *
+     * If the value is `hide`, the popover hides while the anchor is fully out
+     * of view. The popover shows again when the anchor returns to view. `hide`
+     * is the default value.
+     *
+     * If the value is `scroll`, the popover stays visible. The popover also
+     * stays anchored while the anchor is out of view.
+     *
+     * If the value is `close`, the popover behaves as for `hide`. The popover
+     * also emits `igcPopoverScrollClose` for each scroll. The component that
+     * owns the `open` state must then close the popover.
      */
-    shiftPadding: number;
+    scrollStrategy: PopoverScrollStrategy;
     protected update(properties: PropertyValues<this>): void;
     protected firstUpdated(): void;
+    /**
+     * Waits also for the position strategy. The fallback strategy positions
+     * asynchronously, so the container has no position when Lit ends the update.
+     */
+    protected getUpdateComplete(): Promise<boolean>;
     /** @internal */
     connectedCallback(): void;
     /** @internal */
     disconnectedCallback(): void;
     private _handleSlotChange;
-    private _handleToggle;
+    private _getPositionStrategy;
     /**
-     * An unresolved IDREF keeps the current target, so that an anchor rendered
-     * after this popover is picked up the next time it opens.
+     * Hides the container if the anchor leaves the DOM. The `open` property
+     * keeps its value, so the popover shows again when a new anchor resolves.
+     */
+    private readonly _handleAnchorRemoved;
+    /**
+     * An IDREF that does not resolve keeps the current target, so the popover
+     * finds an anchor that renders later, at the next open.
      */
     private _resolveTarget;
     private _setOpenState;
-    private _setPopoverState;
-    private _clearDispose;
-    private get _placement();
-    private _createMiddleware;
-    private _updatePosition;
-    private _updateArrowPosition;
+    /**
+     * Binds one document `scroll` listener while the container shows and the
+     * scroll strategy is `close`. Reads the container, which can stay closed
+     * while `open` is true.
+     */
+    private _syncScrollStrategy;
+    private readonly _handleRootScroll;
+    /** Shows or hides the container and then syncs the scroll listener. */
+    private _syncContainerState;
     protected render(): import("lit-html").TemplateResult<1>;
 }
 declare global {

package/components/popover/popover.js

@@ -4,41 +4,40 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { arrow, autoUpdate, computePosition, flip, inline, limitShift, offset, shift, size, } from '@floating-ui/dom';
 import { html, LitElement } from 'lit';
 import { property, query } from 'lit/decorators.js';
 import { addSlotController, setSlots, } from '#internals/controllers/slot.js';
 import { registerComponent } from '#internals/definitions/register.js';
 import { firstOf } from '#internals/utils/arrays.js';
-import { getElementByIdFromRoot, hasStickyAncestor, isPopoverOpen, roundByDPR, setStyles, } from '#internals/utils/dom.js';
+import { getElementByIdFromRoot, isPopoverOpen } from '#internals/utils/dom.js';
+import { toggleEventListener } from '#internals/utils/events.js';
 import { isString } from '#internals/utils/types.js';
+import { FloatingPositionStrategy } from './position/floating.js';
+import { NativePositionStrategy, shouldUseNativeAnchorPositioning, } from './position/native.js';
+import { resolvePlacement, SCROLL_LISTENER_OPTIONS, } from './position/types.js';
 import { styles } from './themes/light/popover.base.css.js';
-const OPPOSITE_SIDE = {
-    top: 'bottom',
-    right: 'left',
-    bottom: 'top',
-    left: 'right',
-};
-const SIDES = Object.keys(OPPOSITE_SIDE);
 export default class IgcPopoverComponent extends LitElement {
     constructor() {
         super(...arguments);
-        this._positionId = 0;
-        this._strategy = 'absolute';
         this._slots = addSlotController(this, {
             slots: setSlots('anchor'),
             onChange: this._handleSlotChange,
         });
         this.arrow = null;
         this.arrowOffset = 0;
-        this.inline = false;
         this.flip = false;
         this.offset = 0;
         this.open = false;
         this.placement = 'bottom-start';
         this.sameWidth = false;
-        this.shift = false;
-        this.shiftPadding = 0;
+        this.scrollStrategy = 'hide';
+        this._handleAnchorRemoved = () => {
+            this._target = undefined;
+            this._setOpenState(false);
+        };
+        this._handleRootScroll = () => {
+            this.dispatchEvent(new CustomEvent('igcPopoverScrollClose'));
+        };
     }
     static { this.tagName = 'igc-popover'; }
     static { this.styles = styles; }
@@ -47,15 +46,14 @@ export default class IgcPopoverComponent extends LitElement {
     }
     update(properties) {
         if (this.hasUpdated) {
-            this._middleware = undefined;
-            if (properties.has('sameWidth') && !this.sameWidth) {
-                setStyles(this._container, { width: '' });
-            }
             if (properties.has('open') || properties.has('anchor')) {
                 this._setOpenState(this.open);
             }
             else if (this.open) {
-                this._updatePosition();
+                this._positionStrategy?.update();
+            }
+            if (properties.has('scrollStrategy')) {
+                this._syncScrollStrategy();
             }
         }
         super.update(properties);
@@ -63,6 +61,11 @@ export default class IgcPopoverComponent extends LitElement {
     firstUpdated() {
         this._setOpenState(this.open);
     }
+    async getUpdateComplete() {
+        const complete = await super.getUpdateComplete();
+        await this._positionStrategy?.whenPositioned();
+        return complete;
+    }
     connectedCallback() {
         super.connectedCallback();
         if (this.hasUpdated) {
@@ -79,10 +82,21 @@ export default class IgcPopoverComponent extends LitElement {
         }
         this._setOpenState(this.open);
     }
-    _handleToggle() {
-        if (!isPopoverOpen(this._container)) {
-            this._clearDispose();
+    _getPositionStrategy(target) {
+        const mode = shouldUseNativeAnchorPositioning(target)
+            ? 'native'
+            : 'floating';
+        if (this._positionStrategy && this._positionMode === mode) {
+            return this._positionStrategy;
         }
+        this._positionStrategy?.detach();
+        this._positionStrategy?.clear();
+        this._positionMode = mode;
+        this._positionStrategy =
+            mode === 'native'
+                ? new NativePositionStrategy(this, this._handleAnchorRemoved)
+                : new FloatingPositionStrategy(this, this._handleAnchorRemoved);
+        return this._positionStrategy;
     }
     _resolveTarget() {
         if (isString(this.anchor)) {
@@ -92,108 +106,31 @@ export default class IgcPopoverComponent extends LitElement {
             firstOf(this._slots.getAssignedElements('anchor', { flatten: true })));
     }
     _setOpenState(state) {
-        this._clearDispose();
         if (state) {
             this._target = this._resolveTarget();
-            if (this._target) {
-                this._strategy = hasStickyAncestor(this._target) ? 'fixed' : 'absolute';
-                this._dispose = autoUpdate(this._target, this._container, this._updatePosition.bind(this));
-            }
         }
-        this._setPopoverState(state);
-    }
-    _setPopoverState(state) {
-        const container = this._container;
-        if (!container) {
-            return;
+        if (state && this._target) {
+            this._getPositionStrategy(this._target).attach(this._target, this._container);
         }
-        const shouldOpen = state && this._target != null;
-        if (shouldOpen !== isPopoverOpen(container)) {
-            shouldOpen ? container.showPopover() : container.hidePopover();
+        else {
+            this._positionStrategy?.detach();
         }
+        this._syncContainerState(state);
     }
-    _clearDispose() {
-        this._dispose?.();
-        this._dispose = undefined;
+    _syncScrollStrategy() {
+        toggleEventListener(document, isPopoverOpen(this._container) && this.scrollStrategy === 'close', 'scroll', this._handleRootScroll, SCROLL_LISTENER_OPTIONS);
     }
-    get _placement() {
-        return this.placement ?? 'bottom-start';
-    }
-    _createMiddleware() {
-        const shiftMiddleware = this.shift
-            ? shift({ padding: this.shiftPadding, limiter: limitShift() })
-            : null;
-        const flipMiddleware = this.flip ? flip() : null;
-        const positioners = this._placement.includes('-')
-            ? [flipMiddleware, shiftMiddleware]
-            : [shiftMiddleware, flipMiddleware];
-        const chain = [
-            this.offset !== 0 ? offset(this.offset) : null,
-            this.inline ? inline() : null,
-            ...positioners,
-            this.sameWidth
-                ? size({
-                    apply: ({ rects }) => setStyles(this._container, {
-                        width: `${rects.reference.width}px`,
-                    }),
-                })
-                : null,
-            this.arrow ? arrow({ element: this.arrow }) : null,
-        ];
-        return chain.filter((entry) => entry !== null);
-    }
-    async _updatePosition() {
-        if (!this.open) {
-            return;
-        }
-        if (!this._target?.isConnected) {
-            this._target = undefined;
-            this._clearDispose();
-            this._setPopoverState(false);
+    _syncContainerState(state) {
+        if (!this._container) {
             return;
         }
-        const positionId = ++this._positionId;
-        const strategy = this._strategy;
-        const { x, y, middlewareData, placement } = await computePosition(this._target, this._container, {
-            placement: this._placement,
-            middleware: (this._middleware ??= this._createMiddleware()),
-            strategy,
-        });
-        if (positionId !== this._positionId || !this.open) {
-            return;
+        if (state && this._target) {
+            this._positionStrategy?.show();
         }
-        setStyles(this._container, {
-            position: strategy,
-            left: '0',
-            top: '0',
-            transform: `translate(${roundByDPR(x)}px,${roundByDPR(y)}px)`,
-        });
-        this._updateArrowPosition(placement, middlewareData);
-    }
-    _updateArrowPosition(placement, data) {
-        const element = this.arrow;
-        if (!(data.arrow && element)) {
-            return;
+        else {
+            this._positionStrategy?.hide();
         }
-        const { x, y } = data.arrow;
-        const offset = this.arrowOffset;
-        const [side] = placement.split('-');
-        const staticSide = OPPOSITE_SIDE[side];
-        if (!element.part.contains(side)) {
-            element.part.remove(...SIDES);
-            element.part.add(side);
-        }
-        const inset = staticSide === 'top' || staticSide === 'bottom'
-            ? element.offsetHeight
-            : element.offsetWidth;
-        const styles = {
-            top: y != null ? `${roundByDPR(y + offset)}px` : '',
-            right: '',
-            bottom: '',
-            left: x != null ? `${roundByDPR(x + offset)}px` : '',
-        };
-        styles[staticSide] = `${-inset}px`;
-        setStyles(element, styles);
+        this._syncScrollStrategy();
     }
     render() {
         return html `
@@ -202,7 +139,8 @@ export default class IgcPopoverComponent extends LitElement {
         id="container"
         part="container"
         popover="manual"
-        @toggle=${this._handleToggle}
+        data-placement=${resolvePlacement(this)}
+        data-scroll-strategy=${this.scrollStrategy}
       >
         <slot></slot>
       </div>
@@ -221,9 +159,6 @@ __decorate([
 __decorate([
     property({ type: Number, attribute: 'arrow-offset' })
 ], IgcPopoverComponent.prototype, "arrowOffset", void 0);
-__decorate([
-    property({ type: Boolean, reflect: true })
-], IgcPopoverComponent.prototype, "inline", void 0);
 __decorate([
     property({ type: Boolean, reflect: true })
 ], IgcPopoverComponent.prototype, "flip", void 0);
@@ -240,9 +175,6 @@ __decorate([
     property({ type: Boolean, reflect: true, attribute: 'same-width' })
 ], IgcPopoverComponent.prototype, "sameWidth", void 0);
 __decorate([
-    property({ type: Boolean, reflect: true })
-], IgcPopoverComponent.prototype, "shift", void 0);
-__decorate([
-    property({ type: Number, attribute: 'shift-padding' })
-], IgcPopoverComponent.prototype, "shiftPadding", void 0);
+    property({ attribute: 'scroll-strategy' })
+], IgcPopoverComponent.prototype, "scrollStrategy", void 0);
 //# sourceMappingURL=popover.js.map