@deepseek-ai/dsh-client-web 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,61 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/web/README.md
-README.md: 2cedd1748973e13ad1b9a3b0ef89c0101d4ffb09
-README.zh.md: 882c338339b725f82aae4d931ab85a6d14650b42
+/:
+  en: bd6e5fc50f07893f
+  zh: 0ee146674eb01770
+/deepseek-ai-dsh-client-web:
+  en: 8423614617b7bbf1
+  zh: c99647136c800173
+/deepseek-ai-dsh-client-web/summary:
+  en: 646bd0a246789400
+  zh: d875dc0d37f46338
+/deepseek-ai-dsh-client-web/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/deepseek-ai-dsh-client-web/use-this-package:
+  en: 0c8b98946feedb0f
+  zh: ae10ae7b9ecbf89c
+/deepseek-ai-dsh-client-web/use-this-package/what-boot-looks-like:
+  en: f3b01aa878764e5c
+  zh: f02eab65d441bfe0
+/deepseek-ai-dsh-client-web/use-this-package/the-boot-page:
+  en: add354591107b80d
+  zh: 41136254a00d785e
+/deepseek-ai-dsh-client-web/use-this-package/the-shared-module-table:
+  en: 8380cd70b861a3a8
+  zh: 5a331deb7ad8fca1
+/deepseek-ai-dsh-client-web/use-this-package/configuration:
+  en: 942959cb40ee31a1
+  zh: 9c86ac2cf6a13976
+/deepseek-ai-dsh-client-web/understand-the-implementation:
+  en: 9556ca6438410146
+  zh: 8a60572cb4caa04a
+/deepseek-ai-dsh-client-web/understand-the-implementation/design-concept:
+  en: e18ec3ae51dcdc3f
+  zh: e454da2038979aec
+/deepseek-ai-dsh-client-web/understand-the-implementation/two-stage-boot:
+  en: fb3cab79c1505627
+  zh: 875897afe593aeb3
+/deepseek-ai-dsh-client-web/understand-the-implementation/boot-page-mechanics:
+  en: 83f9195138da9a82
+  zh: 135d7da735fb870a
+/deepseek-ai-dsh-client-web/understand-the-implementation/source-map:
+  en: 1fe37d3730368e32
+  zh: 74c2d6980ce82e21
+/deepseek-ai-dsh-client-web/further-exploration:
+  en: f2da70a33bba9086
+  zh: a775f6fe309150ea
+/deepseek-ai-dsh-client-web/model-experience:
+  en: ec17334dcce181f3
+  zh: bc8bc6e25ecbf9e8
+/deepseek-ai-dsh-client-web/model-experience/kv-cache-effect:
+  en: ca75c51c89c2c9b0
+  zh: de54f3467ef3b9be
+/deepseek-ai-dsh-client-web/known-limitations-and-deferred-work:
+  en: f498ba05d4ea96d5
+  zh: c3e57dd8ca9b5bda
+/deepseek-ai-dsh-client-web/known-limitations-and-deferred-work/dev-note:
+  en: 80ab3d00f7aac4de
+  zh: 3c08f30322413856

package/README.md

@@ -52,6 +52,8 @@ The package accepts no plugin config of its own; the generated [configuration ca
 <a id="understand-the-implementation"></a>
 ## Understand the implementation
 
+Menus use the shared `MenuSurface` material, including the macOS backing for background blur; custom content follows the [menu rules](../../../docs/web-styling.md#component-rules).
+
 <details>
 <summary>Implementation internals — click to expand</summary>
 
@@ -76,12 +78,14 @@ The boot kernel delegates manifest entry creation to Client Modules so live grap
 | File | Role |
 |---|---|
 | [`src/index.ts`](src/index.ts) | Library entry: `AppWebEntry`, `getStaticModules`, platform tables |
-| [`src/boot.ts`](src/boot.ts) | `AppWebEntry`: module stage, boot page, immediate-tier prefetch, then `bootClient` + `mountClient` |
+| [`src/boot.ts`](src/boot.ts) | `AppWebEntry`: module stage, boot page, immediate-tier prefetch, window drag-rect watcher install, then `bootClient` + `mountClient` |
 | [`src/boot-client.ts`](src/boot-client.ts) | `bootClient` / `assertEntriesActive`: Loader mount, one entry per manifest row, activation audit |
 | [`src/mount.ts`](src/mount.ts) | `mountClient`: renderer handoff through a `uiRenderer` dependency fiber |
 | [`src/boot-page.ts`](src/boot-page.ts) | Framework-free boot page: spinner, per-entry status, failure rendering |
 | [`src/platform.ts`](src/platform.ts) | `PLATFORM_MODULES` / `PRELOADED_CLIENT_EXTERNALS`: the implicit external baseline |
 | [`src/seed.ts`](src/seed.ts) | Static module table handed to the loader at boot |
+| [`src/window-drag/regions.ts`](src/window-drag/regions.ts) | The darwin app-region composition model, and the interactive selector `base.css` subtracts |
+| [`src/window-drag/recall.ts`](src/window-drag/recall.ts) | The shell's one window drag-rect watcher (electron/electron#32341): measure the marked rows per frame and pulse the recall mark while they move |
 
 </details>
 

package/README.zh.md

@@ -52,6 +52,8 @@ kind: "package-library"
 <a id="understand-the-implementation"></a>
 ## 理解实现
 
+菜单采用共享 `MenuSurface` 材质，包括用于背景模糊的 macOS 底层；自定义内容遵循[菜单规则](../../../docs/web-styling.zh.md#component-rules)。
+
 <details>
 <summary>实现细节——点击展开</summary>
 
@@ -76,12 +78,14 @@ kind: "package-library"
 | 文件 | 职责 |
 |---|---|
 | [`src/index.ts`](src/index.ts) | 库入口：`AppWebEntry`、`getStaticModules`、平台表 |
-| [`src/boot.ts`](src/boot.ts) | `AppWebEntry`：模块阶段、启动页、immediately 层级预取，随后调用 `bootClient` + `mountClient` |
+| [`src/boot.ts`](src/boot.ts) | `AppWebEntry`：模块阶段、启动页、immediately 层级预取、安装窗口拖拽矩形 watcher，随后调用 `bootClient` + `mountClient` |
 | [`src/boot-client.ts`](src/boot-client.ts) | `bootClient` / `assertEntriesActive`：挂载 Loader、每个 manifest 行一个 entry、激活审计 |
 | [`src/mount.ts`](src/mount.ts) | `mountClient`：经 `uiRenderer` 依赖 fiber 完成渲染器交接 |
 | [`src/boot-page.ts`](src/boot-page.ts) | 无框架启动页：spinner、逐 entry 状态、失败渲染 |
 | [`src/platform.ts`](src/platform.ts) | `PLATFORM_MODULES` / `PRELOADED_CLIENT_EXTERNALS`：隐式 external 基座 |
 | [`src/seed.ts`](src/seed.ts) | 启动时交给 loader 的静态模块表 |
+| [`src/window-drag/regions.ts`](src/window-drag/regions.ts) | darwin app-region 组合模型，以及 `base.css` 减除的交互元素选择器 |
+| [`src/window-drag/recall.ts`](src/window-drag/recall.ts) | 外壳唯一的窗口拖拽矩形 watcher（electron/electron#32341）：逐帧测量被打标行，并在它们移动期间脉冲 recall 标记 |
 
 </details>
 

package/lib/base.css

@@ -39,36 +39,46 @@ html[data-platform='darwin'] body {
   background: transparent;
 }
 
-/* The transparent window disables backdrop-filter: Chromium composites it
-   against the root surface, which vibrancy leaves transparent, so the blur in
-   --dsw-menu-backdrop-filter renders as nothing and half-opaque menu fills
-   let underlying text bleed through. Compensate with near-opaque fills on the
-   same design-platform hues (light 248 249 250 / dark 48 49 54). */
+/* Menu backings paint below page content but above the native vibrancy. */
 html[data-platform='darwin'] body {
-  --dsw-specific-menu: rgba(248, 249, 250, 0.94);
+  isolation: isolate;
 }
 
-html[data-platform='darwin'] body[data-ds-dark-theme] {
-  --dsw-specific-menu: rgba(48, 49, 54, 0.94);
+/* macOS desktop: the one drag declaration. A chrome row marks itself in markup
+   (`data-window-drag`) and its own box becomes its draggable geometry, so no fixed
+   band has to match any row's height; the ui-theme app-region gate's CHROME_ROWS
+   manifest is the list of rows that must carry the mark. Electron composes
+   app-regions from geometry, not hit testing, so a surface covering a row would
+   otherwise drag the window instead of receiving clicks; every covering overlay
+   portals to document.body beside #root, which also puts it after every drag row
+   in document order, and one rule subtracts them all. */
+html[data-platform='darwin'] [data-window-drag] {
+  -webkit-app-region: drag;
+}
+
+/* One-frame app-region pulse that forces Electron to recollect the window's drag
+   rects (electron#32341): a change to a computed app-region value is what dirties
+   them. The shell's window drag watcher (window-drag/recall.ts) sets this
+   attribute on the body for each frame in which a marked row's box moved, and
+   clears it on the frame that finds the geometry settled. The box it subtracts
+   is the body's own: the row marks inside still declare drag and win over it in
+   document order, so the pulse changes nothing about the composed surface — it
+   only makes Electron collect it again. */
+html[data-platform='darwin'] [data-window-drag-recall] {
+  -webkit-app-region: no-drag;
 }
 
-/* macOS desktop: the app frame publishes window drag bands, and Electron
-   composes app-regions from geometry, not hit testing — a surface covering a
-   band would otherwise drag the window instead of receiving clicks. Every
-   overlay portals to document.body beside #root, so one rule subtracts them
-   all; drag surfaces all live inside #root. */
 html[data-platform='darwin'] body > :not(#root) {
   -webkit-app-region: no-drag;
 }
 
 /* Inside #root, interactive controls and raised surfaces (dialogs, menus)
-   subtract themselves from any drag band they overlap, wherever they render.
-   Electron composes app-regions from geometry in document order, so this works
-   only because the bands are declared before all content (AppFrame's first
-   child; the sidebar rows that precede the column's overlay slots) — a drag
-   rule on a content container would override every overlay mounted earlier in
-   the DOM. One selector on the native elements, ARIA roles, and tabindexed
-   custom widgets replaces per-component no-drag opt-outs. */
+   subtract themselves from any drag row they overlap, wherever they render.
+   Electron composes app-regions from geometry in document order, so a drag rule
+   must sit on a chrome row that precedes the overlays covering it — never on a
+   content container, which would override every overlay mounted earlier in the
+   DOM. One selector on the native elements, ARIA roles, and tabindexed custom
+   widgets replaces per-component no-drag opt-outs. */
 html[data-platform='darwin'] :is(
   button, a, input, select, textarea, summary, [contenteditable='true'], [tabindex],
   [role='dialog'], [role='alertdialog'], [role='menu'], [role='listbox'], [role='tooltip'],

package/lib/index.js

@@ -220,6 +220,252 @@ function getStaticModules() {
 	};
 }
 //#endregion
+//#region lib/types/window-drag/regions.js
+/**
+* The window drag-region contract for the macOS desktop shell: Electron hands
+* the page's `-webkit-app-region` boxes to the native window, which hit-tests
+* them by geometry in DOM order, ignoring stacking. The property does not inherit:
+* Blink collects one box per element whose own computed value is not `none`,
+* skipping subtrees that are not visible, and the window applies them in that
+* order: `drag` adds geometry, `no-drag` removes it. The composition is therefore
+* equivalent to "the last matching box decides" — a point is draggable when the
+* last collected box containing it is `drag`.
+*
+* This module is the executable statement of that rule. Production CSS authors
+* the boxes; tests and the browser coverage scenario both decide points through
+* this module so a claim about coverage has one meaning.
+*/
+/**
+* The attribute a chrome row puts on the element that owns its window drag.
+* ui-web `base.css` turns the mark into the one darwin drag rule, so the row's
+* own box is the window's draggable geometry.
+*/
+const DRAG_MARK = "data-window-drag";
+/**
+* The attribute the shell sets for one frame to make Electron recollect the
+* window's drag rects (electron#32341). While it is set, ui-web `base.css`
+* subtracts the marked box; the row marks inside it still declare drag and win in
+* document order, so the mark's only effect is that app-region values changed.
+*/
+const RECALL_MARK = "data-window-drag-recall";
+[
+	"button",
+	"a",
+	"input",
+	"select",
+	"textarea",
+	"summary",
+	"[contenteditable='true']",
+	"[tabindex]",
+	"[role='dialog']",
+	"[role='alertdialog']",
+	"[role='menu']",
+	"[role='listbox']",
+	"[role='tooltip']",
+	"[role='button']",
+	"[role='link']",
+	"[role='tab']",
+	"[role='menuitem']",
+	"[role='menuitemcheckbox']",
+	"[role='menuitemradio']",
+	"[role='option']",
+	"[role='checkbox']",
+	"[role='radio']",
+	"[role='switch']",
+	"[role='slider']",
+	"[role='combobox']",
+	"[role='textbox']"
+].join(", ");
+//#endregion
+//#region lib/types/window-drag/recall.js
+/**
+* Window drag recollection for the macOS desktop shell. Electron rebuilds the
+* window's `-webkit-app-region` rects only when a style pass changes a computed
+* app-region value (electron#32341), and Blink skips hidden boxes when it collects
+* them, so a chrome row that appears, moves, or disappears without such a change
+* leaves the native window holding the previous geometry: a press inside the row
+* drags from where it used to be, and a row that slid under the pointer keeps its
+* controls unreachable or its blank runs undraggable. This module owns the one
+* watcher that closes that gap, so no chrome row has to know the trap.
+*
+* A row's viewport box is the measurement: every row in this composition shows and
+* hides by mounting, unmounting, or moving, so a changed box is the signal. The
+* watcher starts on a DOM change that touches a marked row — inside it, on it, on
+* an ancestor that holds one, on a container it lives in, or adding or removing one
+* — on a marked row's box resizing, or on a transition or animation starting on an
+* element that holds one, and then measures every marked row once per frame for as
+* long as any box keeps changing. Each frame that changed sets the recall mark, and
+* the frame that finds the same geometry clears it and stops once the short grace
+* window below has passed: that clear is the collection the steady state comes from.
+* @module @deepseek-ai/dsh-client-web/src/window-drag/recall
+*/
+/** The selector of an element that owns a window drag region. */
+const ROW_SELECTOR = `[${DRAG_MARK}]`;
+/**
+* Quiet frames a report tolerates before the loop stops again. A CSS transition's
+* first frame still reports the box's from-value, so a report that arrives before
+* the surface starts moving must not end the loop on its first unchanged sample.
+*/
+const GRACE_FRAMES = 2;
+/** The event types that mark a box starting or finishing a transition or animation. */
+const MOTION_EVENTS = [
+	"transitionstart",
+	"transitionend",
+	"animationstart",
+	"animationend"
+];
+/**
+* Watch the window's marked drag rows and pulse the recall mark whenever their
+* geometry can have moved. Installs nothing outside the darwin platform, where no
+* app-region rule exists.
+* @param options - the document to watch and the two scheduling seams.
+* @returns a disposer that stops watching, drops any pending frame, and clears the mark.
+*/
+function installWindowDragRecall(options) {
+	const doc = options.document;
+	if (doc.documentElement.dataset.platform !== "darwin") return () => {};
+	const scheduleFrame = options.scheduleFrame ?? defaultScheduleFrame;
+	const watchBox = options.watchBox ?? defaultWatchBox;
+	/** The last frame's measurement per row, the baseline a change is read against. */
+	let geometry = /* @__PURE__ */ new Map();
+	/** One box watcher per row currently rendered. */
+	const boxes = /* @__PURE__ */ new Map();
+	let scheduled = false;
+	let disposed = false;
+	let cancelPending;
+	/** Quiet frames left before the loop may stop; refreshed by every report. */
+	let grace = 0;
+	/**
+	* Measure every marked row and pulse when any box differs from the last frame's.
+	* Runs once per frame while the surface keeps moving.
+	*/
+	const measure = () => {
+		doc.body.removeAttribute(RECALL_MARK);
+		const rows = Array.from(doc.querySelectorAll(ROW_SELECTOR));
+		watchBoxes(rows);
+		const next = new Map(rows.map((row) => [row, readBox(row)]));
+		const moved = rows.length !== geometry.size || rows.some((row) => geometry.get(row) !== next.get(row));
+		geometry = next;
+		if (moved) {
+			doc.body.setAttribute(RECALL_MARK, "");
+			grace = 0;
+			schedule();
+			return;
+		}
+		if (grace === 0) return;
+		grace -= 1;
+		schedule();
+	};
+	/** Report that the surface may be moving, opening the grace window again. */
+	const arm = () => {
+		grace = GRACE_FRAMES;
+		schedule();
+	};
+	/** Schedule one frame, keeping at most one pending. */
+	const schedule = () => {
+		if (scheduled) return;
+		scheduled = true;
+		cancelPending = scheduleFrame(() => {
+			scheduled = false;
+			cancelPending = void 0;
+			if (disposed) return;
+			measure();
+		});
+	};
+	/** Keep one box watcher per live row, re-watching when its frame moves or unmounts. */
+	const watchBoxes = (rows) => {
+		for (const [row, dispose] of boxes) {
+			if (rows.includes(row)) continue;
+			dispose();
+			boxes.delete(row);
+		}
+		for (const row of rows) {
+			if (boxes.has(row)) continue;
+			boxes.set(row, watchBox(row, arm));
+		}
+	};
+	/**
+	* Whether a motion event can be moving a marked row: the transitioning element is
+	* one, holds one, or lives inside one.
+	* @param target - the event target to classify.
+	* @returns true when the drag surface has to be re-measured.
+	*/
+	const movesRows = (target) => {
+		if (!(target instanceof Element)) return false;
+		return target.closest(ROW_SELECTOR) !== null || target.querySelector(ROW_SELECTOR) !== null;
+	};
+	/** Re-arm for a transition or animation that can be sliding a marked row. */
+	const onMotion = (event) => {
+		if (movesRows(event.target)) arm();
+	};
+	const observer = new MutationObserver((records) => {
+		if (records.some((record) => touchesRows(record, geometry.keys()))) arm();
+	});
+	observer.observe(doc.body, {
+		subtree: true,
+		childList: true,
+		attributes: true,
+		characterData: true
+	});
+	for (const type of MOTION_EVENTS) doc.addEventListener(type, onMotion, true);
+	arm();
+	return () => {
+		disposed = true;
+		observer.disconnect();
+		for (const type of MOTION_EVENTS) doc.removeEventListener(type, onMotion, true);
+		if (cancelPending !== void 0) cancelPending();
+		for (const dispose of boxes.values()) dispose();
+		boxes.clear();
+		geometry.clear();
+		doc.body.removeAttribute(RECALL_MARK);
+	};
+}
+/** The box a row owns this frame, in viewport pixels. */
+function readBox(row) {
+	const rect = row.getBoundingClientRect();
+	return `${rect.x},${rect.y},${rect.width},${rect.height}`;
+}
+/**
+* Whether one DOM change can have moved the drag surface: a child list change in a
+* container that holds a marked row, or an attribute or text change that lands on a
+* marked row, inside one, or on an element holding one (a panel's open flag, a
+* column's width). A child list change in a container without a marked row is left
+* alone — a row whose box grows because its content did is a resize, which the box
+* watcher reports — and so is a mounted overlay, whose own app-region value is a
+* change of its own.
+* @param record - the mutation record to classify.
+* @param rows - the rows the last frame measured.
+* @returns true when the drag surface has to be re-measured.
+*/
+function touchesRows(record, rows) {
+	if (record.attributeName === "data-window-drag-recall") return false;
+	for (const node of [...record.addedNodes, ...record.removedNodes]) if (node instanceof Element && (node.matches(ROW_SELECTOR) || node.querySelector(ROW_SELECTOR) !== null)) return true;
+	const target = record.target instanceof Element ? record.target : record.target.parentElement;
+	/* v8 ignore next -- the observer watches body's subtree, so a text target always has a parent element. */
+	if (target === null) return false;
+	if (record.type === "childList") {
+		for (const row of rows) if (target.contains(row)) return true;
+		return false;
+	}
+	return target.closest(ROW_SELECTOR) !== null || target.querySelector(ROW_SELECTOR) !== null;
+}
+/** Schedule one frame through the browser's animation frame queue. */
+function defaultScheduleFrame(frame) {
+	const handle = requestAnimationFrame(frame);
+	return () => {
+		cancelAnimationFrame(handle);
+	};
+}
+/** Watch one row's border box where the document has a `ResizeObserver`. */
+function defaultWatchBox(row, changed) {
+	if (typeof ResizeObserver !== "function") return () => {};
+	const observer = new ResizeObserver(changed);
+	observer.observe(row);
+	return () => {
+		observer.disconnect();
+	};
+}
+//#endregion
 //#region lib/types/boot.js
 /**
 * Web boot kernel. It owns only the module system, Cordis loader, and a
@@ -234,6 +480,7 @@ var AppWebEntry = class {
 	seams;
 	page;
 	ctx;
+	stopDragRecall;
 	modules;
 	manifest;
 	/**
@@ -279,6 +526,7 @@ var AppWebEntry = class {
 					if (onFailure === void 0 || state !== "failed") this.page.setState(name, state);
 				}
 			});
+			this.stopDragRecall = installWindowDragRecall({ document: this.container.ownerDocument });
 			await mountClient(ctx, this.container);
 		} catch (reason) {
 			console.error(reason);
@@ -288,6 +536,8 @@ var AppWebEntry = class {
 	}
 	/** Dispose the client plugin tree and whichever page owns the mount point. */
 	async dispose() {
+		this.stopDragRecall?.();
+		this.stopDragRecall = void 0;
 		const ctx = this.ctx;
 		this.ctx = void 0;
 		if (ctx !== void 0) await ctx.fiber.dispose();

package/lib/types/boot.d.ts

@@ -8,6 +8,7 @@ export declare class AppWebEntry {
     private readonly seams;
     private readonly page;
     private ctx;
+    private stopDragRecall;
     private modules;
     private manifest;
     /**

package/lib/types/window-drag/recall.d.ts

@@ -0,0 +1,25 @@
+/** How the shell installs the one window drag watcher. */
+export interface WindowDragRecallOptions {
+    /** Document whose marked rows are watched. */
+    readonly document: Document;
+    /**
+     * Schedules one frame callback and returns its canceller. The callback runs
+     * asynchronously, as `requestAnimationFrame` does.
+     */
+    readonly scheduleFrame?: (frame: () => void) => () => void;
+    /**
+     * Watches one row's border box and calls `changed` whenever it resizes, returning
+     * a disposer. Defaults to a `ResizeObserver`; a document without one watches no
+     * boxes and relies on the DOM changes alone.
+     */
+    readonly watchBox?: (row: Element, changed: () => void) => () => void;
+}
+/**
+ * Watch the window's marked drag rows and pulse the recall mark whenever their
+ * geometry can have moved. Installs nothing outside the darwin platform, where no
+ * app-region rule exists.
+ * @param options - the document to watch and the two scheduling seams.
+ * @returns a disposer that stops watching, drops any pending frame, and clears the mark.
+ */
+export declare function installWindowDragRecall(options: WindowDragRecallOptions): () => void;
+//# sourceMappingURL=recall.d.ts.map

package/lib/types/window-drag/regions.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The window drag-region contract for the macOS desktop shell: Electron hands
+ * the page's `-webkit-app-region` boxes to the native window, which hit-tests
+ * them by geometry in DOM order, ignoring stacking. The property does not inherit:
+ * Blink collects one box per element whose own computed value is not `none`,
+ * skipping subtrees that are not visible, and the window applies them in that
+ * order: `drag` adds geometry, `no-drag` removes it. The composition is therefore
+ * equivalent to "the last matching box decides" — a point is draggable when the
+ * last collected box containing it is `drag`.
+ *
+ * This module is the executable statement of that rule. Production CSS authors
+ * the boxes; tests and the browser coverage scenario both decide points through
+ * this module so a claim about coverage has one meaning.
+ */
+/**
+ * One collected app-region box, in DOM order.
+ *
+ * Coordinates are viewport CSS pixels, the space `getBoundingClientRect`
+ * reports, so collection and composition never rescale.
+ */
+export interface RegionRect {
+    /** Left edge, viewport CSS pixels. */
+    readonly x: number;
+    /** Top edge, viewport CSS pixels. */
+    readonly y: number;
+    /** Box width in CSS pixels. */
+    readonly width: number;
+    /** Box height in CSS pixels. */
+    readonly height: number;
+    /** Whether this box declares `drag` (true) or `no-drag` (false). */
+    readonly draggable: boolean;
+}
+/**
+ * The attribute a chrome row puts on the element that owns its window drag.
+ * ui-web `base.css` turns the mark into the one darwin drag rule, so the row's
+ * own box is the window's draggable geometry.
+ */
+export declare const DRAG_MARK = "data-window-drag";
+/**
+ * The attribute the shell sets for one frame to make Electron recollect the
+ * window's drag rects (electron#32341). While it is set, ui-web `base.css`
+ * subtracts the marked box; the row marks inside it still declare drag and win in
+ * document order, so the mark's only effect is that app-region values changed.
+ */
+export declare const RECALL_MARK = "data-window-drag-recall";
+/**
+ * The interactive-element selector that subtracts a control from any drag row it
+ * overlaps. ui-web `base.css` declares it for the darwin platform; this constant
+ * is the single source both that sheet and its contract spec compare against, so
+ * the two cannot drift.
+ */
+export declare const INTERACTIVE_SELECTOR: string;
+/**
+ * Whether a box contains a viewport point. Edges belong to the box, matching
+ * the half-open rectangles the window hit test uses.
+ * @param rect - the collected box.
+ * @param x - viewport x in CSS pixels.
+ * @param y - viewport y in CSS pixels.
+ * @returns true when the point lies inside the box.
+ */
+export declare function containsPoint(rect: RegionRect, x: number, y: number): boolean;
+/**
+ * Decide whether the window would drag when pressed at a point.
+ * @param regions - collected boxes in DOM order.
+ * @param x - viewport x in CSS pixels.
+ * @param y - viewport y in CSS pixels.
+ * @returns true when the last box containing the point is a drag box; false
+ * when it is a no-drag box or no box contains the point.
+ */
+export declare function isDraggableAt(regions: readonly RegionRect[], x: number, y: number): boolean;
+//# sourceMappingURL=regions.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-web",
   "description": "Web boot kernel: static module table, Cordis loader, framework-free boot page, and UI-renderer handoff",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,15 +32,15 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "typescript": "^6.0.3",
-    "@deepseek-ai/dsh-client-modules": "0.1.7-alpha.2",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-dockkit": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-modules": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-dockkit": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-host-webserver": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4"