@forgeax/interface 0.4.1

package/dist/package/browser/components/ActivityRail/ActivityRail.css

@@ -0,0 +1,294 @@
+/* Shell-level persistent activity rail. Vertical icon+label nav:
+ *   top fixed (编辑器 / Agents)
+ *   middle = user-pinned plugins (catalog order)
+ *   bottom = More (⋯)
+ * Fixed left column that survives Scene/AI dock-layout switches.
+ *
+ * Styling aligned with product prototype: 52px item, 22px stroke icon,
+ * 8.5px label, accent-dim active. */
+.activity-rail {
+  flex: 0 0 64px;
+  min-height: 0;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  overflow: hidden;
+  padding: 6px 0 12px;
+  position: relative;
+  background: var(--color-background-base);
+  /* Match the dockview grid's 6px inter-group gap: open a canvas-dark gutter on
+     each side (studio-body paints the canvas behind) instead of a hairline
+     border, so the plugin rail sits like a floating dock cell. */
+  margin: 0 6px;
+}
+.activity-rail::-webkit-scrollbar { width: 0; }
+.activity-rail-group {
+  flex: 0 0 auto;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 2px;
+  width: 100%;
+  padding: 6px 0;
+}
+.activity-rail-group + .activity-rail-group {
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+}
+.activity-rail-group[data-category="pinned"] {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+  overflow-x: hidden;
+}
+.activity-rail-group[data-category="pinned"]::-webkit-scrollbar {
+  width: 0;
+}
+.activity-rail-group--more {
+  margin-top: auto;
+  border-top: 0 !important;
+}
+.activity-rail-item {
+  width: 52px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 3px;
+  padding: 6px 2px;
+  border: 1px solid transparent;
+  border-radius: 9px;
+  background: transparent;
+  color: rgba(255, 255, 255, 0.34);
+  cursor: pointer;
+  font-family: inherit;
+  transition: background 140ms ease, color 140ms ease, border-color 140ms ease;
+}
+.activity-rail-item:hover {
+  background: rgba(255, 255, 255, 0.06);
+  color: rgba(255, 255, 255, 0.92);
+}
+.activity-rail-item.active {
+  background: rgba(212, 255, 72, 0.12);
+  border-color: rgba(212, 255, 72, 0.34);
+  color: var(--color-brand-primary); /* #D4FF48 荧光黄绿, matches prototype --accent */
+}
+.activity-rail-item-ic {
+  width: 22px;
+  height: 22px;
+  display: grid;
+  place-items: center;
+  flex-shrink: 0;
+}
+.activity-rail-item-lb {
+  max-width: 50px;
+  font-size: 8.5px;
+  line-height: 1.05;
+  letter-spacing: 0.01em;
+  text-align: center;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.activity-rail-item:focus-visible {
+  outline: 2px solid rgba(255, 255, 255, 0.55);
+  outline-offset: -1px;
+}
+
+/* Plugin hover card — mirrors the studio demo, intentionally omitting
+ * version / install / update state. */
+.activity-rail-plugin-tip {
+  width: 214px;
+  padding: 12px 13px;
+  border-radius: 11px;
+  border-color: var(--color-border-default);
+  background: var(--color-background-elevated);
+  box-shadow: 0 14px 34px rgba(0, 0, 0, 0.5);
+}
+.activity-rail-plugin-tip-title {
+  font-size: 13px;
+  font-weight: 700;
+  line-height: 1.25;
+  color: var(--color-text-primary);
+}
+.activity-rail-plugin-tip-category {
+  margin-top: 3px;
+  font-size: 10px;
+  line-height: 1.2;
+  letter-spacing: 0.02em;
+  color: var(--color-brand-primary);
+}
+.activity-rail-plugin-tip-description {
+  margin-top: 8px;
+  font-size: 11px;
+  line-height: 1.55;
+  color: rgba(255, 255, 255, 0.62);
+}
+
+/* ── More plugins popover ── */
+.activity-rail-more {
+  z-index: var(--z-menu, 10100);
+  width: 300px;
+  max-height: min(70vh, 560px);
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.10);
+  background: color-mix(in srgb, var(--color-background-base) 92%, #000);
+  box-shadow: 0 16px 40px rgba(0, 0, 0, 0.45);
+  color: rgba(255, 255, 255, 0.88);
+}
+.activity-rail-more-hd {
+  flex: 0 0 auto;
+  padding: 12px 14px 8px;
+  font-size: 13px;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+}
+.activity-rail-more-search {
+  flex: 0 0 auto;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin: 0 10px 10px;
+  padding: 7px 10px;
+  border-radius: 8px;
+  border: 1px solid rgba(255, 255, 255, 0.10);
+  background: rgba(255, 255, 255, 0.04);
+  color: rgba(255, 255, 255, 0.38);
+}
+.activity-rail-more-search:focus-within {
+  border-color: rgba(212, 255, 72, 0.34);
+  color: rgba(255, 255, 255, 0.72);
+}
+.activity-rail-more-search-input {
+  flex: 1 1 auto;
+  min-width: 0;
+  border: 0;
+  outline: none;
+  background: transparent;
+  color: rgba(255, 255, 255, 0.92);
+  font: inherit;
+  font-size: 12.5px;
+  line-height: 1.2;
+}
+.activity-rail-more-search-input::placeholder {
+  color: rgba(255, 255, 255, 0.34);
+}
+.activity-rail-more-search-input::-webkit-search-cancel-button {
+  -webkit-appearance: none;
+}
+.activity-rail-more-body {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+  padding: 6px 0 10px;
+  border-top: 1px solid rgba(255, 255, 255, 0.08);
+}
+.activity-rail-more-empty {
+  padding: 28px 16px;
+  text-align: center;
+  font-size: 12px;
+  color: rgba(255, 255, 255, 0.38);
+}
+.activity-rail-more-sec + .activity-rail-more-sec {
+  margin-top: 4px;
+  padding-top: 4px;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
+}
+.activity-rail-more-sec-hd {
+  padding: 8px 14px 4px;
+  font-size: 10px;
+  font-weight: 600;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: rgba(255, 255, 255, 0.38);
+}
+.activity-rail-more-row {
+  display: flex;
+  align-items: center;
+  gap: 2px;
+  padding: 1px 6px;
+}
+.activity-rail-more-row.active .activity-rail-more-name {
+  color: var(--color-brand-primary);
+}
+.activity-rail-more-open {
+  flex: 1 1 auto;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 7px 8px;
+  border: 0;
+  border-radius: 8px;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  text-align: left;
+  font-family: inherit;
+}
+.activity-rail-more-open:hover {
+  background: rgba(255, 255, 255, 0.06);
+}
+.activity-rail-more-ic {
+  width: 28px;
+  height: 28px;
+  flex-shrink: 0;
+  display: grid;
+  place-items: center;
+  border-radius: 7px;
+  background: rgba(255, 255, 255, 0.05);
+  color: rgba(255, 255, 255, 0.72);
+}
+.activity-rail-more-row.active .activity-rail-more-ic {
+  background: rgba(212, 255, 72, 0.12);
+  color: var(--color-brand-primary);
+}
+.activity-rail-more-meta {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.activity-rail-more-name {
+  font-size: 12.5px;
+  font-weight: 500;
+  line-height: 1.2;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.activity-rail-more-desc {
+  font-size: 10.5px;
+  line-height: 1.25;
+  color: rgba(255, 255, 255, 0.38);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.activity-rail-more-pin {
+  flex: 0 0 auto;
+  width: 28px;
+  height: 28px;
+  display: grid;
+  place-items: center;
+  border: 0;
+  border-radius: 7px;
+  background: transparent;
+  color: rgba(255, 255, 255, 0.28);
+  cursor: pointer;
+}
+.activity-rail-more-pin:hover {
+  background: rgba(255, 255, 255, 0.06);
+  color: rgba(255, 255, 255, 0.85);
+}
+.activity-rail-more-pin.on {
+  color: var(--color-brand-primary);
+}
+.activity-rail-more-pin:focus-visible,
+.activity-rail-more-open:focus-visible {
+  outline: 2px solid rgba(255, 255, 255, 0.45);
+  outline-offset: -1px;
+}

package/dist/package/browser/components/ActivityRail/ActivityRail.d.ts

@@ -0,0 +1,2 @@
+import './ActivityRail.css';
+export declare function ActivityRail(): import("react/jsx-runtime").JSX.Element;

package/dist/package/browser/components/ActivityRail/ActivityRail.js

@@ -0,0 +1,164 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
+import { MoreHorizontal, Pin, Search } from 'lucide-react';
+import { useHost } from '../../core/app-shell';
+import { STORAGE_KEYS } from '../../lib/storageKeys';
+import { lucideIconOrBox } from '../../lib/lucide-icon';
+import { Popover, PopoverContent, PopoverTrigger } from '../ui/popover';
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../ui/tooltip';
+import { useTranslation } from '../../i18n';
+import { activityRailCategory, addDefaultPinnedActivity, defaultPinnedActivityIds, groupDiscoverableActivities, localizeActivityRailEntries, migrateLegacyPinnedActivityIds, pinnedActivities, } from './activity-rail-model';
+import './ActivityRail.css';
+function readStoredIds(key) {
+    try {
+        const value = localStorage.getItem(key);
+        if (value === null)
+            return null;
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed.filter((id) => typeof id === 'string') : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writePinned(ids) {
+    try {
+        localStorage.setItem(STORAGE_KEYS.activityRailPinned, JSON.stringify(ids));
+    }
+    catch { /* quota */ }
+}
+function readMigrationFlag(key) {
+    try {
+        return localStorage.getItem(key) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+function writeMigrationFlag(key) {
+    try {
+        localStorage.setItem(key, '1');
+    }
+    catch { /* quota */ }
+}
+export function ActivityRail() {
+    const { t, i18n } = useTranslation();
+    const host = useHost();
+    const catalog = useSyncExternalStore(host.activities.subscribe, host.activities.getSnapshot, host.activities.getSnapshot);
+    const pages = useSyncExternalStore(host.pages.subscribe, host.pages.getSnapshot, host.pages.getSnapshot);
+    const [savedPinned, setSavedPinned] = useState(() => readStoredIds(STORAGE_KEYS.activityRailPinned));
+    const [moreOpen, setMoreOpen] = useState(false);
+    const [moreQuery, setMoreQuery] = useState('');
+    const [rovingId, setRovingId] = useState();
+    const moreSearchRef = useRef(null);
+    const firstMoreActionRef = useRef(null);
+    const pinnedRefs = useRef([]);
+    const migrationComplete = useRef(savedPinned !== null);
+    const videoGameDefaultMigrationComplete = useRef(readMigrationFlag(STORAGE_KEYS.activityRailPinnedVideoGameDefault));
+    const activities = useMemo(() => localizeActivityRailEntries(catalog.activities, i18n.language), [catalog.activities, i18n.language]);
+    const defaultPinnedIds = useMemo(() => defaultPinnedActivityIds(activities), [activities]);
+    const pinnedIds = savedPinned ?? defaultPinnedIds;
+    const pinned = useMemo(() => pinnedActivities(activities, pinnedIds), [activities, pinnedIds]);
+    const builtinPinned = useMemo(() => pinned.filter((activity) => activity.sourceLayer === 'builtin'), [pinned]);
+    const pluginPinned = useMemo(() => pinned.filter((activity) => activity.sourceLayer !== 'builtin'), [pinned]);
+    const groups = useMemo(() => groupDiscoverableActivities(activities, moreQuery), [activities, moreQuery]);
+    const activeTypeId = pages.instances.find((page) => page.encodedKey === pages.activeKey)?.typeId;
+    const activeActivityId = activities.find((activity) => activity.pageTypeId === activeTypeId)?.id;
+    const activePinned = pinned.some((activity) => activity.id === activeActivityId);
+    const moreActive = moreOpen || Boolean(activeActivityId && !activePinned);
+    useEffect(() => {
+        if (migrationComplete.current || activities.length === 0)
+            return;
+        const legacyIds = readStoredIds(STORAGE_KEYS.activityRailPinnedLegacyV1);
+        if (legacyIds === null) {
+            migrationComplete.current = true;
+            return;
+        }
+        if (!activities.some((activity) => activity.sourceLayer !== 'builtin'))
+            return;
+        const next = migrateLegacyPinnedActivityIds(legacyIds, activities);
+        migrationComplete.current = true;
+        setSavedPinned(next);
+        writePinned(next);
+    }, [activities]);
+    useEffect(() => {
+        if (videoGameDefaultMigrationComplete.current || savedPinned === null || activities.length === 0)
+            return;
+        const next = addDefaultPinnedActivity(savedPinned, activities, 'video-game');
+        videoGameDefaultMigrationComplete.current = true;
+        writeMigrationFlag(STORAGE_KEYS.activityRailPinnedVideoGameDefault);
+        if (next.length === savedPinned.length)
+            return;
+        setSavedPinned(next);
+        writePinned(next);
+    }, [activities, savedPinned]);
+    useEffect(() => {
+        if (pinned.length === 0) {
+            setRovingId(undefined);
+            return;
+        }
+        if (rovingId && pinned.some((activity) => activity.id === rovingId))
+            return;
+        setRovingId(pinned.find((activity) => activity.id === activeActivityId)?.id
+            ?? pinned[0]?.id);
+    }, [activeActivityId, pinned, rovingId]);
+    const togglePin = useCallback((id) => {
+        setSavedPinned((current) => {
+            const resolved = current ?? defaultPinnedIds;
+            const next = resolved.includes(id)
+                ? resolved.filter((candidate) => candidate !== id)
+                : [...resolved, id];
+            writePinned(next);
+            return next;
+        });
+    }, [defaultPinnedIds]);
+    const onPinnedKeyDown = (event, index) => {
+        const count = pinned.length;
+        if (count === 0)
+            return;
+        let target;
+        if (event.key === 'ArrowDown' || event.key === 'ArrowRight')
+            target = (index + 1) % count;
+        else if (event.key === 'ArrowUp' || event.key === 'ArrowLeft')
+            target = (index - 1 + count) % count;
+        else if (event.key === 'Home')
+            target = 0;
+        else if (event.key === 'End')
+            target = count - 1;
+        else
+            return;
+        event.preventDefault();
+        const activity = pinned[target];
+        if (!activity)
+            return;
+        setRovingId(activity.id);
+        pinnedRefs.current[target]?.focus();
+    };
+    const pinnedButton = (activity, index) => {
+        const active = activity.pageTypeId === activeTypeId;
+        const Icon = lucideIconOrBox(activity.icon);
+        const category = activityRailCategory(activity);
+        return (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { ref: (element) => { pinnedRefs.current[index] = element; }, type: "button", className: `activity-rail-item${active ? ' active' : ''}`, "aria-label": activity.title, "aria-current": active ? 'page' : undefined, tabIndex: activity.id === rovingId ? 0 : -1, "data-activity-id": activity.id, onFocus: () => setRovingId(activity.id), onKeyDown: (event) => onPinnedKeyDown(event, index), onClick: () => void host.activities.launch(activity.id), children: [_jsx("span", { className: "activity-rail-item-ic", "aria-hidden": true, children: _jsx(Icon, { size: 22, strokeWidth: 1.7 }) }), _jsx("span", { className: "activity-rail-item-lb", children: activity.title })] }) }), _jsxs(TooltipContent, { side: "right", sideOffset: 10, className: "activity-rail-plugin-tip", children: [_jsx("div", { className: "activity-rail-plugin-tip-title", children: activity.title }), _jsx("div", { className: "activity-rail-plugin-tip-category", children: t(`sidebar.categories.${category}`) }), activity.description ? (_jsx("div", { className: "activity-rail-plugin-tip-description", children: activity.description })) : null] })] }, activity.id));
+    };
+    return (_jsx(TooltipProvider, { delayDuration: 260, skipDelayDuration: 80, children: _jsxs("nav", { className: "activity-rail thin-scrollbar", "aria-label": t('sidebar.extensionsHint'), "data-fx-slot": "ActivityRail", children: [_jsx("div", { className: "activity-rail-group", "data-category": "builtin", role: "toolbar", "aria-orientation": "vertical", "aria-label": t('sidebar.extensionsHint'), children: builtinPinned.map((activity) => pinnedButton(activity, pinned.indexOf(activity))) }), _jsx("div", { className: "activity-rail-group", "data-category": "pinned", role: "toolbar", "aria-orientation": "vertical", "aria-label": t('sidebar.extensionsHint'), children: pluginPinned.map((activity) => pinnedButton(activity, pinned.indexOf(activity))) }), _jsx("div", { className: "activity-rail-group activity-rail-group--more", children: _jsxs(Popover, { open: moreOpen, onOpenChange: (open) => {
+                            setMoreOpen(open);
+                            if (!open)
+                                setMoreQuery('');
+                        }, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: `activity-rail-item${moreActive ? ' active' : ''}`, title: t('sidebar.morePluginsHint'), "aria-label": t('sidebar.morePluginsHint'), "aria-haspopup": "dialog", "aria-expanded": moreOpen, "data-rail-action": "more-plugins", children: [_jsx("span", { className: "activity-rail-item-ic", "aria-hidden": true, children: _jsx(MoreHorizontal, { size: 22, strokeWidth: 1.7 }) }), _jsx("span", { className: "activity-rail-item-lb", children: t('sidebar.morePlugins') })] }) }), _jsxs(PopoverContent, { side: "right", align: "end", sideOffset: 10, className: "activity-rail-more", onOpenAutoFocus: (event) => {
+                                    event.preventDefault();
+                                    moreSearchRef.current?.focus();
+                                }, children: [_jsx("div", { className: "activity-rail-more-hd", children: t('sidebar.morePlugins') }), _jsxs("div", { className: "activity-rail-more-search", children: [_jsx(Search, { size: 14, strokeWidth: 1.8, "aria-hidden": true }), _jsx("input", { ref: moreSearchRef, type: "search", className: "activity-rail-more-search-input", value: moreQuery, onChange: (event) => setMoreQuery(event.target.value), onKeyDown: (event) => {
+                                                    if (event.key === 'ArrowDown') {
+                                                        event.preventDefault();
+                                                        firstMoreActionRef.current?.focus();
+                                                    }
+                                                }, placeholder: t('sidebar.searchPlugins'), "aria-label": t('sidebar.searchPlugins') })] }), _jsx("div", { className: "activity-rail-more-body thin-scrollbar", children: groups.length === 0 ? (_jsx("div", { className: "activity-rail-more-empty", children: t('sidebar.noMatchingPlugins') })) : groups.map((group, groupIndex) => (_jsxs("section", { className: "activity-rail-more-sec", children: [_jsx("div", { className: "activity-rail-more-sec-hd", children: t(`sidebar.categories.${group.category}`) }), group.items.map((activity, itemIndex) => {
+                                                    const isPinned = pinnedIds.includes(activity.id);
+                                                    const active = activity.pageTypeId === activeTypeId;
+                                                    const Icon = lucideIconOrBox(activity.icon);
+                                                    return (_jsxs("div", { className: `activity-rail-more-row${active ? ' active' : ''}${isPinned ? ' pinned' : ''}`, children: [_jsxs("button", { ref: groupIndex === 0 && itemIndex === 0 ? firstMoreActionRef : undefined, type: "button", className: "activity-rail-more-open", onClick: async () => {
+                                                                    await host.activities.launch(activity.id);
+                                                                    setMoreOpen(false);
+                                                                }, title: activity.description || activity.title, "aria-current": active ? 'page' : undefined, children: [_jsx("span", { className: "activity-rail-more-ic", "aria-hidden": true, children: _jsx(Icon, { size: 16, strokeWidth: 1.7 }) }), _jsxs("span", { className: "activity-rail-more-meta", children: [_jsx("span", { className: "activity-rail-more-name", children: activity.title }), activity.description ? (_jsx("span", { className: "activity-rail-more-desc", children: activity.description })) : null] })] }), _jsx("button", { type: "button", className: `activity-rail-more-pin${isPinned ? ' on' : ''}`, onClick: () => togglePin(activity.id), title: isPinned ? t('sidebar.unpinPlugin') : t('sidebar.pinPlugin'), "aria-label": `${isPinned ? t('sidebar.unpinPlugin') : t('sidebar.pinPlugin')}: ${activity.title}`, "aria-pressed": isPinned, children: _jsx(Pin, { size: 14, strokeWidth: isPinned ? 2.2 : 1.6 }) })] }, activity.id));
+                                                })] }, group.category))) })] })] }) })] }) }));
+}

package/dist/package/browser/components/ActivityRail/activity-rail-model.d.ts

@@ -0,0 +1,18 @@
+import type { ActivityRegistration } from '../../core/page-platform';
+export type ActivityRailCategory = '3D' | '2D' | 'general';
+export type ActivityRailEntry = ActivityRegistration & {
+    readonly owner: string;
+};
+export declare const DEFAULT_PINNED_ACTIVITY_SLUGS: readonly ["skill", "gen3d", "scene-generator.3d-model", "character", "items", "anim", "scene-generator.2d-assets", "ui", "narrative", "video-game", "reel", "bgm", "scene-generator"];
+export declare function localizeActivityRailEntries(activities: readonly ActivityRailEntry[], locale: string): readonly ActivityRailEntry[];
+export declare function activityRailCategory(activity: ActivityRailEntry): ActivityRailCategory;
+export declare function discoverableActivities(activities: readonly ActivityRailEntry[]): readonly ActivityRailEntry[];
+export interface ActivityRailGroup {
+    readonly category: ActivityRailCategory;
+    readonly items: readonly ActivityRailEntry[];
+}
+export declare function groupDiscoverableActivities(activities: readonly ActivityRailEntry[], query: string): readonly ActivityRailGroup[];
+export declare function pinnedActivities(activities: readonly ActivityRailEntry[], pinnedIds: readonly string[]): readonly ActivityRailEntry[];
+export declare function migrateLegacyPinnedActivityIds(legacyIds: readonly string[], activities: readonly ActivityRailEntry[]): string[];
+export declare function defaultPinnedActivityIds(activities: readonly ActivityRailEntry[]): string[];
+export declare function addDefaultPinnedActivity(pinnedIds: readonly string[], activities: readonly ActivityRailEntry[], slug: string): string[];

package/dist/package/browser/components/ActivityRail/activity-rail-model.js

@@ -0,0 +1,144 @@
+const CATEGORY_ORDER = ['3D', '2D', 'general'];
+export const DEFAULT_PINNED_ACTIVITY_SLUGS = [
+    'skill',
+    'gen3d',
+    'scene-generator.3d-model',
+    'character',
+    'items',
+    'anim',
+    'scene-generator.2d-assets',
+    'ui',
+    'narrative',
+    'video-game',
+    'reel',
+    'bgm',
+    'scene-generator',
+];
+function contributionLocalId(id) {
+    return id.match(/#activity\/(.+)$/)?.[1];
+}
+function ownerSlug(owner) {
+    return owner.split('/').filter(Boolean).at(-1)?.toLowerCase() ?? owner.toLowerCase();
+}
+function localizedText(value, locale, fallback) {
+    if (!value)
+        return fallback;
+    const language = locale.toLowerCase().split('-')[0];
+    if (language === 'zh')
+        return value.zh ?? value.en ?? value.ja ?? fallback;
+    if (language === 'ja')
+        return value.ja ?? value.en ?? value.zh ?? fallback;
+    return value.en ?? value.zh ?? value.ja ?? fallback;
+}
+export function localizeActivityRailEntries(activities, locale) {
+    return activities.map((activity) => ({
+        ...activity,
+        title: localizedText(activity.titleI18n, locale, activity.title),
+        description: localizedText(activity.descriptionI18n, locale, activity.description ?? '') || undefined,
+    }));
+}
+function ownerAliases(activity) {
+    const owner = ownerSlug(activity.owner);
+    return [
+        activity.owner,
+        owner,
+    ];
+}
+function localActivityAliases(activity) {
+    const localId = contributionLocalId(activity.id);
+    const localIdWithoutLauncher = localId?.replace(/\.launcher$/, '');
+    return [
+        activity.id,
+        localId,
+        localIdWithoutLauncher,
+    ].filter((value) => Boolean(value));
+}
+function legacyAliases(activity) {
+    return [...localActivityAliases(activity), ...ownerAliases(activity)];
+}
+export function activityRailCategory(activity) {
+    const declared = activity.category?.trim().toLowerCase();
+    if (declared === '3d')
+        return '3D';
+    if (declared === '2d')
+        return '2D';
+    if (declared === 'general')
+        return 'general';
+    return 'general';
+}
+export function discoverableActivities(activities) {
+    return activities.filter((activity) => activity.sourceLayer !== 'builtin');
+}
+export function groupDiscoverableActivities(activities, query) {
+    const normalizedQuery = query.trim().toLowerCase();
+    const groups = new Map(CATEGORY_ORDER.map((category) => [category, []]));
+    for (const activity of discoverableActivities(activities)) {
+        if (normalizedQuery && ![
+            activity.title,
+            activity.description ?? '',
+            activity.id,
+            activity.owner,
+        ].some((value) => value.toLowerCase().includes(normalizedQuery))) {
+            continue;
+        }
+        groups.get(activityRailCategory(activity))?.push(activity);
+    }
+    return CATEGORY_ORDER
+        .map((category) => ({ category, items: groups.get(category) ?? [] }))
+        .filter((group) => group.items.length > 0);
+}
+export function pinnedActivities(activities, pinnedIds) {
+    const pinned = new Set(pinnedIds);
+    const selected = activities.filter((activity) => activity.sourceLayer === 'builtin' || pinned.has(activity.id));
+    const defaultRank = (activity) => {
+        const aliases = new Set(legacyAliases(activity).map((alias) => alias.toLowerCase()));
+        const rank = DEFAULT_PINNED_ACTIVITY_SLUGS.findIndex((slug) => aliases.has(slug));
+        return rank < 0 ? Number.POSITIVE_INFINITY : rank;
+    };
+    return selected
+        .map((activity, registryIndex) => ({ activity, registryIndex }))
+        .sort((left, right) => {
+        if (left.activity.sourceLayer === 'builtin' || right.activity.sourceLayer === 'builtin') {
+            return left.registryIndex - right.registryIndex;
+        }
+        return defaultRank(left.activity) - defaultRank(right.activity)
+            || left.registryIndex - right.registryIndex;
+    })
+        .map(({ activity }) => activity);
+}
+export function migrateLegacyPinnedActivityIds(legacyIds, activities) {
+    const aliasToQualifiedId = new Map();
+    for (const activity of activities) {
+        for (const alias of ownerAliases(activity)) {
+            const normalized = alias.toLowerCase();
+            if (!aliasToQualifiedId.has(normalized))
+                aliasToQualifiedId.set(normalized, activity.id);
+        }
+    }
+    for (const activity of activities) {
+        for (const alias of localActivityAliases(activity)) {
+            aliasToQualifiedId.set(alias.toLowerCase(), activity.id);
+        }
+    }
+    const migrated = [];
+    const seen = new Set();
+    for (const legacyId of legacyIds) {
+        const qualifiedId = legacyId.includes('#activity/')
+            ? legacyId
+            : aliasToQualifiedId.get(legacyId.toLowerCase());
+        if (qualifiedId && !seen.has(qualifiedId)) {
+            seen.add(qualifiedId);
+            migrated.push(qualifiedId);
+        }
+    }
+    return migrated;
+}
+export function defaultPinnedActivityIds(activities) {
+    return migrateLegacyPinnedActivityIds(DEFAULT_PINNED_ACTIVITY_SLUGS, activities);
+}
+export function addDefaultPinnedActivity(pinnedIds, activities, slug) {
+    const [qualifiedId] = migrateLegacyPinnedActivityIds([slug], activities);
+    if (!qualifiedId || pinnedIds.includes(qualifiedId))
+        return [...pinnedIds];
+    return [...pinnedIds, qualifiedId];
+}

package/dist/package/browser/components/AgentAvatar/AgentAvatar.d.ts

@@ -0,0 +1,17 @@
+/** Vector agent avatar art (forgeax-preview port).
+ *
+ *  The video-enhanced variant (`AgentAvatarVideo`) lives in
+ *  `@forgeax/chat`. The interface foundation only owns the SVG-only
+ *  presentation; standalone applications that want the WEBM state-machine variant import
+ *  `AgentAvatarVideo` from page-builtins directly.
+ */
+type Props = {
+    agentId: string;
+    accent: string;
+    fallback: string;
+    size?: number;
+    glass?: boolean;
+};
+export declare function accentForRoleTribe(tribe: string): string;
+export declare function AgentAvatar({ agentId, accent, fallback, size, glass }: Props): import("react/jsx-runtime").JSX.Element;
+export {};