@scrawl-board/board 0.1.0-beta.0

package/dist/styles.css

@@ -0,0 +1,297 @@
+[data-scrawl-root],
+[data-scrawl-portal] {
+  --scrawl-color-surface: #ffffff;
+  --scrawl-color-surface-raised: #f7f7f4;
+  --scrawl-color-surface-muted: #ecece7;
+  --scrawl-color-text: #1c1c1a;
+  --scrawl-color-text-muted: #62625c;
+  --scrawl-color-edge: #d4d4cc;
+  --scrawl-color-focus: #1856a3;
+  --scrawl-color-selection: #d9e8f7;
+  --scrawl-color-danger: #a3302b;
+  --scrawl-color-warning: #805400;
+  --scrawl-color-success: #28633b;
+  --scrawl-font-ui: system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
+  --scrawl-font-data: ui-monospace, SFMono-Regular, monospace;
+  --scrawl-font-size: 14px;
+  --scrawl-font-weight: 400;
+  --scrawl-font-weight-strong: 650;
+  --scrawl-radius-control: 6px;
+  --scrawl-radius-panel: 10px;
+  --scrawl-elevation-low: 0 2px 3px rgba(28, 28, 26, 0.12);
+  --scrawl-elevation-high: 0 8px 20px rgba(28, 28, 26, 0.18);
+  --scrawl-motion-duration: 140ms;
+  --scrawl-motion-easing: cubic-bezier(0.2, 0, 0, 1);
+  --scrawl-density: comfortable;
+  box-sizing: border-box;
+  color: var(--scrawl-color-text);
+  font-family: var(--scrawl-font-ui);
+  font-size: var(--scrawl-font-size);
+  font-weight: var(--scrawl-font-weight);
+  line-height: 1.4;
+}
+
+[data-scrawl-root] {
+  background: var(--scrawl-color-surface);
+  block-size: 100%;
+  inline-size: 100%;
+  isolation: isolate;
+  min-block-size: 12rem;
+  min-inline-size: 16rem;
+  overflow: visible;
+  position: relative;
+}
+
+[data-scrawl-root] *, [data-scrawl-root] *::before, [data-scrawl-root] *::after,
+[data-scrawl-portal] *, [data-scrawl-portal] *::before, [data-scrawl-portal] *::after { box-sizing: border-box; }
+
+[data-scrawl-root] button, [data-scrawl-root] input, [data-scrawl-root] select, [data-scrawl-root] textarea,
+[data-scrawl-portal] button, [data-scrawl-portal] input, [data-scrawl-portal] select, [data-scrawl-portal] textarea {
+  color: inherit;
+  font: inherit;
+  line-height: 1.4;
+}
+
+[data-scrawl-root] button, [data-scrawl-root] [role="button"],
+[data-scrawl-portal] button, [data-scrawl-portal] [role="button"] { min-block-size: 44px; min-inline-size: 44px; }
+
+[data-scrawl-root] :focus-visible, [data-scrawl-portal] :focus-visible {
+  outline: 3px solid var(--scrawl-color-focus);
+  outline-offset: 2px;
+}
+
+[data-scrawl-root] [data-scrawl-canvas], [data-scrawl-root] .scrawl-board__content {
+  block-size: 100%;
+  inline-size: 100%;
+  min-block-size: inherit;
+  min-inline-size: inherit;
+  position: relative;
+}
+
+[data-scrawl-root] [data-scrawl-canvas] { overflow: clip; }
+
+[data-scrawl-root] .scrawl-board__canvas {
+  block-size: 100%;
+  display: block;
+  inline-size: 100%;
+  touch-action: none;
+}
+
+[data-scrawl-root] .scrawl-board__portal-layer, [data-scrawl-portal] {
+  color: var(--scrawl-color-text);
+  font-family: var(--scrawl-font-ui);
+  line-height: 1.4;
+  overflow: visible;
+  position: relative;
+  z-index: 20;
+}
+
+[data-scrawl-root] .scrawl-board__portal-layer {
+  inset: 0;
+  pointer-events: none;
+  position: absolute;
+}
+
+[data-scrawl-root] [data-scrawl-default-ui] {
+  inset: 0;
+  pointer-events: none;
+  position: absolute;
+  z-index: 10;
+}
+
+[data-scrawl-root] .scrawl-board__actions,
+[data-scrawl-root] .scrawl-board__tools,
+[data-scrawl-root] .scrawl-board__view,
+[data-scrawl-root] .scrawl-board__style-shelf {
+  align-items: center;
+  background: var(--scrawl-color-surface-raised);
+  border: 1px solid color-mix(in srgb, var(--scrawl-color-surface-raised), var(--scrawl-color-text) 12%);
+  border-radius: var(--scrawl-radius-panel);
+  display: flex;
+  gap: 2px;
+  padding: 4px;
+  pointer-events: auto;
+  position: absolute;
+}
+
+[data-scrawl-root] .scrawl-board__actions { inset-block-start: 12px; inset-inline-end: 12px; }
+[data-scrawl-root] .scrawl-board__tools { inset-block-end: 12px; inset-inline-start: 50%; max-inline-size: calc(100% - 24px); transform: translateX(-50%); }
+[data-scrawl-root] .scrawl-board__view { inset-block-end: 12px; inset-inline-end: 12px; }
+[data-scrawl-root] .scrawl-board__style-shelf {
+  gap: 12px;
+  inset-block-end: 68px;
+  inset-inline-start: 50%;
+  max-inline-size: calc(100% - 24px);
+  overflow-x: auto;
+  transform: translateX(-50%);
+}
+[data-scrawl-root] .scrawl-board__style-group { align-items: center; display: flex; gap: 6px; white-space: nowrap; }
+[data-scrawl-root] .scrawl-board__style-group > span:first-child { color: var(--scrawl-color-text-muted); font-size: 0.75rem; font-weight: var(--scrawl-font-weight-strong); text-transform: uppercase; }
+[data-scrawl-root] .scrawl-board__style-group button { align-items: center; display: flex; justify-content: center; padding: 6px 10px; }
+[data-scrawl-root] .scrawl-board__style-group button span[aria-hidden] { block-size: 18px; border-radius: 50%; inline-size: 18px; }
+
+[data-scrawl-root] [data-scrawl-default-ui] button,
+[data-scrawl-root] [data-scrawl-default-ui] select,
+[data-scrawl-portal] .scrawl-board__panel button,
+[data-scrawl-portal] .scrawl-board__panel input {
+  background: transparent;
+  border: 0;
+  border-radius: var(--scrawl-radius-control);
+  color: var(--scrawl-color-text);
+}
+
+[data-scrawl-root] [data-scrawl-default-ui] button,
+[data-scrawl-portal] .scrawl-board__panel button {
+  cursor: pointer;
+  padding: 8px 10px;
+}
+
+[data-scrawl-root] [data-scrawl-default-ui] button:hover,
+[data-scrawl-portal] .scrawl-board__panel button:hover { background: var(--scrawl-color-surface-muted); }
+
+[data-scrawl-root] [data-scrawl-default-ui] button[aria-pressed="true"],
+[data-scrawl-portal] .scrawl-board__panel button[aria-pressed="true"] {
+  background: var(--scrawl-color-selection);
+  font-weight: var(--scrawl-font-weight-strong);
+}
+
+[data-scrawl-root] [data-scrawl-default-ui] button:disabled,
+[data-scrawl-root] [data-scrawl-default-ui] select:disabled { color: var(--scrawl-color-text-muted); cursor: not-allowed; }
+
+[data-scrawl-root] .scrawl-board__tool-select {
+  align-items: center;
+  display: flex;
+  min-block-size: 44px;
+}
+
+[data-scrawl-root] .scrawl-board__tool-select > span { block-size: 1px; clip: rect(0, 0, 0, 0); inline-size: 1px; overflow: hidden; position: absolute; }
+[data-scrawl-root] .scrawl-board__tool-select select {
+  -webkit-appearance: none;
+  appearance: none;
+  /* Chevron drawn from two gradient triangles rather than an embedded asset
+     reference (disallowed by this stylesheet's policy, see styles.test.ts),
+     and currentColor keeps it Theme-aware where a bitmap/SVG asset would
+     need its own colour. */
+  background-image:
+    linear-gradient(45deg, transparent 50%, currentColor 50%),
+    linear-gradient(135deg, currentColor 50%, transparent 50%);
+  background-position: right 14px center, right 9px center;
+  background-repeat: no-repeat;
+  background-size: 5px 5px, 5px 5px;
+  min-block-size: 44px;
+  padding-inline: 8px 24px;
+}
+
+[data-scrawl-root] .scrawl-board__ink-sample,
+[data-scrawl-portal] .scrawl-board__ink-options span {
+  border: 1px solid color-mix(in srgb, currentColor, transparent 72%);
+  border-radius: 50%;
+  block-size: 18px;
+  display: inline-block;
+  inline-size: 18px;
+  margin-inline-end: 6px;
+  vertical-align: middle;
+}
+
+[data-scrawl-root] .scrawl-board__file-input { block-size: 1px; clip: rect(0, 0, 0, 0); inline-size: 1px; overflow: hidden; position: absolute; }
+
+[data-scrawl-portal] .scrawl-board__modal-layer {
+  inset: 0;
+  pointer-events: auto;
+  position: absolute;
+  z-index: 30;
+}
+
+[data-scrawl-portal] .scrawl-board__panel {
+  background: var(--scrawl-color-surface-raised);
+  border: 1px solid color-mix(in srgb, var(--scrawl-color-surface-raised), var(--scrawl-color-text) 14%);
+  border-radius: var(--scrawl-radius-panel);
+  box-shadow: var(--scrawl-elevation-high);
+  color: var(--scrawl-color-text);
+  inline-size: min(28rem, calc(100vw - 32px));
+  inset-block-end: 68px;
+  inset-inline-start: 50%;
+  max-block-size: min(32rem, calc(100vh - 96px));
+  overflow: auto;
+  padding: 12px;
+  pointer-events: auto;
+  position: absolute;
+  transform: translateX(-50%);
+  z-index: 1;
+}
+
+[data-scrawl-portal] .scrawl-board__panel-heading { align-items: center; display: flex; justify-content: space-between; margin-block-end: 10px; }
+[data-scrawl-portal] .scrawl-board__panel-heading h2 { font-size: 1rem; line-height: 1.4; margin: 0; }
+[data-scrawl-portal] .scrawl-board__ink-options,
+[data-scrawl-portal] .scrawl-board__export-options { display: grid; gap: 4px; grid-template-columns: repeat(auto-fit, minmax(7rem, 1fr)); }
+[data-scrawl-portal] .scrawl-board__ink-options button,
+[data-scrawl-portal] .scrawl-board__export-options button { text-align: start; }
+
+[data-scrawl-portal] [data-scrawl-search] label { display: grid; font-weight: var(--scrawl-font-weight-strong); gap: 6px; }
+[data-scrawl-portal] [data-scrawl-search] input { background: var(--scrawl-color-surface); border: 1px solid var(--scrawl-color-edge); min-block-size: 44px; padding: 8px 10px; }
+[data-scrawl-portal] [data-scrawl-search-results] { display: grid; gap: 4px; margin-block-start: 8px; }
+[data-scrawl-portal] [data-scrawl-search-results] button { display: grid; gap: 2px; text-align: start; }
+[data-scrawl-portal] [data-scrawl-search-results] span { color: var(--scrawl-color-text-muted); }
+
+[data-scrawl-portal] .scrawl-board__inline-editor {
+  background: var(--scrawl-color-surface);
+  border: 1px solid var(--scrawl-color-focus);
+  border-radius: var(--scrawl-radius-control);
+  box-shadow: var(--scrawl-elevation-high);
+  min-block-size: 32px;
+  padding: 6px 8px;
+  pointer-events: auto;
+  position: absolute;
+  resize: none;
+  white-space: pre-wrap;
+  word-break: break-word;
+  z-index: 25;
+}
+
+[data-scrawl-portal] .scrawl-board__inline-editor--table-cell {
+  pointer-events: auto;
+  position: absolute;
+  z-index: 25;
+}
+[data-scrawl-portal] .scrawl-board__inline-editor--table-cell .scrawl-board__inline-editor { inset: 0; block-size: 100%; inline-size: 100%; position: absolute; }
+
+[data-scrawl-portal] .scrawl-board__inline-editor-actions {
+  align-items: center;
+  background: var(--scrawl-color-surface-raised);
+  border-radius: var(--scrawl-radius-control);
+  box-shadow: var(--scrawl-elevation-low);
+  display: flex;
+  font-size: 0.75rem;
+  gap: 6px;
+  inset-block-end: calc(100% + 4px);
+  inset-inline-start: 0;
+  padding: 2px 6px;
+  position: absolute;
+  white-space: nowrap;
+}
+[data-scrawl-portal] .scrawl-board__inline-editor-actions button { min-block-size: auto; min-inline-size: auto; padding: 2px 6px; }
+
+@media (max-width: 60rem) {
+  [data-scrawl-root] .scrawl-board__actions,
+  [data-scrawl-root] .scrawl-board__tools { inline-size: calc(100% - 24px); overflow-x: auto; }
+  [data-scrawl-root] .scrawl-board__actions { justify-content: flex-end; }
+  [data-scrawl-root] .scrawl-board__tools { flex-wrap: nowrap; inset-inline-start: 12px; transform: none; }
+  [data-scrawl-root] .scrawl-board__tools :focus-visible { outline-offset: -3px; }
+  [data-scrawl-root] .scrawl-board__view { inset-block-end: 84px; }
+}
+
+[data-scrawl-root] .scrawl-board__status, [data-scrawl-portal] .scrawl-board__status {
+  block-size: 1px;
+  border: 0;
+  clip: rect(0, 0, 0, 0);
+  inline-size: 1px;
+  margin: -1px;
+  overflow: hidden;
+  padding: 0;
+  position: absolute;
+  white-space: nowrap;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-scrawl-root], [data-scrawl-portal] { --scrawl-motion-duration: 0ms !important; }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@scrawl-board/board",
+  "version": "0.1.0-beta.0",
+  "description": "The Scrawl Board SDK: an embeddable, collaborative infinite-canvas whiteboard for React and vanilla JS/TS apps.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/purelogiclimited/scrawl-board-sdk.git",
+    "directory": "packages/board"
+  },
+  "homepage": "https://github.com/purelogiclimited/scrawl-board-sdk/tree/main/packages/board#readme",
+  "bugs": "https://github.com/purelogiclimited/scrawl-board-sdk/issues",
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/styles.css"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "scripts": {
+    "build": "node ./scripts/build.mjs",
+    "prepack": "npm run build",
+    "license-check": "node ./scripts/check-license-allowlist.mjs",
+    "notice": "node ./scripts/generate-notice.mjs",
+    "sbom": "node ./scripts/generate-sbom.mjs",
+    "size": "size-limit",
+    "lint:pack": "publint . && attw --pack . --exclude-entrypoints ./styles.css --profile esm-only",
+    "api-report": "node ./scripts/generate-api-docs.mjs"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@cyclonedx/cyclonedx-npm": "^6.0.1",
+    "@microsoft/api-extractor": "^7.59.0",
+    "@size-limit/file": "^13.0.3",
+    "@types/react": "^19",
+    "@types/ws": "^8.18.1",
+    "publint": "^0.3.24",
+    "size-limit": "^13.0.3",
+    "vite": "^8.1.4",
+    "ws": "^8.21.3"
+  }
+}