refactor: replace overloaded surface terminology

packages/client/ui-slots/src/renderer.ts

@@ -27,7 +27,7 @@ export interface LocaleFace extends HostObservable<{ revision: number }> {
   bind(ns: string): Translate
 }
 
-/** Minimal observable surface for host-provided standard-kit data sources. */
+/** Minimal observable API for host-provided standard-kit data sources. */
 export interface HostObservable<T> {
   getSnapshot(): T
   subscribe(fn: () => void): () => void
@@ -97,7 +97,7 @@ export interface RenderOpts {
   hookContext?: unknown
 }
 
-/** Host surface the runtime SlotsService presents to the installed renderer. */
+/** Host API the runtime SlotsService presents to the installed renderer. */
 export interface SlotRendererHost {
   /**
    * Subscribe to a key's registration changes (microtask-batched).
@@ -167,8 +167,8 @@ export interface SlotRendererHost {
 /** The installation contract: runtime owns install()/renderSlot(); web-react implements rendering. */
 export interface SlotRenderer {
   /**
-   * Render the root slot tree over the host surface (the only ctx-level entry).
-   * @param host - the installing service's host surface.
+   * Render the root slot tree over the host API (the only ctx-level entry).
+   * @param host - the installing service's host API.
    * @param ownerProps - owner props from the shell's renderSlot('root', ...) call.
    * @returns the rendered tree.
    */

packages/client/ui-slots/tests/core.spec.ts

@@ -1,6 +1,6 @@
 // SlotCore terminal-design behavior: the single register composition API —
 // a-priori 'root', children declaration/authorization, load-time validation,
-// one-axis lifecycle cascade, store scope pinning, subscription surface.
+// one-axis lifecycle cascade, store scope pinning, subscription API.
 import { describe, expect, it, vi } from 'vitest'
 import type { SlotComponent, StoreHandle } from '@deepseek-ai/dsh-client-ui-slots'
 import { SlotCore } from '@deepseek-ai/dsh-client-ui-slots'
@@ -230,7 +230,7 @@ describe('store scope pinning', () => {
   })
 })
 
-describe('subscription surface', () => {
+describe('subscription API', () => {
   it('tracks declaration epochs separately from ordinary entry mutations', () => {
     const core = new SlotCore()
     expect(core.declarationEpoch('root')).toBe(1)

packages/client/ui-slots/tests/dynamic-keys.spec.ts

@@ -5,8 +5,8 @@ import { SlotCore } from '@deepseek-ai/dsh-client-ui-slots'
 
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface SlotMap {
-    'surface.a': { kind: 'single'; scope: 'root' }
-    'surface.b': { kind: 'single'; scope: 'root' }
+    'dynamic.a': { kind: 'single'; scope: 'root' }
+    'dynamic.b': { kind: 'single'; scope: 'root' }
     'surface.injected': { kind: 'single'; scope: 'root'; inject: { token: string } }
   }
 }
@@ -16,17 +16,17 @@ const Comp: SlotComponent<object> = () => null
 describe('dynamic-key escape hatch', () => {
   it('specDynamic reads wide-typed specs for string keys; undefined while undeclared', () => {
     const core = new SlotCore()
-    expect(core.specDynamic('surface.a')).toBeUndefined()
-    core.register({ name: 'root', children: { 'surface.a': { kind: 'single', scope: 'root' } } }, Comp as never)
-    expect(core.specDynamic('surface.a')).toEqual({ kind: 'single', scope: 'root' })
+    expect(core.specDynamic('dynamic.a')).toBeUndefined()
+    core.register({ name: 'root', children: { 'dynamic.a': { kind: 'single', scope: 'root' } } }, Comp as never)
+    expect(core.specDynamic('dynamic.a')).toEqual({ kind: 'single', scope: 'root' })
     expect(core.specDynamic('never.declared')).toBeUndefined()
   })
 
   it('spec() narrows by SlotMap key', () => {
     const core = new SlotCore()
-    core.register({ name: 'root', children: { 'surface.a': { kind: 'single', scope: 'root' } } }, Comp as never)
-    expect(core.spec('surface.a')).toEqual({ kind: 'single', scope: 'root' })
-    expect(core.spec('surface.b')).toBeUndefined()
+    core.register({ name: 'root', children: { 'dynamic.a': { kind: 'single', scope: 'root' } } }, Comp as never)
+    expect(core.spec('dynamic.a')).toEqual({ kind: 'single', scope: 'root' })
+    expect(core.spec('dynamic.b')).toBeUndefined()
   })
 
   it('records the parent-declared Slot inject on the runtime spec', () => {
@@ -41,9 +41,9 @@ describe('dynamic-key escape hatch', () => {
 
   it('entries/getVersion on an untouched key return the frozen empty array and 0', () => {
     const core = new SlotCore()
-    expect(core.entries('surface.b')).toHaveLength(0)
-    expect(core.entries('surface.b')).toBe(core.entries('surface.b'))
-    expect(core.getVersion('surface.b')).toBe(0)
+    expect(core.entries('dynamic.b')).toHaveLength(0)
+    expect(core.entries('dynamic.b')).toBe(core.entries('dynamic.b'))
+    expect(core.getVersion('dynamic.b')).toBe(0)
   })
 
   it('isLive is false for entries the core never held', () => {

packages/client/ui-slots/tests/type-chain.spec.tsx

@@ -103,7 +103,7 @@ declare function NarrowTakeover(props: PropsRuntime<'chain.takeover'> & { matche
 
 describe('terminal-design type chain', () => {
   it('holds the positive chain and the compile-time negatives', () => {
-    // Everything below is compile-surface only.
+    // Everything below is compile-time only.
     const samples = (core: SlotCore, chat: ChatHandle, fp: FrameProps, cp: ConvProps, acts: BoundActions<ChatHandle>) => {
       // ── positive chain ─────────────────────────────────────────────
       // Frame: children + factory store + inject; actions arrive baked.