@buoy-gg/shared-ui 7.0.41 → 7.0.43

package/lib/commonjs/sync/valueShape.js

@@ -1,161 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.listShapes = listShapes;
-exports.shapeOf = shapeOf;
-exports.shapeSummary = shapeSummary;
-exports.shapesWereTruncated = shapesWereTruncated;
-exports.unshapedLists = unshapedLists;
-/**
- * A compact type sketch of a runtime value — one implementation, shared by every
- * adapter that hands data to a model.
- *
- * WHY. A model cannot write a well-formed item into a list it has never seen the
- * shape of, and we were not showing it. Measured on `cart/bag-still-zustand`: the
- * rendered prompt is 83,000 characters and the words `lineId`, `itemId`,
- * `sizeId`, `addonIds` and `unitPrice` appear in it ZERO times. Every model
- * "failing" that case invented a line shape because inventing was the only move
- * available. The zustand typed-edit guard would have caught the invention — but
- * only on a list that already holds an item, since it builds its template from
- * `list[0]`. On an EMPTY list there is no template, the guard has nothing to
- * compare against, and the invented shape is written silently.
- *
- * So the sketch has two jobs, and the second is the one that pays:
- *
- *   1. Say what the items in a list look like, so an addition can match.
- *   2. Say when NOTHING knows — an empty list's item shape is not merely
- *      unread, it is unknowable from runtime state, and the honest answer is to
- *      admit that rather than let a guess through unremarked.
- *
- * It is deliberately tiny. A sketch of a 120-line bag is the same size as a
- * sketch of a 2-line one, so unlike the data it survives the engine's 24,000-
- * character result cap — which is the whole point, because the cases where the
- * model most needs the shape are exactly the ones where the data got cut off.
- */
-
-const isPlainObject = v => typeof v === "object" && v !== null && !Array.isArray(v);
-
-/** Beyond this the sketch stops being cheaper to read than the data. */
-const MAX_DEPTH = 3;
-const MAX_KEYS = 24;
-/**
- * Hard caps on `listShapes`. MAX_DEPTH bounds how DEEP it goes; nothing bounded
- * how WIDE it went, and it walks every entry of every object at each permitted
- * level. A store holding a few hundred keyed records therefore produced a
- * "compact" sketch larger than the data it was standing in for — in a value
- * that rides in every prompt. Depth is not a size budget.
- */
-const MAX_LIST_PATHS = 40;
-const MAX_ENTRIES_VISITED = 600;
-
-/**
- * `{lineId: string, qty: number, addonIds: string[]}` — a one-line type for a
- * value, built from the value itself.
- *
- * An array is described by its FIRST item, because a list whose items disagree
- * is a list nothing can safely add to and the guard will say so anyway. An empty
- * array is `unknown[]`, which is the true answer and the one that matters: it
- * tells a reader that adding to this list is unchecked.
- */
-function shapeOf(value, depth = 0) {
-  if (value === null) return "null";
-  if (Array.isArray(value)) {
-    if (!value.length) return "unknown[]";
-    if (depth >= MAX_DEPTH) return "…[]";
-    const inner = shapeOf(value[0], depth + 1);
-    return inner.includes(" ") || inner.endsWith("]") ? `(${inner})[]` : `${inner}[]`;
-  }
-  if (isPlainObject(value)) {
-    if (depth >= MAX_DEPTH) return "{…}";
-    const keys = Object.keys(value);
-    const shown = keys.slice(0, MAX_KEYS);
-    const body = shown.map(k => `${k}: ${shapeOf(value[k], depth + 1)}`).join(", ");
-    const more = keys.length > shown.length ? `, +${keys.length - shown.length} more` : "";
-    return `{${body}${more}}`;
-  }
-  const t = typeof value;
-  return t === "undefined" ? "undefined" : t === "function" ? "function" : t;
-}
-/**
- * Every list inside a value, with the shape of what goes in it.
- *
- * This is what a caller needs before adding to a list, and it is the part that
- * cannot be recovered from a truncated read of the data itself.
- *
- * A list with `item: undefined` is the warning case: it is empty, so its item
- * shape exists nowhere in the running app — not in the store, not in the
- * persisted copy, not in this sketch. Anything added to it goes in unchecked.
- */
-function listShapes(value, path = "", out = [], depth = 0, budget = {
-  visited: 0
-}) {
-  if (depth > MAX_DEPTH) return out;
-  // Two independent stops: enough lists described, or enough of the value
-  // walked. The second is what a wide-but-shallow store hits.
-  if (out.length >= MAX_LIST_PATHS || budget.visited >= MAX_ENTRIES_VISITED) return out;
-  if (Array.isArray(value)) {
-    const first = value[0];
-    out.push({
-      path: path || "(root)",
-      length: value.length,
-      ...(value.length ? {
-        item: shapeOf(first)
-      } : {})
-    });
-    // One level into the items, so `lines[].addonIds` is reachable too.
-    if (value.length && isPlainObject(first)) {
-      for (const [k, v] of Object.entries(first)) {
-        if (++budget.visited >= MAX_ENTRIES_VISITED) break;
-        listShapes(v, path ? `${path}[].${k}` : `[].${k}`, out, depth + 1, budget);
-      }
-    }
-    return out;
-  }
-  if (isPlainObject(value)) {
-    for (const [k, v] of Object.entries(value)) {
-      if (++budget.visited >= MAX_ENTRIES_VISITED) break;
-      listShapes(v, path ? `${path}.${k}` : k, out, depth + 1, budget);
-    }
-  }
-  return out;
-}
-
-/** True when a sketch stopped early, so a caller can say so rather than imply completeness. */
-function shapesWereTruncated(value) {
-  const budget = {
-    visited: 0
-  };
-  const out = listShapes(value, "", [], 0, budget);
-  return out.length >= MAX_LIST_PATHS || budget.visited >= MAX_ENTRIES_VISITED;
-}
-
-/**
- * The lists in a value that a caller could add to WITHOUT any way to know the
- * item shape. Empty by definition on a healthy value; non-empty means a write
- * into one of these paths cannot be checked by anything.
- */
-function unshapedLists(value) {
-  return listShapes(value).filter(l => l.item === undefined).map(l => l.path);
-}
-
-/**
- * The sketch an adapter attaches to a read: the value's own type, plus the item
- * type of every list in it.
- *
- * Returns undefined when there is nothing worth saying (a scalar, or an object
- * holding no lists) so adapters can spread it and add no noise.
- */
-function shapeSummary(value) {
-  if (value === undefined) return undefined;
-  const lists = listShapes(value);
-  const shape = shapeOf(value);
-  if (!lists.length && !isPlainObject(value) && !Array.isArray(value)) return undefined;
-  return lists.length ? {
-    shape,
-    lists
-  } : {
-    shape
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.listShapes=listShapes;exports.shapeOf=shapeOf;exports.shapeSummary=shapeSummary;exports.shapesWereTruncated=shapesWereTruncated;exports.unshapedLists=unshapedLists;const isPlainObject=n=>typeof n==="object"&&n!==null&&!Array.isArray(n);const MAX_DEPTH=3;const MAX_KEYS=24;const MAX_LIST_PATHS=40;const MAX_ENTRIES_VISITED=600;function shapeOf(n,e=0){if(n===null)return"null";if(Array.isArray(n)){if(!n.length)return"unknown[]";if(e>=MAX_DEPTH)return"\u2026[]";const r=shapeOf(n[0],e+1);return r.includes(" ")||r.endsWith("]")?`(${r})[]`:`${r}[]`}if(isPlainObject(n)){if(e>=MAX_DEPTH)return"{\u2026}";const r=Object.keys(n);const s=r.slice(0,MAX_KEYS);const i=s.map(f=>`${f}: ${shapeOf(n[f],e+1)}`).join(", ");const o=r.length>s.length?`, +${r.length-s.length} more`:"";return`{${i}${o}}`}const t=typeof n;return t==="undefined"?"undefined":t==="function"?"function":t}function listShapes(n,e="",t=[],r=0,s={visited:0}){if(r>MAX_DEPTH)return t;if(t.length>=MAX_LIST_PATHS||s.visited>=MAX_ENTRIES_VISITED)return t;if(Array.isArray(n)){const i=n[0];t.push({path:e||"(root)",length:n.length,...n.length?{item:shapeOf(i)}:{}});if(n.length&&isPlainObject(i)){for(const[o,f]of Object.entries(i)){if(++s.visited>=MAX_ENTRIES_VISITED)break;listShapes(f,e?`${e}[].${o}`:`[].${o}`,t,r+1,s)}}return t}if(isPlainObject(n)){for(const[i,o]of Object.entries(n)){if(++s.visited>=MAX_ENTRIES_VISITED)break;listShapes(o,e?`${e}.${i}`:i,t,r+1,s)}}return t}function shapesWereTruncated(n){const e={visited:0};const t=listShapes(n,"",[],0,e);return t.length>=MAX_LIST_PATHS||e.visited>=MAX_ENTRIES_VISITED}function unshapedLists(n){return listShapes(n).filter(e=>e.item===void 0).map(e=>e.path)}function shapeSummary(n){if(n===void 0)return void 0;const e=listShapes(n);const t=shapeOf(n);if(!e.length&&!isPlainObject(n)&&!Array.isArray(n))return void 0;return e.length?{shape:t,lists:e}:{shape:t}}

package/lib/commonjs/sync/wireBudget.js

@@ -1,97 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.approxJsonSize = approxJsonSize;
-exports.isOverWireBudget = isOverWireBudget;
-var _typeHelpers = require("../utils/typeHelpers.js");
-/**
- * Size guards for anything a tool puts on the sync wire.
- *
- * Every adapter faces the same problem: a snapshot is rebuilt and serialized
- * on the device's JS thread ~5x/sec while a dashboard watches, and one fat or
- * unserializable field can either freeze that thread or blow the emit layer's
- * budget — which drops the WHOLE snapshot and leaves the panel stale.
- *
- * Two rules make that safe, and both are easy to get subtly wrong, which is
- * why they live here instead of being copied per adapter:
- *
- *  1. NEVER measure by serializing. `JSON.stringify(value).length` is
- *     O(payload) and allocates the whole string — an unbounded cost to
- *     enforce a 16KB cap, i.e. the protection becomes the freeze. Walk with
- *     an early abort instead: the cost is O(limit) no matter how big the
- *     value, and a string costs a length read rather than a scan.
- *
- *  2. Only reach for `JSON.stringify` when the walk saw something that could
- *     actually make it throw. A value straight out of `JSON.parse` — which is
- *     what a network body or a stored string is — is a finite tree of plain
- *     values and can never throw, so the check is pure waste on the common
- *     path.
- */
-
-/**
- * Approximate JSON size, aborting as soon as `limit` is passed — O(limit),
- * never O(payload). Returns the bytes counted so far, so one walk can both
- * threshold ("over the per-field cap?") and accumulate ("how much of the
- * snapshot budget is left?").
- */
-function approxJsonSize(value, limit) {
-  let bytes = 0;
-  let sawRepeat = false;
-  let sawBigInt = false;
-  const stack = [value];
-  const seen = new Set();
-  while (stack.length > 0) {
-    if (bytes > limit) return {
-      bytes,
-      sawRepeat,
-      sawBigInt
-    };
-    const v = stack.pop();
-    if (v === null || v === undefined) bytes += 4;else if (typeof v === "string") bytes += v.length + 2; // O(1), no scan
-    else if (typeof v === "number") bytes += 8;else if (typeof v === "boolean") bytes += 5;else if (typeof v === "object") {
-      if (seen.has(v)) {
-        sawRepeat = true;
-        continue;
-      }
-      seen.add(v);
-      if (Array.isArray(v)) {
-        bytes += 2 + v.length;
-        for (let i = 0; i < v.length; i++) stack.push(v[i]);
-      } else {
-        bytes += 2;
-        for (const k in v) {
-          bytes += k.length + 4;
-          stack.push(v[k]);
-        }
-      }
-    } else {
-      if (typeof v === "bigint") sawBigInt = true;
-      bytes += 4;
-    }
-  }
-  return {
-    bytes,
-    sawRepeat,
-    sawBigInt
-  };
-}
-
-/**
- * Should this value be withheld from the wire — too big, or unserializable?
- *
- * The ordering is the point: measure with the early-abort walk, and only pay
- * for `JSON.stringify` when the walk found a reason it might throw.
- */
-function isOverWireBudget(value, limit) {
-  const walk = approxJsonSize(value, limit);
-  if (walk.bytes > limit) return true;
-  // A finished walk with no repeated reference and no bigint cannot throw.
-  //
-  // Not exhaustive even then: a `toJSON`/getter that throws is invisible to
-  // the walk, so callers handling hostile payloads should still guard their
-  // own conversion. `safeEmit` is the last backstop.
-  if (!walk.sawRepeat && !walk.sawBigInt) return false;
-  return !(0, _typeHelpers.isJsonSerializable)(value);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.approxJsonSize=approxJsonSize;exports.isOverWireBudget=isOverWireBudget;var _typeHelpers=require("../utils/typeHelpers.js");function approxJsonSize(r,n){let t=0;let o=false;let l=false;const i=[r];const f=new Set;while(i.length>0){if(t>n)return{bytes:t,sawRepeat:o,sawBigInt:l};const e=i.pop();if(e===null||e===void 0)t+=4;else if(typeof e==="string")t+=e.length+2;else if(typeof e==="number")t+=8;else if(typeof e==="boolean")t+=5;else if(typeof e==="object"){if(f.has(e)){o=true;continue}f.add(e);if(Array.isArray(e)){t+=2+e.length;for(let s=0;s<e.length;s++)i.push(e[s])}else{t+=2;for(const s in e){t+=s.length+4;i.push(e[s])}}}else{if(typeof e==="bigint")l=true;t+=4}}return{bytes:t,sawRepeat:o,sawBigInt:l}}function isOverWireBudget(r,n){const t=approxJsonSize(r,n);if(t.bytes>n)return true;if(!t.sawRepeat&&!t.sawBigInt)return false;return!(0,_typeHelpers.isJsonSerializable)(r)}

package/lib/commonjs/sync/wireForm.js

@@ -1,172 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.WIRE_INLINE_LIMIT_BYTES = exports.WIRE_DETAIL_LIMIT_BYTES = void 0;
-exports.capDetail = capDetail;
-exports.detailByIdAction = detailByIdAction;
-exports.isOnDeviceMarker = isOnDeviceMarker;
-exports.memoByIdentity = memoByIdentity;
-exports.newestFitting = newestFitting;
-exports.onDeviceMarker = onDeviceMarker;
-exports.readParams = readParams;
-exports.sizeOrStub = sizeOrStub;
-exports.toWire = toWire;
-exports.truncatedNote = truncatedNote;
-var _wireBudget = require("./wireBudget.js");
-/**
- * wireForm — how a tool turns what it holds into what it may put on the wire.
- *
- * Every adapter that ships large values faces the same four problems, and
- * nine of them solved each one separately:
- *
- *  1. A per-item cap on the snapshot stream (16 KB), with a MARKER left in
- *     the value's place so the dashboard knows to fetch it on demand.
- *  2. A much larger cap on that on-demand detail fetch (8 MB), with a
- *     TRUNCATION NOTE when even that is exceeded.
- *  3. An identity-keyed cache for the wire form, because a snapshot is
- *     rebuilt ~5×/sec while a dashboard watches and stores never mutate a
- *     recorded item — so converting each item once is correct and cheap.
- *  4. For tools whose items are individually fat (console, sentry), a
- *     newest-first walk that keeps as many items as fit a snapshot budget.
- *
- * Marker KEY NAMES are part of the wire protocol — Buoy Desktop and the
- * tool stores test for `__buoyStateOnDevice`, `__buoyPayloadOnDevice`,
- * `__buoyValueOnDevice` — so the factory builds exactly those keys.
- */
-
-/** Per-item budget on the snapshot stream. Anything larger stays on-device. */
-const WIRE_INLINE_LIMIT_BYTES = exports.WIRE_INLINE_LIMIT_BYTES = 16 * 1024;
-
-/**
- * Upper bound for one on-demand detail response. Generous — this is a single
- * explicit fetch, not a per-item stream — but still guarded so a pathological
- * tree can't OOM the device through the reply emit.
- */
-const WIRE_DETAIL_LIMIT_BYTES = exports.WIRE_DETAIL_LIMIT_BYTES = 8 * 1024 * 1024;
-
-/** A frozen `{ __buoy<Kind>OnDevice: true, note }` marker. */
-
-/**
- * Build the sentinel a wire-form snapshot carries in place of a value that
- * stays on the device. `kind` names the value ("State", "Payload", "Value",
- * "Params", "Data", …) and becomes the key the reader tests for.
- */
-function onDeviceMarker(kind, note) {
-  return Object.freeze({
-    [`__buoy${kind}OnDevice`]: true,
-    note
-  });
-}
-
-/** True when `value` is the on-device marker for `kind`. */
-function isOnDeviceMarker(value, kind) {
-  return typeof value === "object" && value !== null && value[`__buoy${kind}OnDevice`] === true;
-}
-
-/** The note a detail fetch returns when a single field exceeds the detail cap. */
-function truncatedNote(limitBytes = WIRE_DETAIL_LIMIT_BYTES) {
-  const mb = limitBytes / (1024 * 1024);
-  return {
-    __buoyTruncated: true,
-    note: `Exceeds the ${mb}MB detail limit — inspect it on-device.`
-  };
-}
-
-/**
- * The value itself if it fits `limit` (and is serializable), else `marker`.
- * `undefined` passes through untouched: an absent field must stay absent.
- */
-function toWire(value, marker, limit = WIRE_INLINE_LIMIT_BYTES) {
-  if (value === undefined) return value;
-  return (0, _wireBudget.isOverWireBudget)(value, limit) ? marker : value;
-}
-
-/** Detail-fetch cap: the value, or a truncation note when it is too big. */
-function capDetail(value, limit = WIRE_DETAIL_LIMIT_BYTES) {
-  return (0, _wireBudget.isOverWireBudget)(value, limit) ? truncatedNote(limit) : value;
-}
-
-/**
- * Memoize a wire-form conversion by item identity. Correct for any store
- * that prepends and never mutates a recorded item — the cache self-invalidates
- * when the item is dropped from the buffer.
- */
-function memoByIdentity(convert) {
-  const cache = new WeakMap();
-  return item => {
-    const cached = cache.get(item);
-    if (cached !== undefined) return cached;
-    const converted = convert(item);
-    cache.set(item, converted);
-    return converted;
-  };
-}
-/**
- * Walk `items` (oldest-first) from the newest end, keeping every item until
- * the budget is spent. Always keeps at least one so an over-budget newest
- * item still reaches the dashboard as a stub rather than an empty panel.
- * Returns oldest-first, matching the input.
- */
-function newestFitting(items, options) {
-  const out = [];
-  let bytes = options.baseBytes ?? 16;
-  for (let i = items.length - 1; i >= 0; i--) {
-    const wired = options.toWire(items[i]);
-    if (bytes + wired.bytes > options.budget && out.length > 0) break;
-    out.push(wired.value);
-    bytes += wired.bytes;
-  }
-  out.reverse();
-  return out;
-}
-
-/**
- * Size one wire-form item against a per-item cap, substituting a stub when it
- * is too fat. One walk decides both "too big?" and "what does it cost".
- */
-function sizeOrStub(wired, limit, stub) {
-  const size = (0, _wireBudget.approxJsonSize)(wired, limit);
-  if (size.bytes <= limit) return {
-    value: wired,
-    bytes: size.bytes
-  };
-  const stubbed = stub();
-  return {
-    value: stubbed,
-    bytes: (0, _wireBudget.approxJsonSize)(stubbed, limit).bytes
-  };
-}
-
-/** `(params as T | undefined) ?? {}` — the first line of every action. */
-function readParams(params) {
-  return params ?? {};
-}
-/**
- * The on-demand detail action every change-log tool exposes: look one item
- * up by id, and return its detail fields size-capped. Replaces the
- * `missing id` / `unknown id` boilerplate copied into each adapter.
- */
-function detailByIdAction(lookup, detail, limit = WIRE_DETAIL_LIMIT_BYTES) {
-  const cap = value => capDetail(value, limit);
-  return params => {
-    const {
-      id
-    } = readParams(params);
-    if (!id) return {
-      found: false,
-      reason: "missing id"
-    };
-    const item = lookup(id);
-    if (!item) return {
-      found: false,
-      reason: "unknown id"
-    };
-    return {
-      found: true,
-      id,
-      ...detail(item, cap)
-    };
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.WIRE_INLINE_LIMIT_BYTES=exports.WIRE_DETAIL_LIMIT_BYTES=void 0;exports.capDetail=capDetail;exports.detailByIdAction=detailByIdAction;exports.isOnDeviceMarker=isOnDeviceMarker;exports.memoByIdentity=memoByIdentity;exports.newestFitting=newestFitting;exports.onDeviceMarker=onDeviceMarker;exports.readParams=readParams;exports.sizeOrStub=sizeOrStub;exports.toWire=toWire;exports.truncatedNote=truncatedNote;var _wireBudget=require("./wireBudget.js");const WIRE_INLINE_LIMIT_BYTES=exports.WIRE_INLINE_LIMIT_BYTES=16*1024;const WIRE_DETAIL_LIMIT_BYTES=exports.WIRE_DETAIL_LIMIT_BYTES=8*1024*1024;function onDeviceMarker(e,t){return Object.freeze({[`__buoy${e}OnDevice`]:true,note:t})}function isOnDeviceMarker(e,t){return typeof e==="object"&&e!==null&&e[`__buoy${t}OnDevice`]===true}function truncatedNote(e=WIRE_DETAIL_LIMIT_BYTES){const t=e/(1024*1024);return{__buoyTruncated:true,note:`Exceeds the ${t}MB detail limit \u2014 inspect it on-device.`}}function toWire(e,t,r=WIRE_INLINE_LIMIT_BYTES){if(e===void 0)return e;return(0,_wireBudget.isOverWireBudget)(e,r)?t:e}function capDetail(e,t=WIRE_DETAIL_LIMIT_BYTES){return(0,_wireBudget.isOverWireBudget)(e,t)?truncatedNote(t):e}function memoByIdentity(e){const t=new WeakMap;return r=>{const o=t.get(r);if(o!==void 0)return o;const n=e(r);t.set(r,n);return n}}function newestFitting(e,t){const r=[];let o=t.baseBytes??16;for(let n=e.length-1;n>=0;n--){const s=t.toWire(e[n]);if(o+s.bytes>t.budget&&r.length>0)break;r.push(s.value);o+=s.bytes}r.reverse();return r}function sizeOrStub(e,t,r){const o=(0,_wireBudget.approxJsonSize)(e,t);if(o.bytes<=t)return{value:e,bytes:o.bytes};const n=r();return{value:n,bytes:(0,_wireBudget.approxJsonSize)(n,t).bytes}}function readParams(e){return e??{}}function detailByIdAction(e,t,r=WIRE_DETAIL_LIMIT_BYTES){const o=n=>capDetail(n,r);return n=>{const{id:s}=readParams(n);if(!s)return{found:false,reason:"missing id"};const i=e(s);if(!i)return{found:false,reason:"unknown id"};return{found:true,id:s,...t(i,o)}}}

package/lib/commonjs/tools/defineTool.js

@@ -1,79 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.createToolFactory = createToolFactory;
-exports.defineToolPreset = defineToolPreset;
-/**
- * defineToolPreset / createToolFactory — the typed way to declare a tool.
- *
- * Every tool package exports a `xToolPreset` object literal and a
- * `createXTool(options)` factory that restates the same literal with
- * `options?.name || default` on each field. None of the 23 presets was
- * annotated with core's `InstalledApp`, so a preset that drifted from the
- * contract (a bad `slot`, a missing `component`) failed at runtime in the
- * dial, not at compile time.
- *
- * `ToolPreset` is that contract, declared here in shared (which every tool
- * already depends on) and structurally identical to core's `InstalledApp`.
- * `defineToolPreset` is an identity function that type-checks the literal;
- * `createToolFactory` derives the `createXTool` function from the preset so
- * the defaults live in exactly one place.
- *
- * Auto-discovery (core's `autoDiscoverPresets` / `autoExternalSync`) stays
- * as hand-written `require()` blocks on purpose: Metro needs each package
- * name as a static string lexically inside its own try, so a manifest can't
- * replace them.
- */
-
-/** Where a tool should render within the floating menu surface. */
-
-/** What an icon renderer receives. Mirrors core's `FloatingMenuRenderCtx`. */
-
-/** Declarative modal chrome for a body-only tool. Mirrors core's `ToolModalConfig`. */
-
-/**
- * The shape the floating menu installs. Structurally identical to core's
- * `InstalledApp`; declared here so tool packages can type their presets
- * without depending on core.
- */
-
-/** Identity with a type check: the literal must satisfy `ToolPreset`. */
-function defineToolPreset(preset) {
-  return preset;
-}
-
-/** The overrides every `createXTool` accepted. */
-
-/**
- * Derive `createXTool(options)` from a preset: id/name/description overrides
- * apply on top, and `mapProps` turns tool-specific options into `props`
- * (merged over the preset's defaults).
- *
- * ```ts
- * export const createNetworkTool = createToolFactory(networkToolPreset, (o: { enableSharedModalDimensions?: boolean }) => ({
- *   enableSharedModalDimensions: o.enableSharedModalDimensions ?? false,
- * }));
- * ```
- */
-function createToolFactory(preset, mapProps, /** Last word on any other preset field (a recolored icon, say). */
-extend) {
-  return options => {
-    const overrides = options ?? {};
-    const props = preset.props === undefined && !mapProps ? undefined : {
-      ...(preset.props ?? {}),
-      ...(mapProps ? mapProps(overrides) : {})
-    };
-    return {
-      ...preset,
-      id: overrides.id || preset.id,
-      name: overrides.name || preset.name,
-      description: overrides.description || preset.description,
-      ...(props !== undefined ? {
-        props
-      } : {}),
-      ...(extend ? extend(overrides, preset) : {})
-    };
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createToolFactory=createToolFactory;exports.defineToolPreset=defineToolPreset;function defineToolPreset(e){return e}function createToolFactory(e,n,i){return t=>{const o=t??{};const r=e.props===void 0&&!n?void 0:{...e.props??{},...n?n(o):{}};return{...e,id:o.id||e.id,name:o.name||e.name,description:o.description||e.description,...r!==void 0?{props:r}:{},...i?i(o,e):{}}}}

package/lib/commonjs/types/types.d.js

@@ -1 +1 @@
-"use strict";
+"use strict";

package/lib/commonjs/types/types.js

@@ -1,37 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isPlainObject = isPlainObject;
-exports.normalizeEnvironment = normalizeEnvironment;
-// Shared type definitions for the dev tools
-
-// Type guard to check if a value is a plain object (not Date, Array, etc.)
-function isPlainObject(value) {
-  return value !== null && value !== undefined && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !(value instanceof Error) && !(value instanceof Map) && !(value instanceof Set) && !(value instanceof RegExp) && typeof value !== "function";
-}
-/**
- * Normalizes common environment strings to canonical Environment values.
- * Handles variants like "production" → "prod", "development" → "dev", etc.
- */
-function normalizeEnvironment(env) {
-  switch (env.toLowerCase().trim()) {
-    case "local":
-      return "local";
-    case "dev":
-    case "development":
-      return "dev";
-    case "qa":
-    case "test":
-      return "qa";
-    case "staging":
-    case "stage":
-      return "staging";
-    case "prod":
-    case "production":
-      return "prod";
-    default:
-      return "local";
-  }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.isPlainObject=isPlainObject;exports.normalizeEnvironment=normalizeEnvironment;function isPlainObject(e){return e!==null&&e!==void 0&&typeof e==="object"&&!Array.isArray(e)&&!(e instanceof Date)&&!(e instanceof Error)&&!(e instanceof Map)&&!(e instanceof Set)&&!(e instanceof RegExp)&&typeof e!=="function"}function normalizeEnvironment(e){switch(e.toLowerCase().trim()){case"local":return"local";case"dev":case"development":return"dev";case"qa":case"test":return"qa";case"staging":case"stage":return"staging";case"prod":case"production":return"prod";default:return"local"}}