active-uix: uix.runtime(morfo, sources) auto-injects dom + semantic

Adds a single convenience method on `ActiveUix` so soma providers stop
duplicating the `dom: this.soma.dom, semantic: this.soma.semantic`
boilerplate at every `createMorfoRuntime` callsite.

Before (8 providers, identical lines):

    this.runtime = createMorfoRuntime(dialogMorfo, {
        dom: this.soma.dom,           // ← duplicated everywhere
        semantic: this.soma.semantic, // ← duplicated everywhere
        states: { … },
        props: { … },
        events: { … }
    })

After:

    this.runtime = this.soma.uix.runtime(dialogMorfo, {
        states: { … },
        props: { … },
        events: { … }
    })

The implementation is a thin convenience — internally `uix.runtime()`
calls `createMorfoRuntime(morfo, { dom: this.dom, semantic: this.semantic,
…sources })`. No registry, no scope ids, no per-instance lifecycle to
track. Per-provider runtime ownership unchanged. The user explicitly
chose this minimal fix over a "single shared runtime + scope handles"
design after weighing the tradeoffs.

Migrated callsites: avatar, collapsible, dialog, drawer, popover,
switch, toast, toggle (8 providers, ~10 callsites including toast's
two — root + item). The `createMorfoRuntime` named import dropped from
each (only `MorfoRuntime` type kept where the field is annotated).

3 new tests on `active-uix.svelte.test.ts`:
  - returns a MorfoRuntime with auto-injected services
  - caller does not pass dom or semantic
  - attach mode uses the external app's dom + semantic

Verified: vitest 17/17 active-uix (was 14), 211/211 UIX, smoke 68/68,
morfo-check 66/66.

src/uix/active-uix/active-uix.svelte.test.ts

@@ -212,6 +212,75 @@ describe('attachActiveUix (integration mode)', () => {
 	})
 })
 
+// ── uix.runtime(morfo, sources) ─────────────────────────────────────────────
+
+describe('uix.runtime(morfo, sources)', () => {
+	const minimalMorfo = {
+		name: 'TestComp',
+		kebab: 'test-comp',
+		scope: ['soma'],
+		events: [],
+		parts: [
+			{
+				name: 'Provider',
+				kebab: 'provider',
+				archetype: 'provider',
+				kind: 'virtual',
+				defaultElement: 'none',
+				optional: false,
+				states: [],
+				data: [],
+				aria: []
+			}
+		]
+	} as const
+
+	it('returns a MorfoRuntime with dom + semantic auto-injected from the uix', () => {
+		const uix = createActiveUix({ lang: minimalLang })
+		try {
+			const rt = uix.runtime(minimalMorfo, {
+				states: {},
+				props: {},
+				parts: {},
+				events: {}
+			})
+			expect(rt).toBeDefined()
+			expect(typeof rt.trigger).toBe('function')
+			expect(typeof rt.registerPart).toBe('function')
+			expect(typeof rt.partProps).toBe('function')
+		} finally {
+			uix.dispose()
+		}
+	})
+
+	it('caller does not need to pass dom or semantic — they come from the uix', () => {
+		const uix = createActiveUix({ lang: minimalLang })
+		try {
+			// Same call as above. The point of the test: the call type-checks
+			// without `dom` or `semantic` keys. If the runtime were missing
+			// either, registerPart / trigger would throw at runtime.
+			const rt = uix.runtime(minimalMorfo, {})
+			expect(rt).toBeDefined()
+		} finally {
+			uix.dispose()
+		}
+	})
+
+	it('attach mode: runtime uses the external app\'s dom + semantic', () => {
+		const app = createActiveApp({
+			services: defineUixServices({ lang: minimalLang })
+		})
+		const uix = attachActiveUix(app as unknown as ActiveApp)
+		try {
+			const rt = uix.runtime(minimalMorfo, {})
+			expect(rt).toBeDefined()
+		} finally {
+			uix.dispose()
+			app.dispose()
+		}
+	})
+})
+
 // ── Cross-mode parity ───────────────────────────────────────────────────────
 
 describe('cross-mode parity', () => {

src/uix/active-uix/active-uix.svelte.ts

@@ -29,6 +29,7 @@ import { createActiveDom, type ActiveDom } from '$adom'
 import { createActiveFrontend, type ActiveFrontend } from '$frontend/active-frontend.svelte'
 import { createActiveFormat, type ActiveFormat } from '$format'
 import { EngineSemantic } from '$uix/sema'
+import { createMorfoRuntime, type Morfo, type MorfoRuntime, type MorfoRuntimeSources } from '$uix/morfo'
 import { CodeError, errCode, moduleSeed, type ErrCode, type ModuleSeed } from '$libs/errs'
 
 import { componentLangs } from '$soma/core/langs'
@@ -268,6 +269,22 @@ class ActiveUixImpl implements ActiveUix {
 		return this.init.mode === 'standalone' ? this.init.prefs : this.init.app.prefs
 	}
 
+	/**
+	 * Build a `MorfoRuntime` for a component instance. Auto-injects
+	 * `dom` + `semantic` from the uix; caller passes the per-instance
+	 * `states`, `props`, `parts`, `events`, `actions`.
+	 */
+	runtime<M extends Morfo>(
+		morfo: M,
+		sources: Omit<MorfoRuntimeSources, 'dom' | 'semantic'>
+	): MorfoRuntime {
+		return createMorfoRuntime(morfo, {
+			dom: this.dom,
+			semantic: this.semantic,
+			...sources
+		})
+	}
+
 	dispose(): void {
 		if (this.disposed) return
 		this.disposed = true

src/uix/active-uix/types.ts

@@ -21,6 +21,7 @@ import type { ActiveTimers } from '$timer'
 import type { ActivePrefs } from '$prefs'
 import type { LangNode, SupportedLocale } from '$libs/lang'
 import type { EngineSemantic, EngineSemanticOptions } from '$uix/sema'
+import type { Morfo, MorfoRuntime, MorfoRuntimeSources } from '$uix/morfo'
 
 /**
  * Lang configuration. Required because every UIX consumer needs at
@@ -102,6 +103,20 @@ export interface ActiveUix {
 	// ── UIX-level config ───────────────────────────────────────────────
 	readonly somaPortalTo: string | HTMLElement | undefined
 
+	/**
+	 * Instantiates a `MorfoRuntime` for a component, auto-injecting
+	 * `dom` and `semantic` from the uix. The caller (typically a soma
+	 * provider) supplies only the per-instance `states`, `props`,
+	 * `parts`, `events` and `actions` sources.
+	 *
+	 * Eliminates the duplicate `dom: this.soma.dom, semantic:
+	 * this.soma.semantic` boilerplate every provider used to write.
+	 */
+	runtime<M extends Morfo>(
+		morfo: M,
+		sources: Omit<MorfoRuntimeSources, 'dom' | 'semantic'>
+	): MorfoRuntime
+
 	/**
 	 * Underlying `ActiveApp` — present ONLY when `ActiveUix` was
 	 * obtained via `attachActiveUix(app)`. In standalone mode

src/uix/soma/components/avatar/avatar-provider.svelte.ts

@@ -12,7 +12,7 @@ import type {
 } from '$soma/provider';
 import type { OnChangeFn } from '../../types';
 import { Soma } from '../../core/soma.svelte';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 import type { HTMLImgAttributes } from 'svelte/elements';
 import type { AvatarLoadingStatus, AvatarProps, AvatarImageProps } from './types';
 
@@ -53,8 +53,7 @@ export class AvatarProvider extends Provider<AvatarOpts> {
 		super(opts, { morfo: avatarMorfo, part: 'provider' }, AvatarProvider.ctx);
 
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(avatarMorfo, {
-			dom: soma.dom,
+		this.runtime = soma.uix.runtime(avatarMorfo, {
 			props: {
 				status: () => opts.status.current
 			}

src/uix/soma/components/collapsible/collapsible-provider.svelte.ts

@@ -10,7 +10,7 @@ import {
 } from '$libs/reactive';
 import type { SomaMouseEvent } from '../../types';
 import { Soma } from '../../core/soma.svelte';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 import { collapsibleMorfo } from '../../../morfo/components/collapsible';
 
 createAttrs(collapsibleMorfo);
@@ -44,8 +44,7 @@ export class CollapsibleProvider extends Provider<CollapsibleOpts> {
 		super(opts, { morfo: collapsibleMorfo, part: 'provider' }, CollapsibleProvider.ctx);
 
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(collapsibleMorfo, {
-			dom: soma.dom,
+		this.runtime = soma.uix.runtime(collapsibleMorfo, {
 			states: {
 				open: () => opts.open.current
 			},

src/uix/soma/components/dialog/dialog-provider.svelte.ts

@@ -22,7 +22,7 @@ import { ScrollLock } from '../../layers/scroll-lock.svelte';
 import { TextSelection } from '../../layers/text-selection.svelte';
 
 import { dialogMorfo } from '../../../morfo/components/dialog';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 
 // ── Provider (root) ─────────────────────────────────────────────────────────
 
@@ -112,9 +112,7 @@ export class DialogProvider extends Provider<DialogOpts> {
 			ref: this.overlayRef
 		});
 
-		this.runtime = createMorfoRuntime(dialogMorfo, {
-			dom: this.soma.dom,
-			semantic: this.soma.semantic,
+		this.runtime = this.soma.uix.runtime(dialogMorfo, {
 			states: { open: () => opts.open.current },
 			props: {
 				disabled: () => opts.disabled.current,

src/uix/soma/components/drawer/drawer-provider.svelte.ts

@@ -39,7 +39,7 @@ import type { DragDirection } from '../../layers/gesture';
 import { DRAWER_LANGS } from './langs';
 
 import { drawerMorfo } from '../../../morfo/components/drawer';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 
 const attrs = createAttrs(drawerMorfo);
 registerContract(drawerMorfo);
@@ -147,9 +147,7 @@ export class DrawerProvider extends Provider<DrawerOpts> {
 			ref: this.overlayRef
 		});
 
-		this.runtime = createMorfoRuntime(drawerMorfo, {
-			dom: this.soma!.dom,
-			semantic: this.soma!.semantic,
+		this.runtime = this.soma!.uix.runtime(drawerMorfo, {
 			states: { open: () => opts.open.current },
 			props: {
 				disabled: () => opts.disabled.current,

src/uix/soma/components/popover/popover-provider.svelte.ts

@@ -42,7 +42,7 @@ import {
 } from '../../layers/floating';
 
 import { popoverMorfo } from '../../../morfo/components/popover';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 
 const attrs = createAttrs(popoverMorfo);
 registerContract(popoverMorfo);
@@ -99,9 +99,7 @@ export class PopoverProvider extends Provider<PopoverOpts> {
 			ref: this.overlayRef
 		});
 
-		this.runtime = createMorfoRuntime(popoverMorfo, {
-			dom: this.soma!.dom,
-			semantic: this.soma!.semantic,
+		this.runtime = this.soma!.uix.runtime(popoverMorfo, {
 			states: { open: () => opts.open.current },
 			props: { modal: () => opts.modal.current },
 			events: {

src/uix/soma/components/switch/switch-provider.svelte.ts

@@ -8,7 +8,7 @@ import type {
 } from '$soma/provider';
 import type { OnChangeFn, SomaMouseEvent } from '../../types';
 import { Soma } from '../../core/soma.svelte';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 
 import { switchMorfo } from '../../../morfo/components/switch';
 import type { SwitchProps } from './types';
@@ -43,8 +43,7 @@ export class SwitchProvider extends Provider<SwitchOpts> {
 		super(opts, { morfo: switchMorfo, part: 'provider' }, SwitchProvider.ctx);
 
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(switchMorfo, {
-			dom: soma.dom,
+		this.runtime = soma.uix.runtime(switchMorfo, {
 			states: {
 				checked: () => opts.checked.current
 			},

src/uix/soma/components/toast/toast-provider.svelte.ts

@@ -13,7 +13,7 @@ import {
 import type { SomaMouseEvent } from '../../types';
 import { Soma } from '../../core/soma.svelte';
 import { isBrowser } from '$libs/dom';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 import { Presence } from '../../layers/presence.svelte';
 import type { Toaster, ToastData, SwipeDirection } from './toaster.svelte';
 
@@ -54,9 +54,7 @@ export class ToastProvider extends Provider<ToastProviderOpts> {
 		// Root-scope runtime — only the Viewport part registers here. Item and
 		// its children get their own runtime per-instance (see ToastItemProvider).
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(toastMorfo, {
-			dom: soma.dom,
-			semantic: soma.semantic,
+		this.runtime = soma.uix.runtime(toastMorfo, {
 			props: {
 				label: () => opts.label.current
 			}
@@ -218,9 +216,7 @@ export class ToastItemProvider extends Provider<ToastItemOpts> {
 		// perceptual signal first, then this callback mutates state, then the
 		// item's effect re-derives data-state etc. via dom.apply.
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(toastMorfo, {
-			dom: soma.dom,
-			semantic: soma.semantic,
+		this.runtime = soma.uix.runtime(toastMorfo, {
 			states: {
 				open: () => this.isOpen
 			},

src/uix/soma/components/toggle/toggle-provider.svelte.ts

@@ -8,7 +8,7 @@ import type {
 } from '$soma/provider';
 import type { OnChangeFn, SomaMouseEvent } from '../../types';
 import { Soma } from '../../core/soma.svelte';
-import { createMorfoRuntime, type MorfoRuntime } from '$uix/morfo';
+import { type MorfoRuntime } from '$uix/morfo';
 import { FieldProvider } from '../field/field-provider.svelte';
 
 import { toggleMorfo } from '../../../morfo/components/toggle';
@@ -63,8 +63,7 @@ export class ToggleProvider extends Provider<ToggleOpts> {
 		// aria-disabled, etc.); this provider keeps only handler wiring + the
 		// HTML `disabled` attribute (not a morfo concern).
 		const soma = Soma.require();
-		this.runtime = createMorfoRuntime(toggleMorfo, {
-			dom: soma.dom,
+		this.runtime = soma.uix.runtime(toggleMorfo, {
 			states: {
 				on: () => opts.pressed.current
 			},