@zseven-w/pen-sdk 0.0.1

package/README.md

@@ -0,0 +1,56 @@
+# @zseven-w/pen-sdk
+
+The umbrella SDK for [OpenPencil](https://github.com/nicepkg/openpencil). One import gives you everything — types, document operations, code generation, Figma import, and rendering.
+
+## Install
+
+```bash
+npm install @zseven-w/pen-sdk
+```
+
+## What's Included
+
+This package re-exports all OpenPencil packages:
+
+| Package | Provides |
+|---|---|
+| `@zseven-w/pen-types` | TypeScript types for the document model |
+| `@zseven-w/pen-core` | Tree operations, layout engine, variables, boolean ops |
+| `@zseven-w/pen-codegen` | Code generators (React, HTML, Vue, Svelte, Flutter, SwiftUI, Compose, RN) |
+| `@zseven-w/pen-figma` | Figma `.fig` parser and converter |
+| `@zseven-w/pen-renderer` | CanvasKit/Skia GPU renderer |
+
+## Usage
+
+```ts
+import {
+  // Types
+  type PenDocument,
+  type PenNode,
+
+  // Document operations
+  createEmptyDocument,
+  findNodeInTree,
+  insertNodeInTree,
+  normalizePenDocument,
+
+  // Code generation
+  generateReactFromDocument,
+  generateHTMLFromDocument,
+  generateFlutterFromDocument,
+
+  // Figma import
+  parseFigFile,
+  figmaAllPagesToPenDocument,
+
+  // Rendering
+  loadCanvasKit,
+  PenRenderer,
+} from '@zseven-w/pen-sdk'
+```
+
+Or install individual packages for smaller bundles — see each package's README for details.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@zseven-w/pen-sdk",
+  "version": "0.0.1",
+  "description": "OpenPencil SDK — parse, manipulate, and generate code from .op design files",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@zseven-w/pen-types": "0.0.1",
+    "@zseven-w/pen-core": "0.0.1",
+    "@zseven-w/pen-codegen": "0.0.1",
+    "@zseven-w/pen-figma": "0.0.1",
+    "@zseven-w/pen-renderer": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,195 @@
+/**
+ * @zseven-w/pen-sdk — OpenPencil SDK
+ *
+ * High-level API for working with OpenPencil (.op) design files.
+ * Combines types, document operations, code generation, and Figma import.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   type PenDocument,
+ *   createEmptyDocument,
+ *   normalizePenDocument,
+ *   generateReactFromDocument,
+ *   parseFigFile,
+ * } from '@zseven-w/pen-sdk'
+ * ```
+ */
+
+// ── Types ──────────────────────────────────────────────────────────────
+export type {
+  // Document model
+  PenDocument,
+  PenNode,
+  PenNodeType,
+  PenPage,
+  PenNodeBase,
+  ContainerProps,
+  SizingBehavior,
+  FrameNode,
+  GroupNode,
+  RectangleNode,
+  EllipseNode,
+  LineNode,
+  PolygonNode,
+  PathNode,
+  TextNode,
+  ImageNode,
+  ImageFitMode,
+  IconFontNode,
+  RefNode,
+  // Styles
+  PenFill,
+  PenStroke,
+  PenEffect,
+  SolidFill,
+  LinearGradientFill,
+  RadialGradientFill,
+  ImageFill,
+  GradientStop,
+  BlendMode,
+  BlurEffect,
+  ShadowEffect,
+  StyledTextSegment,
+  // Variables
+  VariableDefinition,
+  VariableValue,
+  ThemedValue,
+  // Canvas
+  ToolType,
+  ViewportState,
+  // UIKit
+  UIKit,
+  KitComponent,
+  ComponentCategory,
+  // Theme presets
+  ThemePreset,
+  ThemePresetFile,
+} from '@zseven-w/pen-types'
+
+// ── Core: Document operations ──────────────────────────────────────────
+export {
+  // ID generation
+  generateId,
+  // Document creation & tree operations
+  createEmptyDocument,
+  DEFAULT_FRAME_ID,
+  DEFAULT_PAGE_ID,
+  findNodeInTree,
+  findParentInTree,
+  removeNodeFromTree,
+  updateNodeInTree,
+  flattenNodes,
+  insertNodeInTree,
+  isDescendantOf,
+  getNodeBounds,
+  // Page operations
+  getActivePage,
+  getActivePageChildren,
+  setActivePageChildren,
+  getAllChildren,
+  migrateToPages,
+  ensureDocumentNodeIds,
+  // Variables
+  isVariableRef,
+  getDefaultTheme,
+  resolveVariableRef,
+  resolveColorRef,
+  resolveNumericRef,
+  resolveNodeForCanvas,
+  replaceVariableRefsInTree,
+  // Normalization
+  normalizePenDocument,
+  // Layout
+  type Padding,
+  resolvePadding,
+  computeLayoutPositions,
+  getNodeWidth,
+  getNodeHeight,
+  inferLayout,
+  // Text measurement
+  parseSizing,
+  defaultLineHeight,
+  estimateTextWidth,
+  estimateTextHeight,
+  resolveTextContent,
+  hasCjkText,
+  // Arc path
+  buildEllipseArcPath,
+  isArcEllipse,
+  // Boolean operations
+  type BooleanOpType,
+  canBooleanOp,
+  executeBooleanOp,
+} from '@zseven-w/pen-core'
+
+// ── Codegen: Multi-platform code generation ────────────────────────────
+export {
+  // CSS Variables
+  variableNameToCSS,
+  generateCSSVariables,
+  // React + Tailwind
+  generateReactCode,
+  generateReactFromDocument,
+  // HTML + CSS
+  generateHTMLCode,
+  generateHTMLFromDocument,
+  // Vue 3
+  generateVueCode,
+  generateVueFromDocument,
+  // Svelte
+  generateSvelteCode,
+  generateSvelteFromDocument,
+  // Flutter
+  generateFlutterCode,
+  generateFlutterFromDocument,
+  // SwiftUI
+  generateSwiftUICode,
+  generateSwiftUIFromDocument,
+  // Android Compose
+  generateComposeCode,
+  generateComposeFromDocument,
+  // React Native
+  generateReactNativeCode,
+  generateReactNativeFromDocument,
+} from '@zseven-w/pen-codegen'
+
+// ── Figma: .fig file import ────────────────────────────────────────────
+export {
+  parseFigFile,
+  figmaToPenDocument,
+  figmaAllPagesToPenDocument,
+  getFigmaPages,
+  figmaNodeChangesToPenNodes,
+  isFigmaClipboardHtml,
+  extractFigmaClipboardData,
+  figmaClipboardToNodes,
+  resolveImageBlobs,
+  setIconLookup,
+  type FigmaDecodedFile,
+  type FigmaImportLayoutMode,
+} from '@zseven-w/pen-figma'
+
+// ── Renderer: CanvasKit/Skia rendering engine ────────────────────────
+export {
+  // Primary API
+  loadCanvasKit,
+  PenRenderer,
+  // Low-level
+  SkiaNodeRenderer,
+  SkiaFontManager,
+  SkiaImageLoader,
+  SpatialIndex,
+  flattenToRenderNodes,
+  resolveRefs,
+  premeasureTextHeights,
+  // Viewport
+  viewportMatrix,
+  screenToScene,
+  sceneToScreen,
+  zoomToPoint,
+  // Types
+  type RenderNode,
+  type PenRendererOptions,
+  type IconLookupFn,
+} from '@zseven-w/pen-renderer'