@archont561/qgis-sdk 0.4.0 → 0.6.0

package/dist/shared/{chunk-tmca1ynt.d.ts → chunk-nwz8n14x.d.ts}

@@ -1,6 +1,58 @@
-import { BridgeStreamTerminal2, WireTransport2, InvokeOptions2, BridgeSubscription2, BridgeClient2 } from "./chunk-wtv4vt4q.js";
-import { HostOperationId2, HostOperations2 } from "./chunk-khemhx86.js";
-import { OperationShape2, StreamShape2, OperationMap2, StreamMap2, BridgeSchema2 } from "./chunk-jjx14tgd.js";
+import { PluginDescription2, BridgeStreamTerminal2, WireTransport2, InvokeOptions2, BridgeSubscription2, BridgeClient2 } from "./chunk-8c12nwme.js";
+import { HostOperationId2, HostOperations2 } from "./chunk-7tgzmz0m.js";
+/** What one declared action promises: an object in, a value out. */
+interface OperationShape2 {
+	readonly request: object;
+	readonly result: unknown;
+}
+/** What one declared stream promises: an object in, discriminated events out. */
+interface StreamShape2 {
+	readonly request: object;
+	readonly event: {
+		readonly kind: string;
+		readonly payload: unknown;
+	};
+}
+/** The default, untyped map: any id, any shape. */
+type OperationMap2 = {
+	readonly [id: string]: OperationShape2;
+};
+/** The default, untyped map: any id, any shape. */
+type StreamMap2 = {
+	readonly [id: string]: StreamShape2;
+};
+/**
+* A parsed plugin description carrying its `Operations` and `Streams` types.
+*
+* The `"~types"` member is compile-time only: it is never set, and a schema is
+* a frozen {@link PluginDescription} and nothing more at run time. It is a
+* string key, not a unique symbol, so the type stays structurally the same
+* across the package's entry points.
+*/
+interface BridgeSchema2<
+	O = OperationMap2,
+	S = StreamMap2
+> extends PluginDescription2 {
+	readonly "~types"?: {
+		readonly operations: O;
+		readonly streams: S;
+	};
+}
+/** The `Operations` map a schema carries. */
+type OperationsOf2<Schema> = Schema extends BridgeSchema2<infer O, unknown> ? O : never;
+/** The `Streams` map a schema carries. */
+type StreamsOf2<Schema> = Schema extends BridgeSchema2<unknown, infer S> ? S : never;
+/**
+* Parse a description and type it; the generated module is the only caller.
+*
+* The description is checked the way any description is (`schema_version`,
+* ids, handlers, declared streams), so a hand-edited or stale module fails
+* here, at import, rather than on the first call.
+*/
+declare function defineBridgeSchema2<
+	O extends Record<keyof O, OperationShape2>,
+	S extends Record<keyof S, StreamShape2>
+>(input: string | Readonly<Record<string, unknown>>): BridgeSchema2<O, S>;
 /** Options for {@link QgisSdk.fromBridgeSchema}. */
 interface QgisSdkOptions2 {
 	/** A transport to speak through; defaults to the page's QWebChannel. */
@@ -23,6 +75,17 @@ type StreamHandle2 = BridgeSubscription2;
 type OperationMethod2<Op extends OperationShape2> = {} extends Op["request"] ? (request?: Op["request"], options?: InvokeOptions2) => Promise<Op["result"]> : (request: Op["request"], options?: InvokeOptions2) => Promise<Op["result"]>;
 /** The method one declared stream becomes. */
 type StreamMethod2<St extends StreamShape2> = (request: St["request"], handlers: StreamHandlers2<St["event"]>, options?: InvokeOptions2) => Promise<StreamHandle2>;
+/**
+* The running palette, when the handshake carried one (decision-16): the
+* `QPalette` colour roles the host read, as CSS hex (`#rrggbb` or
+* `#rrggbbaa`) by their camel-cased role name, and whether the window colour
+* is dark. `qgis-sdk-ui` turns it into the `--qgis-sdk-*` custom properties;
+* a page outside QGIS sees `null` and keeps the documented defaults.
+*/
+interface QgisSdkHostTheme2 {
+	readonly palette: Readonly<Record<string, string>>;
+	readonly dark: boolean;
+}
 /** What the handshake told this page about the host (decision-27). */
 interface QgisSdkHost2 extends HostOperations2 {
 	/**
@@ -30,6 +93,11 @@ interface QgisSdkHost2 extends HostOperations2 {
 	* until {@link QgisSdkCore.ready} has resolved.
 	*/
 	readonly granted: readonly HostOperationId2[];
+	/**
+	* The host's palette, `null` until {@link QgisSdkCore.ready} has resolved
+	* and when the host sent none.
+	*/
+	readonly theme: QgisSdkHostTheme2 | null;
 }
 /** The members every `QgisSdk` has, whatever its schema declares. */
 interface QgisSdkCore2<
@@ -84,4 +152,4 @@ declare namespace QgisSdk2 {
 		S extends Record<keyof S, StreamShape2>
 	>(schema: BridgeSchema2<O, S>, options?: QgisSdkOptions2): QgisSdk2<O, S>;
 }
-export { QgisSdkOptions2, StreamHandlers2, StreamHandle2, OperationMethod2, StreamMethod2, QgisSdkHost2, QgisSdkCore2, OperationTree2, StreamTree2, QGIS_SDK_MEMBERS2, QgisSdk2 };
+export { OperationShape2, StreamShape2, OperationMap2, StreamMap2, BridgeSchema2, OperationsOf2, StreamsOf2, defineBridgeSchema2, QgisSdkOptions2, StreamHandlers2, StreamHandle2, OperationMethod2, StreamMethod2, QgisSdkHostTheme2, QgisSdkHost2, QgisSdkCore2, OperationTree2, StreamTree2, QGIS_SDK_MEMBERS2, QgisSdk2 };