argus-table 0.0.0-stage → 0.1.0

package/dist/core/src/virtual/row-pool.js

@@ -0,0 +1,64 @@
+// ../core/src/virtual/row-pool.ts
+/**
+* Assigns pool slots to rendered rows (ADR 0001).
+*
+* A row keeps its slot while it stays rendered. A row entering the window takes a
+* slot freed by a row that left, so its DOM is updated in place rather than created.
+* Rows are returned in slot order ("pool order"); the ADR 0001 addendum ruled out
+* re-sorting them by row index, so assistive tech gets row positions from
+* `aria-rowindex` instead.
+*/
+var RowPool = class {
+	#slots = /* @__PURE__ */ new Map();
+	#free = [];
+	#size = 0;
+	#pinned;
+	/** Number of slots created so far: the most rows rendered at once. */
+	get size() {
+		return this.#size;
+	}
+	/** The row id whose slot is kept while it is out of range, if any. */
+	get pinned() {
+		return this.#pinned;
+	}
+	/**
+	* Keeps one row's slot, and keeps it rendered, while it is outside the rendered
+	* range. Used for the row holding focus. `undefined` releases it.
+	*/
+	pin(id) {
+		this.#pinned = id;
+	}
+	/** The slot a row holds, or `undefined` when it isn't rendered. */
+	slotOf(id) {
+		return this.#slots.get(id);
+	}
+	/**
+	* Updates the pool for the rows that should be rendered and returns them, plus the
+	* pinned row if it isn't among them, in slot order.
+	*/
+	update(ids) {
+		const keep = new Set(ids);
+		if (this.#pinned !== void 0) keep.add(this.#pinned);
+		for (const [id, slot] of this.#slots) if (!keep.has(id)) {
+			this.#slots.delete(id);
+			this.#free.push(slot);
+		}
+		for (const id of keep) if (!this.#slots.has(id)) this.#slots.set(id, this.#free.pop() ?? this.#size++);
+		const entries = [];
+		for (const [id, slot] of this.#slots) entries.push({
+			id,
+			slot
+		});
+		return entries.sort((a, b) => a.slot - b.slot);
+	}
+	/** Frees every slot, for example when the data is replaced. */
+	clear() {
+		this.#slots.clear();
+		this.#free = [];
+		this.#size = 0;
+		this.#pinned = void 0;
+	}
+};
+export { RowPool };
+
+//# sourceMappingURL=row-pool.js.map

package/dist/core/src/virtual/row-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-pool.js","names":[],"sources":["../../../../../core/src/virtual/row-pool.ts"],"sourcesContent":["/** A rendered row and the pool slot whose DOM it uses. */\nexport interface PoolEntry {\n  id: string;\n  slot: number;\n}\n\n/**\n * Assigns pool slots to rendered rows (ADR 0001).\n *\n * A row keeps its slot while it stays rendered. A row entering the window takes a\n * slot freed by a row that left, so its DOM is updated in place rather than created.\n * Rows are returned in slot order (\"pool order\"); the ADR 0001 addendum ruled out\n * re-sorting them by row index, so assistive tech gets row positions from\n * `aria-rowindex` instead.\n */\nexport class RowPool {\n  #slots = new Map<string, number>();\n  #free: number[] = [];\n  #size = 0;\n  #pinned: string | undefined;\n\n  /** Number of slots created so far: the most rows rendered at once. */\n  get size(): number {\n    return this.#size;\n  }\n\n  /** The row id whose slot is kept while it is out of range, if any. */\n  get pinned(): string | undefined {\n    return this.#pinned;\n  }\n\n  /**\n   * Keeps one row's slot, and keeps it rendered, while it is outside the rendered\n   * range. Used for the row holding focus. `undefined` releases it.\n   */\n  pin(id: string | undefined): void {\n    this.#pinned = id;\n  }\n\n  /** The slot a row holds, or `undefined` when it isn't rendered. */\n  slotOf(id: string): number | undefined {\n    return this.#slots.get(id);\n  }\n\n  /**\n   * Updates the pool for the rows that should be rendered and returns them, plus the\n   * pinned row if it isn't among them, in slot order.\n   */\n  update(ids: Iterable<string>): PoolEntry[] {\n    const keep = new Set(ids);\n    if (this.#pinned !== undefined) keep.add(this.#pinned);\n\n    for (const [id, slot] of this.#slots) {\n      if (!keep.has(id)) {\n        this.#slots.delete(id);\n        this.#free.push(slot);\n      }\n    }\n    for (const id of keep) {\n      if (!this.#slots.has(id)) this.#slots.set(id, this.#free.pop() ?? this.#size++);\n    }\n\n    const entries: PoolEntry[] = [];\n    for (const [id, slot] of this.#slots) entries.push({ id, slot });\n    return entries.sort((a, b) => a.slot - b.slot);\n  }\n\n  /** Frees every slot, for example when the data is replaced. */\n  clear(): void {\n    this.#slots.clear();\n    this.#free = [];\n    this.#size = 0;\n    this.#pinned = undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;AAeA,IAAa,UAAb,MAAqB;CACnB,yBAAS,IAAI,IAAoB;CACjC,QAAkB,CAAC;CACnB,QAAQ;CACR;;CAGA,IAAI,OAAe;EACjB,OAAO,KAAK;CACd;;CAGA,IAAI,SAA6B;EAC/B,OAAO,KAAK;CACd;;;;;CAMA,IAAI,IAA8B;EAChC,KAAK,UAAU;CACjB;;CAGA,OAAO,IAAgC;EACrC,OAAO,KAAK,OAAO,IAAI,EAAE;CAC3B;;;;;CAMA,OAAO,KAAoC;EACzC,MAAM,OAAO,IAAI,IAAI,GAAG;EACxB,IAAI,KAAK,YAAY,KAAA,GAAW,KAAK,IAAI,KAAK,OAAO;EAErD,KAAK,MAAM,CAAC,IAAI,SAAS,KAAK,QAC5B,IAAI,CAAC,KAAK,IAAI,EAAE,GAAG;GACjB,KAAK,OAAO,OAAO,EAAE;GACrB,KAAK,MAAM,KAAK,IAAI;EACtB;EAEF,KAAK,MAAM,MAAM,MACf,IAAI,CAAC,KAAK,OAAO,IAAI,EAAE,GAAG,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;EAGhF,MAAM,UAAuB,CAAC;EAC9B,KAAK,MAAM,CAAC,IAAI,SAAS,KAAK,QAAQ,QAAQ,KAAK;GAAE;GAAI;EAAK,CAAC;EAC/D,OAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;CAC/C;;CAGA,QAAc;EACZ,KAAK,OAAO,MAAM;EAClB,KAAK,QAAQ,CAAC;EACd,KAAK,QAAQ;EACb,KAAK,UAAU,KAAA;CACjB;AACF"}