@hraness/slopcamera 3.2.4

package/src/icons.ts

@@ -0,0 +1,58 @@
+import type { IconDefinition } from "./types.js"
+
+const shared = 'fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"'
+
+export const builtInIcons: Readonly<Record<string, IconDefinition>> = Object.freeze({
+  brain: {
+    viewBox: "0 0 24 24",
+    body: `<path ${shared} d="M9.5 4.5A3.5 3.5 0 0 0 6 8v.35A3.5 3.5 0 0 0 5.5 15 3.5 3.5 0 0 0 9 19.5M14.5 4.5A3.5 3.5 0 0 1 18 8v.35a3.5 3.5 0 0 1 .5 6.65 3.5 3.5 0 0 1-3.5 4.5M9.5 4.5v15M14.5 4.5v15M6 9.5h3.5M14.5 14.5H18"/>`,
+  },
+  check: {
+    viewBox: "0 0 24 24",
+    body: `<path ${shared} d="m5 12 4.25 4.25L19 6.5"/>`,
+  },
+  code: {
+    viewBox: "0 0 24 24",
+    body: `<path ${shared} d="m8.5 7-5 5 5 5M15.5 7l5 5-5 5M13.5 4l-3 16"/>`,
+  },
+  database: {
+    viewBox: "0 0 24 24",
+    body: `<ellipse ${shared} cx="12" cy="5" rx="7.5" ry="3"/><path ${shared} d="M4.5 5v7c0 1.66 3.36 3 7.5 3s7.5-1.34 7.5-3V5M4.5 12v7c0 1.66 3.36 3 7.5 3s7.5-1.34 7.5-3v-7"/>`,
+  },
+  document: {
+    viewBox: "0 0 24 24",
+    body: `<path ${shared} d="M6 2.75h8l4 4V21.25H6zM14 2.75v4h4M9 11h6M9 15h6"/>`,
+  },
+  globe: {
+    viewBox: "0 0 24 24",
+    body: `<circle ${shared} cx="12" cy="12" r="9"/><path ${shared} d="M3 12h18M12 3c2.4 2.45 3.5 5.45 3.5 9S14.4 18.55 12 21M12 3C9.6 5.45 8.5 8.45 8.5 12s1.1 6.55 3.5 9"/>`,
+  },
+  search: {
+    viewBox: "0 0 24 24",
+    body: `<circle ${shared} cx="10.5" cy="10.5" r="6.5"/><path ${shared} d="m15.25 15.25 5 5"/>`,
+  },
+  server: {
+    viewBox: "0 0 24 24",
+    body: `<rect ${shared} x="3" y="3.5" width="18" height="7" rx="2"/><rect ${shared} x="3" y="13.5" width="18" height="7" rx="2"/><path ${shared} d="M7 7h.01M7 17h.01M11 7h6M11 17h6"/>`,
+  },
+  shield: {
+    viewBox: "0 0 24 24",
+    body: `<path ${shared} d="M12 2.75 20 6v5.5c0 5.25-3.35 8.2-8 10-4.65-1.8-8-4.75-8-10V6z"/>`,
+  },
+  user: {
+    viewBox: "0 0 24 24",
+    body: `<circle ${shared} cx="12" cy="8" r="4"/><path ${shared} d="M4.5 21c.5-4.2 3-6.5 7.5-6.5s7 2.3 7.5 6.5"/>`,
+  },
+})
+
+export function sanitizeIcon(icon: IconDefinition): IconDefinition {
+  const dangerous =
+    /<\s*(script|style|foreignObject|iframe|object|embed|image|use|a)\b|on[a-z]+\s*=|(?:xlink:)?href\s*=|style\s*=|javascript:|url\s*\(/i
+  if (dangerous.test(icon.body)) {
+    throw new Error("Icon body contains executable or externally embedded SVG content")
+  }
+  if (!/^[-+.\d\s]+$/.test(icon.viewBox.trim())) {
+    throw new Error(`Invalid icon viewBox: ${icon.viewBox}`)
+  }
+  return icon
+}

package/src/index.ts

@@ -0,0 +1,200 @@
+import {
+  artifactSummary,
+  checkDiagramFile,
+  readDiagramFile,
+  renderDiagramFile,
+} from "./artifacts.js"
+import {
+  desktopDownloadPage,
+  desktopStatus,
+  findDesktopApplication,
+  getLatestDesktopRelease,
+  installDesktop,
+  openInDesktop,
+  selectDesktopAsset,
+} from "./desktop.js"
+import {
+  generateSlopcameraImage,
+  generateSlopcameraImageFile,
+  slopcameraGatewayCredentialStatus,
+} from "./generate.js"
+import { builtInIcons } from "./icons.js"
+import {
+  resolveDiagramSource,
+  resolveStackLayout,
+  stackLayoutDefaults,
+  StackLayoutError,
+} from "./layout.js"
+import { lintDiagram } from "./lint.js"
+import {
+  executeSlopcameraOperation,
+  slopcameraOperationRegistry,
+  searchSlopcameraOperations,
+} from "./operations.js"
+import {
+  slopcameraMcpProtocolVersion,
+  slopcameraMcpServerName,
+  slopcameraMcpTools,
+  SlopcameraMcpToolRuntime,
+  mcpMaximumRenderedPixels,
+  mcpMaximumScale,
+  mcpSourceByteLimit,
+  runMcpServer,
+  WorkspaceBoundary,
+  WorkspaceBoundaryError,
+} from "./mcp/index.js"
+import {
+  DiagramValidationError,
+  parseDiagramSource,
+  parseDiagramSpec,
+} from "./parse.js"
+import { renderPng, renderSvg, resolveEdge } from "./render.js"
+import { bundledSkillPath, installSkill } from "./skill-install.js"
+import { serializeTldr } from "./tldr.js"
+import { vectorizeImage } from "./vectorize/vectorize.js"
+import {
+  defineSlopcameraWorkflow,
+  runSlopcameraWorkflow,
+  SlopcameraWorkflowError,
+} from "./workflow.js"
+export { SLOPCAMERA_VERSION } from "./version.js"
+
+export const slopcameraApi = Object.freeze({
+  artifactSummary,
+  builtInIcons,
+  bundledSkillPath,
+  checkDiagramFile,
+  desktopDownloadPage,
+  desktopStatus,
+  defineSlopcameraWorkflow,
+  DiagramValidationError,
+  findDesktopApplication,
+  generateSlopcameraImage,
+  generateSlopcameraImageFile,
+  getLatestDesktopRelease,
+  slopcameraGatewayCredentialStatus,
+  slopcameraMcpProtocolVersion,
+  slopcameraMcpServerName,
+  slopcameraMcpTools,
+  slopcameraOperationRegistry,
+  SlopcameraMcpToolRuntime,
+  installDesktop,
+  installSkill,
+  lintDiagram,
+  mcpMaximumRenderedPixels,
+  mcpMaximumScale,
+  mcpSourceByteLimit,
+  openInDesktop,
+  parseDiagramSource,
+  parseDiagramSpec,
+  readDiagramFile,
+  renderDiagramFile,
+  renderPng,
+  renderSvg,
+  resolveEdge,
+  resolveDiagramSource,
+  resolveStackLayout,
+  runSlopcameraWorkflow,
+  runMcpServer,
+  searchSlopcameraOperations,
+  selectDesktopAsset,
+  serializeTldr,
+  stackLayoutDefaults,
+  StackLayoutError,
+  SlopcameraWorkflowError,
+  vectorizeImage,
+  WorkspaceBoundary,
+  WorkspaceBoundaryError,
+  executeSlopcameraOperation,
+})
+
+/** @deprecated Use slopcameraApi. Retained through the Slopcamera 2.x line. */
+export const diagramApi = slopcameraApi
+
+export {
+  artifactSummary,
+  builtInIcons,
+  bundledSkillPath,
+  checkDiagramFile,
+  desktopDownloadPage,
+  desktopStatus,
+  DiagramValidationError,
+  findDesktopApplication,
+  generateSlopcameraImage,
+  generateSlopcameraImageFile,
+  getLatestDesktopRelease,
+  slopcameraGatewayCredentialStatus,
+  slopcameraMcpProtocolVersion,
+  slopcameraMcpServerName,
+  slopcameraMcpTools,
+  slopcameraOperationRegistry,
+  SlopcameraMcpToolRuntime,
+  installDesktop,
+  installSkill,
+  lintDiagram,
+  mcpMaximumRenderedPixels,
+  mcpMaximumScale,
+  mcpSourceByteLimit,
+  openInDesktop,
+  parseDiagramSource,
+  parseDiagramSpec,
+  readDiagramFile,
+  renderDiagramFile,
+  renderPng,
+  renderSvg,
+  resolveDiagramSource,
+  resolveEdge,
+  resolveStackLayout,
+  runMcpServer,
+  searchSlopcameraOperations,
+  selectDesktopAsset,
+  serializeTldr,
+  stackLayoutDefaults,
+  StackLayoutError,
+  vectorizeImage,
+  defineSlopcameraWorkflow,
+  runSlopcameraWorkflow,
+  SlopcameraWorkflowError,
+  WorkspaceBoundary,
+  WorkspaceBoundaryError,
+  executeSlopcameraOperation,
+}
+export * from "./cloud-errors.js"
+export * from "./generate.js"
+export * from "./host-resources.js"
+export * from "./operations.js"
+export * from "./studio/index.js"
+export * from "./workflow.js"
+export type * from "./types.js"
+export type {
+  JsonRpcFailure,
+  JsonRpcId,
+  JsonRpcResponseId,
+  JsonRpcResponse,
+  JsonRpcSuccess,
+  McpServerOptions,
+  McpTextContent,
+  McpToolDefinition,
+  McpToolResult,
+} from "./mcp/index.js"
+export {
+  VectorizeError,
+  vectorizeDefaultLimits,
+  vectorizeHardLimits,
+  vectorizeProfileNames,
+  VTRACER_VERSION,
+  vtracerReleases,
+} from "./vectorize/index.js"
+export type {
+  VectorizeErrorCode,
+  VectorizeInput,
+  VectorizeLimits,
+  VectorizeOptions,
+  VectorizeOutputMode,
+  VectorizeProfile,
+  VectorizeProvenance,
+  VectorizeQualityReceipt,
+  VectorizeReceipt,
+  VectorizeRepresentation,
+  VectorizeResult,
+} from "./vectorize/index.js"

package/src/label-layout.ts

@@ -0,0 +1,130 @@
+import type { BoxLabelRow, BoxShape, DiagramFontFamily, TextWeight } from "./types.js"
+
+const defaultLabelFontSize = 22
+const defaultLabelWeight = 600
+const defaultLineHeightRatio = 1.35
+const defaultRowGap = 8
+const iconLabelGap = 12
+
+function characterWidthRatio(fontFamily: DiagramFontFamily): number {
+  return fontFamily === "mono" ? 0.62 : 0.56
+}
+
+export function estimateDiagramTextWidth(
+  text: string,
+  fontSize: number,
+  fontFamily: DiagramFontFamily = "default",
+): number {
+  return text.length * fontSize * characterWidthRatio(fontFamily)
+}
+
+export interface ResolvedLabelRow {
+  readonly text: string
+  readonly lines: readonly string[]
+  readonly fontSize: number
+  readonly fontFamily: DiagramFontFamily
+  readonly weight: TextWeight
+  readonly lineHeight: number
+  readonly height: number
+  readonly y: number
+}
+
+export interface BoxContentLayout {
+  readonly icon?: {
+    readonly x: number
+    readonly y: number
+    readonly size: number
+  }
+  readonly rows: readonly ResolvedLabelRow[]
+}
+
+export function wrapDiagramText(
+  text: string,
+  maxWidth: number,
+  fontSize: number,
+  fontFamily: DiagramFontFamily = "default",
+): readonly string[] {
+  const explicitLines = text.split("\n")
+  const maxCharacters = Math.max(
+    1,
+    Math.floor(maxWidth / (fontSize * characterWidthRatio(fontFamily))),
+  )
+  const lines: string[] = []
+  for (const explicitLine of explicitLines) {
+    if (explicitLine.length <= maxCharacters) {
+      lines.push(explicitLine)
+      continue
+    }
+    const words = explicitLine.split(/\s+/)
+    let current = ""
+    for (const word of words) {
+      const candidate = current === "" ? word : `${current} ${word}`
+      if (candidate.length <= maxCharacters || current === "") {
+        current = candidate
+      } else {
+        lines.push(current)
+        current = word
+      }
+    }
+    if (current !== "") lines.push(current)
+  }
+  return lines.length === 0 ? [""] : lines
+}
+
+function resolveRows(shape: BoxShape): readonly Omit<ResolvedLabelRow, "lines" | "height" | "y">[] {
+  if (shape.labelRows !== undefined) {
+    return shape.labelRows.map((row: BoxLabelRow) => ({
+      text: row.text,
+      fontSize: row.fontSize ?? defaultLabelFontSize,
+      fontFamily: row.fontFamily ?? "default",
+      weight: row.weight ?? defaultLabelWeight,
+      lineHeight: (row.fontSize ?? defaultLabelFontSize) * defaultLineHeightRatio,
+    }))
+  }
+  if (shape.label === undefined) return []
+  const fontSize = shape.labelFontSize ?? defaultLabelFontSize
+  return [
+    {
+      text: shape.label,
+      fontSize,
+      fontFamily: shape.labelFontFamily ?? "default",
+      weight: shape.labelWeight ?? defaultLabelWeight,
+      lineHeight: fontSize * defaultLineHeightRatio,
+    },
+  ]
+}
+
+export function layoutBoxContent(shape: BoxShape, resolvedIconSize?: number): BoxContentLayout {
+  const textWidth = Math.max(1, shape.width - 32)
+  const pendingRows = resolveRows(shape).map((row) => {
+    const lines = wrapDiagramText(row.text, textWidth, row.fontSize, row.fontFamily)
+    const height = lines.length * row.lineHeight
+    return { ...row, lines, height }
+  })
+  const rowGap = shape.labelRows === undefined ? 0 : (shape.labelRowGap ?? defaultRowGap)
+  const rowsHeight =
+    pendingRows.reduce((total, row) => total + row.height, 0) +
+    Math.max(0, pendingRows.length - 1) * rowGap
+  const hasIcon = resolvedIconSize !== undefined
+  const gap = hasIcon && pendingRows.length > 0 ? iconLabelGap : 0
+  const contentHeight = (resolvedIconSize ?? 0) + gap + rowsHeight
+  let cursorY = shape.y + (shape.height - contentHeight) / 2
+  const icon =
+    resolvedIconSize === undefined
+      ? undefined
+      : {
+          x: shape.x + (shape.width - resolvedIconSize) / 2,
+          y: cursorY,
+          size: resolvedIconSize,
+        }
+  if (hasIcon) cursorY += resolvedIconSize + gap
+  const rows = pendingRows.map((row) => {
+    const resolved = { ...row, y: cursorY }
+    cursorY += row.height + rowGap
+    return resolved
+  })
+  return {
+    ...(icon === undefined ? {} : { icon }),
+    rows,
+  }
+}