@nilvn/core 0.14.0

package/dist/commands.js

@@ -0,0 +1,181 @@
+// Schemas for the engine's built-in CommandNode commands, grounded in
+// packages/engine/src/builtins.ts. These drive the editor's command palette and forms.
+//
+// Excluded on purpose:
+//  - use / alias / actor  -> project setup (Project.plugins / alias / actors), not nodes
+//  - jump / if / set      -> first-class node kinds (JumpNode / JumpNode+condition / SetNode)
+export const BUILTIN_COMMANDS = [
+    {
+        name: 'bg',
+        label: 'cmd.bg.label',
+        category: 'stage',
+        icon: '🖼',
+        hint: 'cmd.bg.hint',
+        params: [
+            { key: 'bg', label: 'cmd.bg.bg', type: 'asset:bg', positional: 0 },
+            { key: 'color', label: 'cmd.bg.color', type: 'color' },
+            { key: 'fade', label: 'cmd.bg.fade', type: 'number', default: 0 },
+        ],
+    },
+    {
+        name: 'char',
+        label: 'cmd.char.label',
+        category: 'stage',
+        icon: '🧍',
+        hint: 'cmd.char.hint',
+        params: [
+            { key: 'id', label: 'cmd.char.id', type: 'actor', required: true, positional: 0 },
+            { key: 'face', label: 'cmd.char.face', type: 'face', positional: 1 },
+            {
+                key: 'at',
+                label: 'cmd.char.at',
+                type: 'enum',
+                options: [
+                    { value: 'left', label: 'cmd.char.at.left' },
+                    { value: 'center', label: 'cmd.char.at.center' },
+                    { value: 'right', label: 'cmd.char.at.right' },
+                ],
+            },
+            // Birth transform — written by the stage drag / scale / rotate handles (4c-4).
+            // NO schema default: these channels carry forward (an absent param means "keep
+            // the previous value", not "identity"), so the serializer must never drop an
+            // explicit identity that overrides an inherited non-identity value.
+            { key: 'y', label: 'cmd.char.y', type: 'number', advanced: true },
+            { key: 'scale', label: 'cmd.char.scale', type: 'number', advanced: true },
+            { key: 'rotation', label: 'cmd.char.rotation', type: 'number', advanced: true },
+            { key: 'fade', label: 'cmd.char.fade', type: 'number', default: 0.3 },
+            { key: 'src', label: 'cmd.char.src', type: 'string', advanced: true },
+        ],
+    },
+    {
+        name: 'hide',
+        label: 'cmd.hide.label',
+        category: 'stage',
+        icon: '🚪',
+        params: [
+            { key: 'id', label: 'cmd.hide.id', type: 'actor', required: true, positional: 0 },
+            { key: 'fade', label: 'cmd.hide.fade', type: 'number', default: 0.3 },
+        ],
+    },
+    {
+        name: 'clear',
+        label: 'cmd.clear.label',
+        category: 'stage',
+        icon: '🧹',
+        hint: 'cmd.clear.hint',
+        params: [{ key: 'fade', label: 'cmd.clear.fade', type: 'number', default: 0.3 }],
+    },
+    {
+        name: 'wait',
+        label: 'cmd.wait.label',
+        category: 'flow',
+        icon: '⏱',
+        hint: 'cmd.wait.hint',
+        params: [{ key: 'sec', label: 'cmd.wait.sec', type: 'number', required: true, default: 0.5, positional: 0 }],
+    },
+    {
+        name: 'fadeout',
+        label: 'cmd.fadeout.label',
+        category: 'fx',
+        icon: '🌑',
+        params: [
+            { key: 'sec', label: 'cmd.fadeout.sec', type: 'number', default: 0.6, positional: 0 },
+            { key: 'color', label: 'cmd.fadeout.color', type: 'color', default: '#000' },
+        ],
+    },
+    {
+        name: 'fadein',
+        label: 'cmd.fadein.label',
+        category: 'fx',
+        icon: '🌗',
+        params: [{ key: 'sec', label: 'cmd.fadein.sec', type: 'number', default: 0.6, positional: 0 }],
+    },
+    {
+        name: 'dialog',
+        label: 'cmd.dialog.label',
+        category: 'stage',
+        icon: '💬',
+        hint: 'cmd.dialog.hint',
+        params: [
+            {
+                key: 'mode',
+                label: 'cmd.dialog.mode',
+                type: 'enum',
+                default: 'show',
+                positional: 0,
+                options: [
+                    { value: 'show', label: 'cmd.dialog.mode.show' },
+                    { value: 'hide', label: 'cmd.dialog.mode.hide' },
+                ],
+            },
+        ],
+    },
+    {
+        name: 'window',
+        label: 'cmd.window.label',
+        category: 'stage',
+        icon: '🪟',
+        hint: 'cmd.window.hint',
+        params: [
+            // The skin picker reuses the background asset pool (a window texture is a
+            // flat image like a bg); type `skin=none` by hand to restore the default.
+            { key: 'skin', label: 'cmd.window.skin', type: 'asset:bg', required: true, positional: 0 },
+            { key: 'target', label: 'cmd.window.target', type: 'string', default: 'dialog', advanced: true },
+        ],
+    },
+    {
+        name: 'textspeed',
+        label: 'cmd.textspeed.label',
+        category: 'text',
+        icon: '⏩',
+        hint: 'cmd.textspeed.hint',
+        params: [{ key: 'cps', label: 'cmd.textspeed.cps', type: 'number', default: 40, positional: 0 }],
+    },
+    {
+        name: 'bgm',
+        label: 'cmd.bgm.label',
+        category: 'audio',
+        icon: '🎵',
+        params: [
+            { key: 'bgm', label: 'cmd.bgm.bgm', type: 'asset:bgm', required: true, positional: 0 },
+            { key: 'loop', label: 'cmd.bgm.loop', type: 'boolean', default: true },
+            { key: 'volume', label: 'cmd.bgm.volume', type: 'number', default: 1 },
+            // Multi-track: 'music' = the classic BGM slot; any other name is an
+            // ambience bed layered alongside (its own loop channel + master volume).
+            { key: 'track', label: 'cmd.bgm.track', type: 'string', default: 'music', advanced: true },
+            { key: 'fade', label: 'cmd.bgm.fade', type: 'number', default: 0, advanced: true },
+        ],
+    },
+    {
+        name: 'stopbgm',
+        label: 'cmd.stopbgm.label',
+        category: 'audio',
+        icon: '🔇',
+        params: [
+            { key: 'fade', label: 'cmd.stopbgm.fade', type: 'number', default: 0 },
+            { key: 'track', label: 'cmd.stopbgm.track', type: 'string', default: 'music', advanced: true },
+        ],
+    },
+    {
+        name: 'se',
+        label: 'cmd.se.label',
+        category: 'audio',
+        icon: '🔔',
+        params: [
+            { key: 'se', label: 'cmd.se.se', type: 'asset:se', required: true, positional: 0 },
+            { key: 'volume', label: 'cmd.se.volume', type: 'number', default: 1 },
+        ],
+    },
+    {
+        name: 'end',
+        label: 'cmd.end.label',
+        category: 'flow',
+        icon: '🏁',
+        hint: 'cmd.end.hint',
+        params: [{ key: 'sec', label: 'cmd.end.sec', type: 'number', default: 1, positional: 0 }],
+    },
+];
+export const BUILTIN_COMMAND_MAP = Object.fromEntries(BUILTIN_COMMANDS.map((c) => [c.name, c]));
+export function getCommandSchema(name) {
+    return BUILTIN_COMMAND_MAP[name];
+}

package/dist/i18n.d.ts

@@ -0,0 +1,50 @@
+export type Catalog = Record<string, string>;
+export type Params = Record<string, string | number>;
+/** Namespaced, per-language catalogs as produced by a LocaleLoader.
+ *  Shape: `{ [namespace]: { [lang]: { [id]: text } } }`. Namespaces (`editor`,
+ *  `core`, `engine`, `plugin:<id>`) are an authoring/override grouping — the
+ *  runtime merges them flat because ids are already globally unique. */
+export interface LoadedCatalogs {
+    [namespace: string]: {
+        [lang: string]: Catalog;
+    };
+}
+/** Loads the catalogs for a host (web glob, Tauri resources + user overrides, or
+ *  an inline injected blob for the engine's offline single-file export). */
+export interface LocaleLoader {
+    load(): Promise<LoadedCatalogs>;
+}
+export interface I18n {
+    /** Switch the active language (unknown languages just miss into the base). */
+    setLocale(lang: string): void;
+    getLocale(): string;
+    /** Merge one language's catalog. `namespace` is advisory (kept for override
+     *  composition at the loader layer); lookup is flat since ids are unique.
+     *  Idempotent, last-write-wins per id. */
+    registerCatalog(namespace: string, lang: string, catalog: Catalog): void;
+    /** Resolve `id` for the active language: active → base → id. `{name}`
+     *  placeholders are filled from `params` (in every language). */
+    t(id: string, params?: Params): string;
+    /** Whether `id` resolves to a real string (in the active or base language). */
+    has(id: string): boolean;
+}
+/** Create an i18n instance. `base` (default `en`) is the guaranteed-complete
+ *  fallback language; `active` defaults to `base`. */
+export declare function createI18n(opts?: {
+    base?: string;
+    active?: string;
+}): I18n;
+/** Register every namespace/language of a LoadedCatalogs into an instance. */
+export declare function applyCatalogs(i18n: I18n, loaded: LoadedCatalogs): void;
+/** The minimal shape `registerEnabledPluginCatalogs` needs from a plugin: its
+ *  id (→ `plugin:<id>` namespace) and an optional baked message fallback for
+ *  when no JSON catalog was loaded (e.g. zero-dep core tooling). PluginManifest
+ *  satisfies this. */
+export interface PluginI18nSource {
+    id: string;
+    messages?: Partial<Record<string, Catalog>>;
+}
+/** Merge each enabled plugin's catalog under its `plugin:<id>` namespace: prefer
+ *  the loaded JSON catalog, else fall back to the manifest's baked `messages`.
+ *  Called by BOTH the editor and the engine so plugin chrome localizes uniformly. */
+export declare function registerEnabledPluginCatalogs(i18n: I18n, plugins: PluginI18nSource[], loaded: LoadedCatalogs): void;

package/dist/i18n.js

@@ -0,0 +1,77 @@
+// Shared UI-chrome i18n runtime for the studio (editor + engine).
+//
+// Unlike the authored-story text i18n (see catalog.ts / project.catalogs), this
+// localizes the *tool/game chrome*: buttons, labels, menus, toasts. It replaces
+// the old "key-as-default" scheme (where the Chinese source string was the lookup
+// key) with STABLE DOTTED IDs — e.g. `topBar.home`, `cmd.bg.label`,
+// `plugin.charfx.name`, `engine.menu.save`. Lookup falls back active → base(en) →
+// the raw id, so a missing translation surfaces a visible id rather than silently
+// showing another language.
+//
+// Zero-dependency and pure: no fetch/fs. Catalogs are plain data injected via
+// registerCatalog / applyCatalogs; the fetching/globbing/override lives in the
+// host packages' LocaleLoader implementations (which produce a LoadedCatalogs and
+// hand it here). The editor and engine each own their own instance — they can't
+// share memory across the engine's IIFE boundary, but they share this code and the
+// same JSON catalog files, which is what removes the old duplicated-key problem.
+const PLACEHOLDER = /\{(\w+)\}/g;
+function fill(tpl, params) {
+    return tpl.replace(PLACEHOLDER, (_, name) => (name in params ? String(params[name]) : `{${name}}`));
+}
+/** Create an i18n instance. `base` (default `en`) is the guaranteed-complete
+ *  fallback language; `active` defaults to `base`. */
+export function createI18n(opts) {
+    const base = opts?.base ?? 'en';
+    let active = opts?.active ?? base;
+    // Flat merged catalog per language; ids are globally unique so namespace need
+    // not be a lookup dimension.
+    const merged = {};
+    return {
+        setLocale(lang) {
+            active = lang;
+        },
+        getLocale() {
+            return active;
+        },
+        registerCatalog(_namespace, lang, catalog) {
+            Object.assign((merged[lang] ??= {}), catalog);
+        },
+        t(id, params) {
+            const tpl = merged[active]?.[id] ?? merged[base]?.[id] ?? id;
+            return params ? fill(tpl, params) : tpl;
+        },
+        has(id) {
+            return merged[active]?.[id] !== undefined || merged[base]?.[id] !== undefined;
+        },
+    };
+}
+/** Register every namespace/language of a LoadedCatalogs into an instance. */
+export function applyCatalogs(i18n, loaded) {
+    for (const namespace in loaded) {
+        const byLang = loaded[namespace];
+        for (const lang in byLang)
+            i18n.registerCatalog(namespace, lang, byLang[lang]);
+    }
+}
+/** Merge each enabled plugin's catalog under its `plugin:<id>` namespace: prefer
+ *  the loaded JSON catalog, else fall back to the manifest's baked `messages`.
+ *  Called by BOTH the editor and the engine so plugin chrome localizes uniformly. */
+export function registerEnabledPluginCatalogs(i18n, plugins, loaded) {
+    for (const p of plugins) {
+        const ns = `plugin:${p.id}`;
+        const fromJson = loaded[ns];
+        if (fromJson) {
+            for (const lang in fromJson)
+                i18n.registerCatalog(ns, lang, fromJson[lang]);
+            continue;
+        }
+        const baked = p.messages;
+        if (baked) {
+            for (const lang in baked) {
+                const cat = baked[lang];
+                if (cat)
+                    i18n.registerCatalog(ns, lang, cat);
+            }
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './ir.js';
+export * from './schema.js';
+export * from './commands.js';
+export * from './plugin-manifest.js';
+export * from './semver.js';
+export * from './plugins.js';
+export * from './serialize.js';
+export * from './catalog.js';
+export * from './i18n.js';
+export * from './chunk.js';
+export * from './chunk-build.js';
+export * from './package.js';
+export * from './versions.js';
+export * from './screenplay.js';
+export * from './screenplay-format.js';

package/dist/index.js

@@ -0,0 +1,17 @@
+// @nilvn/core — shared document model (IR) and command schema for the creator studio.
+// Consumed by the engine, editor, AI generation and the in-browser bundler.
+export * from './ir.js';
+export * from './schema.js';
+export * from './commands.js';
+export * from './plugin-manifest.js';
+export * from './semver.js';
+export * from './plugins.js';
+export * from './serialize.js';
+export * from './catalog.js';
+export * from './i18n.js';
+export * from './chunk.js';
+export * from './chunk-build.js';
+export * from './package.js';
+export * from './versions.js';
+export * from './screenplay.js';
+export * from './screenplay-format.js';