@dolphy-app/extension-sdk 0.2.0 → 0.4.0

package/README.md

@@ -1,24 +1,41 @@
 # @dolphy-app/extension-sdk
 
-SDK автора расширений: defineExtension, defineAnswerElement, помощники тестирования
+SDK for extension authors: defineExtension, defineAnswerView, test helpers
 
-Версия пакетов равна версии приложения Dolphy, из релиза которого они опубликованы (0.2.0).
+The package version equals the version of the Dolphy app release it was published from (0.4.0).
 
-`@dolphy-app/extension-sdk` — код расширения (`defineExtension`,
-`defineExerciseType`), элемент ответа (`defineAnswerElement`) и помощники
-тестов (`@dolphy-app/extension-sdk/testing`).
+`@dolphy-app/extension-sdk` — extension code (`defineExtension`,
+`defineExerciseType`), answer views (`defineAnswerView`), panels,
+markdown renderers and test helpers (`@dolphy-app/extension-sdk/testing`).
+The package has no side effects: an extension `src/index.ts` can be
+imported in plain Node. Ids declared in `extension.json` become types
+through `.dolphy/ids.d.ts`, which `dolphy-ext types` generates.
 
 ```ts
 import { defineExtension } from '@dolphy-app/extension-sdk';
 import { loadExerciseType } from '@dolphy-app/extension-sdk/testing';
 ```
 
-## Установка
+The package ships a guide in `docs/` (`node_modules/@dolphy-app/extension-sdk/docs/`
+after the install): a
+[quick start](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/quick-start.md), recipes for
+[an exercise type](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-exercise-type.md),
+[a theme](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-theme.md),
+[a command and a panel](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-command-panel.md),
+[events and storage](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-event-storage.md),
+[settings](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-settings.md),
+[an importer and an exporter](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-import-export.md),
+[visibility conditions and dependencies](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-when-dependencies.md) and
+[a panel on the UI kit](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/recipe-ui-kit.md), a path
+[without a build](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/no-build.md) and notes on
+[debugging](https://github.com/dolphy-app/dolphy/blob/main/packages/extension-sdk/docs/debugging.md).
+
+## Installation
 
 ```sh
 npm install @dolphy-app/extension-sdk
 ```
 
-## Документация
+## Documentation
 
-[Расширения Dolphy](https://github.com/dolphy-app/dolphy/blob/main/docs/design/extensions.md).
+[Dolphy extensions](https://github.com/dolphy-app/dolphy/blob/main/docs/design/extensions.md).

package/dist/answer-element-BOQcuxYh.js

@@ -0,0 +1,114 @@
+import { ANSWER_EVENT, ELEMENT_NAME_PATTERN } from "@dolphy-app/extension-api";
+
+//#region packages/extension-sdk/src/answer-element.ts
+const logFailure = (tag, message, error) => {
+	console.error({
+		error,
+		tag
+	}, message);
+};
+const createAnswerElementClass = (tag, answerView) => class AnswerElement extends HTMLElement {
+	#root = this.attachShadow({ mode: "open" });
+	#props = {
+		view: void 0,
+		value: void 0,
+		disabled: false,
+		verdict: null
+	};
+	#instance = null;
+	#isFlushScheduled = false;
+	get view() {
+		return this.#props.view;
+	}
+	set view(view) {
+		this.#change({ view });
+	}
+	get value() {
+		return this.#props.value;
+	}
+	set value(value) {
+		this.#change({ value });
+	}
+	get disabled() {
+		return this.#props.disabled;
+	}
+	set disabled(disabled) {
+		this.#change({ disabled });
+	}
+	get verdict() {
+		return this.#props.verdict;
+	}
+	set verdict(verdict) {
+		this.#change({ verdict });
+	}
+	connectedCallback() {
+		if (this.#instance !== null) return;
+		const readLabel = () => this.getAttribute("aria-label");
+		const api = {
+			root: this.#root,
+			get label() {
+				return readLabel();
+			},
+			setAnswer: (value, complete) => {
+				const detail = {
+					value,
+					complete
+				};
+				this.#emit(ANSWER_EVENT.change, detail);
+			},
+			submit: () => this.#emit(ANSWER_EVENT.submit, void 0)
+		};
+		try {
+			this.#instance = answerView.mount(api, Object.freeze({ ...this.#props }));
+		} catch (error) {
+			logFailure(tag, "answer element failed to mount", error);
+		}
+	}
+	disconnectedCallback() {
+		const instance = this.#instance;
+		this.#instance = null;
+		if (instance === null) return;
+		try {
+			instance.destroy?.();
+		} catch (error) {
+			logFailure(tag, "answer element failed to destroy", error);
+		}
+		this.#root.replaceChildren();
+	}
+	#change(patch) {
+		this.#props = {
+			...this.#props,
+			...patch
+		};
+		if (this.#instance === null || this.#isFlushScheduled) return;
+		this.#isFlushScheduled = true;
+		queueMicrotask(() => this.#flush());
+	}
+	#flush() {
+		this.#isFlushScheduled = false;
+		const instance = this.#instance;
+		if (instance === null) return;
+		try {
+			instance.update(Object.freeze({ ...this.#props }));
+		} catch (error) {
+			logFailure(tag, "answer element failed to update", error);
+		}
+	}
+	#emit(name, detail) {
+		this.dispatchEvent(new CustomEvent(name, {
+			detail,
+			bubbles: true,
+			composed: true
+		}));
+	}
+};
+/** Defines the kind's custom element; calling again with the same tag changes nothing. */
+const registerAnswerView = (tag, view) => {
+	if (!ELEMENT_NAME_PATTERN.test(tag)) throw new TypeError(`invalid custom element name '${tag}'`);
+	if (typeof view?.mount !== "function") throw new TypeError(`answer view for '${tag}' has no mount()`);
+	if (customElements.get(tag) !== void 0) return;
+	customElements.define(tag, createAnswerElementClass(tag, view));
+};
+
+//#endregion
+export { registerAnswerView as n, createAnswerElementClass as t };

package/dist/answer-view-D6wnyThb.d.ts

@@ -0,0 +1,28 @@
+import { AnswerElementProps } from "@dolphy-app/extension-api";
+//#region packages/extension-sdk/src/answer-view.d.ts
+interface AnswerViewApi {
+  readonly root: ShadowRoot;
+  /** `aria-label` of the host element set by the app; `null` if none. */
+  readonly label: string | null;
+  /** Reports the current answer to the app: the `dolphy-answer-change` event. */
+  setAnswer(value: unknown, complete: boolean): void;
+  /** Asks the app to submit the answer: the `dolphy-answer-submit` event. */
+  submit(): void;
+}
+interface AnswerViewInstance {
+  /** Called when `view`/`value`/`disabled`/`verdict` change. */
+  update(props: AnswerElementProps): void;
+  destroy?(): void;
+}
+type MountAnswerView = (api: AnswerViewApi, props: AnswerElementProps) => AnswerViewInstance;
+/** Description of an answer input view: side-effect-free data; the build registers the element. */
+interface AnswerView {
+  readonly mount: MountAnswerView;
+}
+/**
+ * Entry `views[<exercise kind id>]` in `src/index.ts`. Registers nothing:
+ * the custom element with the manifest tag is defined by the build's browser file.
+ */
+declare const defineAnswerView: (mount: MountAnswerView) => AnswerView;
+//#endregion
+export { defineAnswerView as a, MountAnswerView as i, AnswerViewApi as n, AnswerViewInstance as r, AnswerView as t };

package/dist/index.d.ts

@@ -1,36 +1,116 @@
-import { AnswerElementProps, ExerciseTypeHandler, ExtensionContext, ExtensionModule, GradePolicyHandler, MarkdownRenderContext, MarkdownRendererModule } from "@dolphy-app/extension-api";
+import { a as defineAnswerView, i as MountAnswerView, n as AnswerViewApi, r as AnswerViewInstance, t as AnswerView } from "./answer-view-D6wnyThb.js";
+import { CommandHandler, ExerciseTypeHandler, ExporterHandler, ExtensionContext as ExtensionContext$1, ExtensionIdSet, ExtensionModule, GradePolicyHandler, ImporterHandler, JsonValue, LearningEventHandler, MarkdownRenderContext, MarkdownRendererModule, NotifyEffect, OpenPanelEffect, PanelContext as PanelContext$1, PanelModule, ScheduleHandler, WidgetContext as WidgetContext$1, WidgetModule } from "@dolphy-app/extension-api";
 export * from "@dolphy-app/extension-api";
+//#region packages/extension-sdk/src/ids.d.ts
+/**
+ * The ids declared in `extension.json`. Empty here: `dolphy-ext types` (and
+ * every `dolphy-ext build`) writes `.dolphy/ids.d.ts`, which augments this
+ * interface with one key per kind of id:
+ *
+ * ```ts
+ * declare module '@dolphy-app/extension-sdk' {
+ *   interface ExtensionIds {
+ *     exerciseTypes: 'acme.echo';
+ *     commands: 'acme.a' | 'acme.b';
+ *     settings: { 'acme.goal': number };
+ *     // …
+ *   }
+ * }
+ * ```
+ *
+ * While the interface is empty (no generated file) every id is a plain
+ * `string` and `defineExtension` does not require any record.
+ */
+interface ExtensionIds {}
+type Declared<K extends keyof ExtensionIdSet> = K extends keyof ExtensionIds ? ExtensionIds[K] extends ExtensionIdSet[K] ? ExtensionIds[K] : ExtensionIdSet[K] : ExtensionIdSet[K];
+/** `ExtensionIds` with the plain-string fallback for the kinds it does not declare. */
+type ResolvedIds = { [K in keyof ExtensionIdSet]: Declared<K>; };
+/** Whether the generated declarations are part of the program. */
+type HasGeneratedIds = [keyof ExtensionIds] extends [never] ? false : true;
+/**
+ * `ExtensionContext` of this extension: `settings`, `events`, `commands` and
+ * the `register…` methods accept the declared ids only.
+ */
+type ExtensionContext = ExtensionContext$1<ResolvedIds>;
+/** Context of a panel module; `call` accepts the declared command ids only. */
+type PanelContext = PanelContext$1<ResolvedIds['commands']>;
+/** Context of a widget module; `call` accepts the declared command ids only. */
+type WidgetContext = WidgetContext$1<ResolvedIds['commands']>;
+/**
+ * A record that holds exactly the declared ids: a missing and an extra key are
+ * both compile errors. With no generated declarations any keys are accepted;
+ * with none declared of this kind no key is accepted.
+ */
+type Exact<Id extends string, Value> = [HasGeneratedIds] extends [false] ? {
+  readonly [key: string]: Value;
+} : [Id] extends [never] ? {
+  readonly [key: string]: never;
+} : { readonly [K in Id]: Value; };
+/** `export const views = { … } satisfies ExtensionViews`: one `defineAnswerView` per declared exercise type. */
+type ExtensionViews = Exact<ResolvedIds['exerciseTypes'], AnswerView>;
+/** `export const panels = { … } satisfies ExtensionPanels`: one `defineExtensionPanel` per declared panel. */
+type ExtensionPanels = Exact<ResolvedIds['panels'], PanelModule<HTMLElement, ResolvedIds['commands']>>;
+/** `export const widgets = { … } satisfies ExtensionWidgets`: one `defineExtensionWidget` per declared widget. */
+type ExtensionWidgets = Exact<ResolvedIds['widgets'], WidgetModule<HTMLElement, ResolvedIds['commands']>>;
+/** `export const markdown = { … } satisfies ExtensionMarkdown`: one `defineMarkdownRenderer` per declared language. */
+type ExtensionMarkdown = Exact<ResolvedIds['markdownLanguages'], MarkdownRendererModule<HTMLElement>>;
+//#endregion
+//#region packages/extension-sdk/src/commands.d.ts
+/** A command result: the app shows a notification (1–500 characters, as is, no markup). */
+export declare const notify: (text: string) => NotifyEffect;
+/** A command result: the app opens a panel of this extension (a declared panel id); `props` reach the panel as `ctx.props`. */
+export declare const openPanel: (panelId: ResolvedIds["panels"], props?: JsonValue) => OpenPanelEffect;
+//#endregion
 //#region packages/extension-sdk/src/define-extension.d.ts
-interface ExtensionDefinition {
-  exerciseTypes?: Readonly<Record<string, ExerciseTypeHandler>>;
-  gradePolicies?: Readonly<Record<string, GradePolicyHandler>>;
-  /** Вызывается после регистрации `exerciseTypes` и `gradePolicies`. */
+declare const inActivateBrand: unique symbol;
+/** Type of `inActivate`. */
+interface InActivate {
+  readonly [inActivateBrand]: true;
+}
+/**
+ * A record value in `defineExtension` that says "this id is registered in
+ * `activate`" (`ctx.commands.register`, `ctx.events.on`,
+ * `ctx.importers.register`, `ctx.exporters.register`, `ctx.schedule.on`,
+ * `ctx.registerExerciseType`, `ctx.registerGradePolicy`) rather than by a
+ * handler in the record. Needed because the records must name every declared
+ * id: a handler that needs `ctx` is written in `activate`, and its id gets this
+ * marker in the record.
+ */
+export declare const inActivate: InActivate;
+/** Without generated declarations a record may name any subset: an index signature already does, a record keyed by the event names needs `Partial`. */
+type Lenient<Entries> = string extends keyof Entries ? Entries : Partial<Entries>;
+/**
+ * The definition record of one kind of id. With generated declarations the
+ * record is required (when the manifest declares any id of the kind) and holds
+ * exactly the declared ids: a missing and an extra key are compile errors.
+ * Without them every key is accepted and the record is optional.
+ */
+type Section<Name extends string, Id extends string, Entries> = [HasGeneratedIds] extends [false] ? { readonly [N in Name]?: Lenient<Entries>; } : [Id] extends [never] ? { readonly [N in Name]?: never; } : { readonly [N in Name]: Entries; };
+type Ids = ResolvedIds;
+/** Learning-event handlers by event name; the events must be declared in `contributes.events`, the `learning.events` permission is needed. */
+type EventHandlers = { readonly [N in Ids['events']]: LearningEventHandler<N> | InActivate; };
+/**
+ * What `defineExtension` takes. `exerciseTypes`, `gradePolicies`, `events`,
+ * `commands`, `schedules`, `importers` and `exporters` name every id
+ * `extension.json` declares for them, exactly: a handler, or `inActivate` for
+ * an id that `activate` registers.
+ */
+type ExtensionDefinition = Section<'exerciseTypes', Ids['exerciseTypes'], { readonly [K in Ids['exerciseTypes']]: ExerciseTypeHandler | InActivate; }> & Section<'gradePolicies', Ids['gradePolicies'], { readonly [K in Ids['gradePolicies']]: GradePolicyHandler | InActivate; }> & Section<'events', Ids['events'], EventHandlers> & Section<'commands', Ids['commands'], { readonly [K in Ids['commands']]: CommandHandler | InActivate; }> & Section<'schedules', Ids['schedules'], { readonly [K in Ids['schedules']]: ScheduleHandler | InActivate; }> & Section<'importers', Ids['importers'], { readonly [K in Ids['importers']]: ImporterHandler | InActivate; }> & Section<'exporters', Ids['exporters'], { readonly [K in Ids['exporters']]: ExporterHandler | InActivate; }> & {
+  /** Runs after the records are registered. */
   activate?(context: ExtensionContext): void | Promise<void>;
   deactivate?(): void | Promise<void>;
-}
+};
 export declare const defineExerciseType: <Spec, Answer, View>(handler: ExerciseTypeHandler<Spec, Answer, View>) => ExerciseTypeHandler<Spec, Answer, View>;
-export declare const defineExtension: (definition: ExtensionDefinition) => ExtensionModule;
-//#endregion
-//#region packages/extension-sdk/src/answer-element.d.ts
-interface AnswerElementApi {
-  readonly root: ShadowRoot;
-  /** `aria-label` хост-элемента, выставленный приложением; `null`, если нет. */
-  readonly label: string | null;
-  /** Сообщает приложению текущий ответ: событие `dolphy-answer-change`. */
-  setAnswer(value: unknown, complete: boolean): void;
-  /** Просит приложение отправить ответ: событие `dolphy-answer-submit`. */
-  submit(): void;
-}
-interface AnswerElementInstance {
-  /** Вызывается при изменении `view`/`value`/`disabled`/`verdict`. */
-  update(props: AnswerElementProps): void;
-  destroy?(): void;
-}
-type MountAnswerElement = (api: AnswerElementApi, props: AnswerElementProps) => AnswerElementInstance;
-export declare const defineAnswerElement: (tag: string, mount: MountAnswerElement) => void;
+export declare const defineExtension: (declared: ExtensionDefinition) => ExtensionModule;
 //#endregion
 //#region packages/extension-sdk/src/markdown-renderer.d.ts
-/** `export default defineMarkdownRenderer(...)` в модуле рендерера содержимого. */
+/** Entry `markdown[<language>]` in `src/index.ts` (`contributes.markdownRenderers`). */
 export declare const defineMarkdownRenderer: (render: (source: string, container: HTMLElement, context: MarkdownRenderContext) => void | Promise<void>) => MarkdownRendererModule<HTMLElement>;
 //#endregion
-export type { AnswerElementApi, AnswerElementInstance, ExtensionDefinition, MountAnswerElement };
+//#region packages/extension-sdk/src/panel.d.ts
+/** An entry of `panels[<panel id>]` in `src/index.ts` (`contributes.panels`); `ctx.call` accepts the declared command ids. */
+export declare const defineExtensionPanel: (module: PanelModule<HTMLElement, ResolvedIds["commands"]>) => PanelModule<HTMLElement, ResolvedIds["commands"]>;
+/** An entry of `widgets[<widget id>]` in `src/index.ts` (`contributes.widgets`); `ctx.call` accepts the declared command ids. */
+export declare const defineExtensionWidget: (module: WidgetModule<HTMLElement, ResolvedIds["commands"]>) => WidgetModule<HTMLElement, ResolvedIds["commands"]>;
+//#endregion
+export { type AnswerView, type AnswerViewApi, type AnswerViewInstance, type EventHandlers, type ExtensionContext, type ExtensionDefinition, type ExtensionIds, type ExtensionMarkdown, type ExtensionPanels, type ExtensionViews, type ExtensionWidgets, type InActivate, type MountAnswerView, type PanelContext, type WidgetContext, defineAnswerView };

package/dist/index.js

@@ -1,9 +1,27 @@
-import { ANSWER_EVENT, ELEMENT_NAME_PATTERN } from "@dolphy-app/extension-api";
-
 export * from "@dolphy-app/extension-api"
 
+//#region packages/extension-sdk/src/commands.ts
+/** A command result: the app shows a notification (1–500 characters, as is, no markup). */
+const notify = (text) => ({ notify: text });
+/** A command result: the app opens a panel of this extension (a declared panel id); `props` reach the panel as `ctx.props`. */
+const openPanel = (panelId, props) => props === void 0 ? { openPanel: panelId } : {
+	openPanel: panelId,
+	props
+};
+
+//#endregion
 //#region packages/extension-sdk/src/define-extension.ts
-const defineExerciseType = (handler) => handler;
+/**
+* A record value in `defineExtension` that says "this id is registered in
+* `activate`" (`ctx.commands.register`, `ctx.events.on`,
+* `ctx.importers.register`, `ctx.exporters.register`, `ctx.schedule.on`,
+* `ctx.registerExerciseType`, `ctx.registerGradePolicy`) rather than by a
+* handler in the record. Needed because the records must name every declared
+* id: a handler that needs `ctx` is written in `activate`, and its id gets this
+* marker in the record.
+*/
+const inActivate = /*#__PURE__*/ Object.freeze({});
+const defineExerciseType = /* @__NO_SIDE_EFFECTS__ */ (handler) => handler;
 const disposeInReverse = async (registrations) => {
 	const errors = [];
 	for (const registration of registrations.splice(0).reverse()) try {
@@ -13,12 +31,19 @@ const disposeInReverse = async (registrations) => {
 	}
 	return errors;
 };
-const defineExtension = (definition) => {
+/** The entries of a record that carry a handler (not `inActivate`). */
+const handlersOf = (record) => Object.entries(record ?? {}).filter((entry) => entry[1] !== inActivate);
+const defineExtension = /* @__NO_SIDE_EFFECTS__ */ (declared) => {
+	const definition = declared;
 	const registrations = [];
 	const register = (context) => {
-		const entries = Object.entries(definition.exerciseTypes ?? {});
-		for (const [type, handler] of entries) registrations.push(context.registerExerciseType(type, handler));
-		for (const [id, handler] of Object.entries(definition.gradePolicies ?? {})) registrations.push(context.registerGradePolicy(id, handler));
+		for (const [type, handler] of handlersOf(definition.exerciseTypes)) registrations.push(context.registerExerciseType(type, handler));
+		for (const [id, handler] of handlersOf(definition.gradePolicies)) registrations.push(context.registerGradePolicy(id, handler));
+		for (const [name, handler] of handlersOf(definition.events)) registrations.push(context.events.on(name, handler));
+		for (const [id, handler] of handlersOf(definition.commands)) registrations.push(context.commands.register(id, handler));
+		for (const [id, handler] of handlersOf(definition.schedules)) registrations.push(context.schedule.on(id, handler));
+		for (const [id, handler] of handlersOf(definition.importers)) registrations.push(context.importers.register(id, handler));
+		for (const [id, handler] of handlersOf(definition.exporters)) registrations.push(context.exporters.register(id, handler));
 	};
 	const activate = async (context) => {
 		try {
@@ -49,118 +74,24 @@ const defineExtension = (definition) => {
 };
 
 //#endregion
-//#region packages/extension-sdk/src/answer-element.ts
-const logFailure = (tag, message, error) => {
-	console.error({
-		error,
-		tag
-	}, message);
-};
-const createAnswerElementClass = (tag, mount) => class AnswerElement extends HTMLElement {
-	#root = this.attachShadow({ mode: "open" });
-	#props = {
-		view: void 0,
-		value: void 0,
-		disabled: false,
-		verdict: null
-	};
-	#instance = null;
-	#isFlushScheduled = false;
-	get view() {
-		return this.#props.view;
-	}
-	set view(view) {
-		this.#change({ view });
-	}
-	get value() {
-		return this.#props.value;
-	}
-	set value(value) {
-		this.#change({ value });
-	}
-	get disabled() {
-		return this.#props.disabled;
-	}
-	set disabled(disabled) {
-		this.#change({ disabled });
-	}
-	get verdict() {
-		return this.#props.verdict;
-	}
-	set verdict(verdict) {
-		this.#change({ verdict });
-	}
-	connectedCallback() {
-		if (this.#instance !== null) return;
-		const readLabel = () => this.getAttribute("aria-label");
-		const api = {
-			root: this.#root,
-			get label() {
-				return readLabel();
-			},
-			setAnswer: (value, complete) => {
-				const detail = {
-					value,
-					complete
-				};
-				this.#emit(ANSWER_EVENT.change, detail);
-			},
-			submit: () => this.#emit(ANSWER_EVENT.submit, void 0)
-		};
-		try {
-			this.#instance = mount(api, Object.freeze({ ...this.#props }));
-		} catch (error) {
-			logFailure(tag, "answer element failed to mount", error);
-		}
-	}
-	disconnectedCallback() {
-		const instance = this.#instance;
-		this.#instance = null;
-		if (instance === null) return;
-		try {
-			instance.destroy?.();
-		} catch (error) {
-			logFailure(tag, "answer element failed to destroy", error);
-		}
-		this.#root.replaceChildren();
-	}
-	#change(patch) {
-		this.#props = {
-			...this.#props,
-			...patch
-		};
-		if (this.#instance === null || this.#isFlushScheduled) return;
-		this.#isFlushScheduled = true;
-		queueMicrotask(() => this.#flush());
-	}
-	#flush() {
-		this.#isFlushScheduled = false;
-		const instance = this.#instance;
-		if (instance === null) return;
-		try {
-			instance.update(Object.freeze({ ...this.#props }));
-		} catch (error) {
-			logFailure(tag, "answer element failed to update", error);
-		}
-	}
-	#emit(name, detail) {
-		this.dispatchEvent(new CustomEvent(name, {
-			detail,
-			bubbles: true,
-			composed: true
-		}));
-	}
-};
-const defineAnswerElement = (tag, mount) => {
-	if (!ELEMENT_NAME_PATTERN.test(tag)) throw new TypeError(`invalid custom element name '${tag}'`);
-	if (customElements.get(tag) !== void 0) return;
-	customElements.define(tag, createAnswerElementClass(tag, mount));
-};
+//#region packages/extension-sdk/src/answer-view.ts
+/**
+* Entry `views[<exercise kind id>]` in `src/index.ts`. Registers nothing:
+* the custom element with the manifest tag is defined by the build's browser file.
+*/
+const defineAnswerView = /* @__NO_SIDE_EFFECTS__ */ (mount) => ({ mount });
 
 //#endregion
 //#region packages/extension-sdk/src/markdown-renderer.ts
-/** `export default defineMarkdownRenderer(...)` в модуле рендерера содержимого. */
-const defineMarkdownRenderer = (render) => ({ render });
+/** Entry `markdown[<language>]` in `src/index.ts` (`contributes.markdownRenderers`). */
+const defineMarkdownRenderer = /* @__NO_SIDE_EFFECTS__ */ (render) => ({ render });
+
+//#endregion
+//#region packages/extension-sdk/src/panel.ts
+/** An entry of `panels[<panel id>]` in `src/index.ts` (`contributes.panels`); `ctx.call` accepts the declared command ids. */
+const defineExtensionPanel = /* @__NO_SIDE_EFFECTS__ */ (module) => module;
+/** An entry of `widgets[<widget id>]` in `src/index.ts` (`contributes.widgets`); `ctx.call` accepts the declared command ids. */
+const defineExtensionWidget = /* @__NO_SIDE_EFFECTS__ */ (module) => module;
 
 //#endregion
-export { defineAnswerElement, defineExerciseType, defineExtension, defineMarkdownRenderer };
+export { defineAnswerView, defineExerciseType, defineExtension, defineExtensionPanel, defineExtensionWidget, defineMarkdownRenderer, inActivate, notify, openPanel };

package/dist/runtime.d.ts

@@ -0,0 +1,17 @@
+import { t as AnswerView } from "./answer-view-D6wnyThb.js";
+import { MarkdownRendererModule, PanelModule, WidgetModule } from "@dolphy-app/extension-api";
+//#region packages/extension-sdk/src/answer-element.d.ts
+/** Defines the kind's custom element; calling again with the same tag changes nothing. */
+export declare const registerAnswerView: (tag: string, view: AnswerView) => void;
+//#endregion
+//#region packages/extension-sdk/src/runtime.d.ts
+type PanelEntry = PanelModule<HTMLElement>;
+type WidgetEntry = WidgetModule<HTMLElement>;
+type MarkdownEntry = MarkdownRendererModule<HTMLElement>;
+/** Panel module that selects the `panels` entry by `ctx.panelId` (for a file shared by several panels). */
+export declare const dispatchPanels: (panels: Readonly<Record<string, PanelEntry>>) => PanelEntry;
+/** Widget module that selects the `widgets` entry by `ctx.widgetId` (for a file shared by several widgets). */
+export declare const dispatchWidgets: (widgets: Readonly<Record<string, WidgetEntry>>) => WidgetEntry;
+/** Renderer module that selects the `markdown` entry by block language. */
+export declare const dispatchMarkdown: (renderers: Readonly<Record<string, MarkdownEntry>>) => MarkdownEntry;
+//#endregion

package/dist/runtime.js

@@ -0,0 +1,24 @@
+import { n as registerAnswerView } from "./answer-element-BOQcuxYh.js";
+
+//#region packages/extension-sdk/src/runtime.ts
+/** Panel module that selects the `panels` entry by `ctx.panelId` (for a file shared by several panels). */
+const dispatchPanels = (panels) => ({ mount(container, context) {
+	const panel = panels[context.panelId];
+	if (panel === void 0) throw new Error(`panel '${context.panelId}' is not exported`);
+	return panel.mount(container, context);
+} });
+/** Widget module that selects the `widgets` entry by `ctx.widgetId` (for a file shared by several widgets). */
+const dispatchWidgets = (widgets) => ({ mount(container, context) {
+	const widget = widgets[context.widgetId];
+	if (widget === void 0) throw new Error(`widget '${context.widgetId}' is not exported`);
+	return widget.mount(container, context);
+} });
+/** Renderer module that selects the `markdown` entry by block language. */
+const dispatchMarkdown = (renderers) => ({ render(source, container, context) {
+	const renderer = renderers[context.language];
+	if (renderer === void 0) throw new Error(`markdown renderer '${context.language}' is not exported`);
+	return renderer.render(source, container, context);
+} });
+
+//#endregion
+export { dispatchMarkdown, dispatchPanels, dispatchWidgets, registerAnswerView };