sh3-core 0.15.4 → 0.16.1

package/dist/app/store/UninstallAppDialog.svelte

@@ -54,33 +54,33 @@
   .uninstall-dialog {
     padding: 16px 20px;
     max-width: 460px;
-    color: var(--shell-fg);
-    background: var(--shell-bg);
+    color: var(--sh3-fg);
+    background: var(--sh3-bg);
     font: inherit;
   }
   h2 { margin: 0 0 8px; font-size: 16px; }
   p { margin: 4px 0; font-size: 13px; }
-  .hint { color: var(--shell-fg-muted); font-size: 12px; }
-  .error { color: var(--shell-error, #c33); }
+  .hint { color: var(--sh3-fg-muted); font-size: 12px; }
+  .error { color: var(--sh3-error, #c33); }
   code {
-    font-family: var(--shell-font-mono, monospace);
-    background: var(--shell-bg-elevated);
+    font-family: var(--sh3-font-mono, monospace);
+    background: var(--sh3-bg-elevated);
     padding: 0 4px;
-    border-radius: var(--shell-radius-sm, 3px);
+    border-radius: var(--sh3-radius-sm, 3px);
   }
   .actions { display: flex; gap: 8px; margin-top: 16px; }
   .actions button {
-    background: var(--shell-bg-elevated);
-    color: var(--shell-fg);
-    border: 1px solid var(--shell-border);
-    border-radius: var(--shell-radius-sm, 3px);
+    background: var(--sh3-bg-elevated);
+    color: var(--sh3-fg);
+    border: 1px solid var(--sh3-border);
+    border-radius: var(--sh3-radius-sm, 3px);
     padding: 6px 14px; font: inherit; cursor: pointer;
   }
   .actions button.danger {
-    background: var(--shell-error, #c33);
+    background: var(--sh3-error, #c33);
     color: #fff;
-    border-color: var(--shell-error, #c33);
+    border-color: var(--sh3-error, #c33);
   }
-  .actions button:hover { border-color: var(--shell-accent); }
+  .actions button:hover { border-color: var(--sh3-accent); }
   .actions button:disabled { opacity: 0.5; cursor: not-allowed; }
 </style>

package/dist/app/store/storeShard.svelte.js

@@ -6,7 +6,7 @@
  *   - `sh3-store:browse` — searchable/filterable catalog of available packages
  *
  * Uninstall and update flows for already-installed packages live on the
- * shell home card's context menu (see `sh3core-shard/appActions.ts`); this
+ * sh3 home card's context menu (see `sh3core-shard/appActions.ts`); this
  * shard exposes the underlying operations as verbs (`installVerb`,
  * `uninstallVerb`, `updateVerb`, `appinfoVerb`) and via `storeContext`.
  *

package/dist/app/store/verbs.js

@@ -1,5 +1,5 @@
 /*
- * Store verbs — shell-accessible commands for the sh3-store shard.
+ * Store verbs — sh3-accessible commands for the sh3-store shard.
  *
  * Registered during storeShard.activate() via ctx.registerVerb().
  * Auto-prefixed to sh3-store:install, sh3-store:uninstall, sh3-store:appinfo.

package/dist/apps/lifecycle.d.ts

@@ -63,7 +63,7 @@ export declare function unloadApp(id: string, skipSwitchToHome?: boolean): void;
  */
 export declare function unregisterApp(id: string): void;
 /**
- * Return to the shell home view without unloading the active app. The
+ * Return to the sh3 home view without unloading the active app. The
  * app's shards stay running, its layout proxy stays attached with its
  * refcount hold intact, and its view containers stay alive in the pool.
  * Launching the same app again is a root swap only.

package/dist/apps/lifecycle.js

@@ -2,9 +2,9 @@
  * App lifecycle — launch, unload, return-to-home.
  *
  * All three functions operate on the shared apps registry and the layout
- * manager. `launchApp` is public (shell home calls it); `unloadApp` is
+ * manager. `launchApp` is public (sh3 home calls it); `unloadApp` is
  * internal (called from launchApp when replacing a different app);
- * `returnToHome` is public (shell UI calls it).
+ * `returnToHome` is public (sh3 UI calls it).
  *
  * "Last active app" is persisted in the user state zone under the
  * reserved shardId `__sh3core__:last-app`. The value shape is simply
@@ -147,7 +147,7 @@ export async function launchApp(id, opts = {}) {
             toastManager.notify(`Couldn't launch "${(_e = app.manifest.label) !== null && _e !== void 0 ? _e : id}": ${err instanceof Error ? err.message : String(err)}`, { level: 'error', duration: 6000 });
         }
         catch (_j) {
-            // Toast layer not mounted (e.g. early boot, tests without Shell).
+            // Toast layer not mounted (e.g. early boot, tests without Sh3).
             // Best-effort UX — original error must still propagate.
         }
         throw err;
@@ -236,7 +236,7 @@ export function unregisterApp(id) {
 }
 // ---------- return to home -----------------------------------------------
 /**
- * Return to the shell home view without unloading the active app. The
+ * Return to the sh3 home view without unloading the active app. The
  * app's shards stay running, its layout proxy stays attached with its
  * refcount hold intact, and its view containers stay alive in the pool.
  * Launching the same app again is a root swap only.

package/dist/apps/lifecycle.test.js

@@ -446,8 +446,8 @@ describe('sh3coreShard — sh3.app.reset-layout registration', () => {
             initialLayout: [{ name: 'main', tree: makeTree(makeSlotNode('x')) }],
         }));
         await launchApp('reset-action-1');
-        const { shell } = await import('../shellRuntime.svelte');
-        const actions = shell.actions.listActive();
+        const { sh3 } = await import('../sh3Runtime.svelte');
+        const actions = sh3.actions.listActive();
         const reset = actions.find((a) => a.id === 'sh3.app.reset-layout');
         expect(reset).toBeDefined();
         expect(reset === null || reset === void 0 ? void 0 : reset.label).toBe('Reset Current Layout');
@@ -467,10 +467,10 @@ describe('sh3coreShard — sh3.app.reset-layout registration', () => {
             initialLayout: [{ name: 'main', tree: makeTree(makeSlotNode('x')) }],
         }));
         await launchApp('reset-action-2');
-        const { shell } = await import('../shellRuntime.svelte');
-        expect(shell.actions.listActive().some((a) => a.id === 'sh3.app.reset-layout')).toBe(true);
+        const { sh3 } = await import('../sh3Runtime.svelte');
+        expect(sh3.actions.listActive().some((a) => a.id === 'sh3.app.reset-layout')).toBe(true);
         await returnToHome();
-        expect(shell.actions.listActive().some((a) => a.id === 'sh3.app.reset-layout')).toBe(false);
+        expect(sh3.actions.listActive().some((a) => a.id === 'sh3.app.reset-layout')).toBe(false);
     });
 });
 // ---------------------------------------------------------------------------

package/dist/apps/registry.svelte.d.ts

@@ -6,7 +6,7 @@ import type { App, AppManifest } from './types';
  */
 export declare const registeredApps: Map<string, App>;
 /**
- * Reactive slot tracking the currently-active app id. Null when the shell is
+ * Reactive slot tracking the currently-active app id. Null when the sh3 is
  * showing the home screen or no app has been launched yet. Phase 8 allows at
  * most one active app at a time.
  */
@@ -40,7 +40,7 @@ export declare function __resetBreadcrumbForTest(): void;
  */
 export declare function registerApp(app: App): void;
 /**
- * Reactive snapshot of all registered app manifests. Shell home iterates
+ * Reactive snapshot of all registered app manifests. Sh3 home iterates
  * this to populate its launcher list. Returns only manifests so callers
  * don't reach into app bodies (initialLayout, activate hook) — those are
  * launch-time concerns.

package/dist/apps/registry.svelte.js

@@ -3,7 +3,7 @@
  * single slot for the currently-active app.
  *
  * Registration is called from the host (main.ts glob loop or a future
- * runtime loader). The shell home view reads `listRegisteredApps()`
+ * runtime loader). The sh3 home view reads `listRegisteredApps()`
  * reactively so newly-registered apps appear in the list without
  * reboot. `activeApp` tracks which app (if any) is currently launched;
  * phase 8 allows at most one.
@@ -15,7 +15,7 @@
  */
 export const registeredApps = $state(new Map());
 /**
- * Reactive slot tracking the currently-active app id. Null when the shell is
+ * Reactive slot tracking the currently-active app id. Null when the sh3 is
  * showing the home screen or no app has been launched yet. Phase 8 allows at
  * most one active app at a time.
  */
@@ -51,7 +51,7 @@ export function registerApp(app) {
     registeredApps.set(app.manifest.id, app);
 }
 /**
- * Reactive snapshot of all registered app manifests. Shell home iterates
+ * Reactive snapshot of all registered app manifests. Sh3 home iterates
  * this to populate its launcher list. Returns only manifests so callers
  * don't reach into app bodies (initialLayout, activate hook) — those are
  * launch-time concerns.

package/dist/apps/types.d.ts

@@ -53,7 +53,7 @@ export interface AppManifest {
      */
     layoutVersion: number;
     /**
-     * When true, the app is only visible on the shell home screen in
+     * When true, the app is only visible on the sh3 home screen in
      * admin mode. Server-side routes may still enforce their own auth
      * independently. Defaults to false (visible to everyone).
      */

package/dist/auth/GuestBanner.svelte

@@ -65,15 +65,15 @@
     align-items: center;
     justify-content: center;
     gap: 12px;
-    padding: 6px var(--shell-pad-md, 12px);
-    background: color-mix(in srgb, var(--shell-accent, #7c7cf0) 15%, transparent);
-    border-bottom: 1px solid var(--shell-border, #3a3a5c);
+    padding: 6px var(--sh3-pad-md, 12px);
+    background: color-mix(in srgb, var(--sh3-accent, #7c7cf0) 15%, transparent);
+    border-bottom: 1px solid var(--sh3-border, #3a3a5c);
     font-size: 12px;
-    color: var(--shell-fg, #e0e0e0);
+    color: var(--sh3-fg, #e0e0e0);
   }
   .guest-banner-action {
     padding: 3px 10px;
-    color: var(--shell-bg, #1a1a2e);
+    color: var(--sh3-bg, #1a1a2e);
     font-size: 11px;
     font-weight: 600;
   }
@@ -91,9 +91,9 @@
     flex-direction: column;
     gap: 12px;
     padding: 32px;
-    background: var(--shell-bg-elevated, #252540);
-    border: 1px solid var(--shell-border, #3a3a5c);
-    border-radius: var(--shell-radius-lg, 12px);
+    background: var(--sh3-bg-elevated, #252540);
+    border: 1px solid var(--sh3-border, #3a3a5c);
+    border-radius: var(--sh3-radius-lg, 12px);
     min-width: 300px;
   }
   .guest-signin-form {
@@ -103,32 +103,32 @@
   }
   .guest-signin-input {
     padding: 8px 12px;
-    background: var(--shell-bg, #1a1a2e);
-    color: var(--shell-fg, #e0e0e0);
-    border: 1px solid var(--shell-border, #3a3a5c);
-    border-radius: var(--shell-radius, 6px);
+    background: var(--sh3-bg, #1a1a2e);
+    color: var(--sh3-fg, #e0e0e0);
+    border: 1px solid var(--sh3-border, #3a3a5c);
+    border-radius: var(--sh3-radius, 6px);
     font-size: 13px;
   }
-  .guest-signin-input::placeholder { color: var(--shell-fg-muted, #888); }
+  .guest-signin-input::placeholder { color: var(--sh3-fg-muted, #888); }
   .guest-signin-actions { display: flex; gap: 8px; }
   .guest-signin-btn {
     flex: 1;
     padding: 8px;
-    color: var(--shell-bg, #1a1a2e);
+    color: var(--sh3-bg, #1a1a2e);
     font-weight: 600;
   }
   .guest-signin-btn:disabled { opacity: 0.6; cursor: not-allowed; }
   .guest-signin-cancel {
     padding: 8px 12px;
     background: transparent;
-    color: var(--shell-fg-subtle, #aaa);
-    border: 1px solid var(--shell-border, #3a3a5c);
+    color: var(--sh3-fg-subtle, #aaa);
+    border: 1px solid var(--sh3-border, #3a3a5c);
   }
   .guest-signin-error {
     padding: 6px 10px;
     font-size: 12px;
-    color: var(--shell-error, #d32f2f);
-    background: color-mix(in srgb, var(--shell-error, #d32f2f) 10%, transparent);
-    border-radius: var(--shell-radius, 6px);
+    color: var(--sh3-error, #d32f2f);
+    background: color-mix(in srgb, var(--sh3-error, #d32f2f) 10%, transparent);
+    border-radius: var(--sh3-radius, 6px);
   }
 </style>

package/dist/auth/SignInWall.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
   /**
-   * SignInWall — standalone sign-in screen shown before shell boots.
+   * SignInWall — standalone sign-in screen shown before sh3 boots.
    * Mounted directly to the target element by createShell().
    */
 
@@ -134,8 +134,8 @@
     display: flex;
     align-items: center;
     justify-content: center;
-    background: var(--shell-grad-bg, var(--shell-bg, #1a1a2e));
-    color: var(--shell-fg, #e0e0e0);
+    background: var(--sh3-grad-bg, var(--sh3-bg, #1a1a2e));
+    color: var(--sh3-fg, #e0e0e0);
     font-family: system-ui, sans-serif;
   }
   .signin-card {
@@ -144,15 +144,15 @@
     align-items: center;
     gap: 16px;
     padding: 48px 40px;
-    background: var(--shell-grad-bg-elevated, var(--shell-bg-elevated, #252540));
-    border: 1px solid var(--shell-border, #3a3a5c);
-    border-radius: var(--shell-radius-lg, 12px);
+    background: var(--sh3-grad-bg-elevated, var(--sh3-bg-elevated, #252540));
+    border: 1px solid var(--sh3-border, #3a3a5c);
+    border-radius: var(--sh3-radius-lg, 12px);
     min-width: 320px;
   }
   .signin-brand {
     margin: 0 0 8px;
     font-size: 42px;
-    color: var(--shell-accent, #7c7cf0);
+    color: var(--sh3-accent, #7c7cf0);
     letter-spacing: 2px;
   }
   .signin-form {
@@ -163,18 +163,18 @@
   }
   .signin-input {
     padding: 10px 14px;
-    background: var(--shell-bg, #1a1a2e);
-    color: var(--shell-fg, #e0e0e0);
-    border: 1px solid var(--shell-border, #3a3a5c);
-    border-radius: var(--shell-radius, 6px);
+    background: var(--sh3-bg, #1a1a2e);
+    color: var(--sh3-fg, #e0e0e0);
+    border: 1px solid var(--sh3-border, #3a3a5c);
+    border-radius: var(--sh3-radius, 6px);
     font-size: 14px;
   }
   .signin-input::placeholder {
-    color: var(--shell-fg-muted, #888);
+    color: var(--sh3-fg-muted, #888);
   }
   .signin-btn {
     padding: 10px 16px;
-    color: var(--shell-bg, #1a1a2e);
+    color: var(--sh3-bg, #1a1a2e);
     font-weight: 600;
     font-size: 14px;
   }
@@ -184,7 +184,7 @@
   }
   .signin-link {
     background: none;
-    color: var(--shell-accent, #7c7cf0);
+    color: var(--sh3-accent, #7c7cf0);
     font-size: 13px;
     padding: 0;
   }
@@ -194,9 +194,9 @@
   .signin-error {
     padding: 8px 12px;
     font-size: 13px;
-    color: var(--shell-error, #d32f2f);
-    background: color-mix(in srgb, var(--shell-error, #d32f2f) 10%, transparent);
-    border-radius: var(--shell-radius, 6px);
+    color: var(--sh3-error, #d32f2f);
+    background: color-mix(in srgb, var(--sh3-error, #d32f2f) 10%, transparent);
+    border-radius: var(--sh3-radius, 6px);
     width: 100%;
     text-align: center;
   }

package/dist/auth/auth.svelte.d.ts

@@ -4,7 +4,7 @@
  * The boot flow (createShell) calls initFromBoot() with the server's
  * boot config. After that, login/logout call the server and update
  * the reactive state. isAdmin/isGuest/isAuthenticated are reactive
- * getters consumed by shell components.
+ * getters consumed by sh3 components.
  *
  * .svelte.ts because it uses $state for reactive auth status.
  */

package/dist/auth/auth.svelte.js

@@ -4,7 +4,7 @@
  * The boot flow (createShell) calls initFromBoot() with the server's
  * boot config. After that, login/logout call the server and update
  * the reactive state. isAdmin/isGuest/isAuthenticated are reactive
- * getters consumed by shell components.
+ * getters consumed by sh3 components.
  *
  * .svelte.ts because it uses $state for reactive auth status.
  */

package/dist/boot/satellitePayload.js

@@ -1,5 +1,5 @@
 /*
- * Satellite payload — what a host shell tells a freshly-spawned satellite
+ * Satellite payload — what a host sh3 tells a freshly-spawned satellite
  * window to render. Encoded as URL-safe base64 JSON in the `payload` query
  * param of the satellite's URL.
  */

package/dist/build.d.ts

@@ -36,7 +36,34 @@ export interface Sh3ArtifactOptions {
     serverEntry?: string;
     /** Override manifest fields not extractable from code (description, author, requires). */
     manifest?: Partial<Pick<ArtifactManifest, 'description' | 'author' | 'requires'>>;
+    /**
+     * Append a semver build-metadata suffix to the artifact `version` written
+     * into `manifest.json`. Per ADR-013 the package.json version remains the
+     * release-version source; this option layers an artifact-level counter on
+     * top so test iterations and hotfix variants of the same release can ship
+     * as distinct artifacts without bumping the release number.
+     *
+     *   - omit / undefined: artifact version equals package.json.version (default).
+     *   - 'auto': resolved from `git describe --tags --abbrev=0` →
+     *     `git rev-list --count <tag>..HEAD`. Suffix is omitted when the
+     *     count is 0 (canonical release) or when git is unavailable.
+     *   - string: literal suffix. Empty string is treated as no suffix.
+     *
+     * Example: package.json says "1.2.3", git is 4 commits past `v1.2.3` →
+     * manifest.json says `"version": "1.2.3+4"`.
+     */
+    buildSuffix?: 'auto' | string;
 }
+/**
+ * Compose a release version (`pkgVersion`) with an optional semver
+ * build-metadata suffix. Pure function — no I/O — for testability.
+ *
+ * Returns `pkgVersion` unchanged when `suffix` is empty/undefined.
+ * Throws when `pkgVersion` already carries build metadata or when the
+ * suffix is not a valid semver build-metadata identifier
+ * (dot-separated `[0-9A-Za-z-]+`).
+ */
+export declare function composeArtifactVersion(pkgVersion: string, suffix: string | undefined): string;
 /**
  * Vite plugin that produces a distributable artifact directory after build.
  *

package/dist/build.js

@@ -17,6 +17,7 @@
  *   });
  */
 import { readFileSync, writeFileSync, unlinkSync, readdirSync, copyFileSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
 import { join } from 'node:path';
 /**
  * Vite plugin that inlines extracted CSS into the JS bundle.
@@ -83,6 +84,52 @@ export function sh3CssInline() {
         },
     };
 }
+/**
+ * Compose a release version (`pkgVersion`) with an optional semver
+ * build-metadata suffix. Pure function — no I/O — for testability.
+ *
+ * Returns `pkgVersion` unchanged when `suffix` is empty/undefined.
+ * Throws when `pkgVersion` already carries build metadata or when the
+ * suffix is not a valid semver build-metadata identifier
+ * (dot-separated `[0-9A-Za-z-]+`).
+ */
+export function composeArtifactVersion(pkgVersion, suffix) {
+    if (!suffix)
+        return pkgVersion;
+    if (pkgVersion.includes('+')) {
+        throw new Error(`[sh3-artifact] package.json version "${pkgVersion}" already contains semver build metadata; cannot append additional suffix "${suffix}".`);
+    }
+    if (!/^[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*$/.test(suffix)) {
+        throw new Error(`[sh3-artifact] buildSuffix "${suffix}" is not a valid semver build-metadata identifier (expected dot-separated [0-9A-Za-z-]+).`);
+    }
+    return `${pkgVersion}+${suffix}`;
+}
+/**
+ * Resolve the auto build suffix from git: count of commits between the
+ * latest reachable tag and HEAD. Returns '' if git is unavailable, no
+ * tags exist, or HEAD is exactly at the tag (canonical release).
+ */
+function resolveAutoBuildSuffix() {
+    try {
+        const lastTag = execSync('git describe --tags --abbrev=0', {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (!lastTag)
+            return '';
+        const count = execSync(`git rev-list --count ${lastTag}..HEAD`, {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        const n = parseInt(count, 10);
+        if (!Number.isFinite(n) || n <= 0)
+            return '';
+        return String(n);
+    }
+    catch (_a) {
+        return '';
+    }
+}
 /**
  * Vite plugin that produces a distributable artifact directory after build.
  *
@@ -224,6 +271,17 @@ export function sh3Artifact(options = {}) {
                 throw new Error('[sh3-artifact] Missing "version" in package.json. Per ADR-013 the package '
                     + 'version is read from package.json, not from the source manifest.');
             }
+            // --- Resolve build suffix and compose the artifact version ---
+            // Per ADR-013 amendment: package.json holds the release version;
+            // sh3Artifact may layer a build-metadata suffix on top.
+            let resolvedSuffix = '';
+            if (options.buildSuffix === 'auto') {
+                resolvedSuffix = resolveAutoBuildSuffix();
+            }
+            else if (typeof options.buildSuffix === 'string') {
+                resolvedSuffix = options.buildSuffix;
+            }
+            const artifactVersion = composeArtifactVersion(pkgVersion, resolvedSuffix);
             // --- Write manifest.json ---
             const overrides = (_c = options.manifest) !== null && _c !== void 0 ? _c : {};
             const finalDescription = (_d = overrides.description) !== null && _d !== void 0 ? _d : pkgDescription;
@@ -234,7 +292,7 @@ export function sh3Artifact(options = {}) {
             if (!finalAuthor) {
                 throw new Error('[sh3-artifact] Missing "author". Add it to package.json or pass it via sh3Artifact({ manifest: { author } }).');
             }
-            const manifest = Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: pkgVersion, contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), overrides);
+            const manifest = Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: artifactVersion, contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), overrides);
             writeFileSync(join(outDir, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\n');
             // --- Log summary ---
             const files = ['manifest.json', 'client.js'];

package/dist/build.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { composeArtifactVersion } from './build';
+describe('composeArtifactVersion', () => {
+    it('returns pkgVersion unchanged when suffix is undefined', () => {
+        expect(composeArtifactVersion('1.2.3', undefined)).toBe('1.2.3');
+    });
+    it('returns pkgVersion unchanged when suffix is empty string', () => {
+        expect(composeArtifactVersion('1.2.3', '')).toBe('1.2.3');
+    });
+    it('appends a numeric suffix as build metadata', () => {
+        expect(composeArtifactVersion('1.2.3', '42')).toBe('1.2.3+42');
+    });
+    it('appends dotted alphanumeric suffix as build metadata', () => {
+        expect(composeArtifactVersion('1.2.3', 'build.42')).toBe('1.2.3+build.42');
+    });
+    it('composes onto a prerelease version (semver allows -pre+meta)', () => {
+        expect(composeArtifactVersion('1.2.3-rc.1', '7')).toBe('1.2.3-rc.1+7');
+    });
+    it('throws when pkgVersion already has build metadata', () => {
+        expect(() => composeArtifactVersion('1.2.3+local', '42')).toThrow(/already contains semver build metadata/);
+    });
+    it('throws when suffix contains an invalid character', () => {
+        expect(() => composeArtifactVersion('1.2.3', 'build_42')).toThrow(/not a valid semver build-metadata identifier/);
+    });
+    it('throws when suffix has empty dot-separated identifier', () => {
+        expect(() => composeArtifactVersion('1.2.3', 'build..42')).toThrow(/not a valid semver build-metadata identifier/);
+    });
+    it('throws when suffix starts with a plus', () => {
+        expect(() => composeArtifactVersion('1.2.3', '+42')).toThrow(/not a valid semver build-metadata identifier/);
+    });
+});

package/dist/color/api.d.ts

@@ -22,7 +22,7 @@ export interface ColorContribution {
     priority?: number;
     open(opts: ColorPickOptions): Promise<string | null>;
 }
-/** Shell-level color API, mounted at `shell.color`. */
+/** Sh3-level color API, mounted at `sh3.color`. */
 export interface ColorApi {
     /**
      * Open a color picker. Resolves with the chosen color as '#rrggbb'

package/dist/color/api.js

@@ -2,7 +2,7 @@
  * Public types for the color-picker contribution point.
  *
  * A contribution registered at COLOR_PICKER_POINT is picked by the
- * primitive in ./primitive.ts when `shell.color.pick()` is called.
+ * primitive in ./primitive.ts when `sh3.color.pick()` is called.
  * The native <input type="color"> fallback is inlined there at priority 0;
  * contributed pickers typically register at priority >= 10.
  */

package/dist/color/{shell-api.js → sh3-api.js}

@@ -1,9 +1,9 @@
 /*
- * shell.color assembled API.
+ * sh3.color assembled API.
  *
  * The selector + inlined native fallback live in primitive.ts;
- * this file just binds `pick` onto the object exposed on the shell
- * singleton, mirroring conflicts/shell-api.ts.
+ * this file just binds `pick` onto the object exposed on the sh3
+ * singleton, mirroring conflicts/sh3-api.ts.
  */
 import { pickColor } from './primitive';
 export const colorApi = {

package/dist/conflicts/ConflictModal.svelte

@@ -16,7 +16,7 @@
       skipped: string[],
     ) => void;
     onCancel: () => void;
-    /** Provided by shell.modal.open wrapping; we must call to actually close. */
+    /** Provided by sh3.modal.open wrapping; we must call to actually close. */
     close: () => void;
   }
   const props: Props = $props();

package/dist/conflicts/ConflictModal.svelte.d.ts

@@ -11,7 +11,7 @@ interface Props {
         meta?: Record<string, unknown>;
     }>, skipped: string[]) => void;
     onCancel: () => void;
-    /** Provided by shell.modal.open wrapping; we must call to actually close. */
+    /** Provided by sh3.modal.open wrapping; we must call to actually close. */
     close: () => void;
 }
 declare const ConflictModal: import("svelte").Component<Props, {}, "">;