@elyracode/clipboard 0.9.3

package/README.md

@@ -0,0 +1,46 @@
+# @elyracode/clipboard
+
+Native cross-platform clipboard access (text, image, HTML, RTF) implemented in Rust and exposed to Node via [NAPI-RS](https://napi.rs).
+
+This package is a fork of [`@mariozechner/clipboard`](https://github.com/badlogic/clipboard) by Mario Zechner (MIT licensed), vendored into the Elyra monorepo so the project owns its development and maintenance.
+
+## API
+
+```ts
+import * as clipboard from "@elyracode/clipboard";
+
+await clipboard.setText("hello");
+const text = await clipboard.getText();
+const hasImage = clipboard.hasImage();
+const bytes = await clipboard.getImageBinary();
+```
+
+See `index.d.ts` for the full surface.
+
+## Building
+
+The native addon is built with NAPI-RS and requires a Rust toolchain:
+
+```bash
+npm run build        # release build for the host platform
+npm run build:debug  # debug build
+```
+
+The build emits a `clipboard.<triple>.node` file in the package root. The loader in `index.js` prefers a locally built `.node` and otherwise falls back to the per-platform npm package (`@elyracode/clipboard-<triple>`).
+
+## Publishing
+
+This package is published by the dedicated [`Publish Clipboard Binaries`](../../.github/workflows/publish-clipboard.yml) GitHub Actions workflow, which cross-compiles the native addon for every supported platform and publishes the loader together with its per-platform binary packages (`@elyracode/clipboard-<triple>`).
+
+The loader is marked `"private": true` in this repo so the regular lockstep release (`npm publish --workspaces`) skips it; the workflow strips the flag at publish time (via `scripts/prepare-npm.mjs`) and owns all clipboard publishing. It runs automatically on release tags (`v*`) pushed by `scripts/release.mjs`, and can be re-run for a tag via `workflow_dispatch`.
+
+Requirements:
+
+- An `NPM_TOKEN` repository secret: an npm automation token with publish access to the `@elyracode` scope.
+- Until a release tag has run the workflow, `@elyracode/clipboard` works only on platforms where it has been built locally (`npm run build`).
+
+Supported targets: macOS (arm64, x64), Linux gnu (x64, arm64, riscv64), Windows msvc (x64, arm64). Alpine/musl and macOS universal are intentionally not built; on those platforms the native addon is absent and clipboard features degrade gracefully.
+
+## License
+
+MIT. Original work Copyright (c) Mario Zechner. Fork maintained by Knut W. Horne.

package/index.d.ts

@@ -0,0 +1,37 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare function availableFormats(): Array<string>
+
+export declare function callThreadsafeFunction(callback: ((err: Error | null, arg: number) => void)): void
+
+export declare function clear(): Promise<void>
+
+export declare function getHtml(): Promise<string>
+
+export declare function getImageBase64(): Promise<string>
+
+export declare function getImageBinary(): Promise<Array<number>>
+
+export declare function getRtf(): Promise<string>
+
+export declare function getText(): Promise<string>
+
+export declare function hasHtml(): boolean
+
+export declare function hasImage(): boolean
+
+export declare function hasRtf(): boolean
+
+export declare function hasText(): boolean
+
+export declare function setHtml(html: string): Promise<void>
+
+export declare function setImageBase64(base64Str: string): Promise<void>
+
+export declare function setImageBinary(imageBytes: Array<number>): Promise<void>
+
+export declare function setRtf(rtf: string): Promise<void>
+
+export declare function setText(text: string): Promise<void>
+
+export declare function watch(): void

package/index.js

@@ -0,0 +1,606 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./clipboard.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-android-arm64')
+        const bindingPackageVersion = require('@elyracode/clipboard-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./clipboard.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-android-arm-eabi')
+        const bindingPackageVersion = require('@elyracode/clipboard-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./clipboard.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-win32-x64-gnu')
+        const bindingPackageVersion = require('@elyracode/clipboard-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./clipboard.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-win32-x64-msvc')
+        const bindingPackageVersion = require('@elyracode/clipboard-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./clipboard.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-win32-ia32-msvc')
+        const bindingPackageVersion = require('@elyracode/clipboard-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./clipboard.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-win32-arm64-msvc')
+        const bindingPackageVersion = require('@elyracode/clipboard-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./clipboard.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@elyracode/clipboard-darwin-universal')
+      const bindingPackageVersion = require('@elyracode/clipboard-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./clipboard.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-darwin-x64')
+        const bindingPackageVersion = require('@elyracode/clipboard-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./clipboard.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-darwin-arm64')
+        const bindingPackageVersion = require('@elyracode/clipboard-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./clipboard.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-freebsd-x64')
+        const bindingPackageVersion = require('@elyracode/clipboard-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./clipboard.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-freebsd-arm64')
+        const bindingPackageVersion = require('@elyracode/clipboard-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./clipboard.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-x64-musl')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./clipboard.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-x64-gnu')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./clipboard.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-arm64-musl')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./clipboard.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-arm64-gnu')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./clipboard.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./clipboard.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./clipboard.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-loong64-musl')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./clipboard.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-loong64-gnu')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./clipboard.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-riscv64-musl')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./clipboard.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@elyracode/clipboard-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@elyracode/clipboard-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./clipboard.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@elyracode/clipboard-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./clipboard.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-linux-s390x-gnu')
+        const bindingPackageVersion = require('@elyracode/clipboard-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./clipboard.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-openharmony-arm64')
+        const bindingPackageVersion = require('@elyracode/clipboard-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./clipboard.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-openharmony-x64')
+        const bindingPackageVersion = require('@elyracode/clipboard-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./clipboard.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@elyracode/clipboard-openharmony-arm')
+        const bindingPackageVersion = require('@elyracode/clipboard-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.9.3' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./clipboard.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (forceWasi) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || forceWasi) {
+    try {
+      wasiBinding = require('@elyracode/clipboard-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (forceWasi) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.availableFormats = nativeBinding.availableFormats
+module.exports.callThreadsafeFunction = nativeBinding.callThreadsafeFunction
+module.exports.clear = nativeBinding.clear
+module.exports.getHtml = nativeBinding.getHtml
+module.exports.getImageBase64 = nativeBinding.getImageBase64
+module.exports.getImageBinary = nativeBinding.getImageBinary
+module.exports.getRtf = nativeBinding.getRtf
+module.exports.getText = nativeBinding.getText
+module.exports.hasHtml = nativeBinding.hasHtml
+module.exports.hasImage = nativeBinding.hasImage
+module.exports.hasRtf = nativeBinding.hasRtf
+module.exports.hasText = nativeBinding.hasText
+module.exports.setHtml = nativeBinding.setHtml
+module.exports.setImageBase64 = nativeBinding.setImageBase64
+module.exports.setImageBinary = nativeBinding.setImageBinary
+module.exports.setRtf = nativeBinding.setRtf
+module.exports.setText = nativeBinding.setText
+module.exports.watch = nativeBinding.watch

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@elyracode/clipboard",
+	"version": "0.9.3",
+	"description": "Native cross-platform clipboard access (text, image, html, rtf) via NAPI-RS (fork of @mariozechner/clipboard)",
+	"main": "index.js",
+	"types": "index.d.ts",
+	"napi": {
+		"name": "clipboard",
+		"triples": {
+			"additional": [
+				"aarch64-apple-darwin",
+				"aarch64-unknown-linux-gnu",
+				"aarch64-pc-windows-msvc",
+				"riscv64gc-unknown-linux-gnu"
+			]
+		}
+	},
+	"license": "MIT",
+	"author": "Knut W. Horne",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kwhorne/elyra.git",
+		"directory": "packages/clipboard"
+	},
+	"engines": {
+		"node": ">= 10"
+	},
+	"scripts": {
+		"artifacts": "napi artifacts",
+		"build": "napi build --platform --release",
+		"build:debug": "napi build --platform",
+		"universal": "napi universalize -o artifacts",
+		"version": "napi version"
+	},
+	"devDependencies": {
+		"@napi-rs/cli": "3.7.0"
+	},
+	"optionalDependencies": {
+		"@elyracode/clipboard-darwin-arm64": "0.9.3",
+		"@elyracode/clipboard-darwin-x64": "0.9.3",
+		"@elyracode/clipboard-linux-arm64-gnu": "0.9.3",
+		"@elyracode/clipboard-linux-riscv64-gnu": "0.9.3",
+		"@elyracode/clipboard-linux-x64-gnu": "0.9.3",
+		"@elyracode/clipboard-win32-arm64-msvc": "0.9.3",
+		"@elyracode/clipboard-win32-x64-msvc": "0.9.3"
+	}
+}