@kubohiroya/turbowarp-title-menu 0.1.0

package/dist/types/composition.d.ts

@@ -0,0 +1,10 @@
+export { createAppShellApplicationMenu as createApplicationMenu } from '@kubohiroya/turbowarp-app-shell';
+export type { AppShellApplicationMenuAction as ApplicationMenuAction, AppShellApplicationMenuOptions as ApplicationMenuOptions } from '@kubohiroya/turbowarp-app-shell';
+export { createDslFilesDialog } from './dsl-files-dialog.js';
+export type { DslFilesDialog, DslFilesDialogLocaleText, DslFilesDialogOptions } from './dsl-files-dialog.js';
+export { createDslStore, defaultDslSort, DslStoreError, readDslFile } from './dsl-store.js';
+export type { DslFileRecord, DslFileSummary, DslSort, DslSortDirection, DslSortField, DslStore, DslStoreErrorCode, DslStoreOptions } from './dsl-store.js';
+export { dslOpenEventName, dslReloadEventName } from './events.js';
+export type { DslSourceEventDetail } from './events.js';
+export { createTitleDialog } from './title-dialog.js';
+export type { TitleDialog, TitleDialogOptions, TitleDialogLocaleText } from './title-dialog.js';

package/dist/types/dom.d.ts

@@ -0,0 +1,7 @@
+export type DomDocument = Document;
+export type DomElement = HTMLElement;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function requireDocument(value: unknown): DomDocument;
+export declare function requireElement(value: unknown, name: string): DomElement;
+export declare function ensureRelativeMount(mount: DomElement): () => void;
+export declare function invokeSafely(operation: () => unknown | Promise<unknown>, onError?: (error: unknown) => void): void;

package/dist/types/dsl-files-dialog.d.ts

@@ -0,0 +1,51 @@
+import { type DslFileSummary, type DslSort } from './dsl-store';
+/**
+ * The stage-mounted DSL file manager.
+ *
+ * The dialog owns presentation and interaction state only: sort order, which row is being renamed,
+ * and which row is awaiting delete confirmation. Every storage operation is a caller-supplied
+ * callback, so the same dialog works against the IndexedDB store, a test double, or a future
+ * file-system backend.
+ */
+export interface DslFilesDialogLocaleText {
+    title: string;
+    add: string;
+    open: string;
+    rename: string;
+    remove: string;
+    confirmRemove: string;
+    confirm: string;
+    cancel: string;
+    close: string;
+    sortByName: string;
+    sortByDate: string;
+    sortBySize: string;
+    empty: string;
+}
+export interface DslFilesDialogOptions {
+    document?: Document;
+    mount?: HTMLElement;
+    locales: Record<string, DslFilesDialogLocaleText>;
+    initialLocale?: string;
+    initialSort?: DslSort;
+    list(sort: DslSort): Promise<readonly DslFileSummary[]>;
+    onOpen(id: string): unknown | Promise<unknown>;
+    onAdd(): unknown | Promise<unknown>;
+    onRename(id: string, name: string): unknown | Promise<unknown>;
+    onRemove(id: string): unknown | Promise<unknown>;
+    describeError?(error: unknown): string;
+    formatSize?(byteLength: number): string;
+    formatDate?(isoDate: string): string;
+    onError?(error: unknown): void;
+}
+export interface DslFilesDialog {
+    readonly element: HTMLElement;
+    readonly locale: string;
+    readonly sort: DslSort;
+    show(locale?: string): Promise<string>;
+    hide(): void;
+    refresh(): Promise<void>;
+    setLocale(locale: string): string;
+    dispose(): void;
+}
+export declare function createDslFilesDialog(options: DslFilesDialogOptions): DslFilesDialog;

package/dist/types/dsl-store.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Multi-file DSL storage backed by IndexedDB.
+ *
+ * The previous single-slot `localStorage` design could only remember the last opened file. A venue
+ * keeps several performances side by side, so records are addressed by a stable id, names are unique
+ * so a list stays meaningful, and the store never deletes a record on its own: exceeding the file
+ * limit fails loudly instead of silently dropping someone's DSL.
+ */
+export interface DslFileRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly source: string;
+    readonly byteLength: number;
+    readonly savedAt: string;
+    readonly updatedAt: string;
+}
+export type DslFileSummary = Omit<DslFileRecord, 'source'>;
+export type DslSortField = 'name' | 'updatedAt' | 'byteLength';
+export type DslSortDirection = 'asc' | 'desc';
+export interface DslSort {
+    readonly field: DslSortField;
+    readonly direction: DslSortDirection;
+}
+export type DslStoreErrorCode = 'unavailable' | 'invalid-name' | 'invalid-source' | 'name-taken' | 'too-large' | 'too-many' | 'not-found' | 'quota' | 'failed';
+export declare class DslStoreError extends Error {
+    readonly code: DslStoreErrorCode;
+    constructor(code: DslStoreErrorCode, message: string, cause?: unknown);
+}
+export interface DslStoreOptions {
+    readonly indexedDB?: IDBFactory;
+    readonly databaseName?: string;
+    readonly maxSourceBytes?: number;
+    readonly maxFileCount?: number;
+    readonly now?: () => Date;
+    readonly createId?: () => string;
+}
+export interface DslStore {
+    readonly databaseName: string;
+    list(sort?: DslSort): Promise<DslFileSummary[]>;
+    count(): Promise<number>;
+    get(id: string): Promise<DslFileRecord | null>;
+    save(file: {
+        name: string;
+        source: string;
+    }): Promise<DslFileRecord>;
+    rename(id: string, name: string): Promise<DslFileRecord>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    lastOpened(): Promise<DslFileRecord | null>;
+    markOpened(id: string): Promise<void>;
+    close(): void;
+}
+export declare const defaultDslSort: DslSort;
+export declare function createDslStore(options?: DslStoreOptions): DslStore;
+/** Reads a picked browser file into a record shape the store accepts. */
+export declare function readDslFile(file: File, maxSourceBytes?: number): Promise<{
+    name: string;
+    source: string;
+}>;

package/dist/types/events.d.ts

@@ -0,0 +1,13 @@
+import type { DslFileRecord } from './dsl-store';
+export declare const dslOpenEventName = "turbowarp-title-menu:dsl-open";
+export declare const dslReloadEventName = "turbowarp-title-menu:dsl-reload";
+export interface DslSourceEventDetail {
+    record: DslFileRecord;
+}
+/**
+ * Announces an opened DSL source on the window.
+ *
+ * The extension also starts a Scratch hat, but a packaged host that embeds this extension may run
+ * its own runtime outside the VM, so the DOM event stays the transport that assumes no Scratch.
+ */
+export declare function dispatchDslSourceEvent(type: string, record: DslFileRecord): void;

package/dist/types/locales.d.ts

@@ -0,0 +1,14 @@
+import type { DslFilesDialogLocaleText } from './dsl-files-dialog';
+import type { TitleDialogLocaleText } from './title-dialog';
+export type SupportedLocale = 'en' | 'ja';
+export interface MenuActionLabels {
+    files: string;
+    reload: string;
+    about: string;
+    close: string;
+}
+export declare const titleLocales: Readonly<Record<SupportedLocale, TitleDialogLocaleText>>;
+export declare const menuLocales: Readonly<Record<SupportedLocale, MenuActionLabels>>;
+export declare const dslFilesLocales: Readonly<Record<SupportedLocale, DslFilesDialogLocaleText>>;
+/** Turns a store error code into operator-facing text, falling back to the raw message. */
+export declare function describeStoreError(locale: SupportedLocale, error: unknown): string;

package/dist/types/title-dialog.d.ts

@@ -0,0 +1,29 @@
+export type TitleMenuLocale = string;
+export interface TitleDialogLocaleText {
+    title: string;
+    author?: string;
+    license?: string;
+    website: string;
+    close: string;
+    language?: string;
+}
+export interface TitleDialogOptions {
+    document?: Document;
+    mount?: HTMLElement;
+    locales: Record<string, TitleDialogLocaleText>;
+    initialLocale?: TitleMenuLocale;
+    websiteUrl?: string;
+    onWebsite?: () => unknown | Promise<unknown>;
+    onClose?: () => unknown | Promise<unknown>;
+    onLocaleChange?: (locale: TitleMenuLocale) => unknown | Promise<unknown>;
+    onError?: (error: unknown) => void;
+}
+export interface TitleDialog {
+    readonly element: HTMLElement;
+    readonly locale: TitleMenuLocale;
+    show(locale?: TitleMenuLocale): TitleMenuLocale;
+    hide(): void;
+    setLocale(locale: TitleMenuLocale): TitleMenuLocale;
+    dispose(): void;
+}
+export declare function createTitleDialog(options: TitleDialogOptions): TitleDialog;

package/docs/architecture.ja.md

@@ -0,0 +1,63 @@
+# アーキテクチャ
+
+[English](architecture.md)
+
+## ビルド出力
+
+このプロジェクトは実行時の動作と互換性メタデータを分離し、リポジトリに保存された同じソース定義から両方を生成します。
+
+```text
+src/index.ts + src/extension.ts
+  -> vite-plugin-turbowarp-extension
+  -> dist/<extension>.js
+
+src/config.ts + src/block-definitions.json
+  -> extension-api-manifest Viteプラグイン
+  -> dist/extension-manifest.json
+```
+
+manifestプラグインはViteのビルド後フェーズで実行されます。これにより、JavaScriptプラグインの単一出力検証を維持しながら、TurboWarpバンドルの完成後にだけmanifestを追加します。
+
+## 拡張機能API manifest v1
+
+`schemas/extension-manifest.schema.json`が規範となるJSON Schemaです。`formatVersion`は`1`で、互換性のないmanifest形式を導入するときに変更する必要があります。
+
+v1契約は次の情報を含みます。
+
+- TurboWarp拡張機能のID
+- 各ブロックのopcodeとブロック種類
+- 各引数のID、引数種類、任意のメニュー参照
+- 各メニューのIDとReporterブロックを受け付けるかどうか
+
+ブロック、引数、メニューは、シリアライズ前に識別子で並べ替えられます。テキスト、説明、既定値、静的メニュー項目は、保存済みプロジェクトのAPI参照を識別しないため、意図的に除外しています。そのため互換性チェッカーは、API変更とドキュメントまたはローカライズの変更を区別できます。
+
+## 差分の検出
+
+`dist/`はリリース成果物としてコミットされます。`npm run check:dist`は両方のファイルを再ビルドし、`dist/`配下に変更、削除、未追跡ファイルがある場合に失敗します。これにより、ローカル検証とCIの両方でmanifestとバンドルの差分を検出できます。
+
+## turbowarp-app-shellとの層の分け方
+
+`@kubohiroya/turbowarp-app-shell`はDOMの機構を所有し、Scratch APIもアプリの語彙も持ちません。
+本パッケージはその上の層で、primitiveを合成してタイトル画面、アプリケーションメニュー、DSL
+ファイル保管を作り、blockとして公開する完成した拡張です。
+
+アプリケーションメニューは`createAppShellApplicationMenu`をそのまま使っており、同じ部品の二重
+実装ではありません。項目は本拡張の語彙なので、別の項目が必要なホストはcomposition API経由で同じ
+primitiveを自分で合成します。タイトルダイアログだけは本パッケージが持ちます。app-shellにはabout
+パネルのprimitiveがなく、こちらはタイトル・作者・ライセンス・Webサイトをまとめて表示するため、
+website/closeのボタン対とは別物だからです。
+
+## DSLファイルの保管
+
+`src/dsl-store.ts`は複数のDSLファイルをIndexedDBに保管します。データベースは、生成したidをkeyに
+持ち`name`に一意indexを張った`files` storeと、最後に開いたidを持つ`meta` storeで構成します。
+
+名前を一意にしているのは、一覧の意味を保ち、同じファイルを再度追加したときに重複を増やさず上書き
+するためです。storeが自分でレコードを消すことはありません。上限を超えるファイルや、件数上限を超える
+追加は、型付きの`DslStoreError`で拒否します。黙って以前のDSLを失うより、理由を運用者に伝えることを
+優先します。並べ替えはsummaryを読んだ後にメモリ上で行い、indexを増やさず、名前による同点処理で
+順序を安定させます。
+
+`src/dsl-files-dialog.ts`は表示と操作の状態だけを持ちます。並べ替え順、名前を編集中の行、削除の
+確認待ちの行の3つです。保管処理はすべて呼び出し側のコールバックなので、IndexedDBのstoreでも、
+テスト用の代替でも、将来のファイルシステム実装でも、ダイアログを変えずに使えます。

package/docs/architecture.md

@@ -0,0 +1,73 @@
+# Architecture
+
+[日本語](architecture.ja.md)
+
+## Build outputs
+
+The project keeps runtime behavior and compatibility metadata separate while generating both from
+the same checked-in source definitions.
+
+```text
+src/index.ts + src/extension.ts
+  -> vite-plugin-turbowarp-extension
+  -> dist/<extension>.js
+
+src/config.ts + src/block-definitions.json
+  -> extension-api-manifest Vite plugin
+  -> dist/extension-manifest.json
+```
+
+The manifest plugin runs in Vite's post-build phase. This preserves the JavaScript plugin's
+single-output validation and adds the manifest only after the TurboWarp bundle is complete.
+
+## Extension API manifest v1
+
+`schemas/extension-manifest.schema.json` is the normative JSON Schema. `formatVersion` is `1` and
+must change when an incompatible manifest shape is introduced.
+
+The v1 contract contains:
+
+- the TurboWarp extension ID;
+- each block opcode and block type;
+- each argument ID, argument type, and optional menu reference;
+- each menu ID and whether it accepts reporter blocks.
+
+Blocks, arguments, and menus are sorted by their identifiers before serialization. Text,
+descriptions, default values, and static menu items are intentionally excluded because they do not
+identify saved-project API references. A compatibility checker can therefore distinguish API
+changes from documentation or localization changes.
+
+## Drift detection
+
+`dist/` is committed as a release artifact. `npm run check:dist` rebuilds both files and fails when
+Git reports any modified, deleted, or untracked file below `dist/`. This catches manifest and bundle
+drift in local checks and CI.
+
+## Layering against turbowarp-app-shell
+
+`@kubohiroya/turbowarp-app-shell` owns the DOM mechanics and knows no Scratch API and no application
+vocabulary. This package is the layer above it: a finished TurboWarp extension that composes those
+primitives into a title screen, an application menu, and DSL file storage, and publishes them as
+blocks.
+
+The application menu is `createAppShellApplicationMenu` used directly, not a second implementation
+of the same control. Its actions are this extension's own vocabulary, so a host project that needs
+different actions composes the same primitive through the composition API instead of inheriting a
+fixed set. The title dialog stays local because app-shell has no about-panel primitive: it presents
+title, author, license, and website together rather than a website/close control pair.
+
+## DSL file storage
+
+`src/dsl-store.ts` keeps many DSL files in IndexedDB. The database holds a `files` store keyed by a
+generated id with a unique index on `name`, and a `meta` store holding the last opened id.
+
+Names are unique so a listing stays meaningful and re-adding the same file updates it in place
+instead of accumulating duplicates. The store never evicts a record: a file over the byte limit, or
+one past the file-count limit, is refused with a typed `DslStoreError` so the operator learns why
+rather than losing an earlier DSL silently. Sorting happens in memory after reading the summaries,
+which keeps the index set small and the order stable through a name tiebreak.
+
+`src/dsl-files-dialog.ts` owns presentation and interaction state only: the sort order, the row
+being renamed, and the row awaiting delete confirmation. Every storage operation is a caller
+supplied callback, so the dialog works against the IndexedDB store, a test double, or a future
+file-system backend without change.

package/docs/index.html

@@ -0,0 +1,34 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>TurboWarp Title Menu documentation</title>
+  <style>
+    body{font-family:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;max-width:900px;margin:0 auto;padding:2rem;line-height:1.6;color:#222}
+    code{background:#f3f3f3;padding:.1em .3em;border-radius:.25em}
+    pre{background:#f6f8fa;padding:1rem;overflow:auto;border-radius:.5rem}
+  </style>
+</head>
+<body>
+  <h1>TurboWarp Title Menu</h1>
+  <p>Reusable title, menu, and DSL source storage controls for TurboWarp projects.</p>
+
+  <h2>Blocks</h2>
+  <ul>
+    <li><code>show title dialog</code>: shows title, author, license, official website, and close controls above the stage.</li>
+    <li><code>show application menu</code>: shows a stage-mounted menu for DSL open, reload, about, and close actions.</li>
+    <li><code>has saved DSL source?</code>: reports whether localStorage contains a saved DSL source.</li>
+    <li><code>saved DSL file name</code>: reports the stored DSL source file name.</li>
+  </ul>
+
+  <h2>Composition API</h2>
+  <p>Host runtimes can import <code>createTitleDialog</code>, <code>createApplicationMenu</code>, and <code>createDslStorage</code> from <code>@kubohiroya/turbowarp-title-menu</code>, or use the <code>TurboWarpTitleMenu</code> global exposed by the standalone extension bundle.</p>
+
+  <h2>Safety</h2>
+  <p>The extension is unsandboxed because it mounts DOM controls and uses browser storage. Load reviewed builds only.</p>
+
+  <h2>Development</h2>
+  <p>See the repository README and architecture documentation for build, test, release, and compatibility details.</p>
+</body>
+</html>

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@kubohiroya/turbowarp-title-menu",
+  "version": "0.1.0",
+  "description": "Reusable title, application menu, and DSL source storage controls for TurboWarp.",
+  "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
+  "license": "MPL-2.0",
+  "homepage": "https://github.com/kubohiroya/turbowarp-title-menu#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kubohiroya/turbowarp-title-menu.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kubohiroya/turbowarp-title-menu/issues"
+  },
+  "keywords": [
+    "turbowarp",
+    "scratch",
+    "extension",
+    "menu",
+    "title",
+    "localstorage",
+    "dsl",
+    "vite",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/types/composition.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/composition.d.ts",
+      "import": "./dist/lib/composition.js"
+    },
+    "./composition": {
+      "types": "./dist/types/composition.d.ts",
+      "import": "./dist/lib/composition.js"
+    },
+    "./extension": "./dist/turbowarp-title-menu.js",
+    "./extension-manifest.json": "./dist/extension-manifest.json"
+  },
+  "files": [
+    "dist/",
+    "docs/",
+    "schemas/",
+    "src/",
+    "README.md",
+    "README.ja.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "packageManager": "pnpm@11.11.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "build": "vite build && tsc -p tsconfig.lib.json",
+    "lint": "eslint src tests vite.config.ts",
+    "test": "vitest run",
+    "docs": "node scripts/generate-readme.mjs",
+    "docs:check": "pnpm run docs && git diff --exit-code -- README.md",
+    "repo:check": "node scripts/check-repo.mjs",
+    "pack:check": "npm pack --dry-run --ignore-scripts",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run docs:check && pnpm run check:dist && pnpm run repo:check && pnpm run pack:check",
+    "check:dist": "pnpm run build && node scripts/check-dist.mjs"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.1.1",
+    "@types/node": "^24.13.3",
+    "eslint": "^9.39.5",
+    "fake-indexeddb": "6.2.5",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.66.0",
+    "vite": "^7.3.6",
+    "vitest": "^4.1.10"
+  },
+  "dependencies": {
+    "@kubohiroya/turbowarp-app-shell": "0.2.0"
+  }
+}

package/schemas/extension-manifest.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/kubohiroya/turbowarp-title-menu/main/schemas/extension-manifest.schema.json",
+  "title": "TurboWarp Extension API Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["formatVersion", "id", "blocks", "menus"],
+  "properties": {
+    "formatVersion": {"const": 1},
+    "id": {"type": "string", "pattern": "^[a-z0-9]+$"},
+    "blocks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["opcode", "blockType", "arguments"],
+        "properties": {
+          "opcode": {"type": "string", "minLength": 1},
+          "blockType": {"type": "string", "minLength": 1},
+          "arguments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "type"],
+              "properties": {
+                "id": {"type": "string", "minLength": 1},
+                "type": {"type": "string", "minLength": 1},
+                "menu": {"type": "string", "minLength": 1}
+              }
+            }
+          }
+        }
+      }
+    },
+    "menus": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "acceptReporters"],
+        "properties": {
+          "id": {"type": "string", "minLength": 1},
+          "acceptReporters": {"type": "boolean"}
+        }
+      }
+    }
+  }
+}

package/src/block-definitions.json

@@ -0,0 +1,65 @@
+{
+  "extensionName": "TurboWarp Title Menu",
+  "blocks": [
+    {
+      "opcode": "showTitle",
+      "blockType": "COMMAND",
+      "text": "show title dialog",
+      "description": "Shows the configured title dialog above the TurboWarp stage."
+    },
+    {
+      "opcode": "showMenu",
+      "blockType": "COMMAND",
+      "text": "show application menu",
+      "description": "Shows the application menu above the TurboWarp stage."
+    },
+    {
+      "opcode": "showDslFiles",
+      "blockType": "COMMAND",
+      "text": "show DSL file manager",
+      "description": "Shows the dialog that adds, opens, renames, deletes, and sorts stored DSL files."
+    },
+    {
+      "opcode": "whenDslSourceOpened",
+      "blockType": "HAT",
+      "text": "when a DSL source is opened",
+      "description": "Runs after the operator opens a stored DSL file, or after the opened source is announced again."
+    },
+    {
+      "opcode": "reloadOpenedDsl",
+      "blockType": "COMMAND",
+      "text": "reload the opened DSL source",
+      "description": "Announces the currently opened DSL source again without showing a dialog."
+    },
+    {
+      "opcode": "openedDslName",
+      "blockType": "REPORTER",
+      "text": "opened DSL file name",
+      "description": "Returns the name of the DSL file that is currently open, or an empty string."
+    },
+    {
+      "opcode": "openedDslSource",
+      "blockType": "REPORTER",
+      "text": "opened DSL source",
+      "description": "Returns the text of the DSL file that is currently open, or an empty string."
+    },
+    {
+      "opcode": "hasSavedDsl",
+      "blockType": "BOOLEAN",
+      "text": "has a saved DSL file?",
+      "description": "Reports whether at least one DSL file is stored in IndexedDB."
+    },
+    {
+      "opcode": "savedDslCount",
+      "blockType": "REPORTER",
+      "text": "saved DSL file count",
+      "description": "Returns how many DSL files are stored in IndexedDB."
+    },
+    {
+      "opcode": "lastDslError",
+      "blockType": "REPORTER",
+      "text": "last DSL storage error",
+      "description": "Returns the most recent DSL storage failure in the interface language, or an empty string."
+    }
+  ]
+}

package/src/composition.ts

@@ -0,0 +1,26 @@
+export {createAppShellApplicationMenu as createApplicationMenu} from '@kubohiroya/turbowarp-app-shell';
+export type {
+  AppShellApplicationMenuAction as ApplicationMenuAction,
+  AppShellApplicationMenuOptions as ApplicationMenuOptions
+} from '@kubohiroya/turbowarp-app-shell';
+export {createDslFilesDialog} from './dsl-files-dialog.js';
+export type {
+  DslFilesDialog,
+  DslFilesDialogLocaleText,
+  DslFilesDialogOptions
+} from './dsl-files-dialog.js';
+export {createDslStore, defaultDslSort, DslStoreError, readDslFile} from './dsl-store.js';
+export type {
+  DslFileRecord,
+  DslFileSummary,
+  DslSort,
+  DslSortDirection,
+  DslSortField,
+  DslStore,
+  DslStoreErrorCode,
+  DslStoreOptions
+} from './dsl-store.js';
+export {dslOpenEventName, dslReloadEventName} from './events.js';
+export type {DslSourceEventDetail} from './events.js';
+export {createTitleDialog} from './title-dialog.js';
+export type {TitleDialog, TitleDialogOptions, TitleDialogLocaleText} from './title-dialog.js';

package/src/config.ts

@@ -0,0 +1,13 @@
+export const extensionConfig = {
+  id: 'kubohiroyaturbowarptitlemenu',
+  slug: 'turbowarp-title-menu',
+  name: 'TurboWarp Title Menu',
+  description: 'Reusable title, application menu, and DSL source storage controls for TurboWarp.',
+  author: 'Hiroya Kubo',
+  license: 'MPL-2.0',
+  unsandboxed: true,
+  homepage: 'https://github.com/kubohiroya/turbowarp-title-menu',
+  docsURI: 'https://kubohiroya.github.io/turbowarp-title-menu/',
+  blockIconURI:
+    'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCI+PHJlY3QgeD0iNSIgeT0iOCIgd2lkdGg9IjM4IiBoZWlnaHQ9IjMyIiByeD0iNCIgZmlsbD0iIzAwN2Q2NiIvPjxyZWN0IHg9IjkiIHk9IjEyIiB3aWR0aD0iMzAiIGhlaWdodD0iMjQiIHJ4PSIyIiBmaWxsPSIjZjRmZmZiIi8+PHBhdGggZD0iTTE1IDE5aDE4TTE1IDI0aDE4TTE1IDI5aDEyIiBzdHJva2U9IiMwMDdkNjYiIHN0cm9rZS13aWR0aD0iMyIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIi8+PC9zdmc+'
+} as const;

package/src/dom.ts

@@ -0,0 +1,39 @@
+export type DomDocument = Document;
+export type DomElement = HTMLElement;
+
+export function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export function requireDocument(value: unknown): DomDocument {
+  if (!isRecord(value) || typeof value.createElement !== 'function') {
+    throw new TypeError('document must provide createElement');
+  }
+  return value as unknown as DomDocument;
+}
+
+export function requireElement(value: unknown, name: string): DomElement {
+  if (!isRecord(value) || typeof value.appendChild !== 'function') {
+    throw new TypeError(`${name} must be a DOM element`);
+  }
+  return value as unknown as DomElement;
+}
+
+export function ensureRelativeMount(mount: DomElement): () => void {
+  const previous = mount.style.position;
+  if (previous === '' || previous === 'static') {
+    mount.style.position = 'relative';
+    return () => {
+      mount.style.position = previous;
+    };
+  }
+  return () => {};
+}
+
+export function invokeSafely(operation: () => unknown | Promise<unknown>, onError?: (error: unknown) => void): void {
+  try {
+    Promise.resolve(operation()).catch((error: unknown) => onError?.(error));
+  } catch (error) {
+    onError?.(error);
+  }
+}