@mdwrk/extension-host 1.0.1

package/README.md

@@ -0,0 +1,49 @@
+# mdwrk/extension-host
+
+Stable host API, lifecycle, context, and registration contracts for Markdown Workspace extensions.
+
+## Package purpose
+
+This package is the extension-facing boundary for interacting with the host application.
+
+## What it exports
+
+- host API contracts
+- extension context contract
+- lifecycle contracts
+- primitive utility types
+- registration contracts for commands, views, components, settings sections, and action rail items
+- i18n catalog and locale-loader registration contracts
+- theme inspection, bridge, preview, and CSS export contracts
+
+## Authoring rule
+
+Extension packages must use this package rather than importing `apps/client/*` internals directly.
+
+## Important Phase 9 APIs
+
+### i18n
+Use:
+- `context.registerLocaleCatalog(...)`
+- `context.registerLocaleCatalogLoader(...)`
+- `host.i18n.ensureLocale()`
+- `host.i18n.format(...)`
+
+### theme
+Use:
+- `host.theme.getTokenMap()`
+- `host.theme.getThemeBridge(target)`
+- `host.theme.getThemeBridgeVariables(target)`
+- `host.theme.previewTheme(...)`
+- `host.theme.applyDraft()`
+- `host.theme.exportThemeCss(...)`
+
+## Build
+
+```bash
+npm run build -w @mdwrk/extension-host
+```
+
+## Publishability
+
+This package is structured as a standalone publishable npm package with typed exports and generated build output under `dist/`.

package/dist/context.d.ts

@@ -0,0 +1,27 @@
+import type { ExtensionCapability, ExtensionManifest } from "@mdwrk/extension-manifest";
+import type { ExtensionLocaleCatalog, ExtensionLocaleCatalogLoader, ExtensionHost, HostEnvironment } from "./host.js";
+import type { Disposable, JsonValue } from "./primitives.js";
+import type { RegisteredActionRailItem, RegisteredCommand, RegisteredComponent, RegisteredSettingsSection, RegisteredView } from "./registration.js";
+export interface ExtensionConfigurationStore {
+    get<T extends JsonValue = JsonValue>(key: string): Promise<T | null>;
+    set<T extends JsonValue = JsonValue>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    watch<T extends JsonValue = JsonValue>(key: string, listener: (value: T | null) => void): Disposable;
+}
+export interface ExtensionContext {
+    readonly extensionId: string;
+    readonly manifest: ExtensionManifest;
+    readonly capabilities: readonly ExtensionCapability[];
+    readonly host: ExtensionHost;
+    readonly environment: HostEnvironment;
+    readonly config: ExtensionConfigurationStore;
+    registerCommand(command: RegisteredCommand): Disposable;
+    registerView(view: RegisteredView): Disposable;
+    registerComponent(component: RegisteredComponent): Disposable;
+    registerActionRailItem(item: RegisteredActionRailItem): Disposable;
+    registerSettingsSection(section: RegisteredSettingsSection): Disposable;
+    registerLocaleCatalog(catalog: ExtensionLocaleCatalog): Disposable;
+    registerLocaleCatalogLoader(loader: ExtensionLocaleCatalogLoader): Disposable;
+    registerService<T>(token: string, service: T): Disposable;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,aAAa,EACb,eAAe,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,UAAU,CAAC;CACtG;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACxD,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAAC;IAC/C,iBAAiB,CAAC,SAAS,EAAE,mBAAmB,GAAG,UAAU,CAAC;IAC9D,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,UAAU,CAAC;IACnE,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU,CAAC;IACxE,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAAC;IACnE,2BAA2B,CAAC,MAAM,EAAE,4BAA4B,GAAG,UAAU,CAAC;IAC9E,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;CAC3D"}

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}

package/dist/host.d.ts

@@ -0,0 +1,149 @@
+import type { ActionRailContributionDescriptor, ExtensionCapability, I18nLabel, ViewContributionDescriptor } from "@mdwrk/extension-manifest";
+import type { MarkdownWorkspaceThemeClassName, MarkdownWorkspaceThemeTokenMap, MarkdownWorkspaceThemeTokenName, ThemeBridgeTarget, ThemeBridgeVariableDefinition, ThemeClassDefinition, ThemePreset, ThemeTokenDefinition } from "@mdwrk/theme-contract";
+import type { Disposable, MaybePromise } from "./primitives.js";
+export interface HostCommandApi {
+    execute<T = unknown>(id: string, ...args: unknown[]): Promise<T>;
+    list(): Promise<readonly string[]>;
+}
+export interface HostViewApi {
+    open(id: string, input?: unknown): Promise<void>;
+    close(id: string): Promise<void>;
+    focus(id: string): Promise<void>;
+    list(): Promise<readonly ViewContributionDescriptor[]>;
+}
+export interface HostActionRailApi {
+    list(): Promise<readonly ActionRailContributionDescriptor[]>;
+    reveal(id: string): Promise<void>;
+    setBadge(id: string, value: number | null): Promise<void>;
+}
+export interface HostSettingsApi {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    watch<T = unknown>(key: string, listener: (value: T | null) => void): Disposable;
+}
+export interface HostNotificationOptions {
+    readonly title?: string;
+    readonly actions?: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+    readonly sticky?: boolean;
+}
+export interface HostNotificationApi {
+    info(message: I18nLabel | string, options?: HostNotificationOptions): Promise<void>;
+    warn(message: I18nLabel | string, options?: HostNotificationOptions): Promise<void>;
+    error(message: I18nLabel | string, options?: HostNotificationOptions): Promise<void>;
+}
+export interface HostThemeCssExportOptions {
+    readonly selector?: string;
+    readonly target?: "host" | ThemeBridgeTarget;
+}
+export interface HostThemeApi {
+    getToken(token: MarkdownWorkspaceThemeTokenName): Promise<string | null>;
+    getTokenMap(): Promise<MarkdownWorkspaceThemeTokenMap>;
+    getTokens(): Promise<readonly ThemeTokenDefinition[]>;
+    getClassNames(): Promise<readonly ThemeClassDefinition[]>;
+    getThemeBridge(target: ThemeBridgeTarget): Promise<readonly ThemeBridgeVariableDefinition[]>;
+    getThemeBridgeVariables(target: ThemeBridgeTarget): Promise<Readonly<Record<`--${string}`, string>>>;
+    setDraftToken(token: MarkdownWorkspaceThemeTokenName, value: string): Promise<void>;
+    setDraftTokens(tokens: Partial<Record<MarkdownWorkspaceThemeTokenName, string>>): Promise<void>;
+    previewTheme(preset: ThemePreset | Partial<Record<MarkdownWorkspaceThemeTokenName, string>>): Promise<void>;
+    applyDraft(): Promise<void>;
+    discardDraft(): Promise<void>;
+    exportTheme(): Promise<ThemePreset>;
+    exportThemeCss(options?: HostThemeCssExportOptions): Promise<string>;
+    supportsClass(className: MarkdownWorkspaceThemeClassName): Promise<boolean>;
+}
+export interface ActiveDocument {
+    readonly uri: string;
+    readonly language: string;
+    readonly content: string;
+    readonly version?: string;
+}
+export interface SelectionRange {
+    readonly start: number;
+    readonly end: number;
+    readonly text?: string;
+}
+export interface HostEditorApi {
+    getActiveDocument(): Promise<ActiveDocument | null>;
+    getSelections(): Promise<readonly SelectionRange[]>;
+    insertText(text: string): Promise<void>;
+    replaceSelections(next: string | readonly string[]): Promise<void>;
+    setDocumentContent(content: string): Promise<void>;
+}
+export interface WorkspaceProjectSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly path?: string;
+}
+export interface WorkspaceFileSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly path: string;
+    readonly kind: "file" | "folder";
+}
+export interface HostWorkspaceApi {
+    listProjects(): Promise<readonly WorkspaceProjectSummary[]>;
+    getActiveProject(): Promise<WorkspaceProjectSummary | null>;
+    getActiveFile(): Promise<WorkspaceFileSummary | null>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+}
+export interface ExtensionLocaleCatalog {
+    readonly locale: string;
+    readonly messages: Readonly<Record<string, string>>;
+}
+export interface ExtensionLocaleCatalogLoader {
+    readonly defaultLocale?: string;
+    readonly fallbackLocale?: string;
+    readonly loaders: Readonly<Record<string, () => ExtensionLocaleCatalog | Promise<ExtensionLocaleCatalog>>>;
+}
+export interface HostI18nApi {
+    getLocale(): Promise<string>;
+    setLocale(locale: string): Promise<void>;
+    ensureLocale(locale?: string): Promise<void>;
+    format(label: I18nLabel | string): string;
+    registerCatalog(extensionId: string, catalog: ExtensionLocaleCatalog): Disposable;
+    registerCatalogLoader(extensionId: string, loader: ExtensionLocaleCatalogLoader): Disposable;
+}
+export interface DiagnosticRecord {
+    readonly severity: "info" | "warning" | "error";
+    readonly code: string;
+    readonly message: string;
+    readonly detail?: string;
+}
+export interface HostDiagnosticsApi {
+    publish(extensionId: string, record: DiagnosticRecord): Promise<void>;
+    clear(extensionId: string): Promise<void>;
+}
+export interface HostLoggerApi {
+    debug(message: string, context?: unknown): MaybePromise<void>;
+    info(message: string, context?: unknown): MaybePromise<void>;
+    warn(message: string, context?: unknown): MaybePromise<void>;
+    error(message: string, context?: unknown): MaybePromise<void>;
+}
+export interface HostEnvironment {
+    readonly platform: "web" | "desktop" | "server";
+    readonly mode: "development" | "production" | "test";
+    readonly hostVersion: string;
+    readonly runtimeVersion: string;
+    readonly grantedCapabilities?: readonly ExtensionCapability[];
+}
+export interface ExtensionHost {
+    readonly apiVersion: string;
+    readonly commands: HostCommandApi;
+    readonly views: HostViewApi;
+    readonly actionRail: HostActionRailApi;
+    readonly settings: HostSettingsApi;
+    readonly notifications: HostNotificationApi;
+    readonly theme: HostThemeApi;
+    readonly editor: HostEditorApi;
+    readonly workspace: HostWorkspaceApi;
+    readonly i18n: HostI18nApi;
+    readonly diagnostics: HostDiagnosticsApi;
+    readonly logger: HostLoggerApi;
+    readonly environment: HostEnvironment;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}

package/dist/host.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./context.js";
+export * from "./host.js";
+export * from "./lifecycle.js";
+export * from "./primitives.js";
+export * from "./registration.js";
+export * from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./context.js";
+export * from "./host.js";
+export * from "./lifecycle.js";
+export * from "./primitives.js";
+export * from "./registration.js";
+export * from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,14 @@
+import type { ExtensionManifest } from "@mdwrk/extension-manifest";
+import type { ExtensionContext } from "./context.js";
+import type { Disposable, MaybePromise } from "./primitives.js";
+export interface ExtensionActivationResult {
+    readonly dispose?: Disposable;
+}
+export type ActivateExtension = (context: ExtensionContext) => MaybePromise<void | Disposable | ExtensionActivationResult>;
+export type DeactivateExtension = (context: ExtensionContext) => MaybePromise<void>;
+export interface MarkdownWorkspaceExtension {
+    readonly manifest: ExtensionManifest;
+    activate: ActivateExtension;
+    deactivate?: DeactivateExtension;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,CAAC,IAAI,GAAG,UAAU,GAAG,yBAAyB,CAAC,CAAC;AAC3H,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEpF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/lifecycle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":""}

package/dist/primitives.d.ts

@@ -0,0 +1,10 @@
+export type MaybePromise<T> = T | Promise<T>;
+export interface Disposable {
+    dispose(): void;
+}
+export type Unsubscribe = Disposable;
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+export type JsonValue = string | number | boolean | null | JsonObject | readonly JsonValue[];
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC;AAErC,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,GACV,SAAS,SAAS,EAAE,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":""}

package/dist/registration.d.ts

@@ -0,0 +1,17 @@
+import type { ActionRailContributionDescriptor, CommandContributionDescriptor, ComponentContributionDescriptor, SettingsSectionContributionDescriptor, ViewContributionDescriptor } from "@mdwrk/extension-manifest";
+export type ViewRenderer<Props = unknown> = (props: Props) => unknown;
+export type ComponentRenderer<Props = unknown> = (props: Props) => unknown;
+export interface RegisteredCommand extends CommandContributionDescriptor {
+    execute: (...args: unknown[]) => unknown | Promise<unknown>;
+}
+export interface RegisteredView extends ViewContributionDescriptor {
+    render: ViewRenderer;
+}
+export interface RegisteredComponent extends ComponentContributionDescriptor {
+    render: ComponentRenderer;
+}
+export interface RegisteredSettingsSection extends SettingsSectionContributionDescriptor {
+}
+export interface RegisteredActionRailItem extends ActionRailContributionDescriptor {
+}
+//# sourceMappingURL=registration.d.ts.map

package/dist/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EAChC,6BAA6B,EAC7B,+BAA+B,EAC/B,qCAAqC,EACrC,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;AACtE,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;AAE3E,MAAM,WAAW,iBAAkB,SAAQ,6BAA6B;IACtE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,cAAe,SAAQ,0BAA0B;IAChE,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,+BAA+B;IAC1E,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,yBAA0B,SAAQ,qCAAqC;CAAG;AAE3F,MAAM,WAAW,wBAAyB,SAAQ,gCAAgC;CAAG"}

package/dist/registration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registration.js.map

package/dist/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const EXTENSION_HOST_API_VERSION: "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,EAAG,OAAgB,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const EXTENSION_HOST_API_VERSION = "1.0.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAgB,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "version": "1.0.1",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20 <23"
+  },
+  "keywords": [
+    "markdown-workspace",
+    "contracts",
+    "typescript"
+  ],
+  "name": "@mdwrk/extension-host",
+  "description": "Stable host API, lifecycle, and context contracts for Markdown Workspace extensions.",
+  "dependencies": {
+    "@mdwrk/extension-manifest": "^1.0.0",
+    "@mdwrk/theme-contract": "^1.0.0"
+  },
+  "scripts": {
+    "build:deps": "npm run build -w @mdwrk/extension-manifest && npm run build -w @mdwrk/theme-contract",
+    "build": "npm run build:deps && tsc -p tsconfig.json",
+    "typecheck": "npm run build:deps && tsc --noEmit -p tsconfig.json",
+    "lint": "npm run typecheck",
+    "test": "npm run typecheck",
+    "prepack": "npm run build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "import": "./dist/version.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives.d.ts",
+      "import": "./dist/primitives.js"
+    },
+    "./registration": {
+      "types": "./dist/registration.d.ts",
+      "import": "./dist/registration.js"
+    },
+    "./host": {
+      "types": "./dist/host.d.ts",
+      "import": "./dist/host.js"
+    },
+    "./context": {
+      "types": "./dist/context.d.ts",
+      "import": "./dist/context.js"
+    },
+    "./lifecycle": {
+      "types": "./dist/lifecycle.d.ts",
+      "import": "./dist/lifecycle.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Jacob Stewart <jacob@swarmauri.com>",
+  "homepage": "https://mdwrk.com"
+}