cryosnap 0.1.0

package/index.d.ts

@@ -0,0 +1,102 @@
+export type BoxValue = number | number[] | string;
+export type LinesValue = number | number[] | string;
+
+export interface BorderConfig {
+  radius?: number;
+  width?: number;
+  color?: string;
+}
+
+export interface ShadowConfig {
+  blur?: number;
+  x?: number;
+  y?: number;
+}
+
+export interface FontConfig {
+  family?: string;
+  file?: string;
+  filePath?: string;
+  size?: number;
+  ligatures?: boolean;
+}
+
+export interface PngConfig {
+  optimize?: boolean;
+  level?: number;
+  optimizeLevel?: number;
+  strip?: 'none' | 'safe' | 'all';
+  quantize?: boolean;
+  quantize_preset?: 'fast' | 'balanced' | 'best';
+  quantizePreset?: 'fast' | 'balanced' | 'best';
+  quantize_quality?: number;
+  quantizeQuality?: number;
+  quantize_speed?: number;
+  quantizeSpeed?: number;
+  quantize_dither?: number;
+  quantizeDither?: number;
+}
+
+export interface RasterConfig {
+  scale?: number;
+  max_pixels?: number;
+  maxPixels?: number;
+  backend?: 'auto' | 'resvg' | 'rsvg';
+}
+
+export interface TitleConfig {
+  enabled?: boolean;
+  text?: string;
+  path_style?: 'absolute' | 'relative' | 'basename';
+  pathStyle?: 'absolute' | 'relative' | 'basename';
+  tmux_format?: string;
+  tmuxFormat?: string;
+  align?: 'left' | 'center' | 'right';
+  size?: number;
+  color?: string;
+  opacity?: number;
+  max_width?: number;
+  maxWidth?: number;
+  ellipsis?: string;
+}
+
+export interface RenderConfig {
+  theme?: string;
+  background?: string;
+  padding?: BoxValue;
+  margin?: BoxValue;
+  width?: number;
+  height?: number;
+  window?: boolean;
+  windowControls?: boolean;
+  show_line_numbers?: boolean;
+  showLineNumbers?: boolean;
+  language?: string;
+  execute_timeout_ms?: number;
+  executeTimeoutMs?: number;
+  wrap?: number;
+  lines?: LinesValue;
+  border?: BorderConfig;
+  shadow?: ShadowConfig;
+  font?: FontConfig;
+  raster?: RasterConfig;
+  png?: PngConfig;
+  title?: TitleConfig;
+  line_height?: number;
+  lineHeight?: number;
+}
+
+export interface RenderOptions {
+  input: string;
+  inputKind?: 'text' | 'file' | 'command';
+  configJson?: string;
+  config?: RenderConfig;
+  format?: 'svg' | 'png' | 'webp';
+}
+
+export function render(options: RenderOptions): Buffer;
+export function renderSvg(options: RenderOptions): Buffer;
+export function renderPng(options: RenderOptions): Buffer;
+export function renderWebp(options: RenderOptions): Buffer;
+export function renderToFile(options: RenderOptions, outputPath: string): string;
+export function version(): string;

package/index.js

@@ -0,0 +1,141 @@
+const fs = require('fs');
+const path = require('path');
+
+function normalizeConfig(config) {
+  if (!config || typeof config !== 'object') return config;
+  const out = { ...config };
+
+  if (out.window === undefined && out.windowControls !== undefined) {
+    out.window = out.windowControls;
+  }
+  if (out.show_line_numbers === undefined && out.showLineNumbers !== undefined) {
+    out.show_line_numbers = out.showLineNumbers;
+  }
+  if (out.line_height === undefined && out.lineHeight !== undefined) {
+    out.line_height = out.lineHeight;
+  }
+  if (out.execute_timeout_ms === undefined && out.executeTimeoutMs !== undefined) {
+    out.execute_timeout_ms = out.executeTimeoutMs;
+  }
+
+  if (out.font && typeof out.font === 'object') {
+    const font = { ...out.font };
+    if (font.filePath !== undefined && font.file === undefined) {
+      font.file = font.filePath;
+    }
+    out.font = font;
+  }
+
+  if (out.png && typeof out.png === 'object') {
+    const png = { ...out.png };
+    if (png.optimizeLevel !== undefined && png.level === undefined) {
+      png.level = png.optimizeLevel;
+    }
+    if (png.quantizeQuality !== undefined && png.quantize_quality === undefined) {
+      png.quantize_quality = png.quantizeQuality;
+    }
+    if (png.quantizeSpeed !== undefined && png.quantize_speed === undefined) {
+      png.quantize_speed = png.quantizeSpeed;
+    }
+    if (png.quantizeDither !== undefined && png.quantize_dither === undefined) {
+      png.quantize_dither = png.quantizeDither;
+    }
+    if (png.quantizePreset !== undefined && png.quantize_preset === undefined) {
+      png.quantize_preset = png.quantizePreset;
+    }
+    if (png.quantizePreset !== undefined && png.quantize === undefined) {
+      png.quantize = true;
+    }
+    out.png = png;
+  }
+
+  if (out.raster && typeof out.raster === 'object') {
+    const raster = { ...out.raster };
+    if (raster.maxPixels !== undefined && raster.max_pixels === undefined) {
+      raster.max_pixels = raster.maxPixels;
+    }
+    out.raster = raster;
+  }
+
+  if (out.title && typeof out.title === 'object') {
+    const title = { ...out.title };
+    if (title.pathStyle !== undefined && title.path_style === undefined) {
+      title.path_style = title.pathStyle;
+    }
+    if (title.tmuxFormat !== undefined && title.tmux_format === undefined) {
+      title.tmux_format = title.tmuxFormat;
+    }
+    if (title.maxWidth !== undefined && title.max_width === undefined) {
+      title.max_width = title.maxWidth;
+    }
+    out.title = title;
+  }
+
+  return out;
+}
+
+function applyConfig(options) {
+  const opts = { ...(options || {}) };
+  if (opts.inputKind !== undefined && opts.input_kind === undefined) {
+    opts.input_kind = opts.inputKind;
+  }
+  if (opts.configJson !== undefined && opts.config_json === undefined) {
+    opts.config_json = opts.configJson;
+  }
+  if (opts.config && !opts.configJson) {
+    const normalized = normalizeConfig(opts.config);
+    opts.configJson = JSON.stringify(normalized);
+    if (opts.config_json === undefined) {
+      opts.config_json = opts.configJson;
+    }
+  }
+  delete opts.config;
+  delete opts.inputKind;
+  return opts;
+}
+
+function resolveFormatFromPath(outputPath) {
+  const ext = path.extname(outputPath).toLowerCase();
+  if (ext === '.png') return 'png';
+  if (ext === '.svg') return 'svg';
+  if (ext === '.webp') return 'webp';
+  return null;
+}
+
+try {
+  // Built by `napi build`
+  const native = require('./cryosnap.node');
+  const render = (options) => native.render(applyConfig(options));
+  const renderSvg = (options) => render({ ...(options || {}), format: 'svg' });
+  const renderPng = (options) => render({ ...(options || {}), format: 'png' });
+  const renderWebp = (options) => render({ ...(options || {}), format: 'webp' });
+  const renderToFile = (options, outputPath) => {
+    if (!outputPath) {
+      throw new Error('outputPath is required');
+    }
+    const opts = { ...(options || {}) };
+    if (!opts.format) {
+      const inferred = resolveFormatFromPath(outputPath);
+      if (inferred) opts.format = inferred;
+    }
+    const bytes = render(opts);
+    fs.writeFileSync(outputPath, bytes);
+    return outputPath;
+  };
+
+  module.exports = {
+    ...native,
+    render,
+    renderSvg,
+    renderPng,
+    renderWebp,
+    renderToFile
+  };
+} catch (err) {
+  const message = [
+    'Unable to load cryosnap native module.',
+    'Run `npm run build` in crates/cryosnap-node first.',
+    err && err.message ? `Original error: ${err.message}` : ''
+  ].filter(Boolean).join('\n');
+  throw new Error(message);
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "cryosnap",
+  "version": "0.1.0",
+  "description": "Node/TS bindings for cryosnap",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wangnov/cryosnap.git",
+    "directory": "crates/cryosnap-node"
+  },
+  "homepage": "https://github.com/Wangnov/cryosnap#readme",
+  "bugs": {
+    "url": "https://github.com/Wangnov/cryosnap/issues"
+  },
+  "keywords": [
+    "screenshot",
+    "code",
+    "terminal",
+    "svg",
+    "png",
+    "napi"
+  ],
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').mkdirSync('../../tmp',{recursive:true})\" && napi build --release --no-js --dts ../../tmp/cryosnap-node.d.ts",
+    "build:debug": "node -e \"require('fs').mkdirSync('../../tmp',{recursive:true})\" && napi build --no-js --dts ../../tmp/cryosnap-node.d.ts"
+  },
+  "napi": {
+    "binaryName": "cryosnap"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.5.1"
+  }
+}