@loomweaver/plugin-sdk 0.7.8 → 0.7.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/plugin-sdk",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "description": "LoomWeaver plugin contract: the public SDK a weaver depends on — ProductIdentity, Command, PluginContext and the host UI vocabulary.",
   "keywords": [
     "loomweaver",

package/src/lib/content-route.d.ts

@@ -199,9 +199,8 @@ export interface ContentRouteBase {
     /** Whether the user may close a tab of this route — carried through from {@link Surface.closable}. */
     readonly closable?: boolean;
     /**
-     * Whether the host insets this surface from its pane edges (default `true`). Declare `false` for a
-     * surface that owns its own edges — a viewer, a canvas, a map, an edge-to-edge table. See
-     * `SurfaceBase.padded`.
+     * Whether the host insets this surface from its pane edges. Absent, the product's own default
+     * applies, which is no inset unless the distribution asked for one. See `SurfaceBase.padded`.
      */
     readonly padded?: boolean;
 }

package/src/lib/rail-item.d.ts

@@ -60,6 +60,11 @@ export interface RailItem {
     /**
      * Id of a registered {@link Command} this item triggers. Provide this **or** {@link run}; when
      * set, the host runs that command (so a keybinding/palette can share the same behaviour).
+     *
+     * The host never marks such an item as current, not even while the address its command opened is
+     * the one on screen: only a {@link workspace} entry is marked, because a command may do anything
+     * and the host cannot tell what "being there" would mean for it. An entry meant to read as a
+     * place the user is *in* belongs to a workspace, not to a command that navigates.
      */
     readonly command?: string;
     /**

package/src/lib/surface.d.ts

@@ -190,13 +190,18 @@ export interface SurfaceBase {
      */
     readonly closable?: boolean;
     /**
-     * Whether the host insets this surface from its pane edges. Defaults to `true` — comfortable for the
-     * prose, forms and lists most surfaces are. Declare `false` for a surface that **is** the content and
-     * owns its own edges: a viewer, a canvas, a map, an edge-to-edge table. It travels with the surface,
-     * so it holds wherever the user puts it — the URL pane, a split, a sidebar, a pop-out window.
+     * Whether the host insets this surface from its pane edges. Leave it out and the product decides:
+     * the host insets nothing unless the distribution asked it to, with `padding` on `provideShell`.
      *
-     * Only the inset is yours to switch off; how wide it is stays a styling question, so a product that
-     * wants a different amount everywhere writes plain unlayered CSS rather than asking for a token.
+     * Declare it where this surface differs from the product's answer, in either direction. `true` for
+     * the prose, forms and lists that read better with air around them; `false` for a surface that
+     * **is** the content and owns its own edges — a viewer, a canvas, a map, an edge-to-edge table —
+     * in a product that insets everything else. It travels with the surface, so it holds wherever the
+     * user puts it: the URL pane, a split, a sidebar, a pop-out window.
+     *
+     * Only whether there is an inset is yours; how wide it is stays a styling question, so a product
+     * that wants a different amount everywhere writes plain unlayered CSS rather than asking for a
+     * token.
      */
     readonly padded?: boolean;
     /**

package/src/lib/view.d.ts

@@ -84,9 +84,8 @@ export interface View {
     /** Whether the user may close a tab of this view — carried through from {@link Surface.closable}. */
     readonly closable?: boolean;
     /**
-     * Whether the host insets this surface from its pane edges (default `true`). Declare `false` for a
-     * surface that owns its own edges — a viewer, a canvas, a map, an edge-to-edge table. See
-     * `SurfaceBase.padded`.
+     * Whether the host insets this surface from its pane edges. Absent, the product's own default
+     * applies, which is no inset unless the distribution asked for one. See `SurfaceBase.padded`.
      */
     readonly padded?: boolean;
     /** Component the host renders as the view body. */