@world-engines/authoring-ui 0.1.0-alpha.0

package/dist/score/scenario-structural-score.js

@@ -0,0 +1,211 @@
+import { detectAllMatchedArchetypes, detectPrimaryArchetype, extractScenarioScoringFeatures, toStructuralInput } from "./scenario-scoring-features.js";
+export const STRUCTURAL_WEIGHT_ENTITY_COUNT = 22;
+export const STRUCTURAL_WEIGHT_RELATION_COUNT = 20;
+export const STRUCTURAL_WEIGHT_ATTR_RICHNESS = 16;
+export const STRUCTURAL_WEIGHT_LORE_COMPLETENESS = 16;
+export const STRUCTURAL_WEIGHT_TEXT_VOLUME = 14;
+export const STRUCTURAL_WEIGHT_ASSET_REFS = 12;
+export const STRUCTURAL_SAT_K_ENTITY_COUNT = 60;
+export const STRUCTURAL_SAT_K_RELATION_COUNT = 80;
+export const STRUCTURAL_SAT_K_ATTR_RICHNESS = 6;
+export const STRUCTURAL_SAT_K_LORE_COMPLETENESS = 8;
+export const STRUCTURAL_SAT_K_TEXT_VOLUME = 4000;
+export const STRUCTURAL_SAT_K_ASSET_REFS = 12;
+export function sat(x, k) {
+    if (k <= 0 || x <= 0)
+        return 0;
+    return 1 - Math.exp(-x / k);
+}
+function attrRichnessRaw(entityCount, totalPropKeys) {
+    if (entityCount === 0)
+        return 0;
+    return totalPropKeys / entityCount;
+}
+function assetRefsRaw(input) {
+    return (input.coverVariantCount +
+        (input.hasViewRef ? 1 : 0) +
+        input.uiHtmlVariantCount +
+        input.mediaBindingCount);
+}
+export function computeStructuralDims(input) {
+    const textVolumeRaw = input.descriptionChars + input.entityPropsTextChars;
+    return {
+        entity_count: sat(input.entityCount, STRUCTURAL_SAT_K_ENTITY_COUNT) * STRUCTURAL_WEIGHT_ENTITY_COUNT,
+        relation_count: sat(input.relationCount, STRUCTURAL_SAT_K_RELATION_COUNT) *
+            STRUCTURAL_WEIGHT_RELATION_COUNT,
+        attr_richness: sat(attrRichnessRaw(input.entityCount, input.totalPropKeys), STRUCTURAL_SAT_K_ATTR_RICHNESS) * STRUCTURAL_WEIGHT_ATTR_RICHNESS,
+        lore_completeness: sat(input.loreEntityCount, STRUCTURAL_SAT_K_LORE_COMPLETENESS) *
+            STRUCTURAL_WEIGHT_LORE_COMPLETENESS,
+        text_volume: sat(textVolumeRaw, STRUCTURAL_SAT_K_TEXT_VOLUME) * STRUCTURAL_WEIGHT_TEXT_VOLUME,
+        asset_refs: sat(assetRefsRaw(input), STRUCTURAL_SAT_K_ASSET_REFS) * STRUCTURAL_WEIGHT_ASSET_REFS
+    };
+}
+/** 与 Rust `compute_structural_dims_with_archetype` 保持同口径。 */
+export function computeStructuralDimsWithArchetype(input, features, archetypeId) {
+    const base = computeStructuralDims(input);
+    const p = features.per_type_counts;
+    const media = features.media_breakdown;
+    switch (archetypeId) {
+        case "solo_protagonist":
+            return {
+                ...base,
+                relation_count: (sat(features.max_edge, 6) + sat(features.p90_edge, 4)) *
+                    0.5 * STRUCTURAL_WEIGHT_RELATION_COUNT,
+                attr_richness: sat(features.max_attr, 12) * STRUCTURAL_WEIGHT_ATTR_RICHNESS
+            };
+        case "world_codex": {
+            const half = (STRUCTURAL_WEIGHT_LORE_COMPLETENESS + STRUCTURAL_WEIGHT_ATTR_RICHNESS) * 0.5;
+            return {
+                ...base,
+                attr_richness: 0,
+                lore_completeness: sat(features.lore_entity_count, STRUCTURAL_SAT_K_LORE_COMPLETENESS) * half +
+                    sat(features.median_attr, 6) * half
+            };
+        }
+        case "sparse_prototype":
+        case "replay_hotspot":
+        case "other":
+            return base;
+        case "attribute_farm": {
+            const half = STRUCTURAL_WEIGHT_LORE_COMPLETENESS * 0.5;
+            return {
+                ...base,
+                lore_completeness: sat(features.median_attr, 12) * half +
+                    sat(features.total_prop_keys, 60) * half
+            };
+        }
+        case "ensemble_cast": {
+            const ratio = features.median_edge / Math.max(features.max_edge, 1);
+            return { ...base, attr_richness: base.attr_richness + sat(ratio, 0.5) * 4 };
+        }
+        case "relation_web":
+            return {
+                ...base,
+                relation_count: Math.min(features.relation_count / STRUCTURAL_SAT_K_RELATION_COUNT, 2) *
+                    STRUCTURAL_WEIGHT_RELATION_COUNT * 1.2
+            };
+        case "flat_graph": {
+            const half = STRUCTURAL_WEIGHT_RELATION_COUNT * 0.5;
+            return {
+                ...base,
+                relation_count: sat(features.entity_count, STRUCTURAL_SAT_K_ENTITY_COUNT) * half +
+                    sat(features.median_attr, 6) * half
+            };
+        }
+        case "faction_conflict": {
+            const half = STRUCTURAL_WEIGHT_ATTR_RICHNESS * 0.5;
+            return {
+                ...base,
+                attr_richness: base.attr_richness * 0.5 + sat(p.faction, 8) * half
+            };
+        }
+        case "location_atlas": {
+            const half = STRUCTURAL_WEIGHT_ATTR_RICHNESS * 0.5;
+            return {
+                ...base,
+                attr_richness: sat(p.location, 12) * half + sat(features.median_edge, 4) * half
+            };
+        }
+        case "item_catalog": {
+            const half = STRUCTURAL_WEIGHT_RELATION_COUNT * 0.5;
+            return {
+                ...base,
+                relation_count: sat(p.item, 20) * half + sat(features.median_attr, 8) * half
+            };
+        }
+        case "event_driven": {
+            const half = STRUCTURAL_WEIGHT_LORE_COMPLETENESS * 0.5;
+            return {
+                ...base,
+                lore_completeness: sat(p.event, 12) * half + sat(features.relation_count, 40) * half
+            };
+        }
+        case "cg_gallery": {
+            const half = STRUCTURAL_WEIGHT_LORE_COMPLETENESS * 0.5;
+            return {
+                ...base,
+                lore_completeness: sat(media.cg_image + media.cg_video, 30) * half +
+                    sat(features.cover_variant_count, 8) * half
+            };
+        }
+        case "voice_theater":
+            return { ...base, asset_refs: sat(media.audio, 20) * STRUCTURAL_WEIGHT_ASSET_REFS };
+        case "puppet_show":
+            return { ...base, asset_refs: sat(media.puppet, 5) * 20 };
+        case "text_heavyweight":
+            return {
+                ...base,
+                text_volume: Math.min(((features.description_chars + features.entity_props_text_chars) / 20_000) *
+                    STRUCTURAL_WEIGHT_TEXT_VOLUME, STRUCTURAL_WEIGHT_TEXT_VOLUME * 1.5)
+            };
+        case "ui_showcase": {
+            const uiBonus = sat(features.ui_html_variant_count, 3) + (features.has_view_ref ? 1 : 0);
+            return {
+                ...base,
+                asset_refs: base.asset_refs + uiBonus * STRUCTURAL_WEIGHT_ASSET_REFS * 0.5
+            };
+        }
+        case "compact_tight":
+            return {
+                entity_count: base.entity_count * 1.05,
+                relation_count: base.relation_count * 1.05,
+                attr_richness: base.attr_richness * 1.05,
+                lore_completeness: base.lore_completeness * 1.05,
+                text_volume: base.text_volume * 1.05,
+                asset_refs: base.asset_refs * 1.05
+            };
+    }
+}
+export function computeStructuralScoreWithArchetype(input, features, archetypeId) {
+    return Math.min(100, Math.max(0, sumStructuralDims(computeStructuralDimsWithArchetype(input, features, archetypeId))));
+}
+export function sumStructuralDims(dims) {
+    return (dims.entity_count +
+        dims.relation_count +
+        dims.attr_richness +
+        dims.lore_completeness +
+        dims.text_volume +
+        dims.asset_refs);
+}
+export function computeStructuralScore(input) {
+    return sumStructuralDims(computeStructuralDims(input));
+}
+/** Host-facing descriptive alias；与历史 computeStructuralScore 使用同一公式实现。 */
+export const computeScenarioStructuralScore = computeStructuralScore;
+export function buildStructuralInput(params) {
+    return toStructuralInput(extractScenarioScoringFeatures({
+        entities: params.entities,
+        relations: params.relations,
+        assets: {
+            description_chars: Array.from(params.description).length,
+            cover_variant_count: params.coverVariantCount,
+            has_view_ref: params.hasViewRef,
+            ui_html_variant_count: params.uiHtmlVariantCount,
+            media_binding_count: params.mediaBindingCount
+        }
+    }));
+}
+/** 本地顶部预估只使用结构事实；不接受 media 自报值，也不伪造 quality/base 或 dual-radar 轴。 */
+export function computeLocalStructuralProjection(input) {
+    if (!Number.isSafeInteger(input.source_revision) || input.source_revision < 0)
+        throw new Error("invalid_source_revision");
+    if (!/^[a-f0-9]{64}$/.test(input.source_digest))
+        throw new Error("invalid_source_digest");
+    const features = extractScenarioScoringFeatures({
+        entities: input.entities,
+        relations: input.relations,
+        assets: { description_chars: Array.from(input.description).length },
+    });
+    const structuralInput = toStructuralInput(features);
+    const primary = detectPrimaryArchetype(features);
+    const dimensions = computeStructuralDimsWithArchetype(structuralInput, features, primary);
+    return Object.freeze({
+        source_revision: input.source_revision,
+        source_digest: input.source_digest,
+        features,
+        archetype: Object.freeze({ primary, all_matched: Object.freeze(detectAllMatchedArchetypes(features)) }),
+        structural: Object.freeze({ score: computeStructuralScoreWithArchetype(structuralInput, features, primary), dimensions }),
+        quality: null,
+        base: null,
+    });
+}

package/dist/score/score-presentation.d.ts

@@ -0,0 +1,51 @@
+export declare const STORY_SCORE_AXES: readonly [{
+    readonly key: "narrative_depth";
+    readonly label: "叙事深度";
+}, {
+    readonly key: "world_breadth";
+    readonly label: "世界广度";
+}, {
+    readonly key: "relation_complexity";
+    readonly label: "关系复杂度";
+}, {
+    readonly key: "interaction_system";
+    readonly label: "交互系统";
+}, {
+    readonly key: "content_presentation";
+    readonly label: "内容呈现";
+}, {
+    readonly key: "replay_potential";
+    readonly label: "重玩潜力";
+}];
+export declare const PRESENTATION_SCORE_AXES: readonly [{
+    readonly key: "visual_design";
+    readonly label: "视觉设计";
+}, {
+    readonly key: "responsive_adaptation";
+    readonly label: "响应式适配";
+}, {
+    readonly key: "interaction_completeness";
+    readonly label: "交互完成度";
+}, {
+    readonly key: "media_orchestration";
+    readonly label: "媒体编排";
+}, {
+    readonly key: "audio_performance";
+    readonly label: "声音表现";
+}, {
+    readonly key: "puppet_performance";
+    readonly label: "人偶演出";
+}];
+export type StoryScoreAxisKey = (typeof STORY_SCORE_AXES)[number]["key"];
+export type PresentationScoreAxisKey = (typeof PRESENTATION_SCORE_AXES)[number]["key"];
+export interface ScoreAxisValues {
+    readonly self: number | null;
+    readonly mean?: number | null;
+    readonly median?: number | null;
+}
+export type ScoreAxisMap<Key extends string> = Readonly<Partial<Record<Key, ScoreAxisValues>>>;
+export type ScoreSource = "draft" | "reviewed";
+export declare function finiteScore(value: number | null | undefined): number | null;
+export declare function scoreScaleValue(value: number | null | undefined): number | null;
+export declare function formatCompactScore(value: number | null | undefined): string;
+export declare function formatFullScore(value: number | null | undefined): string;

package/dist/score/score-presentation.js

@@ -0,0 +1,44 @@
+export const STORY_SCORE_AXES = [
+    { key: "narrative_depth", label: "叙事深度" },
+    { key: "world_breadth", label: "世界广度" },
+    { key: "relation_complexity", label: "关系复杂度" },
+    { key: "interaction_system", label: "交互系统" },
+    { key: "content_presentation", label: "内容呈现" },
+    { key: "replay_potential", label: "重玩潜力" },
+];
+export const PRESENTATION_SCORE_AXES = [
+    { key: "visual_design", label: "视觉设计" },
+    { key: "responsive_adaptation", label: "响应式适配" },
+    { key: "interaction_completeness", label: "交互完成度" },
+    { key: "media_orchestration", label: "媒体编排" },
+    { key: "audio_performance", label: "声音表现" },
+    { key: "puppet_performance", label: "人偶演出" },
+];
+export function finiteScore(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+export function scoreScaleValue(value) {
+    const finite = finiteScore(value);
+    return finite === null ? null : Math.min(100, Math.max(0, finite));
+}
+function compactNumber(value) {
+    const rounded = Math.round(value * 10) / 10;
+    return Number.isInteger(rounded) ? String(rounded) : rounded.toFixed(1);
+}
+export function formatCompactScore(value) {
+    const finite = finiteScore(value);
+    if (finite === null)
+        return "N/A";
+    const absolute = Math.abs(finite);
+    if (absolute >= 1_000_000_000)
+        return `${compactNumber(finite / 1_000_000_000)}B`;
+    if (absolute >= 1_000_000)
+        return `${compactNumber(finite / 1_000_000)}M`;
+    if (absolute >= 1_000)
+        return `${compactNumber(finite / 1_000)}K`;
+    return compactNumber(finite);
+}
+export function formatFullScore(value) {
+    const finite = finiteScore(value);
+    return finite === null ? "N/A" : finite.toLocaleString("zh-CN", { maximumFractionDigits: 10 });
+}

package/dist/score/score-radar.css

@@ -0,0 +1 @@
+.score-radar{--score-self:#32d551;--score-mean:#4f9cff;--score-median:#d15cff;background:#161516;color:#f2f2f2;padding:18px}.score-radar__header{display:flex;align-items:flex-start;justify-content:space-between;gap:18px;margin-bottom:16px}.score-radar__header h2,.score-radar__card h3{margin:0}.score-radar__header p{margin:5px 0 0;color:#aaa7aa;font-size:.78rem}.score-radar__legend{display:flex;flex-wrap:wrap;gap:12px;margin:0;padding:0;list-style:none;font-size:.72rem}.score-radar__legend li{display:flex;align-items:center;gap:6px}.score-radar__legend li::before{width:18px;height:2px;background:currentColor;content:""}.score-radar__legend [data-series="self"]{color:var(--score-self)}.score-radar__legend [data-series="mean"]{color:var(--score-mean)}.score-radar__legend [data-series="median"]{color:var(--score-median)}.score-radar__cards{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px}.score-radar__card{min-width:0;border:1px solid #414041;border-radius:8px;background:#201f20;padding:14px}.score-radar__card h3{font-size:.92rem}.score-radar__plot{display:block;width:min(100%,360px);height:auto;margin:0 auto;overflow:visible}.score-radar__grid,.score-radar__boundary,.score-radar__spoke{fill:none;stroke:#414041;stroke-width:1}.score-radar__boundary{stroke:#5a585a}.score-radar__series{fill:none;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round}.score-radar__series--self,.score-radar__point--self{stroke:var(--score-self)}.score-radar__series--mean,.score-radar__point--mean{stroke:var(--score-mean)}.score-radar__series--median,.score-radar__point--median{stroke:var(--score-median)}.score-radar__point{fill:#161516;stroke-width:2}.score-radar__axis-label{fill:#d4d1d4;font-size:11px;font-weight:600}.score-radar__empty{fill:#aaa7aa;font-size:12px}.score-radar__values{display:grid;gap:6px;margin:0;padding:0;list-style:none}.score-radar__values li{display:grid;grid-template-columns:minmax(100px,1fr) repeat(3,minmax(56px,auto));align-items:center;gap:8px;border-top:1px solid #343334;padding-top:6px;font-size:.72rem}.score-radar__values li>span:not(:first-child){display:grid;text-align:right}.score-radar__values small{color:#817f81;font-size:.62rem}.score-radar__values strong{font-variant-numeric:tabular-nums}@media(max-width:760px){.score-radar__header{display:grid}.score-radar__cards{grid-template-columns:1fr}.score-radar__values li{grid-template-columns:minmax(100px,1fr) repeat(3,minmax(48px,auto))}}

package/dist/sync/DownloadPanel.d.ts

@@ -0,0 +1,42 @@
+export interface DownloadReplaceUiPlan {
+    readonly operation_id: string;
+    readonly plan_digest: string;
+    readonly target_pair_id: string;
+    readonly selection: "scenario" | "view" | "both";
+    readonly local_overwrite_summary: {
+        readonly scenario_file_count: string;
+        readonly scenario_bytes: string;
+        readonly view_file_count: string;
+        readonly view_bytes: string;
+        readonly current_snapshot_digest: string;
+    } | null;
+    readonly dependency_diff: {
+        readonly added: readonly string[];
+        readonly removed: readonly string[];
+        readonly changed: readonly string[];
+        readonly lockfile_changes: boolean;
+    } | null;
+    readonly local_inspection_digest: string;
+    readonly expected_project_revision: number;
+}
+export interface DownloadTargetPairProjection {
+    readonly target_id: string;
+    readonly scenario: string;
+    readonly view: string;
+}
+export interface DownloadReplaceUiPort {
+    prepare(target_pair_id: string, selection: DownloadReplaceUiPlan["selection"]): Promise<void>;
+    apply(plan: DownloadReplaceUiPlan, confirmation: {
+        operation_id: string;
+        plan_digest: string;
+    }): Promise<void>;
+    reconcile(operation_id: string): Promise<void>;
+    retry(operation_id: string): Promise<void>;
+    restore(operation_id: string): Promise<void>;
+}
+/** 只消费上层注入的 typed frozen plan；本组件不构造 HTTP 请求或猜测远端 wire。 */
+export declare function DownloadPanel({ plan, port, targetPairs }: {
+    readonly plan: DownloadReplaceUiPlan | null;
+    readonly port: DownloadReplaceUiPort;
+    readonly targetPairs: readonly DownloadTargetPairProjection[];
+}): JSX.Element;

package/dist/sync/DownloadPanel.js

@@ -0,0 +1,22 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from "react";
+/** 只消费上层注入的 typed frozen plan；本组件不构造 HTTP 请求或猜测远端 wire。 */
+export function DownloadPanel({ plan, port, targetPairs }) {
+    const [targetPairId, setTargetPairId] = useState(plan?.target_pair_id ?? targetPairs[0]?.target_id ?? "");
+    const [selection, setSelection] = useState(plan?.selection ?? "both");
+    const [confirmed, setConfirmed] = useState(false);
+    const [error, setError] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const invoke = async (action) => { setBusy(true); setError(null); try {
+        await action();
+    }
+    catch (cause) {
+        setError(cause instanceof Error ? cause.message : "下载替换失败");
+    }
+    finally {
+        setBusy(false);
+    } };
+    const apply = async () => { if (plan !== null)
+        await invoke(() => port.apply(plan, { operation_id: plan.operation_id, plan_digest: plan.plan_digest })); };
+    return _jsxs("section", { "aria-label": "Download Replace", children: [_jsxs("label", { children: ["\u76EE\u6807\u5BF9", _jsx("select", { "aria-label": "\u4E0B\u8F7D\u76EE\u6807\u5BF9", disabled: busy || targetPairs.length === 0, onChange: (event) => setTargetPairId(event.target.value), value: targetPairId, children: targetPairs.map((pair) => _jsxs("option", { value: pair.target_id, children: [pair.target_id, ": ", pair.scenario, " / ", pair.view] }, pair.target_id)) })] }), _jsxs("label", { children: ["\u66FF\u6362\u8303\u56F4", _jsxs("select", { "aria-label": "\u4E0B\u8F7D\u66FF\u6362\u8303\u56F4", disabled: busy, onChange: (event) => setSelection(event.target.value), value: selection, children: [_jsx("option", { value: "scenario", children: "scenario" }), _jsx("option", { value: "view", children: "view" }), _jsx("option", { value: "both", children: "both" })] })] }), _jsx("button", { disabled: busy || targetPairId === "", onClick: () => void invoke(() => port.prepare(targetPairId, selection)), type: "button", children: "\u751F\u6210\u4E0B\u8F7D\u8BA1\u5212" }), plan === null ? _jsx("p", { role: "status", children: "\u5C1A\u65E0\u51BB\u7ED3\u7684\u4E0B\u8F7D\u8BA1\u5212\u3002" }) : _jsxs(_Fragment, { children: [_jsxs("p", { children: ["\u5C06\u4ECE ", plan.target_pair_id, " \u66FF\u6362\u672C\u5730 ", plan.selection] }), _jsxs("p", { children: ["\u672C\u5730\u68C0\u67E5\uFF1A", _jsx("code", { children: plan.local_inspection_digest }), " \u00B7 revision ", plan.expected_project_revision] }), plan.local_overwrite_summary === null ? null : _jsxs("section", { "aria-label": "\u672C\u5730\u8986\u76D6\u6458\u8981", children: [_jsx("h3", { children: "\u672C\u5730\u8986\u76D6\u6458\u8981" }), _jsxs("p", { children: ["Scenario\uFF1A", plan.local_overwrite_summary.scenario_file_count, " \u4E2A\u6587\u4EF6\uFF0C", plan.local_overwrite_summary.scenario_bytes, " bytes"] }), _jsxs("p", { children: ["View\uFF1A", plan.local_overwrite_summary.view_file_count, " \u4E2A\u6587\u4EF6\uFF0C", plan.local_overwrite_summary.view_bytes, " bytes"] }), _jsxs("p", { children: ["\u5F53\u524D\u672C\u5730\u5FEB\u7167\uFF1A", _jsx("code", { children: plan.local_overwrite_summary.current_snapshot_digest || "未提供" })] })] }), plan.dependency_diff === null ? null : _jsxs("section", { "aria-label": "\u4F9D\u8D56\u53D8\u66F4", children: [_jsx("h3", { children: "\u4F9D\u8D56\u53D8\u66F4" }), _jsxs("p", { children: ["\u65B0\u589E\uFF1A", plan.dependency_diff.added.length === 0 ? "无" : plan.dependency_diff.added.join("、")] }), _jsxs("p", { children: ["\u5220\u9664\uFF1A", plan.dependency_diff.removed.length === 0 ? "无" : plan.dependency_diff.removed.join("、")] }), _jsxs("p", { children: ["\u53D8\u66F4\uFF1A", plan.dependency_diff.changed.length === 0 ? "无" : plan.dependency_diff.changed.join("、")] }), _jsxs("p", { children: ["\u4F9D\u8D56\u5B89\u88C5\u5F71\u54CD\uFF1A", plan.dependency_diff.lockfile_changes ? "依赖锁定文件将变更；替换后需要安装依赖。" : "无 lockfile 变更；不需要因本计划安装依赖。"] })] }), _jsxs("label", { children: [_jsx("input", { checked: confirmed, disabled: busy, onChange: (event) => setConfirmed(event.target.checked), type: "checkbox" }), "\u6211\u786E\u8BA4\u672C\u5730\u66FF\u6362"] }), _jsx("button", { disabled: !confirmed || busy, onClick: () => void apply(), type: "button", children: "\u786E\u8BA4\u5E76\u66FF\u6362" }), _jsx("button", { disabled: busy, onClick: () => void invoke(() => port.reconcile(plan.operation_id)), type: "button", children: "Reconcile download" }), _jsx("button", { disabled: busy, onClick: () => void invoke(() => port.retry(plan.operation_id)), type: "button", children: "Retry same download" }), _jsx("button", { disabled: busy, onClick: () => void invoke(() => port.restore(plan.operation_id)), type: "button", children: "Restore local preimage" })] }), error === null ? null : _jsx("p", { role: "alert", children: error })] });
+}

package/dist/sync/SyncSidebar.d.ts

@@ -0,0 +1,47 @@
+import { type UploadConfirmation, type UploadFanoutPlanProjection, type UploadOperationProjection } from "./UploadPanel.js";
+import { type DownloadReplaceUiPlan } from "./DownloadPanel.js";
+export interface SyncSidebarSnapshot {
+    readonly account: {
+        readonly label: string;
+    } | null;
+    readonly inventory: {
+        readonly project_id: string;
+        readonly project_revision: number;
+        readonly source_digest: string;
+        readonly scenario_entries: number;
+        readonly view_entries: number;
+    } | null;
+    readonly target_pairs: readonly {
+        readonly target_id: string;
+        readonly scenario: string;
+        readonly view: string;
+    }[];
+    readonly history: readonly {
+        readonly operation_id: string;
+        readonly detail: string;
+    }[];
+    readonly upload_plan: UploadFanoutPlanProjection | null;
+    readonly upload_operations: readonly UploadOperationProjection[];
+    readonly download_plan: DownloadReplaceUiPlan | null;
+}
+/** GUI 只消费本地 adapter 的投影；远端身份、wire 与网络 I/O 必须留在 adapter 外。 */
+export interface SyncSidebarAdapter {
+    readSnapshot(): Promise<SyncSidebarSnapshot>;
+    subscribe?(listener: () => void): () => void;
+    confirmUploadTarget(confirmation: UploadConfirmation): Promise<void>;
+    reconcileUpload(operation_id: string): Promise<void>;
+    retryUpload(operation_id: string): Promise<void>;
+    undoUpload(operation_id: string): Promise<void>;
+    prepareDownload?(target_pair_id: string, selection: DownloadReplaceUiPlan["selection"]): Promise<void>;
+    applyDownload?(plan: DownloadReplaceUiPlan, confirmation: {
+        operation_id: string;
+        plan_digest: string;
+    }): Promise<void>;
+    reconcileDownload?(operation_id: string): Promise<void>;
+    retryDownload?(operation_id: string): Promise<void>;
+    restoreDownload?(operation_id: string): Promise<void>;
+    prepareUpload?(): Promise<void>;
+}
+export declare function SyncSidebar({ adapter }: {
+    readonly adapter: SyncSidebarAdapter;
+}): JSX.Element;

package/dist/sync/SyncSidebar.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from "react";
+import { UploadPanel, } from "./UploadPanel.js";
+import { DownloadPanel } from "./DownloadPanel.js";
+export function SyncSidebar({ adapter }) {
+    const [snapshot, setSnapshot] = useState(null);
+    const [failure, setFailure] = useState(null);
+    const reload = useCallback(async () => {
+        try {
+            setSnapshot(await adapter.readSnapshot());
+            setFailure(null);
+        }
+        catch (cause) {
+            setFailure(cause instanceof Error ? cause.message : "无法读取同步状态。");
+        }
+    }, [adapter]);
+    useEffect(() => { void reload(); }, [reload]);
+    useEffect(() => adapter.subscribe?.(() => { void reload(); }), [adapter, reload]);
+    const invoke = useCallback(async (action) => {
+        try {
+            await action();
+            await reload();
+        }
+        catch (cause) {
+            setFailure(cause instanceof Error ? cause.message : "同步操作失败。");
+        }
+    }, [reload]);
+    if (snapshot === null)
+        return _jsx("p", { role: "status", children: "\u6B63\u5728\u8BFB\u53D6\u540C\u6B65\u72B6\u6001\u2026" });
+    return (_jsxs("aside", { "aria-label": "\u540C\u6B65\u4FA7\u8FB9\u680F", children: [failure === null ? null : _jsx("p", { role: "alert", children: failure }), snapshot.account === null ? _jsx("p", { role: "status", children: "\u5F53\u524D\u9879\u76EE\u5C1A\u672A\u767B\u5F55\u3002" }) : _jsxs("p", { children: ["\u8D26\u6237\uFF1A", snapshot.account.label] }), snapshot.inventory === null ? null : _jsxs("section", { "aria-label": "\u672C\u5730\u540C\u6B65\u76D8\u70B9", children: [_jsx("h2", { children: "\u672C\u5730\u76D8\u70B9" }), _jsxs("p", { children: [snapshot.inventory.project_id, " \u00B7 revision ", snapshot.inventory.project_revision] }), _jsxs("p", { children: ["Scenario ", snapshot.inventory.scenario_entries, " \u00B7 View ", snapshot.inventory.view_entries] }), _jsxs("p", { children: ["source readback: ", _jsx("code", { children: snapshot.inventory.source_digest })] })] }), _jsxs("section", { "aria-label": "\u540C\u6B65\u76EE\u6807\u5BF9", children: [_jsx("h2", { children: "Scenario / View \u76EE\u6807\u5BF9" }), snapshot.target_pairs.length === 0 ? _jsx("p", { children: "\u5C1A\u65E0\u8FDC\u7AEF\u76EE\u6807\u5BF9\u3002" }) : _jsx("ul", { children: snapshot.target_pairs.map((pair) => _jsxs("li", { children: [pair.target_id, ": ", pair.scenario, " / ", pair.view] }, pair.target_id)) })] }), _jsx(UploadPanel, { ...(adapter.prepareUpload === undefined ? {} : { onPrepare: () => invoke(() => adapter.prepareUpload()) }), onConfirmTarget: (confirmation) => invoke(() => adapter.confirmUploadTarget(confirmation)), onReconcile: (operation_id) => invoke(() => adapter.reconcileUpload(operation_id)), onRetry: (operation_id) => invoke(() => adapter.retryUpload(operation_id)), onUndo: (operation_id) => invoke(() => adapter.undoUpload(operation_id)), operations: snapshot.upload_operations, plan: snapshot.upload_plan }), adapter.prepareDownload === undefined || adapter.applyDownload === undefined ? null : _jsx(DownloadPanel, { plan: snapshot.download_plan, targetPairs: snapshot.target_pairs, port: { prepare: (target_pair_id, selection) => invoke(() => adapter.prepareDownload(target_pair_id, selection)), apply: (plan, confirmation) => adapter.applyDownload(plan, confirmation), reconcile: (operation_id) => invoke(() => adapter.reconcileDownload(operation_id)), retry: (operation_id) => invoke(() => adapter.retryDownload(operation_id)), restore: (operation_id) => invoke(() => adapter.restoreDownload(operation_id)) } }), _jsxs("section", { "aria-label": "\u540C\u6B65\u5386\u53F2", children: [_jsx("h2", { children: "\u540C\u6B65\u5386\u53F2" }), snapshot.history.length === 0 ? _jsx("p", { children: "\u6682\u65E0\u5386\u53F2\u3002" }) : _jsx("ul", { children: snapshot.history.map((item) => _jsxs("li", { children: [item.operation_id, ": ", item.detail] }, item.operation_id)) })] })] }));
+}

package/dist/sync/UploadPanel.d.ts

@@ -0,0 +1,64 @@
+export type UploadPartKind = "scenario" | "view";
+export type UploadTargetAction = "existing" | "create" | "copy_on_bind";
+export type UploadOperationState = "prepared" | "in_flight" | "completed" | "partial" | "unknown" | "failed" | "undone";
+export interface UploadSnapshotProjection {
+    readonly snapshot_id: string;
+    readonly snapshot_digest: string;
+    readonly parts: readonly UploadPartKind[];
+    readonly bytes: number;
+}
+export interface UploadTargetProjection {
+    readonly target_id: string;
+    readonly scenario: {
+        readonly identity: string;
+        readonly action: "existing" | "create";
+    };
+    readonly view: {
+        readonly identity: string;
+        readonly action: UploadTargetAction;
+    };
+    readonly current_head: string | null;
+    readonly current_digest: string | null;
+    readonly binding_revision: string | null;
+    readonly warnings: readonly string[];
+}
+export interface UploadRetentionProjection {
+    readonly remote_preimage: string;
+    readonly local_preimage: string;
+    readonly local_preimage_pinnable: boolean;
+}
+export interface UploadFanoutPlanProjection {
+    readonly operation_id: string;
+    readonly plan_digest: string;
+    readonly expires_at: string;
+    readonly snapshot: UploadSnapshotProjection;
+    readonly targets: readonly UploadTargetProjection[];
+    readonly retention: UploadRetentionProjection;
+}
+export interface UploadOperationProjection {
+    readonly operation_id: string;
+    readonly target_id: string;
+    readonly state: UploadOperationState;
+    readonly detail: string | null;
+    readonly retryable: boolean;
+    readonly undoable: boolean;
+}
+export interface UploadConfirmation {
+    readonly plan_digest: string;
+    readonly target_id: string;
+    readonly confirmation: "force_overwrite";
+}
+export interface UploadPanelProps {
+    readonly plan: UploadFanoutPlanProjection | null;
+    readonly operations?: readonly UploadOperationProjection[];
+    readonly now?: Date;
+    readonly onConfirmTarget?: (confirmation: UploadConfirmation) => void | Promise<void>;
+    readonly onReconcile?: (operation_id: string) => void | Promise<void>;
+    readonly onRetry?: (operation_id: string) => void | Promise<void>;
+    readonly onUndo?: (operation_id: string) => void | Promise<void>;
+    readonly onPrepare?: () => void | Promise<void>;
+}
+/**
+ * 只渲染已由上层冻结的计划；组件不构造远端请求，也不把当前 UI 输入当作 authority。
+ */
+export declare function UploadPanel({ plan, operations, now, onConfirmTarget, onReconcile, onRetry, onUndo, onPrepare, }: UploadPanelProps): JSX.Element;

package/dist/sync/UploadPanel.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+function targetActionLabel(action) {
+    if (action === "existing")
+        return "覆盖现有对象";
+    if (action === "create")
+        return "新建对象";
+    return "Copy-on-Bind";
+}
+function operationLabel(state) {
+    return {
+        prepared: "已准备",
+        in_flight: "进行中",
+        completed: "已完成",
+        partial: "部分完成",
+        unknown: "结果未知，需 reconcile",
+        failed: "失败",
+        undone: "已撤销",
+    }[state];
+}
+/**
+ * 只渲染已由上层冻结的计划；组件不构造远端请求，也不把当前 UI 输入当作 authority。
+ */
+export function UploadPanel({ plan, operations = [], now = new Date(), onConfirmTarget, onReconcile, onRetry, onUndo, onPrepare, }) {
+    const [confirmed, setConfirmed] = useState(() => new Set());
+    const expired = useMemo(() => plan !== null && Date.parse(plan.expires_at) <= now.getTime(), [now, plan]);
+    if (plan === null)
+        return _jsxs("section", { "aria-label": "Upload Fanout", "data-testid": "upload-panel", children: [_jsx("h2", { children: "Upload Fanout" }), _jsx("button", { disabled: onPrepare === undefined, onClick: () => { void onPrepare?.(); }, type: "button", children: "\u751F\u6210\u4E0A\u4F20\u8BA1\u5212" }), _jsx("p", { role: "status", children: "\u5C1A\u65E0\u51BB\u7ED3\u7684\u4E0A\u4F20\u8BA1\u5212\uFF1B\u4E0D\u4F1A\u4E0A\u4F20 staging \u5BF9\u8C61\u3002" })] });
+    const confirm = async (target_id) => {
+        if (expired || onConfirmTarget === undefined)
+            return;
+        await onConfirmTarget({ plan_digest: plan.plan_digest, target_id, confirmation: "force_overwrite" });
+        setConfirmed((current) => new Set(current).add(target_id));
+    };
+    return (_jsxs("section", { "aria-label": "Upload Fanout", "data-testid": "upload-panel", children: [_jsx("h2", { children: "Upload Fanout" }), _jsxs("p", { children: ["\u5FEB\u7167 ", plan.snapshot.snapshot_id, " \u00B7 ", plan.snapshot.snapshot_digest] }), _jsxs("p", { children: ["parts: ", plan.snapshot.parts.join(", "), " \u00B7 ", plan.snapshot.bytes, " bytes"] }), _jsxs("p", { children: ["\u8BA1\u5212 digest: ", _jsx("code", { children: plan.plan_digest })] }), _jsx("p", { role: expired ? "alert" : "status", children: expired ? "计划已过期；请重新生成计划。" : `计划有效至 ${plan.expires_at}` }), _jsxs("p", { children: ["\u8FDC\u7AEF preimage \u4FDD\u7559 ", plan.retention.remote_preimage, "\uFF1B\u672C\u5730 preimage \u4FDD\u7559 ", plan.retention.local_preimage, plan.retention.local_preimage_pinnable ? "（可固定）" : "", "\u3002"] }), _jsx("ul", { "aria-label": "\u4E0A\u4F20\u76EE\u6807", children: plan.targets.map((target) => (_jsxs("li", { "data-testid": `upload-target-${target.target_id}`, children: [_jsx("h3", { children: target.target_id }), _jsxs("p", { children: ["Scenario: ", target.scenario.identity, "\uFF08", targetActionLabel(target.scenario.action), "\uFF09"] }), _jsxs("p", { children: ["View: ", target.view.identity, "\uFF08", targetActionLabel(target.view.action), "\uFF09"] }), _jsxs("p", { children: ["\u5F53\u524D head: ", target.current_head ?? "新建", "\uFF1Bdigest: ", target.current_digest ?? "新建", "\uFF1Bbinding: ", target.binding_revision ?? "新建"] }), target.warnings.length === 0 ? null : _jsx("ul", { "aria-label": `${target.target_id} warnings`, children: target.warnings.map((warning) => _jsx("li", { children: warning }, warning)) }), _jsx("button", { disabled: expired || confirmed.has(target.target_id) || onConfirmTarget === undefined, onClick: () => { void confirm(target.target_id); }, type: "button", children: confirmed.has(target.target_id) ? "已确认" : `确认 ${target.target_id} force_overwrite` })] }, target.target_id))) }), _jsxs("section", { "aria-label": "\u4E0A\u4F20\u64CD\u4F5C\u5386\u53F2", children: [_jsx("h3", { children: "\u64CD\u4F5C\u5386\u53F2" }), operations.length === 0 ? _jsx("p", { children: "\u6682\u65E0\u64CD\u4F5C\u3002" }) : (_jsx("ul", { children: operations.map((operation) => (_jsxs("li", { "data-testid": `upload-operation-${operation.operation_id}`, children: [_jsxs("span", { children: [operation.target_id, ": ", operationLabel(operation.state)] }), operation.detail === null ? null : _jsxs("span", { children: [" \u00B7 ", operation.detail] }), operation.state === "unknown" ? _jsx("button", { onClick: () => { void onReconcile?.(operation.operation_id); }, type: "button", children: "Reconcile" }) : null, operation.retryable ? _jsx("button", { onClick: () => { void onRetry?.(operation.operation_id); }, type: "button", children: "Retry same operation" }) : null, operation.undoable ? _jsx("button", { onClick: () => { void onUndo?.(operation.operation_id); }, type: "button", children: "Undo upload" }) : null] }, operation.operation_id))) }))] })] }));
+}

package/dist/trigger/TriggerBlueprint.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from "react";
+import type { SpatialObjectV1 } from "@world-engines/spatial-authoring";
+export interface TriggerNode {
+    readonly stable_id: string;
+    readonly kind: "event" | "condition" | "effect" | "presentation";
+    readonly label: string;
+}
+export interface TriggerEdge {
+    readonly from_stable_id: string;
+    readonly to_stable_id: string;
+}
+export interface TriggerBlueprintProjection {
+    readonly revision: number;
+    readonly nodes: readonly TriggerNode[];
+    readonly edges: readonly TriggerEdge[];
+    readonly source: Readonly<Record<string, unknown>>;
+    readonly layout: Readonly<Record<string, unknown>>;
+    readonly validation: Readonly<Record<string, unknown>> | null;
+    readonly simulation: Readonly<Record<string, unknown>> | null;
+}
+export interface TriggerBlueprintProps {
+    readonly blueprint: TriggerBlueprintProjection;
+    readonly disabled: boolean;
+    readonly onValidate: () => Promise<void>;
+    readonly onSimulate: () => Promise<void>;
+    readonly onRepairLocationTarget: (trigger_id: string, spatial_id: string) => Promise<void>;
+    readonly spatialObjects: readonly SpatialObjectV1[];
+    readonly renderBlueprint?: (props: TriggerBlueprintProps) => ReactNode;
+}
+interface TriggerSpatialTarget {
+    readonly triggerId: string;
+    readonly spatialId: string;
+}
+/** 从 Trigger source 读出空间目标；未知格式只显示为空，绝不尝试猜测或写回。 */
+export declare function collectTriggerSpatialTargets(source: Readonly<Record<string, unknown>>): readonly TriggerSpatialTarget[];
+export declare function TriggerBlueprint(props: TriggerBlueprintProps): JSX.Element;
+export {};

package/dist/trigger/TriggerBlueprint.js

@@ -0,0 +1,26 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 从 Trigger source 读出空间目标；未知格式只显示为空，绝不尝试猜测或写回。 */
+export function collectTriggerSpatialTargets(source) {
+    const triggers = source.triggers;
+    if (!Array.isArray(triggers))
+        return [];
+    return triggers.flatMap((value) => {
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            return [];
+        const record = value;
+        if (typeof record.id !== "string" || !Array.isArray(record.spatial_refs))
+            return [];
+        return record.spatial_refs.filter((spatialId) => typeof spatialId === "string").map((spatialId) => ({ triggerId: record.id, spatialId }));
+    });
+}
+export function TriggerBlueprint(props) {
+    if (props.renderBlueprint !== undefined)
+        return _jsx(_Fragment, { children: props.renderBlueprint(props) });
+    const locationObjects = props.spatialObjects.filter((object) => object.kind === "location");
+    const targets = collectTriggerSpatialTargets(props.blueprint.source);
+    return (_jsxs("section", { "aria-label": "Trigger Blueprint", "data-testid": "trigger-blueprint", children: [_jsxs("header", { children: [_jsxs("strong", { children: ["Blueprint revision ", props.blueprint.revision] }), _jsx("button", { disabled: props.disabled, onClick: () => void props.onValidate(), type: "button", children: "\u9A8C\u8BC1" }), _jsx("button", { disabled: props.disabled, onClick: () => void props.onSimulate(), type: "button", children: "\u6A21\u62DF" })] }), props.blueprint.nodes.length === 0 ? _jsx("p", { children: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709 Trigger \u8282\u70B9\u3002" }) : (_jsx("ul", { children: props.blueprint.nodes.map((node) => _jsxs("li", { children: [node.label, " \u00B7 ", node.kind] }, node.stable_id)) })), _jsxs("p", { children: ["\u8FDE\u63A5\u6570\uFF1A", props.blueprint.edges.length] }), _jsxs("section", { "aria-label": "Trigger location targets", children: [_jsx("h2", { children: "\u7A7A\u95F4\u4F4D\u7F6E\u76EE\u6807" }), targets.length === 0 ? _jsx("p", { children: "\u5F53\u524D Trigger \u6CA1\u6709\u7A7A\u95F4\u4F4D\u7F6E\u76EE\u6807\u3002" }) : (_jsx("ul", { children: targets.map((target) => {
+                            const valid = locationObjects.some((object) => object.id === target.spatialId);
+                            return (_jsxs("li", { children: [_jsxs("span", { children: [target.triggerId, " \u2192 ", target.spatialId] }), valid ? _jsx("span", { children: "\uFF08\u6709\u6548\uFF09" }) : (_jsxs("label", { children: ["\u65E0\u6548\u76EE\u6807\uFF0C\u4FEE\u590D\u4E3A", _jsxs("select", { "aria-label": `${target.triggerId} 的 location target`, disabled: props.disabled || locationObjects.length === 0, defaultValue: "", onChange: (event) => { if (event.target.value.length > 0)
+                                                    void props.onRepairLocationTarget(target.triggerId, event.target.value); }, children: [_jsx("option", { disabled: true, value: "", children: "\u9009\u62E9 location" }), locationObjects.map((object) => _jsx("option", { value: object.id, children: object.label }, object.id))] })] }))] }, `${target.triggerId}:${target.spatialId}`));
+                        }) }))] }), _jsxs("details", { children: [_jsx("summary", { children: "Trigger source" }), _jsx("pre", { children: JSON.stringify(props.blueprint.source, null, 2) })] }), _jsxs("details", { children: [_jsx("summary", { children: "Blueprint layout" }), _jsx("pre", { children: JSON.stringify(props.blueprint.layout, null, 2) })] }), props.blueprint.validation === null ? null : _jsx("output", { "aria-label": "Trigger \u9A8C\u8BC1\u7ED3\u679C", children: JSON.stringify(props.blueprint.validation) }), props.blueprint.simulation === null ? null : _jsx("output", { "aria-label": "Trigger trace", children: JSON.stringify(props.blueprint.simulation) })] }));
+}