perf(core): the keyboard notifications' duration has its own export

.changeset/uikit-keyboard-notification.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the keyboard notifications' duration has its own export in the UIKit timing table, so code that reads only it bundles no other timing value. Not exported from the package entry point.
+
+@vjeux

packages/core/src/motion/uikit/keyboardNotification.test.ts

@@ -0,0 +1,46 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file keyboardNotification.test.ts
+ * @input timing.ts, bundled on its own with esbuild
+ * @output Proof that the keyboard notifications' duration is its own export:
+ *   the timing table composes it, and a bundle that reads only it carries no
+ *   other row of the table
+ * @position Guards architecture:component-style-authoring INV6 for the
+ *   keyboard layout guide's one read of the timing table
+ */
+
+import {execFileSync} from 'node:child_process';
+import {describe, expect, it} from 'vitest';
+import {keyboardNotification, timing} from './timing';
+
+describe('keyboardNotification', () => {
+  it('is the timing table\u2019s keyboard duration', () => {
+    expect(timing.keyboardNotificationMs).toBe(keyboardNotification.durationMs);
+  });
+
+  it('a bundle that reads only the keyboard\u2019s duration drops the rest of the table', () => {
+    // esbuild runs in its own Node process: jsdom's TextEncoder fails its
+    // startup check.
+    const code = execFileSync(
+      process.execPath,
+      [
+        '--input-type=module',
+        '-e',
+        [
+          "import {build} from 'esbuild';",
+          'const result = await build({',
+          "  stdin: {contents: \"import {keyboardNotification} from './timing'; export const ms = keyboardNotification.durationMs;\", resolveDir: process.cwd(), loader: 'ts'},",
+          "  bundle: true, write: false, format: 'esm', minify: true, logLevel: 'silent',",
+          '});',
+          'process.stdout.write(result.outputFiles[0].text);',
+        ].join('\n'),
+      ],
+      {cwd: __dirname, encoding: 'utf8'},
+    );
+    expect(code).toContain('383.3');
+    // No other row: not the navigation bar's duration, not the press clocks.
+    expect(code).not.toContain('navigationBarHideShowMs');
+    expect(code).not.toContain('buttonReleaseMs');
+  });
+});

packages/core/src/motion/uikit/timing.ts

@@ -83,6 +83,28 @@ export const press = {
   buttonReleaseMs: 250,
 } as const;
 
+/**
+ * The keyboard notifications' duration, its own export so the keyboard layout
+ * guide reads it without the rest of the table
+ * (`architecture:component-style-authoring` INV6). `timing` composes it under
+ * its table path, `keyboardNotificationMs`, which stays out of the roles.
+ */
+export const keyboardNotification = {
+  /**
+   * The duration the keyboard notifications report
+   * (UIKeyboardAnimationDurationUserInfoKey, with curve 7), show and hide
+   * alike, in ms. The frame follows `springs.keyboard`, cut at this time.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, UIKeyboardWillShow / WillHide / WillChangeFrame read,
+   *   Oct 23 2026
+   */
+  durationMs: 383.3,
+} as const;
+
+// Composed from a binding, so a bundle that reads only the keyboard's
+// duration drops the rest of the table.
+const {durationMs: keyboardNotificationMs} = keyboardNotification;
+
 /**
  * The Reduce Motion fade, its own export so the animator reads it without
  * the rest of the table (`architecture:component-style-authoring` INV6).
@@ -161,15 +183,7 @@ export const timing = {
    *   iPhone 17 Pro, read, Oct 23 2026
    */
   navigationBarHideShowMs: 200,
-  /**
-   * The duration the keyboard notifications report
-   * (UIKeyboardAnimationDurationUserInfoKey, with curve 7), show and hide
-   * alike, in ms. The frame follows `springs.keyboard`, cut at this time.
-   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
-   *   iPhone 17 Pro, UIKeyboardWillShow / WillHide / WillChangeFrame read,
-   *   Oct 23 2026
-   */
-  keyboardNotificationMs: 383.3,
+  keyboardNotificationMs,
   /**
    * Core Animation's implicit animation duration
    * (`CATransaction.animationDuration()`), in ms.