@voxgig/sdkgen 4.8.2 → 4.8.3

package/project/.sdk/tm/ts/test/vendor/omni/compat.ts

@@ -1,188 +0,0 @@
-// VENDORED: @voxgig/omni 0.1.2 (typescript/compat/struct.ts), import path adapted ('../src' -> './index').
-// Source: https://github.com/voxgig/omni @ 5956cc4e5ecdaeebd11eab8bb4b9462dfc76e018
-// License: MIT (c) voxgig - see repository LICENSE. Do not edit: resync from upstream.
-// Drop-in replacement for the in-situ test runner in the voxgig/struct
-// repository (`typescript/test/runner.ts`).
-//
-// struct's own runner and omni's runner implement the same spec format;
-// this module exposes omni behind struct's exact runner API, so a struct
-// port switches over by changing one import:
-//
-//   -import { makeRunner, nullModifier, NULLMARK } from './runner'
-//   +import { makeRunner, nullModifier, NULLMARK } from './omni'
-//
-// where `./omni` is a small resolver in the port's test directory that
-// locates a local omni checkout. Everything else - the corpus, the SDK,
-// the test file - is unchanged. This is the TypeScript peer of
-// javascript/compat/struct.js and python/voxgig_omni/compat/struct.py.
-
-import { dirname, isAbsolute, join, sep } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-import { EXISTSMARK, NULLMARK, UNDEFMARK, makeRunner as omnimakerunner, nullmodifier } from './index'
-
-import type { Json, Provider, Subject } from './index'
-
-// struct's data model is JSON-shaped `any` at its boundaries, and so is
-// its SDK; these aliases say that on purpose rather than by omission.
-export type StructSDK = any
-export type StructUtility = any
-
-// struct's runner API, name for name.
-export type StructSubject = (...args: any[]) => any
-
-export type StructRunSet = (testspec: any, testsubject?: StructSubject) => Promise<void>
-
-export type StructRunSetFlags = (
-  testspec: any,
-  flags: Record<string, any>,
-  testsubject?: StructSubject,
-) => Promise<void>
-
-export type StructRunPack = {
-  spec: any
-  runset: StructRunSet
-  runsetflags: StructRunSetFlags
-  subject?: StructSubject
-  client: StructProvider
-}
-
-export type StructRunner = (name: string, store?: any) => Promise<StructRunPack>
-
-// An omni provider that is also a struct client: test code reaches through
-// the runpack's `client` as an SDK (`client.utility().struct`), so the
-// wrapper forwards `utility()` and `tester()` alongside the four hooks.
-export type StructProvider = Provider & {
-  utility: () => StructUtility
-  tester: (options?: any) => any
-  sdk: StructSDK
-}
-
-// The directory this shim was loaded from: dist/compat when built, compat
-// when run from source. Its parent is the port root, so every frame from
-// inside omni is skipped when locating the caller.
-//
-// It is derived from __dirname rather than matched against a known path,
-// so it holds wherever the package sits - a checkout, or
-// node_modules/@voxgig/omni. The trailing separator matters: without it a
-// sibling whose name merely EXTENDS this one (`omni-js-extra` beside
-// `omni-js`) would read as inside.
-const OMNIDIR = dirname(__dirname)
-
-// A relative test-file path is resolved against the first stack frame
-// outside omni - the caller.
-//
-// PREFER AN ABSOLUTE PATH. This heuristic guesses at what "relative to"
-// means, and the guess is wrong whenever a consumer's test FILES sit at a
-// different depth from the module that loads the runner. struct's TypeScript
-// port is exactly that shape: its loader compiles to `dist-test/` and its
-// test files to `dist-test/utility/`, so the same relative string resolved
-// one directory too deep and read `typescript/build/test/test.json`. That
-// port now resolves the path itself, in `test/omni.ts`, and never reaches
-// this. (An earlier version of this comment asserted it already did - it did
-// not; this shim shipped before any consumer had proved it.)
-// A stack frame's file, as a filesystem path.
-//
-// An ESM caller's frame reports a file:// URL rather than a path, and
-// `dirname('file:///a/b.mjs')` yields 'file:/a', so a relative spec path
-// resolved against it died on `ENOENT ... 'file:/.../fib.json'`. Frames
-// that name no path at all - node: internals, data: URLs, eval - are
-// skipped rather than mistaken for the caller.
-function framepath(frame: any): string | null {
-  const file = 'function' === typeof frame.getFileName ? frame.getFileName() : null
-  if (null == file) {
-    return null
-  }
-  if (file.startsWith('file://')) {
-    try {
-      return fileURLToPath(file)
-    } catch {
-      return null
-    }
-  }
-  return isAbsolute(file) ? file : null
-}
-
-function callerdir(): string {
-  const original = Error.prepareStackTrace
-  Error.prepareStackTrace = (_err, stack) => stack
-  const holder: any = {}
-  Error.captureStackTrace(holder, callerdir)
-  const stack: any = holder.stack
-  Error.prepareStackTrace = original
-
-  for (const frame of stack) {
-    const file = framepath(frame)
-    if (file && !file.startsWith(OMNIDIR + sep)) {
-      return dirname(file)
-    }
-  }
-
-  return process.cwd()
-}
-
-// Wrap a struct SDK client as an omni provider.
-function structprovider(sdk: StructSDK): StructProvider {
-  return {
-    // struct resolves a subject from the utility, or from utility.struct.
-    subject: (name: string): Subject | undefined => {
-      const utility = sdk.utility()
-      return utility[name] || (utility.struct && utility.struct[name])
-    },
-
-    // A DEF.client entry becomes another SDK instance.
-    client: async (options: Json) => structprovider(await sdk.tester(options)),
-
-    // struct's SDK supplies its own context wrapper.
-    contextify: (val: Json): Json => {
-      const utility = sdk.utility()
-      const hook =
-        'function' === typeof utility.contextify
-          ? utility.contextify
-          : 'function' === typeof utility.makeContext
-            ? utility.makeContext
-            : null
-      const ctx = null == hook ? val : hook.call(utility, val)
-      if (null != ctx && 'object' === typeof ctx) {
-        ;(ctx as any).utility = utility
-      }
-      return ctx
-    },
-
-    // Client options may reference the runner store.
-    inject: (options: Json, store: Json): Json => {
-      const structutils = sdk.utility().struct
-      if (structutils && 'function' === typeof structutils.inject) {
-        return structutils.inject(options, store)
-      }
-      return options
-    },
-
-    utility: () => sdk.utility(),
-    tester: (options?: any) => sdk.tester(options),
-    sdk,
-  }
-}
-
-// struct's makeRunner(testfile, client) signature, backed by omni.
-async function makeRunner(testfile: string, client: StructSDK): Promise<StructRunner> {
-  const specpath = isAbsolute(testfile) ? testfile : join(callerdir(), testfile)
-  const provider = structprovider(client)
-  const runner = await omnimakerunner(specpath, provider)
-
-  return async function structrunner(name: string, store?: any): Promise<StructRunPack> {
-    const runpack = await runner(name, store)
-
-    return {
-      spec: runpack.spec,
-      runset: runpack.runset,
-      runsetflags: runpack.runsetflags,
-      subject: runpack.subject,
-      client: provider,
-    }
-  }
-}
-
-const nullModifier = nullmodifier
-
-export { EXISTSMARK, NULLMARK, UNDEFMARK, makeRunner, nullModifier, structprovider }