@ngis/plugin-sdk 0.4.0 → 0.4.1

package/dist/src/sdk/facets/types.d.ts

@@ -32,7 +32,9 @@
  */
 import type { AnalysisToolSchema } from "../../api/analysis";
 import type { SceneType } from "../../api/scenes";
+import type { NgisCrsRef } from "../../domain/models/crs";
 import type { NgisExecutionValidation, NgisToolUiSchema } from "../../types/analysis";
+import type { NgisResolvedToolDependency } from "../../types/extensions";
 import type { NgisBounds, NgisUnsubscribe } from "../map-api";
 export interface NgisSceneInfo {
     id: string;
@@ -59,6 +61,18 @@ export interface NgisSceneFacet {
  * `"table"` would need `NgisFile.fileType`, i.e. a second
  * `GET /api/files/{fileId}` per resource — an N+1 fan-out for a distinction no
  * v1 consumer needs.
+ *
+ * **SURVIVES Stage 29 UNCHANGED (F29.1 row 3).** It is the SDK's v1
+ * plugin-facing classification, frozen by XD7/F13.6 and enforced by two live
+ * gates, and Stage 29 registers **no table dataset model** — so nothing about it
+ * moves (F29.2). It is a *projection* of `NgisDatasetKind` onto the coarser
+ * vocabulary v1 plugins compile against, never a second spelling of it: its
+ * membership is closed because a plugin's `when` expression is, and
+ * `NgisDatasetKind` is open because a kind is registered data. Widening this one
+ * to match would break every shipped plugin fixture.
+ *
+ * *(`GENERIC` no longer reaches the classifier — F29.3 removed it from the wire —
+ * but the "everything else" arm is unchanged and still catches it.)*
  */
 export type NgisResourceType = "vector" | "raster" | "table" | "file";
 /**
@@ -89,6 +103,13 @@ export type NgisResourceType = "vector" | "raster" | "table" | "file";
  * against a builtin node's `"Raster"` and `400`s at workflow save. Y6 applies
  * that column at, and **only** at, the `ngis-workflow` boundary. Nowhere else
  * in either repo is Pascal correct.
+ *
+ * **SURVIVES Stage 29 UNCHANGED (F29.1 row 4).** It is a **tool port** data type
+ * (F14.1), not a dataset kind. The two are related by the compatibility matrix
+ * and **never by equality**: `table` and `pointcloud` are legal port types that
+ * no registered kind emits, and a registered kind the client has never seen binds
+ * to a port through the matrix rather than by name. Renaming or merging them
+ * would assert an identity that does not hold.
  */
 export type NgisDataType = "raster" | "vector" | "table" | "pointcloud" | "raster3d" | "file";
 export declare const NGIS_DATA_TYPES: readonly ["raster", "vector", "table", "pointcloud", "raster3d", "file"];
@@ -130,6 +151,25 @@ export interface NgisResourceSummary {
     geometryType: string | null;
     layerCount: number;
     rendered: boolean;
+    /**
+     * **Stage 25 (F25.1 / F25.9, `S25-V216`).** The dataset's one CRS, or `null`
+     * when the server has none for it (`NEEDS_CRS`).
+     *
+     * It is on the **summary**, not only the detail, and that placement is the
+     * point of the row. `ResourceSelect` lists datasets from `resources.list()`
+     * and must draw each row's projection state at pick time (F25.5); resolving a
+     * ref through `resources.get()` per row is the N+1 XD7 already refused for
+     * `resources.types`. Without this field the picker could draw only the
+     * *absent* state — which is what S25-22 shipped, with the limit recorded
+     * rather than papered over — because a dataset that *has* a projection had
+     * nothing to draw a chip from and inventing one is what G-CRS forbids.
+     *
+     * `null` is a value and not a gap: it is the server saying `NEEDS_CRS`. There
+     * is no `undefined` arm — the facet always answers, and a dataset it could not
+     * read at all reports `datasetStatus: "N/A"` with `crs: null`, which is the
+     * same honest "we cannot say what this is in".
+     */
+    crs: NgisCrsRef | null;
     /**
      * Scene layers that render this resource, when the host can supply them.
      *
@@ -160,7 +200,6 @@ export interface NgisResourceField {
     type: string;
 }
 export interface NgisResourceDetail extends NgisResourceSummary {
-    srid: number | null;
     /** Vector only; `null` otherwise. */
     featureCount: number | null;
     /** Vector only; `[]` otherwise. */
@@ -244,7 +283,21 @@ export interface NgisModelValidateRequest {
     expectedSceneGeneration?: number;
     outputMode?: "ADD_LAYER" | "UPDATE_RESOURCE";
     targetResourceId?: string;
-    targetSrid?: number;
+    /**
+     * **Stage 25 (F25.4, and the `S25-V124` ruling that AMENDS F25.12).**
+     *
+     * Replaces `targetSrid?: number`. It is an {@link NgisCrsRef} **key** — the
+     * string `"EPSG:32650"` or `"custom:<ulid>"` — and never an integer, because
+     * an integer cannot name a custom CRS at all and because a bare number is the
+     * silent-default spelling G-CRS refuses.
+     *
+     * `targetSrid` was typed, forwarded to `validate-execution` and set by no
+     * component: dead plumbing. This member is the live one — `run-data.ts` fills
+     * it from the form's `ngis:outputCrs` parameter and the facade adapter puts it
+     * on the wire as `outputCrs` (the REST leg is camelCase here; the proto
+     * spelling is `output_crs`).
+     */
+    outputCrs?: string;
 }
 export interface NgisModelSearchRequest {
     query?: string;
@@ -300,6 +353,12 @@ export interface NgisModelsFacet {
     /** The one normalized UI schema (F14.2). `null` when the tool or its schema
      *  is absent. Scope `models:read`. */
     uiSchema(toolId: string): Promise<NgisToolUiSchema | null>;
+    /**
+     * Resolves a declared `manifest.toolDependencies[].alias` for this plugin and
+     * viewer. The unavailable arm is a normal, renderable result; it never leaks
+     * implementation UUIDs into plugin manifests. Scope `models:read`.
+     */
+    dependency(alias: string): Promise<NgisResolvedToolDependency>;
     /** REST projection of `ValidateToolExecution`. Returns the response DTO
      *  **verbatim**. Scope `models:read`, **not** `models:run` — it runs nothing,
      *  and returns only registry facts plus dataset metadata the caller can
@@ -324,6 +383,18 @@ export interface NgisTaskRunRequest {
     expectedSceneGeneration?: number;
     outputMode?: "ADD_LAYER" | "UPDATE_RESOURCE";
     targetResourceId?: string;
+    /**
+     * **Stage 25 (F25.4).** The output CRS this run computes in and stores its
+     * result as — an {@link NgisCrsRef} key, never an integer. Absent means
+     * "compute in the primary input's own CRS", which is a real choice and not a
+     * default: the server never substitutes one (G-CRS).
+     *
+     * This is the member that makes exit criterion 6 true. `submitRun` fills it,
+     * the tasks facet spreads the request through to the DIRECT source, and
+     * `createGisTasksSource` hands it to `startTrackedAnalysisTask`, which puts
+     * `outputCrs` in the `POST /api/analysis/tasks` body.
+     */
+    outputCrs?: string;
 }
 export interface NgisTaskHandle {
     /** DIRECT: the analysis task id. WORKFLOW: the workflow instance id. */

package/dist/src/sdk/map-api.d.ts

@@ -73,7 +73,7 @@ import type { WorkspacePanelRegistry } from "./panels";
  * semver compare, **not** by the unknown-capability check: `contributes` and
  * `permissions` are top-level manifest siblings, and a 0.3 runtime inspects
  * only `manifest.capabilities`. */
-export declare const NGIS_MAP_API_VERSION = "0.4.0";
+export declare const NGIS_MAP_API_VERSION = "0.4.1";
 /** A scene layer as the SDK exposes it — a stable projection of the store's
  * `NgisSceneLayer`, so plugins never depend on the store's internal shape. */
 export interface NgisLayerSummary {
@@ -262,6 +262,9 @@ export interface NgisMapAPIBindings {
     /** Raw-map getter for `getMap()`. Usually omitted at construction and wired
      * later via `NgisMapAPIHandle.bindRawMap` (the post-C5 hookup). */
     getRawMap?(): MapLibreMap | null;
+    /** Host hook run before direct raw-map camera commands. Keeps host-owned
+     * temporary camera controllers from racing this SDK escape hatch. */
+    beforeCameraCommand?(map: MapLibreMap): void;
 }
 /**
  * The factory's return value: the public `api` plus the host-side "driver"

package/dist/src/sdk/plugin.d.ts

@@ -26,6 +26,7 @@ import type { NgisContributes, NgisPermissionScope } from "./contributions/types
 import type { NgisSymbolRendererModule } from "./contributions/symbol-renderers";
 import type { PanelRegistration } from "./panels";
 import type { GisDynamicToolDef } from "./rail-tools";
+import type { NgisToolDependencyDeclaration } from "../types/extensions";
 /**
  * **F13.1 / ED19 (Stage 13, X4b) — the `NgisPluginHost` widening.**
  *
@@ -106,6 +107,11 @@ export interface NgisPluginManifest {
      * here and is never prompted.
      */
     permissions?: readonly NgisPermissionScope[];
+    /**
+     * Semantic tool requirements. Bundle code obtains the selected runtime tool
+     * through `host.models.dependency(alias)`; it must not contain a tool UUID.
+     */
+    toolDependencies?: readonly NgisToolDependencyDeclaration[];
     /** **Reserved, never read this stage** (D3): the future third-party loader's
      * ESM-bundle path. First-party plugins are statically imported instead. */
     entry?: string;

package/dist/src/sdk/scopes.d.ts

@@ -62,6 +62,7 @@ export declare const NGIS_SCOPE_MEMBERS: {
     readonly "models.get": "models:read";
     readonly "models.schema": "models:read";
     readonly "models.uiSchema": "models:read";
+    readonly "models.dependency": "models:read";
     readonly "models.validate": "models:read";
     readonly "models.search": "models:read";
     readonly "tasks.run": "models:run";

package/dist/src/systems/renderer/FlowFieldLayer.d.ts

@@ -1,15 +1,14 @@
 import type { CustomLayerInterface, CustomRenderMethodInput, Map as MapLibreMap } from "maplibre-gl";
 import type { SceneLayerStyle } from "../../domain/map/types";
+import type { FlowFieldStyle } from "../../domain/models/flow-field-style";
 import type { AuthenticatedFetch } from "./authenticated-deck-load";
-export type FlowFieldLayerOptions = {
+type FlowFieldStyleOptions = Pick<FlowFieldStyle, "opacity" | "colorRamp" | "speedRange" | "speedFactor" | "particleCount" | "lineWidth" | "trailLength" | "frameDurationMs" | "paused" | "maxParticleAge" | "dropRate" | "dropRateBump">;
+export type FlowFieldLayerOptions = Partial<FlowFieldStyleOptions> & {
     id: string;
     flowFieldId: string;
-    opacity: number;
-    speedFactor: number;
-    particleCount: number;
-    paused: boolean;
     fetchWithAuth: AuthenticatedFetch;
     triggerRepaint: () => void;
+    onReady?: () => void;
     onError?: (error: Error) => void;
 };
 /**
@@ -38,6 +37,7 @@ export declare class FlowFieldLayer implements CustomLayerInterface {
     private validTextures;
     private domainMaskTexture;
     private projectionTexture;
+    private colorRampTexture;
     private simulationBuffers;
     private simulationVaos;
     private transformFeedbacks;
@@ -46,13 +46,15 @@ export declare class FlowFieldLayer implements CustomLayerInterface {
     private stateIndex;
     private trailHead;
     private trailCount;
-    private frameCounter;
+    private frameElapsedMs;
+    private lastRenderTimeMs;
     private particleCount;
     constructor(options: FlowFieldLayerOptions);
     onAdd(map: MapLibreMap, gl: WebGLRenderingContext | WebGL2RenderingContext): void;
     private load;
     private createGpuResources;
     private createParticleResources;
+    private getFrameState;
     private runSimulation;
     private bindTexture;
     private bindRenderBuffers;
@@ -66,3 +68,4 @@ export declare class FlowFieldLayer implements CustomLayerInterface {
     private destroyParticleResources;
     private releaseGpuResources;
 }
+export {};

package/dist/src/systems/renderer/flow-field/flow-field-resources.d.ts

@@ -71,6 +71,9 @@ export interface DecodedFlowFieldAssets {
     domainMask: Uint8Array;
     speedRange: [number, number];
 }
+type FlowFieldSpeedRangeListener = (range: [number, number]) => void;
+export declare function getResolvedFlowFieldSpeedRange(fileId: string): [number, number] | null;
+export declare function subscribeToResolvedFlowFieldSpeedRange(fileId: string, listener: FlowFieldSpeedRangeListener): () => void;
 interface RgbaImage {
     width: number;
     height: number;

package/dist/src/systems/renderer/flow-field/flow-field-shaders.d.ts

@@ -1,4 +1,4 @@
-export declare const FLOW_UPDATE_VERTEX_SHADER = "#version 300 es\nprecision highp float;\n\nlayout(location = 0) in vec4 a_state;\n\nuniform sampler2D u_velocity0;\nuniform sampler2D u_velocity1;\nuniform sampler2D u_seed;\nuniform sampler2D u_domainMask;\nuniform sampler2D u_valid0;\nuniform sampler2D u_valid1;\nuniform vec2 u_gridSize;\nuniform float u_frameMix;\nuniform float u_speedFactor;\nuniform float u_dropRate;\nuniform float u_dropRateBump;\nuniform float u_randomSeed;\nuniform float u_maxAge;\nuniform float u_nodata;\nuniform vec2 u_speedRange;\n\nout vec4 v_state;\n\nfloat randomValue(vec2 value) {\n  return fract(sin(dot(value, vec2(12.9898, 78.233))) * 43758.5453123);\n}\n\nbool isDefinedVelocity(vec2 velocity) {\n  return !any(isnan(velocity)) && !any(isinf(velocity))\n    && abs(velocity.x - u_nodata) > 0.5\n    && abs(velocity.y - u_nodata) > 0.5;\n}\n\nvec2 readVelocity(vec2 uv) {\n  return mix(texture(u_velocity0, uv).rg, texture(u_velocity1, uv).rg, u_frameMix);\n}\n\nivec2 decodeSeedCell(vec4 packed) {\n  ivec4 bytes = ivec4(floor(packed * 255.0 + 0.5));\n  return ivec2(\n    (bytes.r << 8) + bytes.g,\n    (bytes.b << 8) + bytes.a\n  );\n}\n\nbool readMask(sampler2D maskTexture, vec2 uv) {\n  ivec2 size = textureSize(maskTexture, 0);\n  ivec2 cell = clamp(ivec2(floor(uv * vec2(size))), ivec2(0), size - ivec2(1));\n  return texelFetch(maskTexture, cell, 0).r > 0.5;\n}\n\nbool isFlowCell(vec2 uv) {\n  return readMask(u_domainMask, uv)\n    && readMask(u_valid0, uv)\n    && readMask(u_valid1, uv);\n}\n\nfloat normalizedSpeed(vec2 velocity) {\n  return clamp(\n    (length(velocity) - u_speedRange.x) / max(u_speedRange.y - u_speedRange.x, 1.0e-6),\n    0.0,\n    1.0\n  );\n}\n\nvec2 seedPosition(vec2 randomUv) {\n  vec2 cell = vec2(decodeSeedCell(texture(u_seed, randomUv)));\n  vec2 jitter = vec2(\n    randomValue(randomUv + vec2(1.31, u_randomSeed)),\n    randomValue(randomUv + vec2(u_randomSeed, 2.17))\n  );\n  return clamp((cell + jitter) / u_gridSize, vec2(0.0), vec2(1.0));\n}\n\nvec4 respawn(float salt) {\n  vec2 randomUv = vec2(\n    randomValue(vec2(float(gl_VertexID) + salt, u_randomSeed + 0.37)),\n    randomValue(vec2(u_randomSeed + 0.73, float(gl_VertexID) + salt))\n  );\n  vec2 uv = seedPosition(randomUv);\n  vec2 velocity = readVelocity(uv);\n  return vec4(uv, 0.0, isDefinedVelocity(velocity) ? normalizedSpeed(velocity) : 0.0);\n}\n\nvoid main() {\n  vec2 velocity = readVelocity(a_state.xy);\n  float speed = isDefinedVelocity(velocity) ? normalizedSpeed(velocity) : 0.0;\n  vec2 nextPosition = a_state.xy + velocity * u_speedFactor / u_gridSize;\n  bool outside = any(lessThan(nextPosition, vec2(0.0))) || any(greaterThan(nextPosition, vec2(1.0)));\n  float randomDrop = randomValue(a_state.xy + vec2(u_randomSeed, float(gl_VertexID) * 0.000001));\n  bool dropped = randomDrop < (u_dropRate + speed * u_dropRateBump);\n  bool expired = a_state.z >= u_maxAge;\n\n  if (!isDefinedVelocity(velocity) || !isFlowCell(a_state.xy) || outside || dropped || expired) {\n    v_state = respawn(a_state.z + 1.0);\n    return;\n  }\n\n  vec2 nextVelocity = readVelocity(nextPosition);\n  if (!isDefinedVelocity(nextVelocity) || !isFlowCell(nextPosition)) {\n    v_state = respawn(a_state.z + 2.0);\n    return;\n  }\n\n  v_state = vec4(nextPosition, a_state.z + 1.0, normalizedSpeed(nextVelocity));\n}\n";
+export declare const FLOW_UPDATE_VERTEX_SHADER = "#version 300 es\nprecision highp float;\n\nlayout(location = 0) in vec4 a_state;\n\nuniform sampler2D u_velocity0;\nuniform sampler2D u_velocity1;\nuniform sampler2D u_seed;\nuniform sampler2D u_domainMask;\nuniform sampler2D u_valid0;\nuniform sampler2D u_valid1;\nuniform vec2 u_gridSize;\nuniform float u_frameMix;\nuniform float u_speedFactor;\nuniform float u_dropRate;\nuniform float u_dropRateBump;\nuniform float u_randomSeed;\nuniform float u_maxAge;\nuniform float u_nodata;\nuniform vec2 u_speedRange;\nuniform float u_deltaSeconds;\n\nout vec4 v_state;\n\nfloat randomValue(vec2 value) {\n  return fract(sin(dot(value, vec2(12.9898, 78.233))) * 43758.5453123);\n}\n\nbool isDefinedVelocity(vec2 velocity) {\n  return !any(isnan(velocity)) && !any(isinf(velocity))\n    && abs(velocity.x - u_nodata) > 0.5\n    && abs(velocity.y - u_nodata) > 0.5;\n}\n\nvec2 readVelocity(vec2 uv) {\n  return mix(texture(u_velocity0, uv).rg, texture(u_velocity1, uv).rg, u_frameMix);\n}\n\nivec2 decodeSeedCell(vec4 packed) {\n  ivec4 bytes = ivec4(floor(packed * 255.0 + 0.5));\n  return ivec2(\n    (bytes.r << 8) + bytes.g,\n    (bytes.b << 8) + bytes.a\n  );\n}\n\nbool readMask(sampler2D maskTexture, vec2 uv) {\n  ivec2 size = textureSize(maskTexture, 0);\n  ivec2 cell = clamp(ivec2(floor(uv * vec2(size))), ivec2(0), size - ivec2(1));\n  return texelFetch(maskTexture, cell, 0).r > 0.5;\n}\n\nbool isFlowCell(vec2 uv) {\n  return readMask(u_domainMask, uv)\n    && readMask(u_valid0, uv)\n    && readMask(u_valid1, uv);\n}\n\nfloat normalizedSpeed(vec2 velocity) {\n  return clamp(\n    (length(velocity) - u_speedRange.x) / max(u_speedRange.y - u_speedRange.x, 1.0e-6),\n    0.0,\n    1.0\n  );\n}\n\nvec2 seedPosition(vec2 randomUv) {\n  vec2 cell = vec2(decodeSeedCell(texture(u_seed, randomUv)));\n  vec2 jitter = vec2(\n    randomValue(randomUv + vec2(1.31, u_randomSeed)),\n    randomValue(randomUv + vec2(u_randomSeed, 2.17))\n  );\n  return clamp((cell + jitter) / u_gridSize, vec2(0.0), vec2(1.0));\n}\n\nvec4 respawn(float salt) {\n  vec2 randomUv = vec2(\n    randomValue(vec2(float(gl_VertexID) + salt, u_randomSeed + 0.37)),\n    randomValue(vec2(u_randomSeed + 0.73, float(gl_VertexID) + salt))\n  );\n  vec2 uv = seedPosition(randomUv);\n  vec2 velocity = readVelocity(uv);\n  return vec4(uv, 0.0, isDefinedVelocity(velocity) ? length(velocity) : 0.0);\n}\n\nvoid main() {\n  vec2 velocity = readVelocity(a_state.xy);\n  float speed = isDefinedVelocity(velocity) ? normalizedSpeed(velocity) : 0.0;\n  // 60 Hz preserves the fourth-round speed factor semantics while real elapsed\n  // time makes 60 Hz and 144 Hz displays advance identically.\n  vec2 nextPosition = a_state.xy + velocity * u_speedFactor * (u_deltaSeconds * 60.0) / u_gridSize;\n  bool outside = any(lessThan(nextPosition, vec2(0.0))) || any(greaterThan(nextPosition, vec2(1.0)));\n  float randomDrop = randomValue(a_state.xy + vec2(u_randomSeed, float(gl_VertexID) * 0.000001));\n  bool dropped = randomDrop < (u_dropRate + speed * u_dropRateBump);\n  bool expired = a_state.z >= u_maxAge;\n\n  if (!isDefinedVelocity(velocity) || !isFlowCell(a_state.xy) || outside || dropped || expired) {\n    v_state = respawn(a_state.z + 1.0);\n    return;\n  }\n\n  vec2 nextVelocity = readVelocity(nextPosition);\n  if (!isDefinedVelocity(nextVelocity) || !isFlowCell(nextPosition)) {\n    v_state = respawn(a_state.z + 2.0);\n    return;\n  }\n\n  v_state = vec4(nextPosition, a_state.z + 1.0, length(nextVelocity));\n}\n";
 export declare const FLOW_UPDATE_FRAGMENT_SHADER = "#version 300 es\nprecision highp float;\nvoid main() {}\n";
-export declare const FLOW_RENDER_VERTEX_SHADER = "#version 300 es\nprecision highp float;\n\nlayout(location = 0) in vec4 a_fromState;\nlayout(location = 1) in vec4 a_toState;\n\nuniform sampler2D u_projection;\nuniform sampler2D u_domainMask;\nuniform sampler2D u_valid0;\nuniform sampler2D u_valid1;\nuniform mat4 u_matrix;\nuniform float u_alpha;\nuniform int u_points;\nuniform vec2 u_viewport;\n\nout float v_speed;\nout float v_alpha;\nout float v_edge;\n\nbool validProjection(vec2 projected) {\n  return !any(isnan(projected)) && !any(isinf(projected));\n}\n\nbool readMask(sampler2D maskTexture, vec2 uv) {\n  ivec2 size = textureSize(maskTexture, 0);\n  ivec2 cell = clamp(ivec2(floor(uv * vec2(size))), ivec2(0), size - ivec2(1));\n  return texelFetch(maskTexture, cell, 0).r > 0.5;\n}\n\nbool validCell(vec2 uv) {\n  return readMask(u_domainMask, uv)\n    && readMask(u_valid0, uv)\n    && readMask(u_valid1, uv);\n}\n\nbool validCellAt(ivec2 cell) {\n  ivec2 size = textureSize(u_domainMask, 0);\n  if (any(lessThan(cell, ivec2(0))) || any(greaterThanEqual(cell, size))) return false;\n  return texelFetch(u_domainMask, cell, 0).r > 0.5\n    && texelFetch(u_valid0, cell, 0).r > 0.5\n    && texelFetch(u_valid1, cell, 0).r > 0.5;\n}\n\nbool validSegment(vec2 start, vec2 end) {\n  if (any(lessThan(start, vec2(0.0))) || any(greaterThan(start, vec2(1.0)))\n      || any(lessThan(end, vec2(0.0))) || any(greaterThan(end, vec2(1.0)))) return false;\n  vec2 size = vec2(textureSize(u_domainMask, 0));\n  vec2 from = min(start * size, size - vec2(0.000001));\n  vec2 to = min(end * size, size - vec2(0.000001));\n  ivec2 cell = ivec2(floor(from));\n  ivec2 target = ivec2(floor(to));\n  vec2 delta = to - from;\n  ivec2 cellStep = ivec2(sign(delta));\n  vec2 tDelta = vec2(\n    delta.x == 0.0 ? 1.0e30 : abs(1.0 / delta.x),\n    delta.y == 0.0 ? 1.0e30 : abs(1.0 / delta.y)\n  );\n  vec2 nextBoundary = vec2(cell) + vec2(\n    cellStep.x > 0 ? 1.0 : 0.0,\n    cellStep.y > 0 ? 1.0 : 0.0\n  );\n  vec2 tMax = vec2(\n    delta.x == 0.0 ? 1.0e30 : (nextBoundary.x - from.x) / delta.x,\n    delta.y == 0.0 ? 1.0e30 : (nextBoundary.y - from.y) / delta.y\n  );\n  for (int visited = 0; visited < 256; visited += 1) {\n    if (!validCellAt(cell)) return false;\n    if (all(equal(cell, target))) return true;\n    bool advanceX = tMax.x <= tMax.y;\n    bool advanceY = tMax.y <= tMax.x;\n    if (advanceX) {\n      cell.x += cellStep.x;\n      tMax.x += tDelta.x;\n    }\n    if (advanceY) {\n      cell.y += cellStep.y;\n      tMax.y += tDelta.y;\n    }\n  }\n  return false;\n}\n\nvoid main() {\n  bool continuous = a_toState.z > a_fromState.z\n    && distance(a_fromState.xy, a_toState.xy) < 0.1;\n  vec2 fromProjected = texture(u_projection, clamp(a_fromState.xy, vec2(0.0), vec2(1.0))).rg;\n  vec2 toProjected = texture(u_projection, clamp(a_toState.xy, vec2(0.0), vec2(1.0))).rg;\n\n  if ((!continuous && u_points == 0)\n      || !validSegment(a_fromState.xy, a_toState.xy)\n      || !validProjection(fromProjected)\n      || !validProjection(toProjected)) {\n    gl_Position = vec4(2.0, 2.0, 2.0, 1.0);\n    v_speed = 0.0;\n    v_alpha = 0.0;\n    v_edge = 1.0;\n    return;\n  }\n\n  vec4 fromClip = u_matrix * vec4(fromProjected, 0.0, 1.0);\n  vec4 toClip = u_matrix * vec4(toProjected, 0.0, 1.0);\n  if (u_points == 1) {\n    gl_Position = toClip;\n    gl_PointSize = 1.5;\n    v_edge = 0.0;\n  } else {\n    vec2 fromScreen = fromClip.xy / fromClip.w;\n    vec2 toScreen = toClip.xy / toClip.w;\n    vec2 direction = normalize((toScreen - fromScreen) * u_viewport);\n    vec2 normal = vec2(-direction.y, direction.x);\n    float side = (gl_VertexID == 0 || gl_VertexID == 2) ? -1.0 : 1.0;\n    bool useTo = gl_VertexID >= 2;\n    vec4 base = useTo ? toClip : fromClip;\n    vec2 screen = base.xy / base.w;\n    vec2 offset = normal * side * 2.0 / u_viewport;\n    gl_Position = vec4((screen + offset) * base.w, base.z, base.w);\n    v_edge = side;\n  }\n  v_speed = a_toState.w;\n  v_alpha = u_alpha;\n}\n";
-export declare const FLOW_RENDER_FRAGMENT_SHADER = "#version 300 es\nprecision highp float;\n\nin float v_speed;\nin float v_alpha;\nin float v_edge;\nout vec4 fragColor;\n\nconst vec3 COLORS[8] = vec3[](\n  vec3(0.196, 0.533, 0.741),\n  vec3(0.400, 0.761, 0.647),\n  vec3(0.671, 0.867, 0.643),\n  vec3(0.902, 0.961, 0.596),\n  vec3(0.996, 0.878, 0.545),\n  vec3(0.992, 0.682, 0.380),\n  vec3(0.957, 0.427, 0.263),\n  vec3(0.835, 0.243, 0.310)\n);\n\nvec3 velocityColor(float speed) {\n  float scaled = clamp(speed, 0.0, 1.0) * 7.0;\n  int low = int(floor(scaled));\n  int high = min(low + 1, 7);\n  return mix(COLORS[low], COLORS[high], fract(scaled));\n}\n\nvoid main() {\n  float antialias = 1.0 - smoothstep(0.45, 1.0, abs(v_edge));\n  fragColor = vec4(velocityColor(v_speed), v_alpha * antialias);\n}\n";
+export declare const FLOW_RENDER_VERTEX_SHADER = "#version 300 es\nprecision highp float;\n\nlayout(location = 0) in vec4 a_fromState;\nlayout(location = 1) in vec4 a_toState;\n\nuniform sampler2D u_projection;\nuniform sampler2D u_domainMask;\nuniform sampler2D u_valid0;\nuniform sampler2D u_valid1;\nuniform mat4 u_matrix;\nuniform float u_alpha;\nuniform int u_points;\nuniform vec2 u_viewport;\nuniform float u_lineWidth;\n\nout float v_speed;\nout float v_alpha;\nout float v_edge;\n\nbool validProjection(vec2 projected) {\n  return !any(isnan(projected)) && !any(isinf(projected));\n}\n\nbool readMask(sampler2D maskTexture, vec2 uv) {\n  ivec2 size = textureSize(maskTexture, 0);\n  ivec2 cell = clamp(ivec2(floor(uv * vec2(size))), ivec2(0), size - ivec2(1));\n  return texelFetch(maskTexture, cell, 0).r > 0.5;\n}\n\nbool validCell(vec2 uv) {\n  return readMask(u_domainMask, uv)\n    && readMask(u_valid0, uv)\n    && readMask(u_valid1, uv);\n}\n\nbool validCellAt(ivec2 cell) {\n  ivec2 size = textureSize(u_domainMask, 0);\n  if (any(lessThan(cell, ivec2(0))) || any(greaterThanEqual(cell, size))) return false;\n  return texelFetch(u_domainMask, cell, 0).r > 0.5\n    && texelFetch(u_valid0, cell, 0).r > 0.5\n    && texelFetch(u_valid1, cell, 0).r > 0.5;\n}\n\nbool validSegment(vec2 start, vec2 end) {\n  if (any(lessThan(start, vec2(0.0))) || any(greaterThan(start, vec2(1.0)))\n      || any(lessThan(end, vec2(0.0))) || any(greaterThan(end, vec2(1.0)))) return false;\n  vec2 size = vec2(textureSize(u_domainMask, 0));\n  vec2 from = min(start * size, size - vec2(0.000001));\n  vec2 to = min(end * size, size - vec2(0.000001));\n  ivec2 cell = ivec2(floor(from));\n  ivec2 target = ivec2(floor(to));\n  vec2 delta = to - from;\n  ivec2 cellStep = ivec2(sign(delta));\n  vec2 tDelta = vec2(\n    delta.x == 0.0 ? 1.0e30 : abs(1.0 / delta.x),\n    delta.y == 0.0 ? 1.0e30 : abs(1.0 / delta.y)\n  );\n  vec2 nextBoundary = vec2(cell) + vec2(\n    cellStep.x > 0 ? 1.0 : 0.0,\n    cellStep.y > 0 ? 1.0 : 0.0\n  );\n  vec2 tMax = vec2(\n    delta.x == 0.0 ? 1.0e30 : (nextBoundary.x - from.x) / delta.x,\n    delta.y == 0.0 ? 1.0e30 : (nextBoundary.y - from.y) / delta.y\n  );\n  for (int visited = 0; visited < 256; visited += 1) {\n    if (!validCellAt(cell)) return false;\n    if (all(equal(cell, target))) return true;\n    bool advanceX = tMax.x <= tMax.y;\n    bool advanceY = tMax.y <= tMax.x;\n    if (advanceX) {\n      cell.x += cellStep.x;\n      tMax.x += tDelta.x;\n    }\n    if (advanceY) {\n      cell.y += cellStep.y;\n      tMax.y += tDelta.y;\n    }\n  }\n  return false;\n}\n\nvoid main() {\n  bool continuous = a_toState.z > a_fromState.z\n    && distance(a_fromState.xy, a_toState.xy) < 0.1;\n  vec2 fromProjected = texture(u_projection, clamp(a_fromState.xy, vec2(0.0), vec2(1.0))).rg;\n  vec2 toProjected = texture(u_projection, clamp(a_toState.xy, vec2(0.0), vec2(1.0))).rg;\n\n  if ((!continuous && u_points == 0)\n      || !validSegment(a_fromState.xy, a_toState.xy)\n      || !validProjection(fromProjected)\n      || !validProjection(toProjected)) {\n    gl_Position = vec4(2.0, 2.0, 2.0, 1.0);\n    v_speed = 0.0;\n    v_alpha = 0.0;\n    v_edge = 1.0;\n    return;\n  }\n\n  vec4 fromClip = u_matrix * vec4(fromProjected, 0.0, 1.0);\n  vec4 toClip = u_matrix * vec4(toProjected, 0.0, 1.0);\n  if (u_points == 1) {\n    gl_Position = toClip;\n    gl_PointSize = max(1.0, u_lineWidth);\n    v_edge = 0.0;\n  } else {\n    vec2 fromScreen = fromClip.xy / fromClip.w;\n    vec2 toScreen = toClip.xy / toClip.w;\n    vec2 direction = normalize((toScreen - fromScreen) * u_viewport);\n    vec2 normal = vec2(-direction.y, direction.x);\n    float side = (gl_VertexID == 0 || gl_VertexID == 2) ? -1.0 : 1.0;\n    bool useTo = gl_VertexID >= 2;\n    vec4 base = useTo ? toClip : fromClip;\n    vec2 screen = base.xy / base.w;\n    vec2 offset = normal * side * u_lineWidth / u_viewport;\n    gl_Position = vec4((screen + offset) * base.w, base.z, base.w);\n    v_edge = side;\n  }\n  v_speed = a_toState.w;\n  v_alpha = u_alpha;\n}\n";
+export declare const FLOW_RENDER_FRAGMENT_SHADER = "#version 300 es\nprecision highp float;\n\nin float v_speed;\nin float v_alpha;\nin float v_edge;\nout vec4 fragColor;\nuniform sampler2D u_colorRamp;\nuniform vec2 u_speedRange;\n\nvoid main() {\n  float antialias = 1.0 - smoothstep(0.45, 1.0, abs(v_edge));\n  float normalizedSpeed = clamp(\n    (v_speed - u_speedRange.x) / max(u_speedRange.y - u_speedRange.x, 1.0e-6),\n    0.0,\n    1.0\n  );\n  vec4 rampColor = texture(u_colorRamp, vec2(normalizedSpeed, 0.5));\n  float alpha = rampColor.a * v_alpha * antialias;\n  // MapLibre's custom-layer canvas is premultiplied. Keeping this output and\n  // the render pass in the same convention prevents repeated trail fragments\n  // from being composited as straight-alpha colours.\n  fragColor = vec4(rampColor.rgb * alpha, alpha);\n}\n";

package/dist/src/types/analysis.d.ts

@@ -26,6 +26,7 @@
  * `src/sdk/facets/types.ts`; F14.2 fixes the schema family's home here.
  */
 import type { NgisDataType } from "../sdk/facets/types";
+import type { NgisValidationIssue } from "../domain/models/crs";
 export type WorkSurface = "workflow" | "insight" | "code";
 export type RightDockMode = "none" | "ai";
 export type MapFocusMode = "split" | "map" | "work";
@@ -35,15 +36,31 @@ export type NgisParamRole = "input" | "option" | "output";
 /**
  * Total, frozen. **There is NO fallback widget:** an unknown key is a
  * render-time error surfaced in place, never a silently-degraded text input.
- * A Y3 widget registry missing any of the twelve is a defect.
+ * A Y3 widget registry missing any of the thirteen is a defect.
  *
  * `field-select`, `extent` and `textarea` are **never emitted by YB1 in v1** —
  * no builtin schema expresses a field, a bbox or a long-text parameter. They
  * are in the union because the registry must be total over it, and because an
  * author's `ParamForm` `widgets` override and a recipe's promoted inputs can
  * select them.
+ *
+ * ## `"crs"` is the thirteenth, and it **AMENDS F14.2** (Stage 25, F25.3)
+ *
+ * F14.2 froze twelve keys and called the union closed. `"crs"` is added by an
+ * explicit amendment, not by growth: it is the widget for `ngis:outputCrs`, the
+ * one **platform** parameter every tool's UI schema carries (F25.4), and there
+ * was no key in the twelve that could carry a coordinate reference system
+ * without lying about it — `select` would have needed a closed choice list over
+ * the EPSG registry, and `text` would have accepted anything.
+ *
+ * Because {@link NgisWidgetRegistry} is a *total* mapped type, an external
+ * implementer that does not add the key **fails to compile. That is the intended
+ * signal**, recorded here as an amendment rather than discovered as an accident.
+ * S25-02 enumerated every implementer in the repo — there are none outside
+ * `src/` — and the union has **nine** in-repo gate sites, not one; F25.3 lists
+ * them.
  */
-export type NgisWidgetKey = "resource-select" | "resource-multi" | "select" | "multi-select" | "switch" | "number" | "integer" | "text" | "textarea" | "output-name" | "field-select" | "extent";
+export type NgisWidgetKey = "resource-select" | "resource-multi" | "select" | "multi-select" | "switch" | "number" | "integer" | "text" | "textarea" | "output-name" | "field-select" | "extent" | "crs";
 export interface NgisUiSchemaChoice {
     value: string;
     label: string;
@@ -109,7 +126,26 @@ export interface NgisToolUiSchema {
  * rule `recipeVersion` carries in F14.6).
  */
 export declare const NGIS_UI_SCHEMA_VERSION: 1;
-/** `PASS | ADAPTABLE | UNKNOWN | FAIL`, passed through verbatim. */
+/**
+ * `PASS | ADAPTABLE | UNKNOWN | FAIL`, passed through verbatim.
+ *
+ * **Stage 29 (F29.8) — `verdict` and issue code are INDEPENDENT axes.**
+ * `"ADAPTABLE"` is the same token for Stage 26's **CRS** adaptation and Stage
+ * 29's **kind** adaptation; `verdict` carries *what*, `issues[]` carries *why*,
+ * and **only the issue code distinguishes them**. A test that asserts nothing but
+ * `verdict === "ADAPTABLE"` passes on the CRS case (`binding-adaptable.json`
+ * `B02`) and proves Stage 26's code path rather than this stage's — which is why
+ * the predicate is `isKindAdaptableIssue` in
+ * `src/domain/models/dataset-kind.ts`, over the code and never over the verdict.
+ *
+ * The kind code is `KIND_ADAPTABLE`, severity `advisory`, `port` set, and **`fix`
+ * absent** — `NgisValidationIssueFix` means *"set this parameter to this value"*
+ * and there is no parameter that turns a kind adaptation on or off, so a client
+ * rendering a one-click fix here has invented an affordance the server cannot
+ * honour. (CRS differs: `ngis:outputCrs` is a real parameter.) `NgisCrsIssueCode`
+ * is already open, so the code needs no union edit. Rendering it is `S29-33`'s
+ * (W3), and the client never re-classifies a server verdict or severity (`G-U`).
+ */
 export type NgisBindingVerdict = "PASS" | "ADAPTABLE" | "UNKNOWN" | "FAIL";
 /** `READY | NEEDS_CONFIGURATION | NOT_EXECUTABLE`, passed through verbatim. */
 export type NgisExecutionVerdict = "READY" | "NEEDS_CONFIGURATION" | "NOT_EXECUTABLE";
@@ -130,9 +166,30 @@ export interface NgisBindingValidationEntry {
     verdict: NgisBindingVerdict;
     reason: string;
     geometry_type: string;
-    srid: number;
-    native_srid: number;
-    working_srid: number;
+    /**
+     * **Stage 25 (F25.1):** the numeric triple `srid` / `native_srid` /
+     * `working_srid` is gone **from this interface**. It was one of the three SRID
+     * vocabularies that never met, and the only one that could tell a caller
+     * "unknown" — it spelled it `0`, which every consumer read as a CRS. A
+     * binding's CRS is the dataset's `crs: NgisCrsRef | null`.
+     *
+     * **CORRECTION OF RECORD (`S25-V255`, S25-32, W3).** This comment used to say
+     * the triple was gone "from this entry **and from the wire**". The second half
+     * was false when it was written and is still false: `validation_rest.py:72-74`
+     * and `binding_validation.py:183-185` send all three fields on both the REST
+     * and the gRPC leg to this day. The W3 kickoff marked them
+     * `[deprecated = true]` in `geoanalysis.proto`; removing them needs
+     * `binding_validation.py`'s `x-required-srid` path to lose its only CRS
+     * source, which is not a W3 change.
+     *
+     * The distinction matters because this file is **quoted verbatim** into the
+     * published contract reference at `/market/devkit/docs`: a wrong sentence here
+     * is a wrong sentence in the SDK documentation a plugin author reads. What is
+     * true is that **the client drops them on the floor** — nothing in this repo
+     * declares or reads them, so no frontend code path can be misled by a `0`.
+     * That is a client guarantee, not a wire fact, and the two are only the same
+     * sentence when the server has actually stopped sending.
+     */
     access_mode: string;
     executable: boolean;
 }
@@ -145,6 +202,19 @@ export interface NgisBindingValidation {
     unresolved_ports: readonly string[];
     errors: readonly string[];
     warnings: readonly string[];
+    /**
+     * **Stage 25 (F25.6), additive.** Typed per-port issues. The F14.9 string
+     * arrays above are unchanged and keep their meaning; this channel carries the
+     * `param`/`port` routing and the one-click `fix` a string cannot.
+     *
+     * This half and {@link NgisExecutionValidation.issues} are **one channel read
+     * at two levels**, exactly as the F14.9 string arrays are: a blocking entry
+     * here blocks the submit too. Reading only the other level was `S29-V234`.
+     *
+     * Optional because a server that has not shipped F25.6 omits it, and an
+     * absent `issues` is "the server said nothing", never "the server said fine".
+     */
+    issues?: readonly NgisValidationIssue[];
 }
 /** `ValidateToolExecutionResponse`, field-for-field, with `normalized_params_json`
  *  replaced by the decoded `normalized_params` object (the one divergence). */
@@ -161,6 +231,15 @@ export interface NgisExecutionValidation {
     execution_mode: NgisExecutionMode;
     /** Decoded. The proto's `normalized_params_json` string is never sent to a browser. */
     normalized_params: Readonly<Record<string, string>>;
+    /**
+     * **Stage 25 (F25.6), additive.** See {@link NgisBindingValidation.issues}.
+     * `isSubmitBlocked` counts a `severity: "blocking"` entry here **or on that
+     * half**, in addition to F14.9's existing rule; the client never suppresses,
+     * downgrades or re-classifies a server issue (G-U) — and declining to gate on
+     * a severity the server declared is a suppression, which is why reading only
+     * this level was a defect (`S29-V234`) rather than a narrower reading.
+     */
+    issues?: readonly NgisValidationIssue[];
 }
 /** `POST /api/analysis/tools/{tool_id}/validate-execution` body. */
 export interface NgisValidateExecutionBody {
@@ -172,7 +251,32 @@ export interface NgisValidateExecutionBody {
     expected_scene_generation?: number;
     output_mode?: NgisOutputMode;
     target_resource_id?: string | null;
-    target_srid?: number;
+    /**
+     * **Stage 25 (F25.12):** `target_srid` is removed. It was typed, forwarded to
+     * validation, and **set by no component** — dead plumbing, and its presence
+     * made a numeric SRID look like a supported way to ask for a projection. The
+     * replacement is F25.4's `outputCrs?: string` (a `NgisCrsRef` key, not an
+     * integer), added on the submit and validate bodies by the W2 session that
+     * owns `RunButton` / `run-data.ts`.
+     *
+     * **Added here by S25-23 (W2), which is that session.**
+     */
+    /**
+     * **Stage 25 (F25.4).** The `ngis:outputCrs` platform parameter, as an
+     * `NgisCrsRef` **key** (`"EPSG:32650"`, `"custom:<ulid>"`).
+     *
+     * **This one field is camelCase in an otherwise snake_case body, and that is
+     * the server's spelling, not a slip.** The W2 dispatch is explicit: the proto
+     * carries `output_crs` on `SubmitTaskRequest` / the validate messages, and the
+     * REST legs take `outputCrs`. Re-spelling it here to match the neighbours
+     * would put a field on the wire that `ngis-geoanalysis` does not read — which
+     * is exactly the failure `target_srid` had, arriving forever and meaning
+     * nothing.
+     *
+     * Absent means "compute in the primary input's own CRS" (R4). The client never
+     * substitutes a value for an absent one (G-CRS).
+     */
+    outputCrs?: string;
 }
 /** `POST /api/analysis/tools/{tool_id}/validate-bindings` body. */
 export interface NgisValidateBindingsBody {

package/dist/src/types/extensions.d.ts

@@ -184,7 +184,44 @@ export interface PackageManifestDto {
     homepage?: string;
     publisher?: string;
     changelog?: string;
+    /**
+     * Semantic tool requirements declared by a UI plugin. The alias is local to
+     * this manifest; only the host receives the resolved, opaque implementation
+     * id at runtime. A bundle must therefore bind a tool through its alias, never
+     * through a UUID copied from the tool catalogue.
+     */
+    toolDependencies?: NgisToolDependencyDeclaration[];
+}
+/** Stable, publisher-owned identity for a tool dependency. */
+export interface NgisToolDependencyReference {
+    namespace: string;
+    toolKey: string;
+    contractRange: string;
+}
+/** Optional structural contract that narrows a semantic dependency further. */
+export interface NgisToolDependencyRequiredContract {
+    inputs?: Record<string, string>;
+    outputs?: Record<string, string>;
+    parameters?: string[];
 }
+export interface NgisToolDependencyDeclaration {
+    /** Locally unique manifest key, used by plugin code at runtime. */
+    alias: string;
+    ref: NgisToolDependencyReference;
+    requiredContract?: NgisToolDependencyRequiredContract;
+}
+/** Resolver outcomes are intentionally specific enough to render an honest UI. */
+export type NgisToolDependencyUnavailableReason = "tool_missing" | "tool_disabled" | "tool_forbidden" | "tool_version_unavailable" | "tool_contract_incompatible" | "dependency_unavailable";
+export type NgisResolvedToolDependency = {
+    available: true;
+    toolId: string;
+    toolRevision: number;
+    contractVersion: string;
+    schemaFingerprint: string;
+} | {
+    available: false;
+    reason: NgisToolDependencyUnavailableReason;
+};
 export interface ExtensionInstallDto {
     extId: string;
     enabled: boolean;
@@ -267,6 +304,12 @@ export interface BootExtensionEntryDto {
     manifest: PackageManifestDto;
     bundleUrl: string;
     integrity: string;
+    /**
+     * Per-viewer resolution of `manifest.toolDependencies`. This is host data,
+     * not bundle configuration: `toolId` is deliberately never written back into
+     * the manifest or exposed as an authoring-time identifier.
+     */
+    dependencies?: Record<string, NgisResolvedToolDependency>;
     /**
      * The resolved version's declared scopes — a projection of
      * `manifest.permissions` (Stage 13 XB1), where an absent key and `[]` mean

package/dist/src/types/gis.d.ts

@@ -83,7 +83,7 @@ export type GisToolId = "draw-point" | "draw-line" | "draw-polygon" | "draw-rect
  * command catalog; host-only composite controls can ride on the rail without
  * becoming invocable map tools.
  */
-export type GisRailItemId = GisToolId | "multi-view" | "flow-field";
+export type GisRailItemId = GisToolId | "multi-view" | "smart-plotting";
 /** How a tool behaves when invoked from the rail. */
 export type GisToolKind = "mode" | "measure" | "action" | "dropdown";
 /** One-shot actions the rail fires on the map via the imperative handle

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@ngis/plugin-sdk",
-  "version": "0.4.0",
-  "description": "Types-first SDK for authoring NeoGIS map plugins.",
-  "license": "Apache-2.0",
+  "version": "0.4.1",
+  "description": "Types-first SDK for authoring NGIS map plugins (DevKit, Stage 11 E3). Distributed as an immutable-per-version tarball from ngis-extension (GET /api/extensions/sdk/{version}.tgz) \u2014 see the authoring guide.",
+  "license": "UNLICENSED",
   "private": false,
   "type": "module",
-  "sideEffects": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -19,27 +18,6 @@
   "files": [
     "dist"
   ],
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/GeoScenarioScripter/NeoGIS-Frontend.git",
-    "directory": "packages/plugin-sdk"
-  },
-  "homepage": "https://github.com/GeoScenarioScripter/NeoGIS-Frontend#readme",
-  "bugs": {
-    "url": "https://github.com/GeoScenarioScripter/NeoGIS-Frontend/issues"
-  },
-  "keywords": [
-    "neogis",
-    "gis",
-    "plugin",
-    "sdk"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "build": "node scripts/build.mjs",
     "prepack": "npm run build"

package/LICENSE

@@ -1,13 +0,0 @@
-Copyright 2026 NeoGIS contributors
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    https://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.

package/README.md

@@ -1,31 +0,0 @@
-# @ngis/plugin-sdk
-
-The public, types-first authoring contract for NeoGIS map plugins.
-
-```bash
-npm install --save-dev @ngis/plugin-sdk
-```
-
-```ts
-import { defineNgisPlugin, type NgisPlugin } from "@ngis/plugin-sdk";
-
-const plugin: NgisPlugin = defineNgisPlugin({
-  manifest: {
-    id: "com.example.my-plugin",
-    name: "My plugin",
-    version: "0.1.0",
-    minNgisVersion: "0.4.0",
-    capabilities: {},
-  },
-});
-
-export default plugin;
-```
-
-Plugin builds must leave `@ngis/plugin-sdk` external. The running NeoGIS host
-provides the runtime through its plugin import map. The npm package supplies the
-real public declarations plus small host-delegating shims; bundling it into a
-plugin would create a runtime copy that is disconnected from the host.
-
-The package version matches `NGIS_MAP_API_VERSION`. Use
-`create-ngis-plugin` for a complete buildable starter.