Brunobkr/llama.cpp_AlgMor24_github

1# jiti2 3<!-- automd:badges color=F0DB4F bundlephobia -->4 5[![npm version](https://img.shields.io/npm/v/jiti?color=F0DB4F)](https://npmjs.com/package/jiti)6[![npm downloads](https://img.shields.io/npm/dm/jiti?color=F0DB4F)](https://npmjs.com/package/jiti)7[![bundle size](https://img.shields.io/bundlephobia/minzip/jiti?color=F0DB4F)](https://bundlephobia.com/package/jiti)8 9<!-- /automd -->10 11> This is the active development branch. Check out [jiti/v1](https://github.com/unjs/jiti/tree/v1) for legacy v1 docs and code.12 13## 🌟 Used in14 15[Docusaurus](https://docusaurus.io/), [ESLint](https://github.com/eslint/eslint), [FormKit](https://formkit.com/), [Histoire](https://histoire.dev/), [Knip](https://knip.dev/), [Nitro](https://nitro.unjs.io/), [Nuxt](https://nuxt.com/), [PostCSS loader](https://github.com/webpack-contrib/postcss-loader), [Rsbuild](https://rsbuild.dev/), [Size Limit](https://github.com/ai/size-limit), [Slidev](https://sli.dev/), [Tailwindcss](https://tailwindcss.com/), [Tokenami](https://github.com/tokenami/tokenami), [UnoCSS](https://unocss.dev/), [WXT](https://wxt.dev/), [Winglang](https://www.winglang.io/), [Graphql code generator](https://the-guild.dev/graphql/codegen), [Lingui](https://lingui.dev/), [Scaffdog](https://scaff.dog/), [Storybook](https://storybook.js.org), [...UnJS ecosystem](https://unjs.io/), [...60M+ npm monthly downloads](https://npm.chart.dev/jiti), [...6M+ public repositories](https://github.com/unjs/jiti/network/dependents).16 17## ✅ Features18 19- Seamless TypeScript and ESM syntax support for Node.js20- Seamless interoperability between ESM and CommonJS21- Asynchronous API to replace `import()`22- Synchronous API to replace `require()` (deprecated)23- Super slim and zero dependency24- Custom resolve aliases25- Smart syntax detection to avoid extra transforms26- Node.js native `require.cache` integration27- Filesystem transpile with hard disk caches28- ESM Loader support29- JSX support (opt-in)30 31> [!IMPORTANT]32> To enhance compatibility, jiti `>=2.1` enabled [`interopDefault`](#interopdefault) using a new Proxy method. If you migrated to `2.0.0` earlier, this might have caused behavior changes. In case of any issues during the upgrade, please [report](https://github.com/unjs/jiti/issues) so we can investigate to solve them. 🙏🏼33 34## 💡 Usage35 36### CLI37 38You can use `jiti` CLI to quickly run any script with TypeScript and native ESM support!39 40```bash41npx jiti ./index.ts42```43 44### Programmatic45 46Initialize a jiti instance:47 48```js49// ESM50import { createJiti } from "jiti";51const jiti = createJiti(import.meta.url);52 53// CommonJS (deprecated)54const { createJiti } = require("jiti");55const jiti = createJiti(__filename);56```57 58Import (async) and resolve with ESM compatibility:59 60```js61// jiti.import(id) is similar to import(id)62const mod = await jiti.import("./path/to/file.ts");63 64// jiti.esmResolve(id) is similar to import.meta.resolve(id)65const resolvedPath = jiti.esmResolve("./src");66```67 68If you need the default export of module, you can use `jiti.import(id, { default: true })` as shortcut to `mod?.default ?? mod`.69 70```js71// shortcut to mod?.default ?? mod72const modDefault = await jiti.import("./path/to/file.ts", { default: true });73```74 75CommonJS (sync & deprecated):76 77```js78// jiti() is similar to require(id)79const mod = jiti("./path/to/file.ts");80 81// jiti.resolve() is similar to require.resolve(id)82const resolvedPath = jiti.resolve("./src");83```84 85You can also pass options as the second argument:86 87```js88const jiti = createJiti(import.meta.url, { debug: true });89```90 91### Register global ESM loader92 93You can globally register jiti using [global hooks](https://nodejs.org/api/module.html#initialize). (Important: Requires Node.js > 20)94 95```js96import "jiti/register";97```98 99Or:100 101```bash102node --import jiti/register index.ts103```104 105## 🎈 `jiti/native`106 107You can alias `jiti` to `jiti/native` to directly depend on runtime's [`import.meta.resolve`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta/resolve) and dynamic [`import()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import) support. This allows easing up the ecosystem transition to runtime native support by giving the same API of jiti.108 109## ⚙️ Options110 111### `debug`112 113- Type: Boolean114- Default: `false`115- Environment variable: `JITI_DEBUG`116 117Enable verbose logging. You can use `JITI_DEBUG=1 <your command>` to enable it.118 119### `fsCache`120 121- Type: Boolean | String122- Default: `true`123- Environment variable: `JITI_FS_CACHE`124 125Filesystem source cache (enabled by default)126 127By default (when is `true`), jiti uses `node_modules/.cache/jiti` (if exists) or `{TMP_DIR}/jiti`.128 129**Note:** It is recommended that this option be enabled for better performance.130 131### `rebuildFsCache`132 133- Type: Boolean134- Default: `false`135- Environment variable: `JITI_REBUILD_FS_CACHE`136 137Rebuild filesystem source cache created by `fsCache`.138 139### `moduleCache`140 141- Type: String142- Default: `true`143- Environment variable: `JITI_MODULE_CACHE`144 145Runtime module cache (enabled by default).146 147Disabling allows editing code and importing the same module multiple times.148 149When enabled, jiti integrates with Node.js native CommonJS cache-store.150 151### `transform`152 153- Type: Function154- Default: Babel (lazy loaded)155 156Transform function. See [src/babel](./src/babel.ts) for more details157 158### `sourceMaps`159 160- Type: Boolean161- Default `false`162- Environment variable: `JITI_SOURCE_MAPS`163 164Add inline source map to transformed source for better debugging.165 166### `interopDefault`167 168- Type: Boolean169- Default: `true`170- Environment variable: `JITI_INTEROP_DEFAULT`171 172Jiti combines module exports with the `default` export using an internal Proxy to improve compatibility with mixed CJS/ESM usage. You can check the current implementation [here](https://github.com/unjs/jiti/blob/main/src/utils.ts#L105).173 174> [!WARNING]175> This option wraps **all imported modules** in a Proxy, which adds ~25-50ns overhead per property access. For performance-critical hot paths where you access module exports very frequently, consider setting `interopDefault: false` or `JITI_INTEROP_DEFAULT=false`.176 177### `alias`178 179- Type: Object180- Default: -181- Environment variable: `JITI_ALIAS`182 183You can also pass an object to the environment variable for inline config. Example: `JITI_ALIAS='{"~/*": "./src/*"}' jiti ...`.184 185Custom alias map used to resolve IDs.186 187### `tsconfigPaths`188 189- Type: Boolean | String190- Default: `false`191- Environment variable: `JITI_TSCONFIG_PATHS`192 193Enable TypeScript [`paths`](https://www.typescriptlang.org/tsconfig/#paths) resolution using [`get-tsconfig`](https://github.com/privatenumber/get-tsconfig).194 195- `true`: Auto-discover `tsconfig.json` by walking up from the jiti instance's parent path.196- `string`: Explicit path to a `tsconfig.json` file.197- `false` (default): Disabled.198 199### `nativeModules`200 201- Type: Array202- Default: ['typescript']203- Environment variable: `JITI_NATIVE_MODULES`204 205List of modules (within `node_modules`) to always use native `require()` for them.206 207### `transformModules`208 209- Type: Array210- Default: []211- Environment variable: `JITI_TRANSFORM_MODULES`212 213List of modules (within `node_modules`) to transform them regardless of syntax.214 215### `importMeta`216 217Parent module's [`import.meta`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import.meta) context to use for ESM resolution. (only used for `jiti/native` import).218 219### `tryNative`220 221- Type: Boolean222- Default: Enabled if bun is detected223- Environment variable: `JITI_TRY_NATIVE`224 225Try to use native require and import without jiti transformations first.226 227### `jsx`228 229- Type: Boolean | {options}230- Default: `false`231- Environment Variable: `JITI_JSX`232 233Enable JSX support using [`@babel/plugin-transform-react-jsx`](https://babeljs.io/docs/babel-plugin-transform-react-jsx).234 235See [`test/fixtures/jsx`](./test/fixtures/jsx) for framework integration examples.236 237## Development238 239- Clone this repository240- Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable`241- Install dependencies using `pnpm install`242- Run `pnpm dev`243- Run `pnpm jiti ./test/path/to/file.ts`244 245## License246 247<!-- automd:contributors license=MIT author="pi0" -->248 249Published under the [MIT](https://github.com/unjs/jiti/blob/main/LICENSE) license.250Made by [@pi0](https://github.com/pi0) and [community](https://github.com/unjs/jiti/graphs/contributors) 💛251<br><br>252<a href="https://github.com/unjs/jiti/graphs/contributors">253<img src="https://contrib.rocks/image?repo=unjs/jiti" />254</a>255 256<!-- /automd -->257 258<!-- automd:with-automd -->259