@linxiraos/pi-natives 1.0.0

package/native/index.js

@@ -0,0 +1,142 @@
+import { loadNative } from "./loader-state.js";
+
+/**
+ * Native addon entrypoint.
+ *
+ * Hand-written surface area: one `loadNative()` call. Everything else in
+ * this file (the surface-area `export const` block between MARKER_START
+ * and MARKER_END) is rewritten by `packages/natives/scripts/gen-enums.ts`
+ * after `napi build` regenerates `index.d.ts`.
+ *
+ * Loader logic lives in `./loader-state.js` so the pure helpers stay
+ * unit-testable without triggering AVX2 detection or filesystem probes on
+ * import. Types are auto-generated by napi-rs in `./index.d.ts`.
+ */
+
+const nativeBindings = loadNative();
+// --- generated native exports (do not edit) ---
+// classes
+export const AudioCapture = nativeBindings.AudioCapture;
+export const AudioPlayback = nativeBindings.AudioPlayback;
+export const DesktopSession = nativeBindings.DesktopSession;
+export const FileLock = nativeBindings.FileLock;
+export const LiveWebRtcPeer = nativeBindings.LiveWebRtcPeer;
+export const MacAppearanceObserver = nativeBindings.MacAppearanceObserver;
+export const MacOSPowerAssertion = nativeBindings.MacOSPowerAssertion;
+export const Process = nativeBindings.Process;
+export const PtySession = nativeBindings.PtySession;
+export const Shell = nativeBindings.Shell;
+
+// functions
+export const __ompInstallTokioRuntime = nativeBindings.__ompInstallTokioRuntime;
+export const __piNativesV1_0_0 = nativeBindings.__piNativesV1_0_0;
+export const astEdit = nativeBindings.astEdit;
+export const astGrep = nativeBindings.astGrep;
+export const astMatch = nativeBindings.astMatch;
+export const blockRangeAt = nativeBindings.blockRangeAt;
+export const copyToClipboard = nativeBindings.copyToClipboard;
+export const cosineSimilarityPairs = nativeBindings.cosineSimilarityPairs;
+export const countTokens = nativeBindings.countTokens;
+export const detectMacOSAppearance = nativeBindings.detectMacOSAppearance;
+export const deviceCheckGenerateToken = nativeBindings.deviceCheckGenerateToken;
+export const diffLineRuns = nativeBindings.diffLineRuns;
+export const diffLines = nativeBindings.diffLines;
+export const diffWords = nativeBindings.diffWords;
+export const enclosingBlockBoundaries = nativeBindings.enclosingBlockBoundaries;
+export const encodeSixel = nativeBindings.encodeSixel;
+export const executeShell = nativeBindings.executeShell;
+export const extractSegments = nativeBindings.extractSegments;
+export const fuzzyFind = nativeBindings.fuzzyFind;
+export const getSupportedLanguages = nativeBindings.getSupportedLanguages;
+export const getWorkProfile = nativeBindings.getWorkProfile;
+export const glob = nativeBindings.glob;
+export const grep = nativeBindings.grep;
+export const hasMatch = nativeBindings.hasMatch;
+export const highlightCode = nativeBindings.highlightCode;
+export const htmlToMarkdown = nativeBindings.htmlToMarkdown;
+export const invalidateFsScanCache = nativeBindings.invalidateFsScanCache;
+export const isoBackend = nativeBindings.isoBackend;
+export const isoDiff = nativeBindings.isoDiff;
+export const isoIsUnavailableError = nativeBindings.isoIsUnavailableError;
+export const isoProbe = nativeBindings.isoProbe;
+export const isoResolve = nativeBindings.isoResolve;
+export const isoStart = nativeBindings.isoStart;
+export const isoStop = nativeBindings.isoStop;
+export const listWorkspace = nativeBindings.listWorkspace;
+export const matchesKey = nativeBindings.matchesKey;
+export const matchesKittySequence = nativeBindings.matchesKittySequence;
+export const matchesLegacySequence = nativeBindings.matchesLegacySequence;
+export const mmrRerankIndices = nativeBindings.mmrRerankIndices;
+export const parseKey = nativeBindings.parseKey;
+export const parseKittySequence = nativeBindings.parseKittySequence;
+export const readImageFromClipboard = nativeBindings.readImageFromClipboard;
+export const renderSnapcompactPng = nativeBindings.renderSnapcompactPng;
+export const search = nativeBindings.search;
+export const setHangulCompatJamoWidthOverride = nativeBindings.setHangulCompatJamoWidthOverride;
+export const sliceWithWidth = nativeBindings.sliceWithWidth;
+export const snapcompactSupportedChars = nativeBindings.snapcompactSupportedChars;
+export const structuredPatchHunks = nativeBindings.structuredPatchHunks;
+export const summarizeCode = nativeBindings.summarizeCode;
+export const supportsLanguage = nativeBindings.supportsLanguage;
+export const truncateToWidth = nativeBindings.truncateToWidth;
+export const vectorIndexTopK = nativeBindings.vectorIndexTopK;
+export const visibleWidth = nativeBindings.visibleWidth;
+export const wrapTextWithAnsi = nativeBindings.wrapTextWithAnsi;
+
+// string/numeric enums (napi-rs string_enum produces TS-only const enum)
+export const AstMatchStrictness = {
+	Cst: "cst",
+	Smart: "smart",
+	Ast: "ast",
+	Relaxed: "relaxed",
+	Signature: "signature",
+	Template: "template",
+};
+export const Ellipsis = {
+	Unicode: 0,
+	Ascii: 1,
+	Omit: 2,
+};
+export const Encoding = {
+	O200kBase: "O200kBase",
+	Cl100kBase: "Cl100kBase",
+};
+export const FileType = {
+	File: 1,
+	Dir: 2,
+	Symlink: 3,
+};
+export const GrepOutputMode = {
+	Content: "content",
+	Count: "count",
+	FilesWithMatches: "filesWithMatches",
+};
+export const IsoBackendKind = {
+	Apfs: 0,
+	Btrfs: 1,
+	Zfs: 2,
+	LinuxReflink: 3,
+	Overlayfs: 4,
+	WindowsBlockClone: 5,
+	Projfs: 6,
+	Rcopy: 7,
+};
+export const IsoChangeKind = {
+	Added: 0,
+	Modified: 1,
+	Removed: 2,
+};
+export const KeyEventType = {
+	Press: 1,
+	Repeat: 2,
+	Release: 3,
+};
+export const MacOSAppearance = {
+	Dark: "dark",
+	Light: "light",
+};
+export const ProcessStatus = {
+	Running: "running",
+	Exited: "exited",
+};
+// --- end generated native exports ---

package/native/loader-state.d.ts

@@ -0,0 +1,129 @@
+export interface EmbeddedAddonFile {
+	variant: "modern" | "baseline" | "default";
+	filename: string;
+	size?: number;
+	filePath?: string;
+}
+
+export interface EmbeddedAddonArchive {
+	format: "tar.gz";
+	filename: string;
+	filePath: string;
+}
+
+export interface EmbeddedAddon {
+	platformTag: string;
+	version: string;
+	files: EmbeddedAddonFile[];
+	archive?: EmbeddedAddonArchive;
+}
+
+export interface DetectCompiledBinaryInput {
+	embeddedAddon: EmbeddedAddon | null | undefined;
+	env: Record<string, string | undefined>;
+	importMetaUrl: string | null | undefined;
+}
+
+export function detectCompiledBinary(input: DetectCompiledBinaryInput): boolean;
+
+export interface GetAddonFilenamesInput {
+	tag: string;
+	arch: string;
+	variant: "modern" | "baseline" | null | undefined;
+}
+
+export function getAddonFilenames(input: GetAddonFilenamesInput): string[];
+
+export interface ShouldStageNodeModulesAddonInput {
+	platform: NodeJS.Platform | string;
+	isCompiledBinary: boolean;
+	nativeDir: string;
+}
+
+export function shouldStageNodeModulesAddon(input: ShouldStageNodeModulesAddonInput): boolean;
+
+export interface ResolveLoaderCandidatesInput {
+	addonFilenames: string[];
+	isCompiledBinary: boolean;
+	stageFromNodeModules?: boolean;
+	nativeDir: string;
+	leafPackageDir?: string | null;
+	execDir: string;
+	versionedDir: string;
+	userDataDir: string;
+}
+
+export function resolveLoaderCandidates(input: ResolveLoaderCandidatesInput): string[];
+
+export interface InitLoaderContextOverrides {
+	nativeDir?: string;
+	platform?: NodeJS.Platform | string;
+	isCompiledBinary?: boolean;
+	leafPackageDir?: string | null;
+}
+
+export interface NativeLoaderContext {
+	platformTag: string;
+	packageVersion: string;
+	nativeDir: string;
+	leafPackageDir: string | null;
+	versionedDir: string;
+	isCompiledBinary: boolean;
+	stageFromNodeModules: boolean;
+	selectedVariant: "modern" | "baseline" | null;
+	addonFilenames: string[];
+	addonLabel: string;
+	candidates: string[];
+	versionSentinelExport: string;
+	isWorkspaceLoad: boolean;
+	nativesDir: string;
+}
+
+export function initLoaderContext(overrides?: InitLoaderContextOverrides): NativeLoaderContext;
+
+export interface CleanupStaleNativeVersionsInput {
+	nativesDir: string;
+	currentVersion: string;
+}
+
+export function cleanupStaleNativeVersions(input: CleanupStaleNativeVersionsInput): string[];
+
+export function prepareNativeVersionDir(versionedDir: string): void;
+
+export interface ExtractEmbeddedAddonArchiveInput {
+	archivePath: string;
+	files: EmbeddedAddonFile[];
+	targetDir: string;
+}
+
+export function extractEmbeddedAddonArchive(input: ExtractEmbeddedAddonArchiveInput): string[];
+
+export interface SelectCpuVariantInput {
+	arch: string;
+	override: "modern" | "baseline" | null | undefined;
+	env: Record<string, string | undefined>;
+	detectAvx2: () => boolean;
+}
+
+export interface SelectCpuVariantResult {
+	variant: "modern" | "baseline" | null;
+	source: "non-x64" | "override" | "cache" | "detect";
+	cacheEnvKey?: string;
+	cacheEnvValue?: string;
+}
+
+export function selectCpuVariant(input: SelectCpuVariantInput): SelectCpuVariantResult;
+
+export interface ValidateLoadedBindingsContext {
+	isWorkspaceLoad: boolean;
+	packageVersion: string;
+	versionSentinelExport: string;
+}
+
+export function validateLoadedBindings(
+	ctx: ValidateLoadedBindingsContext,
+	bindings: Record<string, unknown>,
+	candidate: string,
+): void;
+
+export function loadNative(): Record<string, unknown>;