@open-pencil/vue

Headless Vue 3 SDK for building OpenPencil-powered editors.

@open-pencil/vue sits on top of @open-pencil/core and provides:

• Vue editor injection via provideEditor() / useEditor()
• canvas integration via useCanvas(), useCanvasInput(), and useTextEdit()
• selection, command, panel, variables, and i18n composables
• headless structural primitives like CanvasRoot, LayerTreeRoot, PageListRoot, and ToolbarRoot

The SDK is headless by design: it provides logic and structure, while your app owns styling and product-specific UI.

Install

bun add @open-pencil/vue @open-pencil/core canvaskit-wasm

Quick start

<script setup lang="ts">
import { createEditor } from '@open-pencil/core/editor'
import { provideEditor } from '@open-pencil/vue'

const editor = createEditor({
  width: 1200,
  height: 800,
})

editor.createShape('RECTANGLE', 100, 100, 200, 150)
editor.zoomToFit()

provideEditor(editor)
</script>

<template>
  <div class="h-screen">
    <CanvasRoot v-slot="{ canvasRef }">
      <canvas ref="canvasRef" class="size-full" />
    </CanvasRoot>
  </div>
</template>

Core concepts

Editor context

Use provideEditor(editor) once near the top of your subtree.

import { provideEditor } from '@open-pencil/vue'

provideEditor(editor)

Read it anywhere below with useEditor().

import { useEditor } from '@open-pencil/vue'

const editor = useEditor()

Canvas wiring

At the composable level, the main canvas APIs are:

• useCanvas()
• useCanvasInput()
• useTextEdit()

If you want SDK-provided structure, use headless primitives like CanvasRoot and CanvasSurface.

Headless primitives

Main structural primitives include:

• CanvasRoot
• LayerTreeRoot
• PageListRoot
• PropertyListRoot
• ToolbarRoot
• ColorPickerRoot
• FillPickerRoot
• FontPickerRoot

These components coordinate structure and state, but do not impose app styling.

Public API tiers

Core API

These are the main APIs most SDK consumers should start with.

Context and canvas

• provideEditor()
• useEditor()
• useCanvas()
• useCanvasInput()
• useTextEdit()

Selection and commands

• useSelectionState()
• useSelectionCapabilities()
• useEditorCommands()
• useMenuModel()

Property panels

• usePosition()
• useLayout()
• useAppearance()
• useTypography()
• useExport()
• useFillControls()
• useStrokeControls()
• useEffectsControls()

Variables, navigation, and localization

• useVariablesEditor()
• usePageList()
• useI18n()

Headless primitives

• CanvasRoot
• LayerTreeRoot
• PageListRoot
• PropertyListRoot
• ToolbarRoot

Advanced API

These exports are intentionally public, but they are lower-level or more specialized.

• useNodeProps()
• useSceneComputed()
• useColorVariableBinding()
• useFillPicker()
• useGradientStops()
• useFontPicker()
• useOkHCL()
• useVariables()
• useVariablesDialogState()
• useVariablesTable()
• usePropScrub()
• useLayerDrag()
• useInlineRename()
• useToolbarState()
• useNodeFontStatus()
• useCanvasDrop()
• extractImageFilesFromClipboard()
• useViewportKind()
• toolCursor()

Primitive context helpers and low-level stores

These are mostly useful when extending SDK primitives rather than building from top-level composables.

• useCanvasContext()
• useLayerTree()
• useToolbar()
• usePropertyList()
• useScrubInput()
• locale
• localeSetting
• setLocale()
• AVAILABLE_LOCALES
• LOCALE_LABELS

Example patterns

Minimal provider component

<script setup lang="ts">
import { provideEditor } from '@open-pencil/vue'

import type { Editor } from '@open-pencil/core/editor'

const props = defineProps<{
  editor: Editor
}>()

provideEditor(props.editor)
</script>

<template>
  <slot />
</template>

Read selection state

import { useSelectionState } from '@open-pencil/vue'

const { hasSelection, selectedCount, selectedNode } = useSelectionState()

Build a menu

import { useMenuModel } from '@open-pencil/vue'

const { appMenu, canvasMenu } = useMenuModel()

Build a page list

<PageListRoot v-slot="{ pages, currentPageId, switchPage }">
  <ul>
    <li v-for="page in pages" :key="page.id">
      <button :data-active="page.id === currentPageId" @click="switchPage(page.id)">
        {{ page.name }}
      </button>
    </li>
  </ul>
</PageListRoot>

Documentation

For fuller guides and API docs, see the documentation site:

• packages/docs/programmable/sdk/

Example app

Run the included example:

cd packages/vue/example
bun install
bun run dev