@vielzeug/illusionist 2.2.0

package/dist/seed/mulberry32.d.ts

@@ -0,0 +1,12 @@
+import type { RandomSource } from '@vielzeug/arsenal/random';
+/**
+ * Mulberry32 — a fast, deterministic 32-bit PRNG.
+ *
+ * Not cryptographically secure. Use `createSeed()` without a seed for
+ * `crypto.getRandomValues`-backed randomness in security-sensitive contexts.
+ *
+ * @param seed - A 32-bit integer seed.
+ * @returns A {@link RandomSource} producing floats in `[0, 1)`.
+ */
+export declare function mulberry32(seed: number): RandomSource;
+//# sourceMappingURL=mulberry32.d.ts.map

package/dist/seed/mulberry32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.d.ts","sourceRoot":"","sources":["../../src/seed/mulberry32.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAcrD"}

package/dist/seed/mulberry32.js

@@ -0,0 +1,13 @@
+//#region src/seed/mulberry32.ts
+function e(e) {
+	let t = e >>> 0;
+	return { next() {
+		t = t + 1831565813 >>> 0;
+		let e = t;
+		return e = Math.imul(e ^ e >>> 15, e | 1), e ^= e + Math.imul(e ^ e >>> 7, e | 61), ((e ^ e >>> 14) >>> 0) / 4294967296;
+	} };
+}
+//#endregion
+export { e as mulberry32 };
+
+//# sourceMappingURL=mulberry32.js.map

package/dist/seed/mulberry32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.js","names":[],"sources":["../../src/seed/mulberry32.ts"],"sourcesContent":["import type { RandomSource } from '@vielzeug/arsenal/random';\n\n/**\n * Mulberry32 — a fast, deterministic 32-bit PRNG.\n *\n * Not cryptographically secure. Use `createSeed()` without a seed for\n * `crypto.getRandomValues`-backed randomness in security-sensitive contexts.\n *\n * @param seed - A 32-bit integer seed.\n * @returns A {@link RandomSource} producing floats in `[0, 1)`.\n */\nexport function mulberry32(seed: number): RandomSource {\n  let state = seed >>> 0;\n\n  return {\n    next(): number {\n      state = (state + 0x6d2b79f5) >>> 0;\n      let t = state;\n\n      t = Math.imul(t ^ (t >>> 15), t | 1);\n      t ^= t + Math.imul(t ^ (t >>> 7), t | 61);\n\n      return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n    },\n  };\n}\n"],"mappings":";AAWA,SAAgB,EAAW,GAA4B;CACrD,IAAI,IAAQ,MAAS;CAErB,OAAO,EACL,OAAe;EACb,IAAS,IAAQ,eAAgB;EACjC,IAAI,IAAI;EAKR,OAHA,IAAI,KAAK,KAAK,IAAK,MAAM,IAAK,IAAI,CAAC,GACnC,KAAK,IAAI,KAAK,KAAK,IAAK,MAAM,GAAI,IAAI,EAAE,KAE/B,IAAK,MAAM,QAAS,KAAK;CACpC,EACF;AACF"}

package/dist/system/data.cjs

@@ -0,0 +1,2 @@
+var e={cronExpressions:[`0 * * * *`,`0 0 * * *`,`0 0 * * 0`,`*/5 * * * *`,`0 12 * * 1-5`,`0 0 1 * *`,`0 0 1 1 *`,`0 3 * * *`,`30 7 * * 1-5`,`0 18 * * 5`],directories:[`src`,`dist`,`build`,`lib`,`test`,`docs`,`config`,`assets`,`public`,`private`,`tmp`,`cache`,`var`,`opt`,`etc`],fileExtensions:`txt.pdf.doc.docx.xls.xlsx.ppt.pptx.jpg.png.gif.svg.webp.ico.mp3.wav.flac.ogg.mp4.avi.mkv.webm.zip.tar.gz.rar.7z.js.ts.json.xml.html.css.md.py.java.go.rs.c.cpp`.split(`.`),fileNames:[`document`,`report`,`summary`,`notes`,`draft`,`config`,`readme`,`index`,`main`,`app`,`data`,`backup`,`export`,`import`,`log`],mimeTypes:{avi:`video/x-msvideo`,css:`text/css`,gif:`image/gif`,gz:`application/gzip`,html:`text/html`,jpeg:`image/jpeg`,jpg:`image/jpeg`,js:`application/javascript`,json:`application/json`,mp3:`audio/mpeg`,mp4:`video/mp4`,pdf:`application/pdf`,png:`image/png`,svg:`image/svg+xml`,tar:`application/x-tar`,txt:`text/plain`,wav:`audio/wav`,webp:`image/webp`,xml:`application/xml`,zip:`application/zip`}};exports.SYSTEM_DATA=e;
+//# sourceMappingURL=data.cjs.map

package/dist/system/data.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.cjs","names":[],"sources":["../../src/system/data.ts"],"sourcesContent":["export const SYSTEM_DATA = {\n  cronExpressions: [\n    '0 * * * *',\n    '0 0 * * *',\n    '0 0 * * 0',\n    '*/5 * * * *',\n    '0 12 * * 1-5',\n    '0 0 1 * *',\n    '0 0 1 1 *',\n    '0 3 * * *',\n    '30 7 * * 1-5',\n    '0 18 * * 5',\n  ],\n  directories: [\n    'src',\n    'dist',\n    'build',\n    'lib',\n    'test',\n    'docs',\n    'config',\n    'assets',\n    'public',\n    'private',\n    'tmp',\n    'cache',\n    'var',\n    'opt',\n    'etc',\n  ],\n  fileExtensions: [\n    'txt',\n    'pdf',\n    'doc',\n    'docx',\n    'xls',\n    'xlsx',\n    'ppt',\n    'pptx',\n    'jpg',\n    'png',\n    'gif',\n    'svg',\n    'webp',\n    'ico',\n    'mp3',\n    'wav',\n    'flac',\n    'ogg',\n    'mp4',\n    'avi',\n    'mkv',\n    'webm',\n    'zip',\n    'tar',\n    'gz',\n    'rar',\n    '7z',\n    'js',\n    'ts',\n    'json',\n    'xml',\n    'html',\n    'css',\n    'md',\n    'py',\n    'java',\n    'go',\n    'rs',\n    'c',\n    'cpp',\n  ],\n  fileNames: [\n    'document',\n    'report',\n    'summary',\n    'notes',\n    'draft',\n    'config',\n    'readme',\n    'index',\n    'main',\n    'app',\n    'data',\n    'backup',\n    'export',\n    'import',\n    'log',\n  ],\n  mimeTypes: {\n    avi: 'video/x-msvideo',\n    css: 'text/css',\n    gif: 'image/gif',\n    gz: 'application/gzip',\n    html: 'text/html',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    js: 'application/javascript',\n    json: 'application/json',\n    mp3: 'audio/mpeg',\n    mp4: 'video/mp4',\n    pdf: 'application/pdf',\n    png: 'image/png',\n    svg: 'image/svg+xml',\n    tar: 'application/x-tar',\n    txt: 'text/plain',\n    wav: 'audio/wav',\n    webp: 'image/webp',\n    xml: 'application/xml',\n    zip: 'application/zip',\n  },\n} as const;\n"],"mappings":"AAAA,IAAa,EAAc,CACzB,gBAAiB,CACf,YACA,YACA,YACA,cACA,eACA,YACA,YACA,YACA,eACA,YACF,EACA,YAAa,CACX,MACA,OACA,QACA,MACA,OACA,OACA,SACA,SACA,SACA,UACA,MACA,QACA,MACA,MACA,KACF,EACA,eAAgB,0KAyChB,EACA,UAAW,CACT,WACA,SACA,UACA,QACA,QACA,SACA,SACA,QACA,OACA,MACA,OACA,SACA,SACA,SACA,KACF,EACA,UAAW,CACT,IAAK,kBACL,IAAK,WACL,IAAK,YACL,GAAI,mBACJ,KAAM,YACN,KAAM,aACN,IAAK,aACL,GAAI,yBACJ,KAAM,mBACN,IAAK,aACL,IAAK,YACL,IAAK,kBACL,IAAK,YACL,IAAK,gBACL,IAAK,oBACL,IAAK,aACL,IAAK,YACL,KAAM,aACN,IAAK,kBACL,IAAK,iBACP,CACF"}

package/dist/system/data.d.ts

@@ -0,0 +1,29 @@
+export declare const SYSTEM_DATA: {
+    readonly cronExpressions: readonly ["0 * * * *", "0 0 * * *", "0 0 * * 0", "*/5 * * * *", "0 12 * * 1-5", "0 0 1 * *", "0 0 1 1 *", "0 3 * * *", "30 7 * * 1-5", "0 18 * * 5"];
+    readonly directories: readonly ["src", "dist", "build", "lib", "test", "docs", "config", "assets", "public", "private", "tmp", "cache", "var", "opt", "etc"];
+    readonly fileExtensions: readonly ["txt", "pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "jpg", "png", "gif", "svg", "webp", "ico", "mp3", "wav", "flac", "ogg", "mp4", "avi", "mkv", "webm", "zip", "tar", "gz", "rar", "7z", "js", "ts", "json", "xml", "html", "css", "md", "py", "java", "go", "rs", "c", "cpp"];
+    readonly fileNames: readonly ["document", "report", "summary", "notes", "draft", "config", "readme", "index", "main", "app", "data", "backup", "export", "import", "log"];
+    readonly mimeTypes: {
+        readonly avi: "video/x-msvideo";
+        readonly css: "text/css";
+        readonly gif: "image/gif";
+        readonly gz: "application/gzip";
+        readonly html: "text/html";
+        readonly jpeg: "image/jpeg";
+        readonly jpg: "image/jpeg";
+        readonly js: "application/javascript";
+        readonly json: "application/json";
+        readonly mp3: "audio/mpeg";
+        readonly mp4: "video/mp4";
+        readonly pdf: "application/pdf";
+        readonly png: "image/png";
+        readonly svg: "image/svg+xml";
+        readonly tar: "application/x-tar";
+        readonly txt: "text/plain";
+        readonly wav: "audio/wav";
+        readonly webp: "image/webp";
+        readonly xml: "application/xml";
+        readonly zip: "application/zip";
+    };
+};
+//# sourceMappingURL=data.d.ts.map

package/dist/system/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/system/data.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Gd,CAAC"}

package/dist/system/data.js

@@ -0,0 +1,76 @@
+//#region src/system/data.ts
+var e = {
+	cronExpressions: [
+		"0 * * * *",
+		"0 0 * * *",
+		"0 0 * * 0",
+		"*/5 * * * *",
+		"0 12 * * 1-5",
+		"0 0 1 * *",
+		"0 0 1 1 *",
+		"0 3 * * *",
+		"30 7 * * 1-5",
+		"0 18 * * 5"
+	],
+	directories: [
+		"src",
+		"dist",
+		"build",
+		"lib",
+		"test",
+		"docs",
+		"config",
+		"assets",
+		"public",
+		"private",
+		"tmp",
+		"cache",
+		"var",
+		"opt",
+		"etc"
+	],
+	fileExtensions: /* @__PURE__ */ "txt.pdf.doc.docx.xls.xlsx.ppt.pptx.jpg.png.gif.svg.webp.ico.mp3.wav.flac.ogg.mp4.avi.mkv.webm.zip.tar.gz.rar.7z.js.ts.json.xml.html.css.md.py.java.go.rs.c.cpp".split("."),
+	fileNames: [
+		"document",
+		"report",
+		"summary",
+		"notes",
+		"draft",
+		"config",
+		"readme",
+		"index",
+		"main",
+		"app",
+		"data",
+		"backup",
+		"export",
+		"import",
+		"log"
+	],
+	mimeTypes: {
+		avi: "video/x-msvideo",
+		css: "text/css",
+		gif: "image/gif",
+		gz: "application/gzip",
+		html: "text/html",
+		jpeg: "image/jpeg",
+		jpg: "image/jpeg",
+		js: "application/javascript",
+		json: "application/json",
+		mp3: "audio/mpeg",
+		mp4: "video/mp4",
+		pdf: "application/pdf",
+		png: "image/png",
+		svg: "image/svg+xml",
+		tar: "application/x-tar",
+		txt: "text/plain",
+		wav: "audio/wav",
+		webp: "image/webp",
+		xml: "application/xml",
+		zip: "application/zip"
+	}
+};
+//#endregion
+export { e as SYSTEM_DATA };
+
+//# sourceMappingURL=data.js.map

package/dist/system/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","names":[],"sources":["../../src/system/data.ts"],"sourcesContent":["export const SYSTEM_DATA = {\n  cronExpressions: [\n    '0 * * * *',\n    '0 0 * * *',\n    '0 0 * * 0',\n    '*/5 * * * *',\n    '0 12 * * 1-5',\n    '0 0 1 * *',\n    '0 0 1 1 *',\n    '0 3 * * *',\n    '30 7 * * 1-5',\n    '0 18 * * 5',\n  ],\n  directories: [\n    'src',\n    'dist',\n    'build',\n    'lib',\n    'test',\n    'docs',\n    'config',\n    'assets',\n    'public',\n    'private',\n    'tmp',\n    'cache',\n    'var',\n    'opt',\n    'etc',\n  ],\n  fileExtensions: [\n    'txt',\n    'pdf',\n    'doc',\n    'docx',\n    'xls',\n    'xlsx',\n    'ppt',\n    'pptx',\n    'jpg',\n    'png',\n    'gif',\n    'svg',\n    'webp',\n    'ico',\n    'mp3',\n    'wav',\n    'flac',\n    'ogg',\n    'mp4',\n    'avi',\n    'mkv',\n    'webm',\n    'zip',\n    'tar',\n    'gz',\n    'rar',\n    '7z',\n    'js',\n    'ts',\n    'json',\n    'xml',\n    'html',\n    'css',\n    'md',\n    'py',\n    'java',\n    'go',\n    'rs',\n    'c',\n    'cpp',\n  ],\n  fileNames: [\n    'document',\n    'report',\n    'summary',\n    'notes',\n    'draft',\n    'config',\n    'readme',\n    'index',\n    'main',\n    'app',\n    'data',\n    'backup',\n    'export',\n    'import',\n    'log',\n  ],\n  mimeTypes: {\n    avi: 'video/x-msvideo',\n    css: 'text/css',\n    gif: 'image/gif',\n    gz: 'application/gzip',\n    html: 'text/html',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    js: 'application/javascript',\n    json: 'application/json',\n    mp3: 'audio/mpeg',\n    mp4: 'video/mp4',\n    pdf: 'application/pdf',\n    png: 'image/png',\n    svg: 'image/svg+xml',\n    tar: 'application/x-tar',\n    txt: 'text/plain',\n    wav: 'audio/wav',\n    webp: 'image/webp',\n    xml: 'application/xml',\n    zip: 'application/zip',\n  },\n} as const;\n"],"mappings":";AAAA,IAAa,IAAc;CACzB,iBAAiB;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,aAAa;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,gBAAgB,0LAyChB;CACA,WAAW;EACT;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,WAAW;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,IAAI;EACJ,MAAM;EACN,MAAM;EACN,KAAK;EACL,IAAI;EACJ,MAAM;EACN,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,MAAM;EACN,KAAK;EACL,KAAK;CACP;AACF"}

package/dist/system/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./system.cjs");exports.cron=e.cron,exports.fileExtension=e.fileExtension,exports.fileName=e.fileName,exports.filePath=e.filePath,exports.mimeType=e.mimeType,exports.port=e.port,exports.process=e.process,exports.semver=e.semver,exports.uuid=e.uuid;

package/dist/system/index.d.ts

@@ -0,0 +1,2 @@
+export * from './system';
+//# sourceMappingURL=index.d.ts.map

package/dist/system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/system/index.js

@@ -0,0 +1,2 @@
+import { cron as e, fileExtension as t, fileName as n, filePath as r, mimeType as i, port as a, process as o, semver as s, uuid as c } from "./system.js";
+export { e as cron, t as fileExtension, n as fileName, r as filePath, i as mimeType, a as port, o as process, s as semver, c as uuid };

package/dist/system/system.cjs

@@ -0,0 +1,2 @@
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../_helpers/int.cjs"),n=require("../_helpers/string.cjs"),r=require("./data.cjs");let i=require("@vielzeug/arsenal/random");var a=e.__exportAll({cron:()=>p,fileExtension:()=>o,fileName:()=>s,filePath:()=>c,mimeType:()=>l,port:()=>f,process:()=>m,semver:()=>u,uuid:()=>d});function o(e){return n.pick(r.SYSTEM_DATA.fileExtensions,e.source)}function s(e){return`${n.pick(r.SYSTEM_DATA.fileNames,e.source)}.${o(e)}`}function c(e){let i=t.int(1,4,e.source),a=[];for(let t=0;t<i;t++)a.push(n.pick(r.SYSTEM_DATA.directories,e.source));return`${a.join(`/`)}/${s(e)}`}function l(e){let t=Object.values(r.SYSTEM_DATA.mimeTypes);return n.pick(t,e.source)}function u(e,r){let i=r?.maxMajor??20,a=`${t.int(0,i,e.source)}.${t.int(0,20,e.source)}.${t.int(0,99,e.source)}`;if(r?.includePrerelease&&e.source.next()<.3){let r=n.pick([`alpha`,`beta`,`rc`,`next`],e.source),i=t.int(1,10,e.source);a+=`-${r}.${i}`}return a}function d(){return(0,i.uuid)()}function f(e,n){let r=n?.min??1024,i=n?.max??65535;return t.int(r,i,e.source)}function p(e){return n.pick(r.SYSTEM_DATA.cronExpressions,e.source)}function m(e){return`${n.pick([`node`,`python`,`ruby`,`java`,`go`,`rust`,`bash`],e.source)}_${n.alphanumeric(t.int(3,8,e.source),e.source)}`}exports.cron=p,exports.fileExtension=o,exports.fileName=s,exports.filePath=c,exports.mimeType=l,exports.port=f,exports.process=m,exports.semver=u,Object.defineProperty(exports,"system_exports",{enumerable:!0,get:function(){return a}}),exports.uuid=d;
+//# sourceMappingURL=system.cjs.map

package/dist/system/system.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.cjs","names":[],"sources":["../../src/system/system.ts"],"sourcesContent":["import { uuid as cryptoUuid } from '@vielzeug/arsenal/random';\n\nimport { int } from '../_helpers/int';\nimport { alphanumeric, pick } from '../_helpers/string';\nimport type { IllusionistContext } from '../types';\nimport { SYSTEM_DATA } from './data';\n\n/** Generates a random file extension from common types. */\nexport function fileExtension(ctx: IllusionistContext): string {\n  return pick(SYSTEM_DATA.fileExtensions, ctx.source)!;\n}\n\n/** Generates a random file name with extension. */\nexport function fileName(ctx: IllusionistContext): string {\n  const base = pick(SYSTEM_DATA.fileNames, ctx.source)!;\n  const ext = fileExtension(ctx);\n\n  return `${base}.${ext}`;\n}\n\n/** Generates a random file path with 1-4 directory segments and a file name. */\nexport function filePath(ctx: IllusionistContext): string {\n  const segments = int(1, 4, ctx.source);\n  const dirs: string[] = [];\n\n  for (let i = 0; i < segments; i++) {\n    dirs.push(pick(SYSTEM_DATA.directories, ctx.source)!);\n  }\n\n  return `${dirs.join('/')}/${fileName(ctx)}`;\n}\n\n/** Returns a random MIME type string. */\nexport function mimeType(ctx: IllusionistContext): string {\n  const types = Object.values(SYSTEM_DATA.mimeTypes);\n\n  return pick(types, ctx.source)!;\n}\n\n/** Generates a random semver version string. */\nexport function semver(ctx: IllusionistContext, options?: { maxMajor?: number; includePrerelease?: boolean }): string {\n  const maxMajor = options?.maxMajor ?? 20;\n  const major = int(0, maxMajor, ctx.source);\n  const minor = int(0, 20, ctx.source);\n  const patch = int(0, 99, ctx.source);\n\n  let version = `${major}.${minor}.${patch}`;\n\n  if (options?.includePrerelease && ctx.source.next() < 0.3) {\n    const labels = ['alpha', 'beta', 'rc', 'next'];\n    const label = pick(labels, ctx.source)!;\n    const num = int(1, 10, ctx.source);\n\n    version += `-${label}.${num}`;\n  }\n\n  return version;\n}\n\n/**\n * Generates a random UUID via `crypto.randomUUID()`.\n *\n * **Not deterministic** — ignores the seeded `RandomSource` and always uses\n * cryptographic randomness. Use this for unique identifiers where\n * unpredictability matters more than reproducibility.\n */\nexport function uuid(): string {\n  return cryptoUuid();\n}\n\n/** Generates a random port number (1-65535, avoiding well-known ports below 1024 by default). */\nexport function port(ctx: IllusionistContext, options?: { min?: number; max?: number }): number {\n  const min = options?.min ?? 1024;\n  const max = options?.max ?? 65535;\n\n  return int(min, max, ctx.source);\n}\n\n/** Returns a random cron expression from common patterns. */\nexport function cron(ctx: IllusionistContext): string {\n  return pick(SYSTEM_DATA.cronExpressions, ctx.source)!;\n}\n\n/** Generates a random process name. */\nexport function process(ctx: IllusionistContext): string {\n  const prefixes = ['node', 'python', 'ruby', 'java', 'go', 'rust', 'bash'];\n  const prefix = pick(prefixes, ctx.source)!;\n  const suffix = alphanumeric(int(3, 8, ctx.source), ctx.source);\n\n  return `${prefix}_${suffix}`;\n}\n"],"mappings":"gVAQA,SAAgB,EAAc,EAAiC,CAC7D,OAAO,EAAA,KAAK,EAAA,YAAY,eAAgB,EAAI,MAAM,CACpD,CAGA,SAAgB,EAAS,EAAiC,CAIxD,MAAO,GAHM,EAAA,KAAK,EAAA,YAAY,UAAW,EAAI,MAGnC,EAAK,GAFH,EAAc,CAER,GACpB,CAGA,SAAgB,EAAS,EAAiC,CACxD,IAAM,EAAW,EAAA,IAAI,EAAG,EAAG,EAAI,MAAM,EAC/B,EAAiB,CAAC,EAExB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAU,IAC5B,EAAK,KAAK,EAAA,KAAK,EAAA,YAAY,YAAa,EAAI,MAAM,CAAE,EAGtD,MAAO,GAAG,EAAK,KAAK,GAAG,EAAE,GAAG,EAAS,CAAG,GAC1C,CAGA,SAAgB,EAAS,EAAiC,CACxD,IAAM,EAAQ,OAAO,OAAO,EAAA,YAAY,SAAS,EAEjD,OAAO,EAAA,KAAK,EAAO,EAAI,MAAM,CAC/B,CAGA,SAAgB,EAAO,EAAyB,EAAsE,CACpH,IAAM,EAAW,GAAS,UAAY,GAKlC,EAAU,GAJA,EAAA,IAAI,EAAG,EAAU,EAAI,MAIlB,EAAM,GAHT,EAAA,IAAI,EAAG,GAAI,EAAI,MAGH,EAAM,GAFlB,EAAA,IAAI,EAAG,GAAI,EAAI,MAEM,IAEnC,GAAI,GAAS,mBAAqB,EAAI,OAAO,KAAK,EAAI,GAAK,CAEzD,IAAM,EAAQ,EAAA,KAAK,CADH,QAAS,OAAQ,KAAM,MACpB,EAAQ,EAAI,MAAM,EAC/B,EAAM,EAAA,IAAI,EAAG,GAAI,EAAI,MAAM,EAEjC,GAAW,IAAI,EAAM,GAAG,GAC1B,CAEA,OAAO,CACT,CASA,SAAgB,GAAe,CAC7B,OAAA,EAAO,EAAA,KAAA,CAAW,CACpB,CAGA,SAAgB,EAAK,EAAyB,EAAkD,CAC9F,IAAM,EAAM,GAAS,KAAO,KACtB,EAAM,GAAS,KAAO,MAE5B,OAAO,EAAA,IAAI,EAAK,EAAK,EAAI,MAAM,CACjC,CAGA,SAAgB,EAAK,EAAiC,CACpD,OAAO,EAAA,KAAK,EAAA,YAAY,gBAAiB,EAAI,MAAM,CACrD,CAGA,SAAgB,EAAQ,EAAiC,CAKvD,MAAO,GAHQ,EAAA,KAAK,CADF,OAAQ,SAAU,OAAQ,OAAQ,KAAM,OAAQ,MAC9C,EAAU,EAAI,MAGxB,EAAO,GAFF,EAAA,aAAa,EAAA,IAAI,EAAG,EAAG,EAAI,MAAM,EAAG,EAAI,MAEnC,GACtB"}

package/dist/system/system.d.ts

@@ -0,0 +1,32 @@
+import type { IllusionistContext } from '../types';
+/** Generates a random file extension from common types. */
+export declare function fileExtension(ctx: IllusionistContext): string;
+/** Generates a random file name with extension. */
+export declare function fileName(ctx: IllusionistContext): string;
+/** Generates a random file path with 1-4 directory segments and a file name. */
+export declare function filePath(ctx: IllusionistContext): string;
+/** Returns a random MIME type string. */
+export declare function mimeType(ctx: IllusionistContext): string;
+/** Generates a random semver version string. */
+export declare function semver(ctx: IllusionistContext, options?: {
+    maxMajor?: number;
+    includePrerelease?: boolean;
+}): string;
+/**
+ * Generates a random UUID via `crypto.randomUUID()`.
+ *
+ * **Not deterministic** — ignores the seeded `RandomSource` and always uses
+ * cryptographic randomness. Use this for unique identifiers where
+ * unpredictability matters more than reproducibility.
+ */
+export declare function uuid(): string;
+/** Generates a random port number (1-65535, avoiding well-known ports below 1024 by default). */
+export declare function port(ctx: IllusionistContext, options?: {
+    min?: number;
+    max?: number;
+}): number;
+/** Returns a random cron expression from common patterns. */
+export declare function cron(ctx: IllusionistContext): string;
+/** Generates a random process name. */
+export declare function process(ctx: IllusionistContext): string;
+//# sourceMappingURL=system.d.ts.map

package/dist/system/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/system/system.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAE7D;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAKxD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CASxD;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAIxD;AAED,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAiBpH;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,iGAAiG;AACjG,wBAAgB,IAAI,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK9F;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAEpD;AAED,uCAAuC;AACvC,wBAAgB,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAMvD"}

package/dist/system/system.js

@@ -0,0 +1,70 @@
+import { __exportAll as e } from "../_virtual/_rolldown/runtime.js";
+import { int as t } from "../_helpers/int.js";
+import { alphanumeric as n, pick as r } from "../_helpers/string.js";
+import { SYSTEM_DATA as i } from "./data.js";
+import { uuid as a } from "@vielzeug/arsenal/random";
+//#region src/system/system.ts
+var o = /* @__PURE__ */ e({
+	cron: () => m,
+	fileExtension: () => s,
+	fileName: () => c,
+	filePath: () => l,
+	mimeType: () => u,
+	port: () => p,
+	process: () => h,
+	semver: () => d,
+	uuid: () => f
+});
+function s(e) {
+	return r(i.fileExtensions, e.source);
+}
+function c(e) {
+	return `${r(i.fileNames, e.source)}.${s(e)}`;
+}
+function l(e) {
+	let n = t(1, 4, e.source), a = [];
+	for (let t = 0; t < n; t++) a.push(r(i.directories, e.source));
+	return `${a.join("/")}/${c(e)}`;
+}
+function u(e) {
+	let t = Object.values(i.mimeTypes);
+	return r(t, e.source);
+}
+function d(e, n) {
+	let i = n?.maxMajor ?? 20, a = `${t(0, i, e.source)}.${t(0, 20, e.source)}.${t(0, 99, e.source)}`;
+	if (n?.includePrerelease && e.source.next() < .3) {
+		let n = r([
+			"alpha",
+			"beta",
+			"rc",
+			"next"
+		], e.source), i = t(1, 10, e.source);
+		a += `-${n}.${i}`;
+	}
+	return a;
+}
+function f() {
+	return a();
+}
+function p(e, n) {
+	let r = n?.min ?? 1024, i = n?.max ?? 65535;
+	return t(r, i, e.source);
+}
+function m(e) {
+	return r(i.cronExpressions, e.source);
+}
+function h(e) {
+	return `${r([
+		"node",
+		"python",
+		"ruby",
+		"java",
+		"go",
+		"rust",
+		"bash"
+	], e.source)}_${n(t(3, 8, e.source), e.source)}`;
+}
+//#endregion
+export { m as cron, s as fileExtension, c as fileName, l as filePath, u as mimeType, p as port, h as process, d as semver, o as system_exports, f as uuid };
+
+//# sourceMappingURL=system.js.map

package/dist/system/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","names":[],"sources":["../../src/system/system.ts"],"sourcesContent":["import { uuid as cryptoUuid } from '@vielzeug/arsenal/random';\n\nimport { int } from '../_helpers/int';\nimport { alphanumeric, pick } from '../_helpers/string';\nimport type { IllusionistContext } from '../types';\nimport { SYSTEM_DATA } from './data';\n\n/** Generates a random file extension from common types. */\nexport function fileExtension(ctx: IllusionistContext): string {\n  return pick(SYSTEM_DATA.fileExtensions, ctx.source)!;\n}\n\n/** Generates a random file name with extension. */\nexport function fileName(ctx: IllusionistContext): string {\n  const base = pick(SYSTEM_DATA.fileNames, ctx.source)!;\n  const ext = fileExtension(ctx);\n\n  return `${base}.${ext}`;\n}\n\n/** Generates a random file path with 1-4 directory segments and a file name. */\nexport function filePath(ctx: IllusionistContext): string {\n  const segments = int(1, 4, ctx.source);\n  const dirs: string[] = [];\n\n  for (let i = 0; i < segments; i++) {\n    dirs.push(pick(SYSTEM_DATA.directories, ctx.source)!);\n  }\n\n  return `${dirs.join('/')}/${fileName(ctx)}`;\n}\n\n/** Returns a random MIME type string. */\nexport function mimeType(ctx: IllusionistContext): string {\n  const types = Object.values(SYSTEM_DATA.mimeTypes);\n\n  return pick(types, ctx.source)!;\n}\n\n/** Generates a random semver version string. */\nexport function semver(ctx: IllusionistContext, options?: { maxMajor?: number; includePrerelease?: boolean }): string {\n  const maxMajor = options?.maxMajor ?? 20;\n  const major = int(0, maxMajor, ctx.source);\n  const minor = int(0, 20, ctx.source);\n  const patch = int(0, 99, ctx.source);\n\n  let version = `${major}.${minor}.${patch}`;\n\n  if (options?.includePrerelease && ctx.source.next() < 0.3) {\n    const labels = ['alpha', 'beta', 'rc', 'next'];\n    const label = pick(labels, ctx.source)!;\n    const num = int(1, 10, ctx.source);\n\n    version += `-${label}.${num}`;\n  }\n\n  return version;\n}\n\n/**\n * Generates a random UUID via `crypto.randomUUID()`.\n *\n * **Not deterministic** — ignores the seeded `RandomSource` and always uses\n * cryptographic randomness. Use this for unique identifiers where\n * unpredictability matters more than reproducibility.\n */\nexport function uuid(): string {\n  return cryptoUuid();\n}\n\n/** Generates a random port number (1-65535, avoiding well-known ports below 1024 by default). */\nexport function port(ctx: IllusionistContext, options?: { min?: number; max?: number }): number {\n  const min = options?.min ?? 1024;\n  const max = options?.max ?? 65535;\n\n  return int(min, max, ctx.source);\n}\n\n/** Returns a random cron expression from common patterns. */\nexport function cron(ctx: IllusionistContext): string {\n  return pick(SYSTEM_DATA.cronExpressions, ctx.source)!;\n}\n\n/** Generates a random process name. */\nexport function process(ctx: IllusionistContext): string {\n  const prefixes = ['node', 'python', 'ruby', 'java', 'go', 'rust', 'bash'];\n  const prefix = pick(prefixes, ctx.source)!;\n  const suffix = alphanumeric(int(3, 8, ctx.source), ctx.source);\n\n  return `${prefix}_${suffix}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAQA,SAAgB,EAAc,GAAiC;CAC7D,OAAO,EAAK,EAAY,gBAAgB,EAAI,MAAM;AACpD;AAGA,SAAgB,EAAS,GAAiC;CAIxD,OAAO,GAHM,EAAK,EAAY,WAAW,EAAI,MAGnC,EAAK,GAFH,EAAc,CAER;AACpB;AAGA,SAAgB,EAAS,GAAiC;CACxD,IAAM,IAAW,EAAI,GAAG,GAAG,EAAI,MAAM,GAC/B,IAAiB,CAAC;CAExB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAU,KAC5B,EAAK,KAAK,EAAK,EAAY,aAAa,EAAI,MAAM,CAAE;CAGtD,OAAO,GAAG,EAAK,KAAK,GAAG,EAAE,GAAG,EAAS,CAAG;AAC1C;AAGA,SAAgB,EAAS,GAAiC;CACxD,IAAM,IAAQ,OAAO,OAAO,EAAY,SAAS;CAEjD,OAAO,EAAK,GAAO,EAAI,MAAM;AAC/B;AAGA,SAAgB,EAAO,GAAyB,GAAsE;CACpH,IAAM,IAAW,GAAS,YAAY,IAKlC,IAAU,GAJA,EAAI,GAAG,GAAU,EAAI,MAIlB,EAAM,GAHT,EAAI,GAAG,IAAI,EAAI,MAGH,EAAM,GAFlB,EAAI,GAAG,IAAI,EAAI,MAEM;CAEnC,IAAI,GAAS,qBAAqB,EAAI,OAAO,KAAK,IAAI,IAAK;EAEzD,IAAM,IAAQ,EAAK;GADH;GAAS;GAAQ;GAAM;EACpB,GAAQ,EAAI,MAAM,GAC/B,IAAM,EAAI,GAAG,IAAI,EAAI,MAAM;EAEjC,KAAW,IAAI,EAAM,GAAG;CAC1B;CAEA,OAAO;AACT;AASA,SAAgB,IAAe;CAC7B,OAAO,EAAW;AACpB;AAGA,SAAgB,EAAK,GAAyB,GAAkD;CAC9F,IAAM,IAAM,GAAS,OAAO,MACtB,IAAM,GAAS,OAAO;CAE5B,OAAO,EAAI,GAAK,GAAK,EAAI,MAAM;AACjC;AAGA,SAAgB,EAAK,GAAiC;CACpD,OAAO,EAAK,EAAY,iBAAiB,EAAI,MAAM;AACrD;AAGA,SAAgB,EAAQ,GAAiC;CAKvD,OAAO,GAHQ,EAAK;EADF;EAAQ;EAAU;EAAQ;EAAQ;EAAM;EAAQ;CAC9C,GAAU,EAAI,MAGxB,EAAO,GAFF,EAAa,EAAI,GAAG,GAAG,EAAI,MAAM,GAAG,EAAI,MAEnC;AACtB"}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+import type { RandomSource } from '@vielzeug/arsenal/random';
+/** Locale-specific data used by the person category. */
+export type PersonLocaleData = {
+    readonly firstNameFemale: readonly string[];
+    readonly firstNameMale: readonly string[];
+    readonly gender: readonly string[];
+    readonly jobAreas: readonly string[];
+    readonly jobTypes: readonly string[];
+    readonly lastName: readonly string[];
+    readonly prefix: readonly string[];
+    readonly suffix: readonly string[];
+};
+/** Locale-specific data used by the location category. */
+export type LocationLocaleData = {
+    readonly cities: readonly string[];
+    readonly countries: readonly string[];
+    readonly states: readonly string[];
+    readonly streets: readonly string[];
+    readonly zipPattern: string;
+};
+/** Explicit locale data supplied to {@link createIllusion}. */
+export type IllusionistLocale = {
+    readonly code: string;
+    readonly person: PersonLocaleData;
+    readonly location: LocationLocaleData;
+};
+/** Options for {@link createIllusion}. */
+export type IllusionistOptions = {
+    /** Numeric or string seed for deterministic output. Omit for cryptographic randomness. */
+    seed?: number | string;
+    /** Locale data for locale-aware categories. */
+    locale: IllusionistLocale;
+};
+/** Internal context passed to every category factory. */
+export type IllusionistContext = {
+    readonly source: RandomSource;
+    readonly locale: IllusionistLocale;
+};
+/** Re-exported from arsenal for consumer convenience. */
+export type { RandomSource } from '@vielzeug/arsenal/random';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,+CAA+C;IAC/C,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF,yDAAyD;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -0,0 +1,155 @@
+{
+  "name": "@vielzeug/illusionist",
+  "version": "2.2.0",
+  "description": "Typed, deterministic, locale-aware fake data generator with seeded PRNG",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/helmuthdu/vielzeug",
+    "directory": "packages/illusionist"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./commerce": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js",
+      "require": "./dist/commerce/index.cjs"
+    },
+    "./date": {
+      "types": "./dist/date/index.d.ts",
+      "import": "./dist/date/index.js",
+      "require": "./dist/date/index.cjs"
+    },
+    "./finance": {
+      "types": "./dist/finance/index.d.ts",
+      "import": "./dist/finance/index.js",
+      "require": "./dist/finance/index.cjs"
+    },
+    "./internet": {
+      "types": "./dist/internet/index.d.ts",
+      "import": "./dist/internet/index.js",
+      "require": "./dist/internet/index.cjs"
+    },
+    "./location": {
+      "types": "./dist/location/index.d.ts",
+      "import": "./dist/location/index.js",
+      "require": "./dist/location/index.cjs"
+    },
+    "./lorem": {
+      "types": "./dist/lorem/index.d.ts",
+      "import": "./dist/lorem/index.js",
+      "require": "./dist/lorem/index.cjs"
+    },
+    "./person": {
+      "types": "./dist/person/index.d.ts",
+      "import": "./dist/person/index.js",
+      "require": "./dist/person/index.cjs"
+    },
+    "./seed": {
+      "types": "./dist/seed/index.d.ts",
+      "import": "./dist/seed/index.js",
+      "require": "./dist/seed/index.cjs"
+    },
+    "./system": {
+      "types": "./dist/system/index.d.ts",
+      "import": "./dist/system/index.js",
+      "require": "./dist/system/index.cjs"
+    },
+    "./locales": {
+      "types": "./dist/locales/index.d.ts",
+      "import": "./dist/locales/index.js",
+      "require": "./dist/locales/index.cjs"
+    },
+    "./locales/de": {
+      "types": "./dist/locales/de.d.ts",
+      "import": "./dist/locales/de.js",
+      "require": "./dist/locales/de.cjs"
+    },
+    "./locales/en": {
+      "types": "./dist/locales/en.d.ts",
+      "import": "./dist/locales/en.js",
+      "require": "./dist/locales/en.cjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "commerce": [
+        "dist/commerce/index.d.ts"
+      ],
+      "date": [
+        "dist/date/index.d.ts"
+      ],
+      "finance": [
+        "dist/finance/index.d.ts"
+      ],
+      "internet": [
+        "dist/internet/index.d.ts"
+      ],
+      "location": [
+        "dist/location/index.d.ts"
+      ],
+      "lorem": [
+        "dist/lorem/index.d.ts"
+      ],
+      "person": [
+        "dist/person/index.d.ts"
+      ],
+      "seed": [
+        "dist/seed/index.d.ts"
+      ],
+      "system": [
+        "dist/system/index.d.ts"
+      ],
+      "locales": [
+        "dist/locales/index.d.ts"
+      ],
+      "locales/de": [
+        "dist/locales/de.d.ts"
+      ],
+      "locales/en": [
+        "dist/locales/en.d.ts"
+      ]
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "pnpm run verify:exports && vite build && pnpm run build:bundle && pnpm run build:types",
+    "build:bundle": "vite build --config vite.bundle.config.ts",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "fix": "biome check --write src",
+    "lint": "biome ci src",
+    "prepublishOnly": "pnpm run build",
+    "preview": "vite preview",
+    "sync:exports": "node ./scripts/sync-exports.mjs",
+    "test": "pnpm run verify:exports && vitest",
+    "verify:exports": "node ./scripts/sync-exports.mjs --check"
+  },
+  "dependencies": {
+    "@vielzeug/arsenal": "2.1.0",
+    "@vielzeug/coins": "2.1.0",
+    "@vielzeug/tempo": "2.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.2.1",
+    "vitest": "^4.1.10"
+  }
+}