@kb-labs/shared-command-kit 1.0.0

package/dist/studio/index.js

@@ -0,0 +1,178 @@
+// src/studio/index.ts
+function toDataSource(shorthand) {
+  if (!shorthand) {
+    return { type: "static" };
+  }
+  if ("rest" in shorthand) {
+    return { type: "rest", routeId: shorthand.rest, method: shorthand.method };
+  }
+  if ("mock" in shorthand) {
+    return { type: "mock", fixtureId: shorthand.mock };
+  }
+  return { type: "static", value: shorthand.static };
+}
+function collectWidgets(nodes) {
+  const widgets = [];
+  const rootIds = [];
+  for (const node of nodes) {
+    if (typeof node === "string") {
+      rootIds.push(node);
+      continue;
+    }
+    rootIds.push(node.id);
+    if (node.kind === "tabs") {
+      const tabsNode = node;
+      const allChildWidgets = [];
+      const tabChildIds = {};
+      for (const tab of tabsNode.tabs) {
+        const { widgets: tabWidgets, rootIds: tabRootIds } = collectWidgets(tab.children);
+        allChildWidgets.push(...tabWidgets);
+        tabChildIds[tab.id] = tabRootIds;
+      }
+      widgets.push(...allChildWidgets);
+      widgets.push({
+        id: tabsNode.id,
+        kind: "tabs",
+        title: tabsNode.title,
+        description: tabsNode.description,
+        data: { source: toDataSource(tabsNode.source) },
+        options: {
+          ...tabsNode.options,
+          tabs: tabsNode.tabs.map((t) => ({ id: t.id, label: t.label, icon: t.icon })),
+          tabChildren: tabChildIds
+        },
+        children: Object.values(tabChildIds).flat(),
+        layoutHint: tabsNode.layout,
+        actions: tabsNode.actions,
+        events: tabsNode.events,
+        visibility: tabsNode.visibility,
+        pollingMs: tabsNode.pollingMs,
+        order: tabsNode.order
+      });
+    } else if ("children" in node && Array.isArray(node.children)) {
+      const compositeNode = node;
+      const { widgets: childWidgets, rootIds: childIds } = collectWidgets(compositeNode.children);
+      widgets.push(...childWidgets);
+      widgets.push({
+        id: compositeNode.id,
+        kind: compositeNode.kind,
+        title: compositeNode.title,
+        description: compositeNode.description,
+        data: { source: toDataSource(compositeNode.source) },
+        options: compositeNode.options,
+        children: childIds,
+        layoutHint: compositeNode.layout,
+        actions: compositeNode.actions,
+        events: compositeNode.events,
+        visibility: compositeNode.visibility,
+        pollingMs: compositeNode.pollingMs,
+        order: compositeNode.order
+      });
+    } else {
+      const leafNode = node;
+      widgets.push({
+        id: leafNode.id,
+        kind: leafNode.kind,
+        title: leafNode.title,
+        description: leafNode.description,
+        data: { source: toDataSource(leafNode.source) },
+        options: leafNode.options,
+        layoutHint: leafNode.layout,
+        actions: leafNode.actions,
+        events: leafNode.events,
+        visibility: leafNode.visibility,
+        pollingMs: leafNode.pollingMs,
+        order: leafNode.order
+      });
+    }
+  }
+  return { widgets, rootIds };
+}
+function definePage(config) {
+  const { widgets, rootIds } = collectWidgets(config.children);
+  return {
+    layout: {
+      id: config.id,
+      kind: config.layout ?? "grid",
+      title: config.title,
+      description: config.description,
+      icon: config.icon,
+      widgets: rootIds,
+      actions: config.actions,
+      visibility: config.visibility,
+      order: config.order
+    },
+    widgets
+  };
+}
+function defineMenu(config) {
+  return config;
+}
+function defineStudio(config) {
+  const allWidgets = [];
+  const layouts = [];
+  const menus = [];
+  for (const page of config.pages ?? []) {
+    const result = definePage(page);
+    layouts.push(result.layout);
+    allWidgets.push(...result.widgets);
+  }
+  if (config.widgets?.length) {
+    const { widgets } = collectWidgets(config.widgets);
+    allWidgets.push(...widgets);
+  }
+  for (const menu2 of config.menus ?? []) {
+    menus.push(defineMenu(menu2));
+  }
+  return { widgets: allWidgets, layouts, menus };
+}
+function createWidgetFactory(kind) {
+  return (config) => ({
+    ...config,
+    kind
+  });
+}
+var metric = createWidgetFactory("metric");
+var metricGroup = createWidgetFactory("metric-group");
+var table = createWidgetFactory("table");
+var card = createWidgetFactory("card");
+var cardlist = createWidgetFactory("cardlist");
+var chartLine = createWidgetFactory("chart-line");
+var chartBar = createWidgetFactory("chart-bar");
+var chartPie = createWidgetFactory("chart-pie");
+var chartArea = createWidgetFactory("chart-area");
+var timeline = createWidgetFactory("timeline");
+var tree = createWidgetFactory("tree");
+var json = createWidgetFactory("json");
+var diff = createWidgetFactory("diff");
+var logs = createWidgetFactory("logs");
+var form = createWidgetFactory("form");
+var input = createWidgetFactory("input");
+var select = createWidgetFactory("select");
+var checkboxGroup = createWidgetFactory("checkbox-group");
+var switchWidget = createWidgetFactory("switch");
+var datePicker = createWidgetFactory("date-picker");
+var breadcrumb = createWidgetFactory("breadcrumb");
+var stepper = createWidgetFactory("stepper");
+var menu = createWidgetFactory("menu");
+var alert = createWidgetFactory("alert");
+var confirm = createWidgetFactory("confirm");
+function section(config) {
+  return { ...config, kind: "section" };
+}
+function grid(config) {
+  return { ...config, kind: "grid" };
+}
+function stack(config) {
+  return { ...config, kind: "stack" };
+}
+function tabs(config) {
+  return { ...config, kind: "tabs" };
+}
+function modal(config) {
+  return { ...config, kind: "modal" };
+}
+
+export { alert, breadcrumb, card, cardlist, chartArea, chartBar, chartLine, chartPie, checkboxGroup, confirm, datePicker, defineMenu, definePage, defineStudio, diff, form, grid, input, json, logs, menu, metric, metricGroup, modal, section, select, stack, stepper, switchWidget, table, tabs, timeline, tree };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/studio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/studio/index.ts"],"names":["menu"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module @kb-labs/shared-command-kit/studio\n * SDK helpers for defining Studio widgets, pages, and layouts.\n *\n * @example\n * ```typescript\n * import { defineStudio, definePage, section, metric, table } from '@kb-labs/shared-command-kit/studio';\n *\n * export const studioConfig = defineStudio({\n *   pages: [\n *     definePage({\n *       id: 'release.dashboard',\n *       title: 'Release Dashboard',\n *       children: [\n *         section({\n *           id: 'overview',\n *           title: 'Overview',\n *           children: [\n *             metric({ id: 'total', source: { rest: 'release/metrics' } }),\n *             table({ id: 'plans', source: { rest: 'release/plans' }, columns: [...] }),\n *           ],\n *         }),\n *       ],\n *     }),\n *   ],\n *   menus: [\n *     { id: 'release', label: 'Release', icon: 'rocket', target: 'release.dashboard' },\n *   ],\n * });\n * ```\n */\n\nimport type {\n  StudioWidgetDecl,\n  StudioLayoutDecl,\n  StudioMenuDecl,\n  StudioConfig,\n  StudioWidgetKind,\n  CompositeWidgetKind,\n  DataSource,\n  WidgetAction,\n  WidgetEventConfig,\n  LayoutHint,\n  VisibilityRule,\n  WidgetOptionsMap,\n} from '@kb-labs/studio-contracts';\n\n// =============================================================================\n// Data Source Shorthand\n// =============================================================================\n\n/**\n * Shorthand for data source definition.\n * Allows concise syntax in widget definitions.\n */\nexport type DataSourceShorthand =\n  | { rest: string; method?: 'GET' | 'POST' }\n  | { mock: string }\n  | { static: unknown }\n  | undefined;\n\n/**\n * Convert shorthand to canonical DataSource.\n */\nfunction toDataSource(shorthand: DataSourceShorthand): DataSource {\n  if (!shorthand) {\n    return { type: 'static' };\n  }\n  if ('rest' in shorthand) {\n    return { type: 'rest', routeId: shorthand.rest, method: shorthand.method };\n  }\n  if ('mock' in shorthand) {\n    return { type: 'mock', fixtureId: shorthand.mock };\n  }\n  return { type: 'static', value: shorthand.static };\n}\n\n// =============================================================================\n// Widget Node Types\n// =============================================================================\n\n/**\n * Base widget config (shared by all widgets).\n */\ninterface BaseWidgetConfig {\n  id: string;\n  title?: string;\n  description?: string;\n  source?: DataSourceShorthand;\n  layout?: LayoutHint;\n  actions?: WidgetAction[];\n  events?: WidgetEventConfig;\n  visibility?: VisibilityRule;\n  pollingMs?: number;\n  order?: number;\n}\n\n/**\n * Leaf widget config (no children).\n */\nexport interface LeafWidgetConfig<K extends Exclude<StudioWidgetKind, CompositeWidgetKind>>\n  extends BaseWidgetConfig {\n  kind: K;\n  options?: WidgetOptionsMap[K];\n}\n\n/**\n * Widget node in tree (leaf, composite, or ID reference).\n */\nexport type WidgetNode =\n  | LeafWidgetConfig<Exclude<StudioWidgetKind, CompositeWidgetKind>>\n  | SectionConfig\n  | GridConfig\n  | StackConfig\n  | TabsConfig\n  | ModalConfig\n  | string; // ID reference\n\n// =============================================================================\n// Composite Widget Configs\n// =============================================================================\n\n/**\n * Section widget config.\n */\nexport interface SectionConfig extends BaseWidgetConfig {\n  kind: 'section';\n  options?: WidgetOptionsMap['section'];\n  children: WidgetNode[];\n}\n\n/**\n * Grid widget config.\n */\nexport interface GridConfig extends BaseWidgetConfig {\n  kind: 'grid';\n  options?: WidgetOptionsMap['grid'];\n  children: WidgetNode[];\n}\n\n/**\n * Stack widget config.\n */\nexport interface StackConfig extends BaseWidgetConfig {\n  kind: 'stack';\n  options?: WidgetOptionsMap['stack'];\n  children: WidgetNode[];\n}\n\n/**\n * Tab definition for tabs widget.\n */\nexport interface TabConfig {\n  id: string;\n  label: string;\n  icon?: string;\n  children: WidgetNode[];\n}\n\n/**\n * Tabs widget config.\n */\nexport interface TabsConfig extends BaseWidgetConfig {\n  kind: 'tabs';\n  options?: Omit<WidgetOptionsMap['tabs'], 'tabs' | 'tabChildren'>;\n  tabs: TabConfig[];\n}\n\n/**\n * Modal widget config.\n */\nexport interface ModalConfig extends BaseWidgetConfig {\n  kind: 'modal';\n  options?: WidgetOptionsMap['modal'];\n  children: WidgetNode[];\n}\n\n// =============================================================================\n// Recursive Widget Collection\n// =============================================================================\n\ninterface CollectResult {\n  widgets: StudioWidgetDecl[];\n  rootIds: string[];\n}\n\n/**\n * Recursively collect all widgets from a tree of nodes.\n * Returns flat list of widgets and list of root IDs.\n */\nfunction collectWidgets(nodes: WidgetNode[]): CollectResult {\n  const widgets: StudioWidgetDecl[] = [];\n  const rootIds: string[] = [];\n\n  for (const node of nodes) {\n    // ID reference - just add to rootIds\n    if (typeof node === 'string') {\n      rootIds.push(node);\n      continue;\n    }\n\n    rootIds.push(node.id);\n\n    // Check for composite widgets\n    if (node.kind === 'tabs') {\n      // Tabs - special case with tabChildren mapping\n      const tabsNode = node as TabsConfig;\n      const allChildWidgets: StudioWidgetDecl[] = [];\n      const tabChildIds: Record<string, string[]> = {};\n\n      for (const tab of tabsNode.tabs) {\n        const { widgets: tabWidgets, rootIds: tabRootIds } = collectWidgets(tab.children);\n        allChildWidgets.push(...tabWidgets);\n        tabChildIds[tab.id] = tabRootIds;\n      }\n\n      widgets.push(...allChildWidgets);\n      widgets.push({\n        id: tabsNode.id,\n        kind: 'tabs',\n        title: tabsNode.title,\n        description: tabsNode.description,\n        data: { source: toDataSource(tabsNode.source) },\n        options: {\n          ...tabsNode.options,\n          tabs: tabsNode.tabs.map((t) => ({ id: t.id, label: t.label, icon: t.icon })),\n          tabChildren: tabChildIds,\n        },\n        children: Object.values(tabChildIds).flat(),\n        layoutHint: tabsNode.layout,\n        actions: tabsNode.actions,\n        events: tabsNode.events,\n        visibility: tabsNode.visibility,\n        pollingMs: tabsNode.pollingMs,\n        order: tabsNode.order,\n      } as StudioWidgetDecl);\n    } else if ('children' in node && Array.isArray(node.children)) {\n      // Other composite widgets (section, grid, stack, modal)\n      const compositeNode = node as SectionConfig | GridConfig | StackConfig | ModalConfig;\n      const { widgets: childWidgets, rootIds: childIds } = collectWidgets(compositeNode.children);\n      widgets.push(...childWidgets);\n\n      widgets.push({\n        id: compositeNode.id,\n        kind: compositeNode.kind,\n        title: compositeNode.title,\n        description: compositeNode.description,\n        data: { source: toDataSource(compositeNode.source) },\n        options: compositeNode.options,\n        children: childIds,\n        layoutHint: compositeNode.layout,\n        actions: compositeNode.actions,\n        events: compositeNode.events,\n        visibility: compositeNode.visibility,\n        pollingMs: compositeNode.pollingMs,\n        order: compositeNode.order,\n      } as StudioWidgetDecl);\n    } else {\n      // Leaf widget\n      const leafNode = node as LeafWidgetConfig<Exclude<StudioWidgetKind, CompositeWidgetKind>>;\n      widgets.push({\n        id: leafNode.id,\n        kind: leafNode.kind,\n        title: leafNode.title,\n        description: leafNode.description,\n        data: { source: toDataSource(leafNode.source) },\n        options: leafNode.options,\n        layoutHint: leafNode.layout,\n        actions: leafNode.actions,\n        events: leafNode.events,\n        visibility: leafNode.visibility,\n        pollingMs: leafNode.pollingMs,\n        order: leafNode.order,\n      } as StudioWidgetDecl);\n    }\n  }\n\n  return { widgets, rootIds };\n}\n\n// =============================================================================\n// definePage\n// =============================================================================\n\n/**\n * Page configuration.\n */\nexport interface PageConfig {\n  id: string;\n  title: string;\n  description?: string;\n  icon?: string;\n  layout?: 'grid' | 'stack';\n  children: WidgetNode[];\n  actions?: WidgetAction[];\n  visibility?: VisibilityRule;\n  order?: number;\n}\n\n/**\n * Define a Studio page.\n * Collects all widgets recursively and returns layout + widgets.\n */\nexport function definePage(config: PageConfig): {\n  layout: StudioLayoutDecl;\n  widgets: StudioWidgetDecl[];\n} {\n  const { widgets, rootIds } = collectWidgets(config.children);\n\n  return {\n    layout: {\n      id: config.id,\n      kind: config.layout ?? 'grid',\n      title: config.title,\n      description: config.description,\n      icon: config.icon,\n      widgets: rootIds,\n      actions: config.actions,\n      visibility: config.visibility,\n      order: config.order,\n    },\n    widgets,\n  };\n}\n\n// =============================================================================\n// defineMenu\n// =============================================================================\n\n/**\n * Menu configuration.\n */\nexport interface MenuConfig {\n  id: string;\n  label: string;\n  icon?: string;\n  target: string;\n  order?: number;\n  parentId?: string;\n  visibility?: VisibilityRule;\n  badge?: string;\n  badgeVariant?: 'default' | 'primary' | 'danger';\n}\n\n/**\n * Define a menu item.\n */\nexport function defineMenu(config: MenuConfig): StudioMenuDecl {\n  return config;\n}\n\n// =============================================================================\n// defineStudio\n// =============================================================================\n\n/**\n * Studio manifest configuration.\n */\nexport interface StudioManifestConfig {\n  pages?: PageConfig[];\n  widgets?: WidgetNode[];\n  menus?: MenuConfig[];\n}\n\n/**\n * Define a complete Studio configuration.\n * Main entry point for plugin authors.\n */\nexport function defineStudio(config: StudioManifestConfig): StudioConfig {\n  const allWidgets: StudioWidgetDecl[] = [];\n  const layouts: StudioLayoutDecl[] = [];\n  const menus: StudioMenuDecl[] = [];\n\n  // Process pages -> layouts + widgets\n  for (const page of config.pages ?? []) {\n    const result = definePage(page);\n    layouts.push(result.layout);\n    allWidgets.push(...result.widgets);\n  }\n\n  // Add standalone widgets (also supports nesting)\n  if (config.widgets?.length) {\n    const { widgets } = collectWidgets(config.widgets);\n    allWidgets.push(...widgets);\n  }\n\n  // Add menus\n  for (const menu of config.menus ?? []) {\n    menus.push(defineMenu(menu));\n  }\n\n  return { widgets: allWidgets, layouts, menus };\n}\n\n// =============================================================================\n// Widget Factory Helpers\n// =============================================================================\n\ntype LeafKind = Exclude<StudioWidgetKind, CompositeWidgetKind>;\n\n/**\n * Create a widget config factory for a specific kind.\n */\nfunction createWidgetFactory<K extends LeafKind>(kind: K) {\n  return (\n    config: Omit<LeafWidgetConfig<K>, 'kind'> & { options?: WidgetOptionsMap[K] }\n  ): LeafWidgetConfig<K> => ({\n    ...config,\n    kind,\n  });\n}\n\n// Display widgets (14)\nexport const metric = createWidgetFactory('metric');\nexport const metricGroup = createWidgetFactory('metric-group');\nexport const table = createWidgetFactory('table');\nexport const card = createWidgetFactory('card');\nexport const cardlist = createWidgetFactory('cardlist');\nexport const chartLine = createWidgetFactory('chart-line');\nexport const chartBar = createWidgetFactory('chart-bar');\nexport const chartPie = createWidgetFactory('chart-pie');\nexport const chartArea = createWidgetFactory('chart-area');\nexport const timeline = createWidgetFactory('timeline');\nexport const tree = createWidgetFactory('tree');\nexport const json = createWidgetFactory('json');\nexport const diff = createWidgetFactory('diff');\nexport const logs = createWidgetFactory('logs');\n\n// Form widgets (6)\nexport const form = createWidgetFactory('form');\nexport const input = createWidgetFactory('input');\nexport const select = createWidgetFactory('select');\nexport const checkboxGroup = createWidgetFactory('checkbox-group');\nexport const switchWidget = createWidgetFactory('switch');\nexport const datePicker = createWidgetFactory('date-picker');\n\n// Navigation widgets (3)\nexport const breadcrumb = createWidgetFactory('breadcrumb');\nexport const stepper = createWidgetFactory('stepper');\nexport const menu = createWidgetFactory('menu');\n\n// Feedback widgets (2)\nexport const alert = createWidgetFactory('alert');\nexport const confirm = createWidgetFactory('confirm');\n\n// =============================================================================\n// Composite Widget Factories\n// =============================================================================\n\n/**\n * Create a section widget.\n */\nexport function section(\n  config: Omit<SectionConfig, 'kind'> & { options?: WidgetOptionsMap['section'] }\n): SectionConfig {\n  return { ...config, kind: 'section' };\n}\n\n/**\n * Create a grid widget.\n */\nexport function grid(\n  config: Omit<GridConfig, 'kind'> & { options?: WidgetOptionsMap['grid'] }\n): GridConfig {\n  return { ...config, kind: 'grid' };\n}\n\n/**\n * Create a stack widget.\n */\nexport function stack(\n  config: Omit<StackConfig, 'kind'> & { options?: WidgetOptionsMap['stack'] }\n): StackConfig {\n  return { ...config, kind: 'stack' };\n}\n\n/**\n * Create a tabs widget.\n */\nexport function tabs(\n  config: Omit<TabsConfig, 'kind'> & { options?: Omit<WidgetOptionsMap['tabs'], 'tabs' | 'tabChildren'> }\n): TabsConfig {\n  return { ...config, kind: 'tabs' };\n}\n\n/**\n * Create a modal widget.\n */\nexport function modal(\n  config: Omit<ModalConfig, 'kind'> & { options?: WidgetOptionsMap['modal'] }\n): ModalConfig {\n  return { ...config, kind: 'modal' };\n}\n\n// =============================================================================\n// Re-exports from studio-contracts\n// =============================================================================\n\nexport type {\n  StudioWidgetDecl,\n  StudioLayoutDecl,\n  StudioMenuDecl,\n  StudioConfig,\n  StudioWidgetKind,\n  CompositeWidgetKind,\n  DataSource,\n  WidgetAction,\n  WidgetEventConfig,\n  LayoutHint,\n  VisibilityRule,\n  WidgetOptionsMap,\n} from '@kb-labs/studio-contracts';\n"]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@kb-labs/shared-command-kit",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Command Kit for KB Labs CLI - utilities and high-level API for building commands",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./flags": {
+      "import": "./dist/flags/index.js",
+      "types": "./dist/flags/index.d.ts"
+    },
+    "./analytics": {
+      "import": "./dist/analytics/index.js",
+      "types": "./dist/analytics/index.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/errors/index.js",
+      "types": "./dist/errors/index.d.ts"
+    },
+    "./helpers": {
+      "import": "./dist/helpers/index.js",
+      "types": "./dist/helpers/index.d.ts"
+    },
+    "./studio": {
+      "import": "./dist/studio/index.js",
+      "types": "./dist/studio/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@kb-labs/core-platform": "link:../../../kb-labs-core/packages/core-platform",
+    "@kb-labs/core-resource-broker": "link:../../../kb-labs-core/packages/core-resource-broker",
+    "@kb-labs/core-runtime": "link:../../../kb-labs-core/packages/core-runtime",
+    "@kb-labs/plugin-contracts": "link:../../../kb-labs-plugin/packages/plugin-contracts",
+    "@kb-labs/plugin-runtime": "link:../../../kb-labs-plugin/packages/plugin-runtime",
+    "@kb-labs/studio-contracts": "link:../../../kb-labs-studio/packages/studio-contracts",
+    "zod": "^3.23.8",
+    "glob": "^11.0.0",
+    "@kb-labs/shared-cli-ui": "1.0.0"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "@types/node": "^24.3.3",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}