@io7/quantum-plugin-sdk 0.1.0-nightly.20260914.3.3

package/README.md

@@ -0,0 +1,116 @@
+# Quantum TypeScript Plugin SDK
+
+> **Experimental:** JavaScript/TypeScript plugin development is still experimental. Many capabilities are not yet available, so it is not recommended as the primary development path. Prefer the .NET SDK for the current release.
+
+`@io7/quantum-plugin-sdk` provides the typed lifecycle and host-capability contract for Quantum Web plugins.
+Web plugins execute in a dedicated sandboxed iframe. The iframe is destroyed on unload, so timers, DOM state,
+module globals, and event handlers cannot leak into the next runtime generation.
+
+The .NET-only `IQuantumPlugin.ConfigureServices` hook configures a private `IServiceCollection` and therefore has
+no TypeScript equivalent. Web plugins do not own a .NET DI container; use `activate` and its cleanup result for
+runtime state and lifecycle, and consume Host capabilities through the supplied context.
+
+```ts
+import { definePlugin, QuantumTopic } from "@io7/quantum-plugin-sdk";
+
+export default definePlugin({
+  async activate(context) {
+    await context.log.info("Plugin activated");
+    const topic = QuantumTopic.of("devices.status");
+    const subscription = await context.eventBus.subscribe(topic, event => {
+      const payload = event.payload as { state?: string };
+      return context.log.info(`${event.publisher.id}: ${payload.state ?? "unknown"}`);
+    });
+    const publisher = context.eventBus.createPublisher<{ state: string }>(topic);
+    await publisher.publish({ state: "ready" });
+    return () => subscription.dispose();
+  },
+
+  mount({ element, route, locale, signal }) {
+    element.textContent = `${route.path} (${locale.cultureName})`;
+    signal.addEventListener("abort", () => element.replaceChildren(), { once: true });
+  }
+});
+```
+
+`QuantumPluginViewContext.locale` carries the Host-selected BCP-47 culture, ISO language, and text direction.
+The Host remounts the view when the user changes language, so render localized copy and create locale-sensitive
+`Intl` formatters inside `mount`.
+
+The emitted plugin entry must be a single self-contained ESM file. Bundle dependencies into the entry with
+esbuild, Rollup, Vite, or another ESM-capable bundler; runtime imports are intentionally unavailable inside the
+opaque-origin frame.
+
+Database schema migrations are package metadata rather than an iframe API. A Web plugin may use Prisma, Drizzle,
+or another ORM during development, but its release declares `database.migrations` in `plugin.json` and ships an
+append-only SQLite SQL history. The Host applies pending scripts before `activate`; the iframe receives no direct
+database connection. See the repository Web plugin guide for the artifact and upgrade rules.
+
+Installed plugins run as trusted, controlled code. Host navigation and name-routed plugin RPC are directly available;
+an `integration` declaration is not required. TypeScript and .NET use the same RPC names and JSON boundary:
+
+```ts
+const result = await context.rpc.invoke<Note[]>(
+  "quantum.plugin.notes.notes.find",
+  { text: "quantum" },
+  { traceId: "web-search" },
+  { signal: context.signal });
+
+if (!result.isSuccess) {
+  throw new Error(`${result.errorCode}: ${result.message}`);
+}
+console.log(result.value);
+```
+
+The same method can be addressed by its short `service.method` name or any method-level alias. Names are
+case-insensitive. When multiple plugins implement a short name or alias, the Host logs the collision and selects
+the implementation whose normalized plugin id is lexicographically smallest using ordinal comparison. A missing
+name resolves to a failed `QuantumResult` with `rpc_not_found` instead of rejecting the Promise.
+
+Each invocation owns a target DI scope, awaits the generated NOF Handler, serializes its `Result`, and then disposes
+the scope. No CLR type name, service provider, or service instance enters the iframe.
+Entries in `environment.snapshot().integrations` are informational declarations used for soft ordering; their `active`
+field reports target availability and version compatibility but does not authorize or block interaction.
+
+## Plugin identity and version value objects
+
+`QuantumPluginInfo` and `QuantumPluginIdentity` use the branded `PluginId` and `SemanticVersion` string types.
+Construct external values at the boundary instead of casting unchecked strings:
+
+```ts
+import { PluginId, SemanticVersion, VersionRange } from "@io7/quantum-plugin-sdk";
+
+const pluginId = PluginId.of("Quantum.Plugin.Theme");
+const current = SemanticVersion.parse("2.1.0-rc.2+linux.arm64");
+const minimum = SemanticVersion.parse("2.1.0-beta.1");
+const parts = SemanticVersion.components(current);
+const range = VersionRange.parse("{1.2.3} | [2.0.0-alpha,3.0.0)");
+
+if (SemanticVersion.compare(current, minimum) >= 0) {
+  console.log(pluginId, parts.major, parts.preReleaseIdentifiers, VersionRange.contains(range, current));
+}
+```
+
+`PluginId.of()` applies the same normalization, 128-character limit, character rules, and reserved `disabled`
+check as the .NET SDK. `SemanticVersion.parse()` strictly requires SemVer 2.0.0 `major.minor.patch`; its numeric
+components are `bigint`, and `SemanticVersion.compare()` ignores build metadata when determining precedence.
+Both branded values remain strings on the JSON wire, preserving the existing iframe/Host payload shape.
+
+Manifest `dependencies` and `integrations` use `versionRange` rather than the legacy `minVersion`. `VersionRange`
+supports bounded or unbounded mathematical intervals, finite sets in braces, and unions separated by `|`; `(,)`
+and `*` both mean all versions. Prereleases participate directly in SemVer precedence, while build metadata is
+ignored, so `{1.2.3}` contains `1.2.3+linux-x64`. The branded range also remains a string on the JSON wire.
+
+## Topic EventBus
+
+TypeScript and .NET plugins share the same Host EventBus. `QuantumTopic.of()` applies the same dot-delimited,
+255-character validation as the .NET `QuantumTopic` value object. Topics must match
+`^[A-Za-z][A-Za-z0-9_-]*(\.[A-Za-z0-9][A-Za-z0-9_-]*)*$`; the branded TypeScript type prevents passing unchecked
+strings to the SDK API.
+
+`QuantumEvent.payload` is the original JSON value. JavaScript already has a deserialized value, so the SDK does
+not add CLR-style deserialization helpers; validate or narrow the `unknown` payload in the handler. Publishing
+waits for all current subscribers, including asynchronous iframe handlers, and subscriber failures are returned
+to the publisher. Disposing a subscription unregisters it immediately; runtime deactivation and iframe disposal
+also remove all remaining subscriptions as a Host-side fallback. Messages are in-memory only and are not retained
+or replayed.

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+export type MaybePromise<T> = T | PromiseLike<T>;
+export type QuantumCleanup = void | (() => MaybePromise<void>) | {
+    dispose(): MaybePromise<void>;
+};
+export interface QuantumRpcOptions {
+    signal?: AbortSignal;
+}
+export interface QuantumPluginIdentity {
+    readonly id: PluginId;
+    readonly version: SemanticVersion;
+    readonly runtimeId: string;
+}
+export interface QuantumPluginInfo {
+    readonly id: PluginId;
+    readonly version: SemanticVersion;
+}
+declare const pluginIdBrand: unique symbol;
+/** A normalized Quantum plugin identifier. */
+export type PluginId = string & {
+    readonly [pluginIdBrand]: "PluginId";
+};
+/** Runtime factory and validator for PluginId values. */
+export declare const PluginId: Readonly<{
+    maximumLength: 128;
+    of(value: string): PluginId;
+    tryParse(value: string): PluginId | null;
+}>;
+declare const semanticVersionBrand: unique symbol;
+/** A validated Semantic Versioning 2.0.0 string. */
+export type SemanticVersion = string & {
+    readonly [semanticVersionBrand]: "SemanticVersion";
+};
+export interface SemanticVersionComponents {
+    readonly major: bigint;
+    readonly minor: bigint;
+    readonly patch: bigint;
+    readonly preReleaseIdentifiers: readonly string[];
+    readonly buildMetadataIdentifiers: readonly string[];
+    readonly isPreRelease: boolean;
+    readonly preRelease: string | null;
+    readonly buildMetadata: string | null;
+}
+/** Parser, component accessor, and precedence comparator for SemanticVersion values. */
+export declare const SemanticVersion: Readonly<{
+    parse(value: string): SemanticVersion;
+    tryParse(value: string): SemanticVersion | null;
+    components(value: SemanticVersion): SemanticVersionComponents;
+    compare(left: SemanticVersion, right: SemanticVersion): number;
+}>;
+declare const versionRangeBrand: unique symbol;
+/** A validated union of Semantic Versioning 2.0.0 intervals and finite sets. */
+export type VersionRange = string & {
+    readonly [versionRangeBrand]: "VersionRange";
+};
+/** Parser and membership test for VersionRange values. */
+export declare const VersionRange: Readonly<{
+    parse(value: string): VersionRange;
+    tryParse(value: string): VersionRange | null;
+    contains(range: VersionRange, version: SemanticVersion): boolean;
+}>;
+declare const quantumTopicBrand: unique symbol;
+/** A validated, dot-delimited EventBus topic. */
+export type QuantumTopic = string & {
+    readonly [quantumTopicBrand]: "QuantumTopic";
+};
+/** Runtime factory and validator for QuantumTopic values. */
+export declare const QuantumTopic: Readonly<{
+    of(value: string): QuantumTopic;
+}>;
+export interface QuantumEvent {
+    readonly id: string;
+    readonly topic: QuantumTopic;
+    readonly payload: unknown;
+    readonly publisher: QuantumPluginInfo;
+    /** ISO-8601 timestamp assigned by the Host. */
+    readonly publishedAt: string;
+}
+export interface QuantumEventPublisher<TMessage> {
+    readonly topic: QuantumTopic;
+    publish(message: TMessage, options?: QuantumRpcOptions): Promise<void>;
+}
+export interface QuantumEventSubscription {
+    readonly topic: QuantumTopic;
+    dispose(): Promise<void>;
+}
+export type QuantumEventHandler = (event: QuantumEvent) => MaybePromise<void>;
+export interface QuantumEventBus {
+    createPublisher<TMessage>(topic: QuantumTopic): QuantumEventPublisher<TMessage>;
+    subscribe(topic: QuantumTopic, handler: QuantumEventHandler, options?: QuantumRpcOptions): Promise<QuantumEventSubscription>;
+}
+export interface QuantumPluginIntegration {
+    readonly pluginId: PluginId;
+    readonly versionRange: VersionRange;
+    /** Informational availability of the declared target; this does not gate plugin interaction. */
+    readonly active: boolean;
+}
+export interface QuantumEnvironmentSnapshot {
+    readonly plugin: QuantumPluginIdentity;
+    readonly loadedPlugins: readonly QuantumPluginInfo[];
+    readonly integrations: readonly QuantumPluginIntegration[];
+}
+export type QuantumRpcContext = Readonly<Record<string, unknown>>;
+export type QuantumResult<TResponse = undefined> = {
+    readonly isSuccess: true;
+    readonly value: TResponse;
+    readonly errorCode: string;
+    readonly message: string;
+    readonly extra?: Readonly<Record<string, string>> | null;
+} | {
+    readonly isSuccess: false;
+    readonly errorCode: string;
+    readonly message: string;
+    readonly extra?: Readonly<Record<string, string>> | null;
+};
+export interface QuantumRpcInvoker {
+    invoke<TResponse = undefined>(rpcName: string, payload: unknown, context?: QuantumRpcContext, options?: QuantumRpcOptions): Promise<QuantumResult<TResponse>>;
+}
+export interface QuantumPluginContext {
+    readonly plugin: QuantumPluginIdentity;
+    /** Aborted before plugin cleanup runs. */
+    readonly signal: AbortSignal;
+    readonly log: {
+        trace(message: string): Promise<void>;
+        debug(message: string): Promise<void>;
+        info(message: string): Promise<void>;
+        warn(message: string): Promise<void>;
+        error(message: string): Promise<void>;
+    };
+    readonly navigation: {
+        navigate(href: string): Promise<void>;
+    };
+    readonly environment: {
+        snapshot(): Promise<QuantumEnvironmentSnapshot>;
+    };
+    readonly eventBus: QuantumEventBus;
+    readonly assets: {
+        url(path: string): string;
+        readText(path: string, options?: QuantumRpcOptions): Promise<string>;
+    };
+    readonly rpc: QuantumRpcInvoker;
+}
+export interface QuantumRoute {
+    readonly path: string;
+    readonly view: string;
+    readonly title?: string | null;
+}
+/** Locale selected by the Host for the mounted plugin view. */
+export interface QuantumLocale {
+    /** Normalized BCP-47 culture name, such as `en-US` or `zh-CN`. */
+    readonly cultureName: string;
+    /** ISO language name, such as `en` or `zh`. */
+    readonly languageName: string;
+    readonly textDirection: "ltr" | "rtl";
+}
+export interface QuantumPluginViewContext extends Omit<QuantumPluginContext, "signal"> {
+    /** The root element inside the plugin's isolated document. */
+    readonly element: HTMLElement;
+    readonly route: QuantumRoute;
+    readonly locale: QuantumLocale;
+    /** Aborted whenever the view is unmounted. */
+    readonly signal: AbortSignal;
+}
+export interface QuantumPluginDefinition {
+    activate?(context: QuantumPluginContext): MaybePromise<QuantumCleanup>;
+    deactivate?(context: QuantumPluginContext): MaybePromise<void>;
+    mount?(context: QuantumPluginViewContext): MaybePromise<QuantumCleanup>;
+    unmount?(context: QuantumPluginContext): MaybePromise<void>;
+}
+/**
+ * Adds compile-time checking while leaving the plugin definition unchanged for bundlers.
+ */
+export declare function definePlugin<TDefinition extends QuantumPluginDefinition>(definition: TDefinition): TDefinition;
+export {};
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,287 @@
+/** Runtime factory and validator for PluginId values. */
+export const PluginId = Object.freeze({
+    maximumLength: 128,
+    of(value) {
+        if (typeof value !== "string" || value.trim().length === 0) {
+            throw new TypeError("A plugin id is required.");
+        }
+        const trimmed = value.trim();
+        if (!/^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,126}[A-Za-z0-9])?$/.test(trimmed)) {
+            throw new TypeError("A plugin id must contain between 1 and 128 ASCII letters, numbers, dots, underscores, or hyphens, and must start and end with a letter or number.");
+        }
+        const normalized = trimmed.toLowerCase();
+        if (normalized === "disabled") {
+            throw new TypeError("Plugin id 'disabled' is reserved by the host.");
+        }
+        return normalized;
+    },
+    tryParse(value) {
+        try {
+            return PluginId.of(value);
+        }
+        catch (error) {
+            if (error instanceof TypeError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+});
+/** Parser, component accessor, and precedence comparator for SemanticVersion values. */
+export const SemanticVersion = Object.freeze({
+    parse(value) {
+        if (parseSemanticVersion(value) === null) {
+            throw new TypeError(`'${String(value)}' is not a valid Semantic Versioning 2.0.0 version.`);
+        }
+        return value;
+    },
+    tryParse(value) {
+        return parseSemanticVersion(value) === null ? null : value;
+    },
+    components(value) {
+        const components = parseSemanticVersion(value);
+        if (components === null) {
+            throw new TypeError(`'${String(value)}' is not a valid Semantic Versioning 2.0.0 version.`);
+        }
+        return components;
+    },
+    compare(left, right) {
+        const leftComponents = parseSemanticVersion(left);
+        const rightComponents = parseSemanticVersion(right);
+        if (leftComponents === null || rightComponents === null) {
+            throw new TypeError("SemanticVersion.compare requires valid Semantic Versioning 2.0.0 values.");
+        }
+        return compareSemanticVersions(leftComponents, rightComponents);
+    }
+});
+function parseSemanticVersion(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        return null;
+    }
+    const buildSeparator = value.indexOf("+");
+    if (buildSeparator >= 0 && (value.indexOf("+", buildSeparator + 1) >= 0
+        || buildSeparator === value.length - 1)) {
+        return null;
+    }
+    const versionWithoutBuild = buildSeparator < 0 ? value : value.slice(0, buildSeparator);
+    const buildValue = buildSeparator < 0 ? null : value.slice(buildSeparator + 1);
+    const preReleaseSeparator = versionWithoutBuild.indexOf("-");
+    if (preReleaseSeparator >= 0 && preReleaseSeparator === versionWithoutBuild.length - 1) {
+        return null;
+    }
+    const coreValue = preReleaseSeparator < 0
+        ? versionWithoutBuild
+        : versionWithoutBuild.slice(0, preReleaseSeparator);
+    const preReleaseValue = preReleaseSeparator < 0
+        ? null
+        : versionWithoutBuild.slice(preReleaseSeparator + 1);
+    const coreIdentifiers = coreValue.split(".");
+    if (coreIdentifiers.length !== 3
+        || coreIdentifiers.some(identifier => !/^(?:0|[1-9][0-9]*)$/.test(identifier))) {
+        return null;
+    }
+    const preReleaseIdentifiers = preReleaseValue === null ? [] : preReleaseValue.split(".");
+    const buildMetadataIdentifiers = buildValue === null ? [] : buildValue.split(".");
+    const validIdentifier = (identifier) => /^[0-9A-Za-z-]+$/.test(identifier);
+    if (preReleaseIdentifiers.some(identifier => !validIdentifier(identifier) || (/^[0-9]+$/.test(identifier)
+        && identifier.length > 1 && identifier.startsWith("0")))
+        || buildMetadataIdentifiers.some(identifier => !validIdentifier(identifier))) {
+        return null;
+    }
+    return Object.freeze({
+        major: BigInt(coreIdentifiers[0]),
+        minor: BigInt(coreIdentifiers[1]),
+        patch: BigInt(coreIdentifiers[2]),
+        preReleaseIdentifiers: Object.freeze(preReleaseIdentifiers),
+        buildMetadataIdentifiers: Object.freeze(buildMetadataIdentifiers),
+        isPreRelease: preReleaseIdentifiers.length > 0,
+        preRelease: preReleaseValue,
+        buildMetadata: buildValue
+    });
+}
+function compareSemanticVersions(left, right) {
+    for (const [leftNumber, rightNumber] of [
+        [left.major, right.major],
+        [left.minor, right.minor],
+        [left.patch, right.patch]
+    ]) {
+        if (leftNumber !== rightNumber) {
+            return leftNumber < rightNumber ? -1 : 1;
+        }
+    }
+    if (left.preReleaseIdentifiers.length === 0 || right.preReleaseIdentifiers.length === 0) {
+        if (left.preReleaseIdentifiers.length === right.preReleaseIdentifiers.length) {
+            return 0;
+        }
+        return left.preReleaseIdentifiers.length === 0 ? 1 : -1;
+    }
+    const sharedLength = Math.min(left.preReleaseIdentifiers.length, right.preReleaseIdentifiers.length);
+    for (let index = 0; index < sharedLength; index++) {
+        const leftIdentifier = left.preReleaseIdentifiers[index];
+        const rightIdentifier = right.preReleaseIdentifiers[index];
+        const leftNumeric = /^[0-9]+$/.test(leftIdentifier);
+        const rightNumeric = /^[0-9]+$/.test(rightIdentifier);
+        if (leftNumeric !== rightNumeric) {
+            return leftNumeric ? -1 : 1;
+        }
+        if (leftIdentifier !== rightIdentifier) {
+            if (leftNumeric) {
+                return leftIdentifier.length === rightIdentifier.length
+                    ? leftIdentifier < rightIdentifier ? -1 : 1
+                    : leftIdentifier.length < rightIdentifier.length ? -1 : 1;
+            }
+            return leftIdentifier < rightIdentifier ? -1 : 1;
+        }
+    }
+    return Math.sign(left.preReleaseIdentifiers.length - right.preReleaseIdentifiers.length);
+}
+/** Parser and membership test for VersionRange values. */
+export const VersionRange = Object.freeze({
+    parse(value) {
+        const range = parseVersionRange(value);
+        if (range === null) {
+            throw new TypeError(`'${String(value)}' is not a valid version range.`);
+        }
+        return range.normalized;
+    },
+    tryParse(value) {
+        const range = parseVersionRange(value);
+        return range === null ? null : range.normalized;
+    },
+    contains(range, version) {
+        const parsedRange = parseVersionRange(range);
+        const parsedVersion = parseSemanticVersion(version);
+        if (parsedRange === null || parsedVersion === null) {
+            throw new TypeError("VersionRange.contains requires valid range and version values.");
+        }
+        return parsedRange.terms.some(term => versionRangeTermContains(term, parsedVersion));
+    }
+});
+function parseVersionRange(value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return null;
+    }
+    const rawTerms = value.trim().split("|");
+    if (rawTerms.some(term => term.trim().length === 0)) {
+        return null;
+    }
+    const terms = [];
+    const normalizedTerms = [];
+    for (const rawTerm of rawTerms) {
+        const parsed = parseVersionRangeTerm(rawTerm.trim());
+        if (parsed === null) {
+            return null;
+        }
+        terms.push(parsed.term);
+        normalizedTerms.push(parsed.normalized);
+    }
+    return Object.freeze({
+        normalized: normalizedTerms.join("|"),
+        terms: Object.freeze(terms)
+    });
+}
+function parseVersionRangeTerm(term) {
+    if (term === "*") {
+        return {
+            normalized: "(,)",
+            term: {
+                kind: "interval",
+                lowerBound: null,
+                includeLowerBound: false,
+                upperBound: null,
+                includeUpperBound: false
+            }
+        };
+    }
+    if (term.startsWith("{") && term.endsWith("}")) {
+        const values = term.slice(1, -1).split(",").map(value => value.trim());
+        if (values.length === 0 || values.some(value => value.length === 0)) {
+            return null;
+        }
+        const versions = values.map(parseSemanticVersion);
+        if (versions.some(version => version === null)) {
+            return null;
+        }
+        return {
+            normalized: `{${values.join(",")}}`,
+            term: { kind: "set", versions: versions }
+        };
+    }
+    if (term.length < 3
+        || !(term.startsWith("[") || term.startsWith("("))
+        || !(term.endsWith("]") || term.endsWith(")"))) {
+        return null;
+    }
+    const bounds = term.slice(1, -1).split(",").map(value => value.trim());
+    if (bounds.length !== 2) {
+        return null;
+    }
+    const lowerValue = bounds[0];
+    const upperValue = bounds[1];
+    const includeLowerBound = term.startsWith("[");
+    const includeUpperBound = term.endsWith("]");
+    if ((lowerValue.length === 0 && includeLowerBound)
+        || (upperValue.length === 0 && includeUpperBound)) {
+        return null;
+    }
+    const lowerBound = lowerValue.length === 0 ? null : parseSemanticVersion(lowerValue);
+    const upperBound = upperValue.length === 0 ? null : parseSemanticVersion(upperValue);
+    if ((lowerValue.length > 0 && lowerBound === null)
+        || (upperValue.length > 0 && upperBound === null)) {
+        return null;
+    }
+    if (lowerBound !== null && upperBound !== null) {
+        const comparison = compareSemanticVersions(lowerBound, upperBound);
+        if (comparison > 0 || (comparison === 0 && (!includeLowerBound || !includeUpperBound))) {
+            return null;
+        }
+    }
+    return {
+        normalized: `${term[0]}${lowerValue},${upperValue}${term.at(-1)}`,
+        term: {
+            kind: "interval",
+            lowerBound,
+            includeLowerBound,
+            upperBound,
+            includeUpperBound
+        }
+    };
+}
+function versionRangeTermContains(term, version) {
+    if (term.kind === "set") {
+        return term.versions.some(candidate => compareSemanticVersions(candidate, version) === 0);
+    }
+    if (term.lowerBound !== null) {
+        const comparison = compareSemanticVersions(version, term.lowerBound);
+        if (comparison < 0 || (comparison === 0 && !term.includeLowerBound)) {
+            return false;
+        }
+    }
+    if (term.upperBound !== null) {
+        const comparison = compareSemanticVersions(version, term.upperBound);
+        if (comparison > 0 || (comparison === 0 && !term.includeUpperBound)) {
+            return false;
+        }
+    }
+    return true;
+}
+/** Runtime factory and validator for QuantumTopic values. */
+export const QuantumTopic = Object.freeze({
+    of(value) {
+        if (typeof value !== "string" || value.length === 0 || value.length > 255) {
+            throw new TypeError("A topic must contain between 1 and 255 characters.");
+        }
+        const match = /^[A-Za-z][A-Za-z0-9_-]*(\.[A-Za-z0-9][A-Za-z0-9_-]*)*$/.exec(value);
+        if (match?.[0] !== value) {
+            throw new TypeError("A topic must match ^[A-Za-z][A-Za-z0-9_-]*(\\.[A-Za-z0-9][A-Za-z0-9_-]*)*$/.");
+        }
+        return value;
+    }
+});
+/**
+ * Adds compile-time checking while leaving the plugin definition unchanged for bundlers.
+ */
+export function definePlugin(definition) {
+    return definition;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@io7/quantum-plugin-sdk",
+  "version": "0.1.0-nightly.20260914.3.3",
+  "description": "TypeScript SDK for isolated Quantum Web plugins",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test test/*.test.mjs"
+  },
+  "keywords": [
+    "quantum",
+    "plugin",
+    "typescript"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/XmmShp/Quantum.Sdk.git"
+  },
+  "homepage": "https://github.com/XmmShp/Quantum.Sdk#readme",
+  "bugs": "https://github.com/XmmShp/Quantum.Sdk/issues",
+  "devDependencies": {
+    "typescript": "5.9.2"
+  }
+}