@coldsmirk/inkstone-core 0.19.0 → 0.19.1

package/README.md

@@ -9,7 +9,7 @@ Part of [inkstone](https://github.com/coldsmirk/inkstone). The editor layers ([`
 - **`getHighlighter()`** — the process-wide `HighlighterCore` promise. JavaScript / TypeScript / JSON / SQL grammars and the catppuccin theme pair load by default.
 - **`configureHighlighter(config)`** — extend or replace the default grammar / theme set, once, before any editor mounts. `DEFAULT_HIGHLIGHTER_LANGS` is exported so extension is additive.
 - **`shikiThemeId(dark)`** plus the `INKSTONE_LIGHT_THEME` / `INKSTONE_DARK_THEME` constants — the theme names to pass wherever a Shiki theme id is expected.
-- **`configureEditorSurface(surfaces)`** — re-light the editors' own surfaces in your design language, once, before any editor mounts: per-scheme CSS color literals for `background` (content and gutter), `lineHighlight`, `lineNumber`, `widget` (completion, hover, parameter hints, the find widget and search panels), `widgetBorder`, and `widgetSelection`. The catppuccin pair keeps its syntax palette and gets these baked into its theme colors — Monaco, static rendering, and CodeMirror's chrome all read the same values — so an editor sits inside the app instead of bringing a second dark. A role or scheme left out keeps the flavor's own color, a later call replaces the schemes it names, and values must be color literals (a `var()` reference is refused — Monaco cannot resolve one). Keep `lineHighlight` translucent: CodeMirror draws selections behind the content, so an opaque active line would hide them. `getEditorSurface(dark)` reads what was configured.
+- **`configureEditorSurface(surfaces)`** — re-light the editors' own surfaces in your design language, once, before any editor mounts: per-scheme CSS color literals for `background` (content and gutter), `lineHighlight`, `lineNumber`, `widget` (completion, hover, parameter hints, the find widget and search panels), `widgetBorder`, and `widgetSelection`. The catppuccin pair keeps its syntax palette and gets these baked into its theme colors — Monaco, static rendering, and CodeMirror's chrome all read the same values — so an editor sits inside the app instead of bringing a second dark. A role or scheme left out keeps the flavor's own color, a later call replaces the schemes it names, and values must be hex colors (`#rrggbb`, `#rrggbbaa`) — Monaco parses theme colors as hex and paints red for anything else, so a `var()` reference or an `rgb(…)` is refused up front. Keep `lineHighlight` translucent: CodeMirror draws selections behind the content, so an opaque active line would hide them. `getEditorSurface(dark)` reads what was configured.
 - **`CODE_FONT_FAMILY`** — the shared code font stack both editor engines render with: the page's `--inkstone-font-family-code` CSS token when defined, else the platform's native monospace.
 - **`inkstoneRadius(size, fallback)` / `inkstoneShadow(size, fallback)`** — `var()` references to the host's `--inkstone-radius-{small,medium,large,xlarge}` and `--inkstone-shadow-{medium,large,xlarge}` tokens. Set them once on your root and both engines' chrome follows: the Monaco host maps them onto VS Code's `--vscode-cornerRadius-*` / `--vscode-shadow-*` design tokens (which the standalone editor never defines), CodeMirror's polish reads them directly; unset, each engine keeps the look it ships with.
 

package/dist/index.d.ts

@@ -15,8 +15,9 @@ declare const CODE_FONT_FAMILY = "var(--inkstone-font-family-code, ui-monospace,
  * chrome — background, gutter, current line, the floating completion / hover / find widgets —
  * in its own tokens, so an editor sits inside the app instead of bringing a second dark.
  *
- * Every value is a CSS color literal (`#rrggbb`, `rgb(…)`): Monaco resolves its theme colors
- * itself and cannot follow a custom property. An omitted role keeps the flavor's own color.
+ * Every value is a hex color (`#rrggbb`, `#rrggbbaa`): Monaco parses its theme colors itself,
+ * as hex only, and cannot follow a custom property. An omitted role keeps the flavor's own
+ * color.
  */
 interface EditorSurface {
   /**
@@ -124,8 +125,9 @@ declare function configureHighlighter(options: HighlighterConfig): void;
  * role's flavor color; a later call replaces the schemes it names. Process-global like the
  * highlighter itself, for the same reason: one palette across every editor and rendered block.
  *
- * Every value must be a CSS color literal — Monaco resolves theme colors itself, so a custom
- * property reference would silently paint the wrong color; it is refused here instead.
+ * Every value must be a hex color (`#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`) — Monaco parses
+ * theme colors as hex and paints red for anything else, a custom property reference or an
+ * `rgb(…)` alike, so those are refused here instead of failing on screen.
  */
 declare function configureEditorSurface(surfaces: EditorSurfaces): void;
 /**

package/dist/index.js

@@ -101,12 +101,13 @@ function configureHighlighter(options) {
 		...options
 	};
 }
+const HEX_COLOR = /^#(?:[\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i;
 function configureEditorSurface(surfaces) {
 	const registry = getHighlighterRegistry();
 	assertConfigurable(registry, "configureEditorSurface");
 	for (const [scheme, surface] of Object.entries(surfaces)) {
 		const roles = Object.entries(surface ?? {});
-		for (const [role, value] of roles) if (typeof value === "string" && value.includes("var(")) throw new Error(`configureEditorSurface: ${scheme}.${role} must be a CSS color literal, not a custom property reference (${value})`);
+		for (const [role, value] of roles) if (typeof value === "string" && !HEX_COLOR.test(value)) throw new Error(`configureEditorSurface: ${scheme}.${role} must be a hex color, which is all Monaco parses (${value})`);
 	}
 	registry.surfaces = {
 		...registry.surfaces,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldsmirk/inkstone-core",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Shared Shiki highlighter service for the inkstone editor toolkit: one fine-grained singleton (catppuccin themes, JS regex engine) reused by Monaco, static rendering, and markdown surfaces.",
   "keywords": [
     "shiki",