@clerc/parser 1.1.0 → 1.1.1

package/dist/index.mjs

@@ -1,302 +1 @@
-import { camelCase, looseIsArray, resolveValue } from "@clerc/utils";
-
-//#region src/errors.ts
-var InvalidSchemaError = class extends Error {
-	constructor(message) {
-		super(`Invalid schema: ${message}`);
-		this.name = "InvalidSchemaError";
-	}
-};
-
-//#endregion
-//#region src/iterator.ts
-const KNOWN_FLAG = "known-flag";
-const UNKNOWN_FLAG = "unknown-flag";
-const PARAMETER = "parameter";
-function iterateArgs(args, result, shouldProcessAsFlag, isKnownFlag, ignore, callback) {
-	let index = 0;
-	let stopped = false;
-	const argsLength = args.length;
-	const iterator = {
-		current: "",
-		index: 0,
-		hasNext: false,
-		next: "",
-		shouldIgnore: (arg) => {
-			if (ignore) return ignore(shouldProcessAsFlag(arg) ? isKnownFlag(arg) ? KNOWN_FLAG : UNKNOWN_FLAG : PARAMETER, arg);
-			return false;
-		},
-		eat: () => {
-			if (index + 1 >= argsLength) return;
-			const nextArg = args[index + 1];
-			if (iterator.shouldIgnore(nextArg)) {
-				iterator.exit();
-				return;
-			}
-			index++;
-			next();
-			return args[index];
-		},
-		exit: (push = true) => {
-			if (!stopped) {
-				if (push) result.ignored.push(...args.slice(index + 1));
-				stopped = true;
-			}
-		}
-	};
-	function next() {
-		iterator.current = args[index];
-		iterator.index = index;
-		iterator.hasNext = index + 1 < argsLength;
-		iterator.next = iterator.hasNext ? args[index + 1] : "";
-	}
-	for (index = 0; index < argsLength; index++) {
-		if (stopped) break;
-		next();
-		callback(iterator);
-	}
-}
-
-//#endregion
-//#region src/config.ts
-const defaultParserOptions = { delimiters: ["=", ":"] };
-const resolveParserOptions = (options = {}) => ({
-	...defaultParserOptions,
-	...options
-});
-const normalizeConfig = (config) => typeof config === "function" || looseIsArray(config) ? { type: config } : config;
-const BUILDTIN_DELIMITERS_RE = /[\s.]/;
-function buildConfigsAndAliases(delimiters, flags) {
-	const configs = /* @__PURE__ */ new Map();
-	const aliases = /* @__PURE__ */ new Map();
-	const isNameInvalid = (name) => delimiters.some((char) => name.includes(char)) || BUILDTIN_DELIMITERS_RE.test(name);
-	function validateFlagOptions(name, options) {
-		const prefix = `Flag "${name}"`;
-		if (Array.isArray(options.type) && options.type.length > 1) throw new InvalidSchemaError(`${prefix} has an invalid type array. Only single-element arrays are allowed to denote multiple occurrences.`);
-		if (name.length < 2) throw new InvalidSchemaError(`${prefix} name must be at least 2 characters long.`);
-		const names = [name];
-		if (options.short) {
-			if (options.short.length !== 1) throw new InvalidSchemaError(`${prefix} short flag must be exactly 1 character long.`);
-			names.push(options.short);
-		}
-		if (names.some(isNameInvalid)) throw new InvalidSchemaError(`${prefix} contains reserved characters, which are used as delimiters.`);
-		if (options.required && options.default !== void 0) throw new InvalidSchemaError(`${prefix} cannot be both required and have a default value.`);
-	}
-	for (const [name, config] of Object.entries(flags)) {
-		const normalized = normalizeConfig(config);
-		validateFlagOptions(name, normalized);
-		configs.set(name, normalized);
-		aliases.set(name, name);
-		aliases.set(camelCase(name), name);
-		if (normalized.short) aliases.set(normalized.short, name);
-	}
-	return {
-		configs,
-		aliases
-	};
-}
-
-//#endregion
-//#region src/utils.ts
-const isArrayOfType = (arr, type) => Array.isArray(arr) && arr[0] === type;
-/**
-* Check if it's a letter (a-z: 97-122, A-Z: 65-90)
-*/
-const isLetter = (charCode) => charCode >= 65 && charCode <= 90 || charCode >= 97 && charCode <= 122;
-/**
-* Check if it's a digit (0-9: 48-57)
-*/
-const isDigit = (charCode) => charCode >= 48 && charCode <= 57;
-function setValueByType(flags, key, value, config) {
-	const { type } = config;
-	if (looseIsArray(type)) if (isArrayOfType(type, Boolean)) flags[key] = (flags[key] ?? 0) + 1;
-	else (flags[key] ??= []).push(type[0](value));
-	else flags[key] = type(value);
-}
-function setDotValues(obj, path, value) {
-	const keys = path.split(".");
-	let current = obj;
-	for (let i = 0; i < keys.length - 1; i++) {
-		const key = keys[i];
-		current[key] ??= {};
-		current = current[key];
-	}
-	const lastKey = keys[keys.length - 1];
-	if (value === "true" || value === "") current[lastKey] = true;
-	else if (value === "false") current[lastKey] = false;
-	else current[lastKey] = value;
-}
-function splitNameAndValue(arg, delimiters) {
-	let sepIdx = -1;
-	let delimiterLen = 0;
-	for (const delimiter of delimiters) {
-		const idx = arg.indexOf(delimiter);
-		if (idx !== -1 && (sepIdx === -1 || idx < sepIdx)) {
-			sepIdx = idx;
-			delimiterLen = delimiter.length;
-		}
-	}
-	if (!(sepIdx !== -1)) return {
-		rawName: arg,
-		rawValue: void 0,
-		hasSep: false
-	};
-	return {
-		rawName: arg.slice(0, sepIdx),
-		rawValue: arg.slice(sepIdx + delimiterLen),
-		hasSep: true
-	};
-}
-
-//#endregion
-//#region src/parse.ts
-const DOUBLE_DASH = "--";
-function createParser(options = {}) {
-	const { flags: flagsConfig = {}, delimiters, ignore } = resolveParserOptions(options);
-	const { configs, aliases } = buildConfigsAndAliases(delimiters, flagsConfig);
-	function resolve(name, isShortFlag = false) {
-		const dotIdx = name.indexOf(".");
-		const rootName = dotIdx === -1 ? name : name.slice(0, dotIdx);
-		let key = aliases.get(rootName);
-		if (!key) {
-			key = aliases.get(camelCase(rootName));
-			if (!key) return;
-		}
-		const config = configs.get(key);
-		if (!isShortFlag && config.short === rootName) return;
-		return {
-			key,
-			config,
-			path: dotIdx === -1 ? void 0 : name.slice(dotIdx + 1)
-		};
-	}
-	function resolveNegated(name) {
-		if (!name.startsWith("no")) return;
-		const possibleName = name[2] === "-" ? name.slice(3) : name.length > 2 && /[A-Z]/.test(name[2]) ? name[2].toLowerCase() + name.slice(3) : "";
-		if (possibleName) {
-			const possibleResolved = resolve(possibleName);
-			if (possibleResolved?.config.type === Boolean && possibleResolved.config.negatable !== false) return possibleResolved;
-		}
-	}
-	function shouldProcessAsFlag(arg) {
-		if (arg.charCodeAt(0) !== 45) return false;
-		const len = arg.length;
-		if (len < 2) return false;
-		const secondChar = arg.charCodeAt(1);
-		if (isLetter(secondChar)) return true;
-		if (isDigit(secondChar)) {
-			const isShortFlag = secondChar !== 45;
-			return !!resolve(isShortFlag ? arg[1] : arg.slice(2), isShortFlag);
-		}
-		if (secondChar === 45 && len > 2) return isLetter(arg.charCodeAt(2));
-		return false;
-	}
-	function isKnownFlag(arg) {
-		if (arg.charCodeAt(1) === 45) {
-			const { rawName } = splitNameAndValue(arg.slice(2), delimiters);
-			if (resolve(rawName, false)) return true;
-			if (resolveNegated(rawName)) return true;
-			return false;
-		}
-		const chars = arg.slice(1);
-		for (const char of chars) if (!resolve(char, true)) return false;
-		return true;
-	}
-	const parse$1 = (args) => {
-		const result = {
-			parameters: [],
-			doubleDash: [],
-			flags: {},
-			raw: args,
-			unknown: {},
-			ignored: [],
-			missingRequiredFlags: []
-		};
-		iterateArgs(args, result, shouldProcessAsFlag, isKnownFlag, ignore, ({ current, eat, exit, hasNext, index, next, shouldIgnore }) => {
-			if (current === DOUBLE_DASH) {
-				result.doubleDash.push(...args.slice(index + 1));
-				exit(false);
-				return;
-			}
-			if (shouldIgnore(current)) {
-				result.ignored.push(current);
-				exit();
-				return;
-			}
-			if (!shouldProcessAsFlag(current)) {
-				result.parameters.push(current);
-				return;
-			}
-			const isShortFlag = !current.startsWith(DOUBLE_DASH);
-			const chars = current.slice(isShortFlag ? 1 : 2);
-			if (isShortFlag) {
-				const charsLen = chars.length;
-				for (let j = 0; j < charsLen; j++) {
-					const char = chars[j];
-					const resolved = resolve(char, true);
-					if (!resolved) {
-						result.unknown[char] = true;
-						continue;
-					}
-					const { key, config } = resolved;
-					const configType = config.type;
-					if (configType === Boolean || isArrayOfType(configType, Boolean)) setValueByType(result.flags, key, "true", config);
-					else if (j + 1 < charsLen) {
-						setValueByType(result.flags, key, chars.slice(j + 1), config);
-						break;
-					} else {
-						const value = hasNext && !shouldProcessAsFlag(next) ? eat() ?? "" : "";
-						setValueByType(result.flags, key, value, config);
-					}
-				}
-			} else {
-				const { rawName, rawValue, hasSep } = splitNameAndValue(chars, delimiters);
-				let resolved = resolve(rawName);
-				let isNegated = false;
-				if (!resolved) {
-					const negated = resolveNegated(rawName);
-					if (negated) {
-						resolved = negated;
-						isNegated = true;
-					}
-				}
-				if (!resolved) {
-					const key$1 = camelCase(rawName);
-					if (hasSep) result.unknown[key$1] = rawValue;
-					else if (hasNext && !shouldProcessAsFlag(next)) {
-						const value = eat();
-						result.unknown[key$1] = value ?? true;
-					} else result.unknown[key$1] = true;
-					return;
-				}
-				const { key, config, path } = resolved;
-				if (path) {
-					if (config.type === Object) {
-						result.flags[key] ??= {};
-						const value = hasSep ? rawValue : hasNext && !shouldProcessAsFlag(next) ? eat() ?? "" : "";
-						setDotValues(result.flags[key], path, value);
-					}
-				} else if (config.type === Boolean) {
-					const value = hasSep ? rawValue !== "false" : true;
-					result.flags[key] = isNegated ? !value : value;
-				} else {
-					const value = hasSep ? rawValue : hasNext && !shouldProcessAsFlag(next) ? eat() ?? "" : "";
-					setValueByType(result.flags, key, value, config);
-				}
-			}
-		});
-		for (const [key, config] of configs.entries()) if (result.flags[key] === void 0) {
-			if (config.default !== void 0) result.flags[key] = resolveValue(config.default);
-			else if (Array.isArray(config.type)) result.flags[key] = isArrayOfType(config.type, Boolean) ? 0 : [];
-			else if (config.type === Object) result.flags[key] = {};
-			else if (config.type === Boolean) result.flags[key] = false;
-			else if (config.required) result.missingRequiredFlags.push(key);
-		}
-		return result;
-	};
-	return { parse: parse$1 };
-}
-const parse = (args, options = {}) => createParser(options).parse(args);
-
-//#endregion
-export { DOUBLE_DASH, InvalidSchemaError, KNOWN_FLAG, PARAMETER, UNKNOWN_FLAG, createParser, parse };
+import{camelCase as e,looseIsArray as t,resolveValue as n}from"@clerc/utils";var r=class extends Error{constructor(e){super(`Invalid schema: ${e}`),this.name=`InvalidSchemaError`}};const i=`known-flag`,a=`unknown-flag`,o=`parameter`;function s(e,t,n,r,s,c){let l=0,u=!1,d=e.length,f={current:``,index:0,hasNext:!1,next:``,shouldIgnore:e=>s?s(n(e)?r(e)?i:a:o,e):!1,eat:()=>{if(l+1>=d)return;let t=e[l+1];if(f.shouldIgnore(t)){f.exit();return}return l++,p(),e[l]},exit:(n=!0)=>{u||=(n&&t.ignored.push(...e.slice(l+1)),!0)}};function p(){f.current=e[l],f.index=l,f.hasNext=l+1<d,f.next=f.hasNext?e[l+1]:``}for(l=0;l<d&&!u;l++)p(),c(f)}const c={delimiters:[`=`,`:`]},l=(e={})=>({...c,...e}),u=e=>typeof e==`function`||t(e)?{type:e}:e,d=/[\s.]/;function f(t,n){let i=new Map,a=new Map,o=e=>t.some(t=>e.includes(t))||d.test(e);function s(e,t){let n=`Flag "${e}"`;if(Array.isArray(t.type)&&t.type.length>1)throw new r(`${n} has an invalid type array. Only single-element arrays are allowed to denote multiple occurrences.`);if(e.length<2)throw new r(`${n} name must be at least 2 characters long.`);let i=[e];if(t.short){if(t.short.length!==1)throw new r(`${n} short flag must be exactly 1 character long.`);i.push(t.short)}if(i.some(o))throw new r(`${n} contains reserved characters, which are used as delimiters.`);if(t.required&&t.default!==void 0)throw new r(`${n} cannot be both required and have a default value.`)}for(let[t,r]of Object.entries(n)){let n=u(r);s(t,n),i.set(t,n),a.set(t,t),a.set(e(t),t),n.short&&a.set(n.short,t)}return{configs:i,aliases:a}}const p=(e,t)=>Array.isArray(e)&&e[0]===t,m=e=>e>=65&&e<=90||e>=97&&e<=122,h=e=>e>=48&&e<=57;function g(e,n,r,i){let{type:a}=i;t(a)?p(a,Boolean)?e[n]=(e[n]??0)+1:(e[n]??=[]).push(a[0](r)):e[n]=a(r)}function _(e,t,n){let r=t.split(`.`),i=e;for(let e=0;e<r.length-1;e++){let t=r[e];i[t]??={},i=i[t]}let a=r[r.length-1];n===`true`||n===``?i[a]=!0:n===`false`?i[a]=!1:i[a]=n}function v(e,t){let n=-1,r=0;for(let i of t){let t=e.indexOf(i);t!==-1&&(n===-1||t<n)&&(n=t,r=i.length)}return n===-1?{rawName:e,rawValue:void 0,hasSep:!1}:{rawName:e.slice(0,n),rawValue:e.slice(n+r),hasSep:!0}}const y=`--`;function b(t={}){let{flags:r={},delimiters:i,ignore:a}=l(t),{configs:o,aliases:c}=f(i,r);function u(t,n=!1){let r=t.indexOf(`.`),i=r===-1?t:t.slice(0,r),a=c.get(i);if(!a&&(a=c.get(e(i)),!a))return;let s=o.get(a);if(!(!n&&s.short===i))return{key:a,config:s,path:r===-1?void 0:t.slice(r+1)}}function d(e){if(!e.startsWith(`no`))return;let t=e[2]===`-`?e.slice(3):e.length>2&&/[A-Z]/.test(e[2])?e[2].toLowerCase()+e.slice(3):``;if(t){let e=u(t);if(e?.config.type===Boolean&&e.config.negatable!==!1)return e}}function y(e){if(e.charCodeAt(0)!==45)return!1;let t=e.length;if(t<2)return!1;let n=e.charCodeAt(1);if(m(n))return!0;if(h(n)){let t=n!==45;return!!u(t?e[1]:e.slice(2),t)}return n===45&&t>2?m(e.charCodeAt(2)):!1}function b(e){if(e.charCodeAt(1)===45){let{rawName:t}=v(e.slice(2),i);return!!(u(t,!1)||d(t))}let t=e.slice(1);for(let e of t)if(!u(e,!0))return!1;return!0}return{parse:t=>{let r={parameters:[],doubleDash:[],flags:{},raw:t,unknown:{},ignored:[],missingRequiredFlags:[]};s(t,r,y,b,a,({current:n,eat:a,exit:o,hasNext:s,index:c,next:l,shouldIgnore:f})=>{if(n===`--`){r.doubleDash.push(...t.slice(c+1)),o(!1);return}if(f(n)){r.ignored.push(n),o();return}if(!y(n)){r.parameters.push(n);return}let m=!n.startsWith(`--`),h=n.slice(m?1:2);if(m){let e=h.length;for(let t=0;t<e;t++){let n=h[t],i=u(n,!0);if(!i){r.unknown[n]=!0;continue}let{key:o,config:c}=i,d=c.type;if(d===Boolean||p(d,Boolean))g(r.flags,o,`true`,c);else if(t+1<e){g(r.flags,o,h.slice(t+1),c);break}else{let e=s&&!y(l)?a()??``:``;g(r.flags,o,e,c)}}}else{let{rawName:t,rawValue:n,hasSep:o}=v(h,i),c=u(t),f=!1;if(!c){let e=d(t);e&&(c=e,f=!0)}if(!c){let i=e(t);if(o)r.unknown[i]=n;else if(s&&!y(l)){let e=a();r.unknown[i]=e??!0}else r.unknown[i]=!0;return}let{key:p,config:m,path:b}=c;if(b){if(m.type===Object){r.flags[p]??={};let e=o?n:s&&!y(l)?a()??``:``;_(r.flags[p],b,e)}}else if(m.type===Boolean){let e=o?n!==`false`:!0;r.flags[p]=f?!e:e}else{let e=o?n:s&&!y(l)?a()??``:``;g(r.flags,p,e,m)}}});for(let[e,t]of o.entries())r.flags[e]===void 0&&(t.default===void 0?Array.isArray(t.type)?r.flags[e]=p(t.type,Boolean)?0:[]:t.type===Object?r.flags[e]={}:t.type===Boolean?r.flags[e]=!1:t.required&&r.missingRequiredFlags.push(e):r.flags[e]=n(t.default));return r}}}const x=(e,t={})=>b(t).parse(e);export{y as DOUBLE_DASH,r as InvalidSchemaError,i as KNOWN_FLAG,o as PARAMETER,a as UNKNOWN_FLAG,b as createParser,x as parse};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/parser",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc parser",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@clerc/utils": "1.1.0"
+    "@clerc/utils": "1.1.1"
   },
   "devDependencies": {
     "@types/minimist": "^1.2.5",