@duplojs/server 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/_virtual/_rolldown/runtime.mjs

@@ -9,5 +9,9 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+});
 //#endregion
-export { __exportAll };
+export { __exportAll, __require };

package/dist/command/create.cjs

@@ -51,19 +51,21 @@ function create(...args) {
 			}
 			const commandOptions = await _duplojs_lang_generator.asyncReduce(self.options, _duplojs_lang_generator.reduceFrom({
 				options: {},
-				restArgs: args
-			}), async ({ item: option, lastValue, next, exit }) => {
+				restArgs: args,
+				hasError: false
+			}), async ({ item: option, lastValue, next }) => {
 				const optionResult = await option.execute(lastValue.restArgs, error);
-				if (optionResult === require_error.SymbolCommandError) return exit(require_error.SymbolCommandError);
+				if (optionResult === require_error.SymbolCommandError) return next(_duplojs_lang_object.override(lastValue, { hasError: true }));
 				return next({
 					options: _duplojs_lang_object.override(lastValue.options, { [option.name]: optionResult.result }),
-					restArgs: optionResult.argumentRest
+					restArgs: optionResult.argumentRest,
+					hasError: lastValue.hasError
 				});
 			});
-			if (commandOptions === require_error.SymbolCommandError) return require_error.SymbolCommandError;
+			if (commandOptions.hasError === true) return require_error.SymbolCommandError;
 			if (self.subject?.type === "argument") {
-				if (self.subject.args.length !== commandOptions.restArgs.length) return error.addTooMuchCommandArgumentIssue(self.subject.args.length, commandOptions.restArgs.length);
-				const commandArguments = await _duplojs_lang_generator.asyncReduce(self.subject.args, _duplojs_lang_generator.reduceFrom({
+				if (self.subject.args.length < commandOptions.restArgs.length) return error.addTooMuchCommandArgumentIssue(self.subject.args.length, commandOptions.restArgs.length);
+				const commandArgs = await _duplojs_lang_generator.asyncReduce(self.subject.args, _duplojs_lang_generator.reduceFrom({
 					args: {},
 					restArgs: commandOptions.restArgs
 				}), async ({ item: argument, lastValue, next, exit }) => {
@@ -75,10 +77,10 @@ function create(...args) {
 						restArgs: _duplojs_lang_array.shift(lastValue.restArgs)
 					});
 				});
-				if (commandArguments === require_error.SymbolCommandError) return require_error.SymbolCommandError;
+				if (commandArgs === require_error.SymbolCommandError) return require_error.SymbolCommandError;
 				await execute({
 					options: commandOptions.options,
-					args: commandArguments.args
+					args: commandArgs.args
 				});
 			} else {
 				if (commandOptions.restArgs.length > 0) return error.addTooMuchCommandArgumentIssue(0, commandOptions.restArgs.length);

package/dist/command/create.mjs

@@ -46,19 +46,21 @@ function create(...args) {
 			}
 			const commandOptions = await DGenerator.asyncReduce(self.options, DGenerator.reduceFrom({
 				options: {},
-				restArgs: args
-			}), async ({ item: option, lastValue, next, exit }) => {
+				restArgs: args,
+				hasError: false
+			}), async ({ item: option, lastValue, next }) => {
 				const optionResult = await option.execute(lastValue.restArgs, error);
-				if (optionResult === SymbolCommandError) return exit(SymbolCommandError);
+				if (optionResult === SymbolCommandError) return next(DObject.override(lastValue, { hasError: true }));
 				return next({
 					options: DObject.override(lastValue.options, { [option.name]: optionResult.result }),
-					restArgs: optionResult.argumentRest
+					restArgs: optionResult.argumentRest,
+					hasError: lastValue.hasError
 				});
 			});
-			if (commandOptions === SymbolCommandError) return SymbolCommandError;
+			if (commandOptions.hasError === true) return SymbolCommandError;
 			if (self.subject?.type === "argument") {
-				if (self.subject.args.length !== commandOptions.restArgs.length) return error.addTooMuchCommandArgumentIssue(self.subject.args.length, commandOptions.restArgs.length);
-				const commandArguments = await DGenerator.asyncReduce(self.subject.args, DGenerator.reduceFrom({
+				if (self.subject.args.length < commandOptions.restArgs.length) return error.addTooMuchCommandArgumentIssue(self.subject.args.length, commandOptions.restArgs.length);
+				const commandArgs = await DGenerator.asyncReduce(self.subject.args, DGenerator.reduceFrom({
 					args: {},
 					restArgs: commandOptions.restArgs
 				}), async ({ item: argument, lastValue, next, exit }) => {
@@ -70,10 +72,10 @@ function create(...args) {
 						restArgs: DArray.shift(lastValue.restArgs)
 					});
 				});
-				if (commandArguments === SymbolCommandError) return SymbolCommandError;
+				if (commandArgs === SymbolCommandError) return SymbolCommandError;
 				await execute({
 					options: commandOptions.options,
-					args: commandArguments.args
+					args: commandArgs.args
 				});
 			} else {
 				if (commandOptions.restArgs.length > 0) return error.addTooMuchCommandArgumentIssue(0, commandOptions.restArgs.length);

package/dist/command/error.cjs

@@ -2,12 +2,12 @@ const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
 const require_defaultInterpreter = require("../dataStructure/common/error/defaultInterpreter.cjs");
 let _duplojs_lang_common = require("@duplojs/lang/common");
 _duplojs_lang_common = require_runtime.__toESM(_duplojs_lang_common, 1);
+let _duplojs_lang_pattern = require("@duplojs/lang/pattern");
+_duplojs_lang_pattern = require_runtime.__toESM(_duplojs_lang_pattern, 1);
 let _duplojs_lang_dataStructure = require("@duplojs/lang/dataStructure");
 _duplojs_lang_dataStructure = require_runtime.__toESM(_duplojs_lang_dataStructure, 1);
 let _duplojs_lang_array = require("@duplojs/lang/array");
 _duplojs_lang_array = require_runtime.__toESM(_duplojs_lang_array, 1);
-let _duplojs_lang_pattern = require("@duplojs/lang/pattern");
-_duplojs_lang_pattern = require_runtime.__toESM(_duplojs_lang_pattern, 1);
 let _duplojs_lang_string = require("@duplojs/lang/string");
 _duplojs_lang_string = require_runtime.__toESM(_duplojs_lang_string, 1);
 let _duplojs_lang_printer = require("@duplojs/lang/printer");

package/dist/command/error.mjs

@@ -1,8 +1,8 @@
 import { defaultErrorInterpreterCodecDictionary, defaultErrorInterpreterDataStructureDictionary } from "../dataStructure/common/error/defaultInterpreter.mjs";
 import * as DCommon from "@duplojs/lang/common";
+import * as DPattern from "@duplojs/lang/pattern";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 import * as DArray from "@duplojs/lang/array";
-import * as DPattern from "@duplojs/lang/pattern";
 import * as DString from "@duplojs/lang/string";
 import * as DPrinter from "@duplojs/lang/printer";
 import * as DModeling from "@duplojs/lang/modeling";

package/dist/command/help.cjs

@@ -1,19 +1,21 @@
 const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
-const require_exist = require("../dataStructure/constraint/exist.cjs");
+const require_fileExist = require("../dataStructure/constraint/fileExist.cjs");
+const require_folderExist = require("../dataStructure/constraint/folderExist.cjs");
 const require_mimeType = require("../dataStructure/constraint/mimeType.cjs");
 const require_size = require("../dataStructure/constraint/size.cjs");
 const require_file = require("../dataStructure/type/file.cjs");
+const require_folder = require("../dataStructure/type/folder.cjs");
 const require_array = require("./options/defaults/array.cjs");
 const require_boolean = require("./options/defaults/boolean.cjs");
 const require_simple = require("./options/defaults/simple.cjs");
 let _duplojs_lang_common = require("@duplojs/lang/common");
 _duplojs_lang_common = require_runtime.__toESM(_duplojs_lang_common, 1);
+let _duplojs_lang_pattern = require("@duplojs/lang/pattern");
+_duplojs_lang_pattern = require_runtime.__toESM(_duplojs_lang_pattern, 1);
 let _duplojs_lang_dataStructure = require("@duplojs/lang/dataStructure");
 _duplojs_lang_dataStructure = require_runtime.__toESM(_duplojs_lang_dataStructure, 1);
 let _duplojs_lang_array = require("@duplojs/lang/array");
 _duplojs_lang_array = require_runtime.__toESM(_duplojs_lang_array, 1);
-let _duplojs_lang_pattern = require("@duplojs/lang/pattern");
-_duplojs_lang_pattern = require_runtime.__toESM(_duplojs_lang_pattern, 1);
 let _duplojs_lang_string = require("@duplojs/lang/string");
 _duplojs_lang_string = require_runtime.__toESM(_duplojs_lang_string, 1);
 let _duplojs_lang_printer = require("@duplojs/lang/printer");
@@ -53,7 +55,7 @@ function formatBytes(value) {
 	return `${Number.isInteger(size) ? size : size.toFixed(1)} ${units[index]}`;
 }
 function renderType(type) {
-	return _duplojs_lang_pattern.match(type).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.stringLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.numberLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.bigintLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.booleanLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.nullTypeKind), _duplojs_lang_common.justReturn([literal("null")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.undefinedTypeKind), _duplojs_lang_common.justReturn([literal("undefined")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.stringTypeKind), _duplojs_lang_common.justReturn([typeLabel("string")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.numberTypeKind), _duplojs_lang_common.justReturn([typeLabel("number")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.bigintTypeKind), _duplojs_lang_common.justReturn([typeLabel("bigint")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.booleanTypeKind), _duplojs_lang_common.justReturn([typeLabel("boolean")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.dateTypeKind), _duplojs_lang_common.justReturn([typeLabel("date")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.timeTypeKind), _duplojs_lang_common.justReturn([typeLabel("time")])).when(_duplojs_lang_dataStructure.typeIdentifier(require_file.fileTypeKind), _duplojs_lang_common.justReturn([typeLabel("file")])).otherwise(_duplojs_lang_common.justReturn([typeLabel("unknown")]));
+	return _duplojs_lang_pattern.match(type).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.stringLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.numberLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.bigintLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.booleanLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.nullTypeKind), _duplojs_lang_common.justReturn([literal("null")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.undefinedTypeKind), _duplojs_lang_common.justReturn([literal("undefined")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.stringTypeKind), _duplojs_lang_common.justReturn([typeLabel("string")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.numberTypeKind), _duplojs_lang_common.justReturn([typeLabel("number")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.bigintTypeKind), _duplojs_lang_common.justReturn([typeLabel("bigint")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.booleanTypeKind), _duplojs_lang_common.justReturn([typeLabel("boolean")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.dateTypeKind), _duplojs_lang_common.justReturn([typeLabel("date")])).when(_duplojs_lang_dataStructure.typeIdentifier(_duplojs_lang_dataStructure.timeTypeKind), _duplojs_lang_common.justReturn([typeLabel("time")])).when(_duplojs_lang_dataStructure.typeIdentifier(require_file.fileTypeKind), _duplojs_lang_common.justReturn([typeLabel("file")])).when(_duplojs_lang_dataStructure.typeIdentifier(require_folder.folderTypeKind), _duplojs_lang_common.justReturn([typeLabel("folder")])).otherwise(_duplojs_lang_common.justReturn([typeLabel("unknown")]));
 }
 function renderStringLength(constraints) {
 	const equal = _duplojs_lang_array.find(constraints, _duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.stringLengthEqualConstraintKind));
@@ -83,7 +85,7 @@ function renderNumberBounds(constraints) {
 	return _duplojs_lang_array.filter([greaterThan ? [constraintLabel("> "), literal(String(greaterThan.definition.threshold))] : greaterThanOrEqual ? [constraintLabel("min "), literal(String(greaterThanOrEqual.definition.threshold))] : null, lessThan ? [constraintLabel("< "), literal(String(lessThan.definition.threshold))] : lessThanOrEqual ? [constraintLabel("max "), literal(String(lessThanOrEqual.definition.threshold))] : null], _duplojs_lang_common.truthy);
 }
 function renderSimpleConstraint(constraint) {
-	return _duplojs_lang_pattern.match(constraint).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.emailConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("email")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.urlConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("url")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.uuidConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("uuid")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.integerConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("integer")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.trimmedConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("trimmed")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.notEmptyConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("not empty")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.numberInStringConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("number in string")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.evenConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("even")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.oddConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("odd")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.positiveConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("positive")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.negativeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("negative")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.notZeroConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("not zero")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.safeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("safe number")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.pathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("path")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.absolutePathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("absolute path")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.segmentPathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("path segment")])).when(_duplojs_lang_dataStructure.constraintIdentifier(require_exist.existConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("exists")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.strictPositiveConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("> "), literal("0")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.strictNegativeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("< "), literal("0")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.betweenThanConstraintKind), ({ definition }) => [
+	return _duplojs_lang_pattern.match(constraint).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.emailConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("email")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.urlConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("url")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.uuidConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("uuid")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.integerConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("integer")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.trimmedConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("trimmed")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.notEmptyConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("not empty")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.numberInStringConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("number in string")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.evenConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("even")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.oddConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("odd")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.positiveConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("positive")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.negativeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("negative")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.notZeroConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("not zero")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.safeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("safe number")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.pathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("path")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.absolutePathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("absolute path")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.segmentPathConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("path segment")])).when(_duplojs_lang_dataStructure.constraintIdentifier(require_fileExist.fileExistConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("exists")])).when(_duplojs_lang_dataStructure.constraintIdentifier(require_folderExist.folderExistConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("exists")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.strictPositiveConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("> "), literal("0")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.strictNegativeConstraintKind), _duplojs_lang_common.justReturn([constraintLabel("< "), literal("0")])).when(_duplojs_lang_dataStructure.constraintIdentifier(_duplojs_lang_dataStructure.betweenThanConstraintKind), ({ definition }) => [
 		constraintLabel("> "),
 		literal(String(definition.greater)),
 		secondary(" and "),
@@ -192,8 +194,8 @@ function renderOptionDetails(option, depth) {
 		const help = renderDataStructure(option.dataStructure);
 		return _duplojs_lang_array.filter([
 			renderInline([_duplojs_lang_printer.indent(depth), renderMetadata(help, option.required ? "required" : "optional")]),
-			renderDescriptionLine(option.description, depth),
-			...renderConstraintLines(help.constraints, depth)
+			...renderConstraintLines(help.constraints, depth),
+			renderDescriptionLine(option.description, depth)
 		], _duplojs_lang_common.truthy);
 	}
 	if (require_boolean.booleanOptionKind.has(option)) return _duplojs_lang_array.filter([renderInline([_duplojs_lang_printer.indent(depth), typeLabel("boolean")]), renderDescriptionLine(option.description, depth)], _duplojs_lang_common.truthy);
@@ -211,8 +213,8 @@ function renderArgumentsHelp(args, depth) {
 				name(argument.name.padEnd(12)),
 				renderMetadata(help, argument.optional ? "optional" : "required")
 			]),
-			renderDescriptionLine(argument.description, depth + 2),
-			renderConstraintLines(help.constraints, depth + 2)
+			renderConstraintLines(help.constraints, depth + 2),
+			renderDescriptionLine(argument.description, depth + 2)
 		]);
 	})]);
 }

package/dist/command/help.mjs

@@ -1,14 +1,16 @@
-import { existConstraintKind } from "../dataStructure/constraint/exist.mjs";
+import { fileExistConstraintKind } from "../dataStructure/constraint/fileExist.mjs";
+import { folderExistConstraintKind } from "../dataStructure/constraint/folderExist.mjs";
 import { mimeTypeConstraintKind } from "../dataStructure/constraint/mimeType.mjs";
 import { sizeConstraintKind } from "../dataStructure/constraint/size.mjs";
 import { fileTypeKind } from "../dataStructure/type/file.mjs";
+import { folderTypeKind } from "../dataStructure/type/folder.mjs";
 import { arrayOptionKind } from "./options/defaults/array.mjs";
 import { booleanOptionKind, createBooleanOption } from "./options/defaults/boolean.mjs";
 import { simpleOptionKind } from "./options/defaults/simple.mjs";
 import * as DCommon from "@duplojs/lang/common";
+import * as DPattern from "@duplojs/lang/pattern";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 import * as DArray from "@duplojs/lang/array";
-import * as DPattern from "@duplojs/lang/pattern";
 import * as DString from "@duplojs/lang/string";
 import * as DPrinter from "@duplojs/lang/printer";
 //#region scripts/command/help.ts
@@ -46,7 +48,7 @@ function formatBytes(value) {
 	return `${Number.isInteger(size) ? size : size.toFixed(1)} ${units[index]}`;
 }
 function renderType(type) {
-	return DPattern.match(type).when(DDataStructure.typeIdentifier(DDataStructure.stringLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.numberLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.bigintLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.booleanLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.nullTypeKind), DCommon.justReturn([literal("null")])).when(DDataStructure.typeIdentifier(DDataStructure.undefinedTypeKind), DCommon.justReturn([literal("undefined")])).when(DDataStructure.typeIdentifier(DDataStructure.stringTypeKind), DCommon.justReturn([typeLabel("string")])).when(DDataStructure.typeIdentifier(DDataStructure.numberTypeKind), DCommon.justReturn([typeLabel("number")])).when(DDataStructure.typeIdentifier(DDataStructure.bigintTypeKind), DCommon.justReturn([typeLabel("bigint")])).when(DDataStructure.typeIdentifier(DDataStructure.booleanTypeKind), DCommon.justReturn([typeLabel("boolean")])).when(DDataStructure.typeIdentifier(DDataStructure.dateTypeKind), DCommon.justReturn([typeLabel("date")])).when(DDataStructure.typeIdentifier(DDataStructure.timeTypeKind), DCommon.justReturn([typeLabel("time")])).when(DDataStructure.typeIdentifier(fileTypeKind), DCommon.justReturn([typeLabel("file")])).otherwise(DCommon.justReturn([typeLabel("unknown")]));
+	return DPattern.match(type).when(DDataStructure.typeIdentifier(DDataStructure.stringLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.numberLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.bigintLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.booleanLiteralTypeKind), ({ definition }) => [literal(formatLiteral(definition.value))]).when(DDataStructure.typeIdentifier(DDataStructure.nullTypeKind), DCommon.justReturn([literal("null")])).when(DDataStructure.typeIdentifier(DDataStructure.undefinedTypeKind), DCommon.justReturn([literal("undefined")])).when(DDataStructure.typeIdentifier(DDataStructure.stringTypeKind), DCommon.justReturn([typeLabel("string")])).when(DDataStructure.typeIdentifier(DDataStructure.numberTypeKind), DCommon.justReturn([typeLabel("number")])).when(DDataStructure.typeIdentifier(DDataStructure.bigintTypeKind), DCommon.justReturn([typeLabel("bigint")])).when(DDataStructure.typeIdentifier(DDataStructure.booleanTypeKind), DCommon.justReturn([typeLabel("boolean")])).when(DDataStructure.typeIdentifier(DDataStructure.dateTypeKind), DCommon.justReturn([typeLabel("date")])).when(DDataStructure.typeIdentifier(DDataStructure.timeTypeKind), DCommon.justReturn([typeLabel("time")])).when(DDataStructure.typeIdentifier(fileTypeKind), DCommon.justReturn([typeLabel("file")])).when(DDataStructure.typeIdentifier(folderTypeKind), DCommon.justReturn([typeLabel("folder")])).otherwise(DCommon.justReturn([typeLabel("unknown")]));
 }
 function renderStringLength(constraints) {
 	const equal = DArray.find(constraints, DDataStructure.constraintIdentifier(DDataStructure.stringLengthEqualConstraintKind));
@@ -76,7 +78,7 @@ function renderNumberBounds(constraints) {
 	return DArray.filter([greaterThan ? [constraintLabel("> "), literal(String(greaterThan.definition.threshold))] : greaterThanOrEqual ? [constraintLabel("min "), literal(String(greaterThanOrEqual.definition.threshold))] : null, lessThan ? [constraintLabel("< "), literal(String(lessThan.definition.threshold))] : lessThanOrEqual ? [constraintLabel("max "), literal(String(lessThanOrEqual.definition.threshold))] : null], DCommon.truthy);
 }
 function renderSimpleConstraint(constraint) {
-	return DPattern.match(constraint).when(DDataStructure.constraintIdentifier(DDataStructure.emailConstraintKind), DCommon.justReturn([constraintLabel("email")])).when(DDataStructure.constraintIdentifier(DDataStructure.urlConstraintKind), DCommon.justReturn([constraintLabel("url")])).when(DDataStructure.constraintIdentifier(DDataStructure.uuidConstraintKind), DCommon.justReturn([constraintLabel("uuid")])).when(DDataStructure.constraintIdentifier(DDataStructure.integerConstraintKind), DCommon.justReturn([constraintLabel("integer")])).when(DDataStructure.constraintIdentifier(DDataStructure.trimmedConstraintKind), DCommon.justReturn([constraintLabel("trimmed")])).when(DDataStructure.constraintIdentifier(DDataStructure.notEmptyConstraintKind), DCommon.justReturn([constraintLabel("not empty")])).when(DDataStructure.constraintIdentifier(DDataStructure.numberInStringConstraintKind), DCommon.justReturn([constraintLabel("number in string")])).when(DDataStructure.constraintIdentifier(DDataStructure.evenConstraintKind), DCommon.justReturn([constraintLabel("even")])).when(DDataStructure.constraintIdentifier(DDataStructure.oddConstraintKind), DCommon.justReturn([constraintLabel("odd")])).when(DDataStructure.constraintIdentifier(DDataStructure.positiveConstraintKind), DCommon.justReturn([constraintLabel("positive")])).when(DDataStructure.constraintIdentifier(DDataStructure.negativeConstraintKind), DCommon.justReturn([constraintLabel("negative")])).when(DDataStructure.constraintIdentifier(DDataStructure.notZeroConstraintKind), DCommon.justReturn([constraintLabel("not zero")])).when(DDataStructure.constraintIdentifier(DDataStructure.safeConstraintKind), DCommon.justReturn([constraintLabel("safe number")])).when(DDataStructure.constraintIdentifier(DDataStructure.pathConstraintKind), DCommon.justReturn([constraintLabel("path")])).when(DDataStructure.constraintIdentifier(DDataStructure.absolutePathConstraintKind), DCommon.justReturn([constraintLabel("absolute path")])).when(DDataStructure.constraintIdentifier(DDataStructure.segmentPathConstraintKind), DCommon.justReturn([constraintLabel("path segment")])).when(DDataStructure.constraintIdentifier(existConstraintKind), DCommon.justReturn([constraintLabel("exists")])).when(DDataStructure.constraintIdentifier(DDataStructure.strictPositiveConstraintKind), DCommon.justReturn([constraintLabel("> "), literal("0")])).when(DDataStructure.constraintIdentifier(DDataStructure.strictNegativeConstraintKind), DCommon.justReturn([constraintLabel("< "), literal("0")])).when(DDataStructure.constraintIdentifier(DDataStructure.betweenThanConstraintKind), ({ definition }) => [
+	return DPattern.match(constraint).when(DDataStructure.constraintIdentifier(DDataStructure.emailConstraintKind), DCommon.justReturn([constraintLabel("email")])).when(DDataStructure.constraintIdentifier(DDataStructure.urlConstraintKind), DCommon.justReturn([constraintLabel("url")])).when(DDataStructure.constraintIdentifier(DDataStructure.uuidConstraintKind), DCommon.justReturn([constraintLabel("uuid")])).when(DDataStructure.constraintIdentifier(DDataStructure.integerConstraintKind), DCommon.justReturn([constraintLabel("integer")])).when(DDataStructure.constraintIdentifier(DDataStructure.trimmedConstraintKind), DCommon.justReturn([constraintLabel("trimmed")])).when(DDataStructure.constraintIdentifier(DDataStructure.notEmptyConstraintKind), DCommon.justReturn([constraintLabel("not empty")])).when(DDataStructure.constraintIdentifier(DDataStructure.numberInStringConstraintKind), DCommon.justReturn([constraintLabel("number in string")])).when(DDataStructure.constraintIdentifier(DDataStructure.evenConstraintKind), DCommon.justReturn([constraintLabel("even")])).when(DDataStructure.constraintIdentifier(DDataStructure.oddConstraintKind), DCommon.justReturn([constraintLabel("odd")])).when(DDataStructure.constraintIdentifier(DDataStructure.positiveConstraintKind), DCommon.justReturn([constraintLabel("positive")])).when(DDataStructure.constraintIdentifier(DDataStructure.negativeConstraintKind), DCommon.justReturn([constraintLabel("negative")])).when(DDataStructure.constraintIdentifier(DDataStructure.notZeroConstraintKind), DCommon.justReturn([constraintLabel("not zero")])).when(DDataStructure.constraintIdentifier(DDataStructure.safeConstraintKind), DCommon.justReturn([constraintLabel("safe number")])).when(DDataStructure.constraintIdentifier(DDataStructure.pathConstraintKind), DCommon.justReturn([constraintLabel("path")])).when(DDataStructure.constraintIdentifier(DDataStructure.absolutePathConstraintKind), DCommon.justReturn([constraintLabel("absolute path")])).when(DDataStructure.constraintIdentifier(DDataStructure.segmentPathConstraintKind), DCommon.justReturn([constraintLabel("path segment")])).when(DDataStructure.constraintIdentifier(fileExistConstraintKind), DCommon.justReturn([constraintLabel("exists")])).when(DDataStructure.constraintIdentifier(folderExistConstraintKind), DCommon.justReturn([constraintLabel("exists")])).when(DDataStructure.constraintIdentifier(DDataStructure.strictPositiveConstraintKind), DCommon.justReturn([constraintLabel("> "), literal("0")])).when(DDataStructure.constraintIdentifier(DDataStructure.strictNegativeConstraintKind), DCommon.justReturn([constraintLabel("< "), literal("0")])).when(DDataStructure.constraintIdentifier(DDataStructure.betweenThanConstraintKind), ({ definition }) => [
 		constraintLabel("> "),
 		literal(String(definition.greater)),
 		secondary(" and "),
@@ -185,8 +187,8 @@ function renderOptionDetails(option, depth) {
 		const help = renderDataStructure(option.dataStructure);
 		return DArray.filter([
 			renderInline([DPrinter.indent(depth), renderMetadata(help, option.required ? "required" : "optional")]),
-			renderDescriptionLine(option.description, depth),
-			...renderConstraintLines(help.constraints, depth)
+			...renderConstraintLines(help.constraints, depth),
+			renderDescriptionLine(option.description, depth)
 		], DCommon.truthy);
 	}
 	if (booleanOptionKind.has(option)) return DArray.filter([renderInline([DPrinter.indent(depth), typeLabel("boolean")]), renderDescriptionLine(option.description, depth)], DCommon.truthy);
@@ -204,8 +206,8 @@ function renderArgumentsHelp(args, depth) {
 				name(argument.name.padEnd(12)),
 				renderMetadata(help, argument.optional ? "optional" : "required")
 			]),
-			renderDescriptionLine(argument.description, depth + 2),
-			renderConstraintLines(help.constraints, depth + 2)
+			renderConstraintLines(help.constraints, depth + 2),
+			renderDescriptionLine(argument.description, depth + 2)
 		]);
 	})]);
 }

package/dist/common/environmentVariable/parseEnvironmentFiles.d.ts

@@ -1,4 +1,5 @@
 import type * as DPath from "@duplojs/lang/path";
 import * as DEither from "@duplojs/lang/either";
+import * as DSFile from '../../file';
 export declare function parseEnvironmentLine(line: string): Record<string, string>;
-export declare function parseEnvironmentFiles(baseEnv: Record<string, string>, paths: (string & DPath.Path)[]): Promise<DEither.Left<"file-system-read-text-file-not-found", unknown> | DEither.Left<"file-system-read-text-file-permission-denied", unknown> | DEither.Left<"file-system-read-text-file-is-directory", unknown> | DEither.Left<"file-system-read-text-file-not-directory", unknown> | DEither.Left<"file-system-read-text-file-too-many-open-files", unknown> | DEither.Left<"file-system-read-text-file-busy", unknown> | DEither.Left<"file-system-read-text-file-error", unknown> | Record<string, string>[]>;
+export declare function parseEnvironmentFiles(baseEnv: Record<string, string>, paths: (string & DPath.Path)[]): Promise<DEither.Left<"file-system-read-text-file-error", DSFile.ReadTextFileErrors> | Record<string, string>[]>;

package/dist/common/index.cjs

@@ -7,6 +7,7 @@ const require_index = require("./environmentVariable/index.cjs");
 const require_environmentVariableOrThrow = require("./environmentVariableOrThrow.cjs");
 const require_exitProcess = require("./exitProcess.cjs");
 const require_getProcessArguments = require("./getProcessArguments.cjs");
+const require_getCurrentDirectoryName = require("./meta/getCurrentDirectoryName.cjs");
 //#region scripts/common/index.ts
 var common_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	EnvironmentVariableError: () => require_environmentVariableOrThrow.EnvironmentVariableError,
@@ -15,6 +16,7 @@ var common_exports = /* @__PURE__ */ require_runtime.__exportAll({
 	environmentVariable: () => require_index.environmentVariable,
 	environmentVariableOrThrow: () => require_environmentVariableOrThrow.environmentVariableOrThrow,
 	exitProcess: () => require_exitProcess.exitProcess,
+	getCurrentDirectoryName: () => require_getCurrentDirectoryName.getCurrentDirectoryName,
 	getCurrentWorkDirectory: () => require_getCurrentWorkDirectory.getCurrentWorkDirectory,
 	getCurrentWorkDirectoryOrThrow: () => require_getCurrentWorkDirectoryOrThrow.getCurrentWorkDirectoryOrThrow,
 	getProcessArguments: () => require_getProcessArguments.getProcessArguments,
@@ -34,6 +36,7 @@ Object.defineProperty(exports, "common_exports", {
 exports.environmentVariable = require_index.environmentVariable;
 exports.environmentVariableOrThrow = require_environmentVariableOrThrow.environmentVariableOrThrow;
 exports.exitProcess = require_exitProcess.exitProcess;
+exports.getCurrentDirectoryName = require_getCurrentDirectoryName.getCurrentDirectoryName;
 exports.getCurrentWorkDirectory = require_getCurrentWorkDirectory.getCurrentWorkDirectory;
 exports.getCurrentWorkDirectoryOrThrow = require_getCurrentWorkDirectoryOrThrow.getCurrentWorkDirectoryOrThrow;
 exports.getProcessArguments = require_getProcessArguments.getProcessArguments;

package/dist/common/index.d.ts

@@ -6,3 +6,4 @@ export * from './environmentVariable';
 export * from './environmentVariableOrThrow';
 export * from './exitProcess';
 export * from './getProcessArguments';
+export * from './meta';

package/dist/common/index.mjs

@@ -7,6 +7,7 @@ import { environmentVariable } from "./environmentVariable/index.mjs";
 import { EnvironmentVariableError, environmentVariableOrThrow } from "./environmentVariableOrThrow.mjs";
 import { exitProcess } from "./exitProcess.mjs";
 import { getProcessArguments } from "./getProcessArguments.mjs";
+import { getCurrentDirectoryName } from "./meta/getCurrentDirectoryName.mjs";
 //#region scripts/common/index.ts
 var common_exports = /* @__PURE__ */ __exportAll({
 	EnvironmentVariableError: () => EnvironmentVariableError,
@@ -15,6 +16,7 @@ var common_exports = /* @__PURE__ */ __exportAll({
 	environmentVariable: () => environmentVariable,
 	environmentVariableOrThrow: () => environmentVariableOrThrow,
 	exitProcess: () => exitProcess,
+	getCurrentDirectoryName: () => getCurrentDirectoryName,
 	getCurrentWorkDirectory: () => getCurrentWorkDirectory,
 	getCurrentWorkDirectoryOrThrow: () => getCurrentWorkDirectoryOrThrow,
 	getProcessArguments: () => getProcessArguments,
@@ -22,4 +24,4 @@ var common_exports = /* @__PURE__ */ __exportAll({
 	setCurrentWorkingDirectoryOrThrow: () => setCurrentWorkingDirectoryOrThrow
 });
 //#endregion
-export { EnvironmentVariableError, GetCurrentWorkDirectoryError, SetCurrentWorkingDirectoryError, common_exports, environmentVariable, environmentVariableOrThrow, exitProcess, getCurrentWorkDirectory, getCurrentWorkDirectoryOrThrow, getProcessArguments, setCurrentWorkingDirectory, setCurrentWorkingDirectoryOrThrow };
+export { EnvironmentVariableError, GetCurrentWorkDirectoryError, SetCurrentWorkingDirectoryError, common_exports, environmentVariable, environmentVariableOrThrow, exitProcess, getCurrentDirectoryName, getCurrentWorkDirectory, getCurrentWorkDirectoryOrThrow, getProcessArguments, setCurrentWorkingDirectory, setCurrentWorkingDirectoryOrThrow };

package/dist/common/meta/getCurrentDirectoryName.cjs

@@ -0,0 +1,10 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_implementor = require("../../implementor.cjs");
+let _duplojs_lang_common = require("@duplojs/lang/common");
+_duplojs_lang_common = require_runtime.__toESM(_duplojs_lang_common, 1);
+let _duplojs_lang_path = require("@duplojs/lang/path");
+_duplojs_lang_path = require_runtime.__toESM(_duplojs_lang_path, 1);
+//#region scripts/common/meta/getCurrentDirectoryName.ts
+const getCurrentDirectoryName = require_implementor.implementFunction("getCurrentDirectoryName", { NODE: (importMeta) => _duplojs_lang_common.pipe(importMeta.dirname, _duplojs_lang_path.createAbsoluteOrThrow) });
+//#endregion
+exports.getCurrentDirectoryName = getCurrentDirectoryName;

package/dist/common/meta/getCurrentDirectoryName.d.ts

@@ -0,0 +1,7 @@
+import * as DPath from "@duplojs/lang/path";
+declare module '../../implementor' {
+    interface ServerFunction {
+        getCurrentDirectoryName(importMeta: ImportMeta): string & DPath.Absolute;
+    }
+}
+export declare const getCurrentDirectoryName: (importMeta: ImportMeta) => string & DPath.Absolute;

package/dist/common/meta/getCurrentDirectoryName.mjs

@@ -0,0 +1,7 @@
+import { implementFunction } from "../../implementor.mjs";
+import * as DCommon from "@duplojs/lang/common";
+import * as DPath from "@duplojs/lang/path";
+//#region scripts/common/meta/getCurrentDirectoryName.ts
+const getCurrentDirectoryName = implementFunction("getCurrentDirectoryName", { NODE: (importMeta) => DCommon.pipe(importMeta.dirname, DPath.createAbsoluteOrThrow) });
+//#endregion
+export { getCurrentDirectoryName };

package/dist/common/meta/index.d.ts

@@ -0,0 +1,7 @@
+import type * as DKind from "@duplojs/lang/kind";
+declare const importMetaKind: DKind.Handler<DKind.Definition<"@DuplojsServer/import-meta", unknown>>;
+declare global {
+    interface ImportMeta extends DKind.Kind<typeof importMetaKind> {
+    }
+}
+export * from './getCurrentDirectoryName';

package/dist/dataStructure/common/codec/defaults/json.cjs

@@ -1,6 +1,8 @@
 const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
 const require_fileInterface = require("../../../../file/fileInterface.cjs");
+const require_folderInterface = require("../../../../file/folderInterface.cjs");
 const require_file = require("../../../fundamentalType/file.cjs");
+const require_folder = require("../../../fundamentalType/folder.cjs");
 let _duplojs_lang_path = require("@duplojs/lang/path");
 _duplojs_lang_path = require_runtime.__toESM(_duplojs_lang_path, 1);
 let _duplojs_lang_dataStructure = require("@duplojs/lang/dataStructure");
@@ -8,7 +10,16 @@ _duplojs_lang_dataStructure = require_runtime.__toESM(_duplojs_lang_dataStructur
 //#region scripts/dataStructure/common/codec/defaults/json.ts
 const codecsJson = _duplojs_lang_dataStructure.createCodecs({
 	..._duplojs_lang_dataStructure.codecsJson.definition,
-	file: _duplojs_lang_dataStructure.createCodec(require_file.TheFile, (data) => typeof data === "string" && _duplojs_lang_path.is(data), (data) => data.path, (data) => require_fileInterface.createFileInterface(data))
+	file: _duplojs_lang_dataStructure.createCodec(require_file.TheFile, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = _duplojs_lang_path.normalize(data);
+		if (!result) return _duplojs_lang_dataStructure.ErrorSymbol;
+		return require_fileInterface.createFileInterface(result);
+	}),
+	folder: _duplojs_lang_dataStructure.createCodec(require_folder.TheFolder, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = _duplojs_lang_path.normalize(data);
+		if (!result) return _duplojs_lang_dataStructure.ErrorSymbol;
+		return require_folderInterface.createFolderInterface(result);
+	})
 });
 //#endregion
 exports.codecsJson = codecsJson;

package/dist/dataStructure/common/codec/defaults/json.d.ts

@@ -1,8 +1,8 @@
-import * as DPath from "@duplojs/lang/path";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 import * as FundamentalType from "../../../fundamentalType";
 export declare const codecsJson: DDataStructure.Codecs<{
-    file: DDataStructure.Codec<FundamentalType.TheFile, string & DPath.Path>;
+    file: DDataStructure.Codec<FundamentalType.TheFile, string>;
+    folder: DDataStructure.Codec<FundamentalType.TheFolder, string>;
     bigint: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheBigint, string>;
     date: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheDate, string>;
     time: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheTime, string>;

package/dist/dataStructure/common/codec/defaults/json.mjs

@@ -1,11 +1,22 @@
 import { createFileInterface } from "../../../../file/fileInterface.mjs";
+import { createFolderInterface } from "../../../../file/folderInterface.mjs";
 import { TheFile } from "../../../fundamentalType/file.mjs";
+import { TheFolder } from "../../../fundamentalType/folder.mjs";
 import * as DPath from "@duplojs/lang/path";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 //#region scripts/dataStructure/common/codec/defaults/json.ts
 const codecsJson = DDataStructure.createCodecs({
 	...DDataStructure.codecsJson.definition,
-	file: DDataStructure.createCodec(TheFile, (data) => typeof data === "string" && DPath.is(data), (data) => data.path, (data) => createFileInterface(data))
+	file: DDataStructure.createCodec(TheFile, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = DPath.normalize(data);
+		if (!result) return DDataStructure.ErrorSymbol;
+		return createFileInterface(result);
+	}),
+	folder: DDataStructure.createCodec(TheFolder, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = DPath.normalize(data);
+		if (!result) return DDataStructure.ErrorSymbol;
+		return createFolderInterface(result);
+	})
 });
 //#endregion
 export { codecsJson };

package/dist/dataStructure/common/codec/defaults/string.cjs

@@ -1,6 +1,8 @@
 const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
 const require_fileInterface = require("../../../../file/fileInterface.cjs");
+const require_folderInterface = require("../../../../file/folderInterface.cjs");
 const require_file = require("../../../fundamentalType/file.cjs");
+const require_folder = require("../../../fundamentalType/folder.cjs");
 let _duplojs_lang_path = require("@duplojs/lang/path");
 _duplojs_lang_path = require_runtime.__toESM(_duplojs_lang_path, 1);
 let _duplojs_lang_dataStructure = require("@duplojs/lang/dataStructure");
@@ -8,7 +10,16 @@ _duplojs_lang_dataStructure = require_runtime.__toESM(_duplojs_lang_dataStructur
 //#region scripts/dataStructure/common/codec/defaults/string.ts
 const codecsString = _duplojs_lang_dataStructure.createCodecs({
 	..._duplojs_lang_dataStructure.codecsString.definition,
-	file: _duplojs_lang_dataStructure.createCodec(require_file.TheFile, (data) => typeof data === "string" && _duplojs_lang_path.is(data), (data) => data.path, (data) => require_fileInterface.createFileInterface(data))
+	file: _duplojs_lang_dataStructure.createCodec(require_file.TheFile, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = _duplojs_lang_path.normalize(data);
+		if (!result) return _duplojs_lang_dataStructure.ErrorSymbol;
+		return require_fileInterface.createFileInterface(result);
+	}),
+	folder: _duplojs_lang_dataStructure.createCodec(require_folder.TheFolder, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = _duplojs_lang_path.normalize(data);
+		if (!result) return _duplojs_lang_dataStructure.ErrorSymbol;
+		return require_folderInterface.createFolderInterface(result);
+	})
 });
 //#endregion
 exports.codecsString = codecsString;

package/dist/dataStructure/common/codec/defaults/string.d.ts

@@ -1,8 +1,8 @@
-import * as DPath from "@duplojs/lang/path";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 import * as FundamentalType from "../../../fundamentalType";
 export declare const codecsString: DDataStructure.Codecs<{
-    file: DDataStructure.Codec<FundamentalType.TheFile, string & DPath.Path>;
+    file: DDataStructure.Codec<FundamentalType.TheFile, string>;
+    folder: DDataStructure.Codec<FundamentalType.TheFolder, string>;
     bigint: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheBigint, string>;
     boolean: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheBoolean, "true" | "false">;
     date: import('@duplojs/lang/dataStructure').Codec<DDataStructure.TheDate, string>;

package/dist/dataStructure/common/codec/defaults/string.mjs

@@ -1,11 +1,22 @@
 import { createFileInterface } from "../../../../file/fileInterface.mjs";
+import { createFolderInterface } from "../../../../file/folderInterface.mjs";
 import { TheFile } from "../../../fundamentalType/file.mjs";
+import { TheFolder } from "../../../fundamentalType/folder.mjs";
 import * as DPath from "@duplojs/lang/path";
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 //#region scripts/dataStructure/common/codec/defaults/string.ts
 const codecsString = DDataStructure.createCodecs({
 	...DDataStructure.codecsString.definition,
-	file: DDataStructure.createCodec(TheFile, (data) => typeof data === "string" && DPath.is(data), (data) => data.path, (data) => createFileInterface(data))
+	file: DDataStructure.createCodec(TheFile, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = DPath.normalize(data);
+		if (!result) return DDataStructure.ErrorSymbol;
+		return createFileInterface(result);
+	}),
+	folder: DDataStructure.createCodec(TheFolder, (data) => typeof data === "string", (data) => data.path, (data) => {
+		const result = DPath.normalize(data);
+		if (!result) return DDataStructure.ErrorSymbol;
+		return createFolderInterface(result);
+	})
 });
 //#endregion
 export { codecsString };

package/dist/dataStructure/common/error/defaultInterpreter.cjs

@@ -6,6 +6,7 @@ _duplojs_lang_dataStructure = require_runtime.__toESM(_duplojs_lang_dataStructur
 const defaultErrorInterpreterDataStructureDictionary = {
 	..._duplojs_lang_dataStructure.defaultErrorInterpreterDataStructureDictionary,
 	"@DuplojsServerDataStructure/file-type": () => "Expected a valid file.",
+	"@DuplojsServerDataStructure/folder-type": () => "Expected a valid folder.",
 	"@DuplojsServerDataStructure/size-constraint": (source) => {
 		const { min, max } = source.definition;
 		if (min !== void 0 && max !== void 0) return `Expected a file size between ${min} and ${max} bytes.`;
@@ -14,7 +15,8 @@ const defaultErrorInterpreterDataStructureDictionary = {
 		return "Expected a valid file size.";
 	},
 	"@DuplojsServerDataStructure/mime-type-constraint": (source) => `Expected a file with a MIME type matching ${source.definition.regex.toString()}.`,
-	"@DuplojsServerDataStructure/exist-constraint": () => "Expected the file to exist."
+	"@DuplojsServerDataStructure/file-exist-constraint": () => "Expected the file to exist.",
+	"@DuplojsServerDataStructure/folder-exist-constraint": () => "Expected the folder to exist."
 };
 const defaultErrorInterpreterCodecDictionary = [..._duplojs_lang_dataStructure.defaultErrorInterpreterCodecDictionary, [require_json.codecsJson.definition.file, (_codec, issue) => {
 	if (issue.from === "predicate") return _duplojs_lang_dataStructure.encodeIssueKind.has(issue) ? "The JSON file codec must produce a valid file path string." : "Expected a valid file path string for the JSON file codec.";

package/dist/dataStructure/common/error/defaultInterpreter.d.ts

@@ -1,9 +1,11 @@
 import * as DDataStructure from "@duplojs/lang/dataStructure";
 export declare const defaultErrorInterpreterDataStructureDictionary: {
     readonly "@DuplojsServerDataStructure/file-type": () => string;
+    readonly "@DuplojsServerDataStructure/folder-type": () => string;
     readonly "@DuplojsServerDataStructure/size-constraint": (source: import('../..').SizeConstraint) => string;
     readonly "@DuplojsServerDataStructure/mime-type-constraint": (source: import('../..').MimeTypeConstraint) => string;
-    readonly "@DuplojsServerDataStructure/exist-constraint": () => string;
+    readonly "@DuplojsServerDataStructure/file-exist-constraint": () => string;
+    readonly "@DuplojsServerDataStructure/folder-exist-constraint": () => string;
     readonly "@DuplojsLangDataStructure/array-structure": () => string;
     readonly "@DuplojsLangDataStructure/lazy-structure": () => string;
     readonly "@DuplojsLangDataStructure/non-encodable-string-structure": (source: import('@duplojs/lang/dataStructure').NonEncodableStringStructure) => string;
@@ -29,9 +31,11 @@ export declare const defaultErrorInterpreterDataStructureDictionary: {
     readonly "@DuplojsLangDataStructure/between-than-constraint": (source: import('@duplojs/lang/dataStructure').BetweenThanConstraint<number, number>) => string;
     readonly "@DuplojsLangDataStructure/between-than-or-equal-constraint": (source: import('@duplojs/lang/dataStructure').BetweenThanOrEqualConstraint<number, number>) => string;
     readonly "@DuplojsLangDataStructure/email-constraint": () => string;
+    readonly "@DuplojsLangDataStructure/ends-with-constraint": (source: import('@duplojs/lang/dataStructure').EndsWithConstraint<string>) => string;
     readonly "@DuplojsLangDataStructure/even-constraint": () => string;
     readonly "@DuplojsLangDataStructure/greater-than-constraint": (source: import('@duplojs/lang/dataStructure').GreaterThanConstraint<number>) => string;
     readonly "@DuplojsLangDataStructure/greater-than-or-equal-constraint": (source: import('@duplojs/lang/dataStructure').GreaterThanOrEqualConstraint<number>) => string;
+    readonly "@DuplojsLangDataStructure/include-constraint": (source: import('@duplojs/lang/dataStructure').IncludeConstraint<string>) => string;
     readonly "@DuplojsLangDataStructure/integer-constraint": () => string;
     readonly "@DuplojsLangDataStructure/less-than-constraint": (source: import('@duplojs/lang/dataStructure').LessThanConstraint<number>) => string;
     readonly "@DuplojsLangDataStructure/less-than-or-equal-constraint": (source: import('@duplojs/lang/dataStructure').LessThanOrEqualConstraint<number>) => string;
@@ -51,6 +55,7 @@ export declare const defaultErrorInterpreterDataStructureDictionary: {
     readonly "@DuplojsLangDataStructure/regex-constraint": (source: import('@duplojs/lang/dataStructure').RegexConstraint) => string;
     readonly "@DuplojsLangDataStructure/safe-constraint": () => string;
     readonly "@DuplojsLangDataStructure/segment-path-constraint": () => string;
+    readonly "@DuplojsLangDataStructure/starts-with-constraint": (source: import('@duplojs/lang/dataStructure').StartsWithConstraint<string>) => string;
     readonly "@DuplojsLangDataStructure/strict-negative-constraint": () => string;
     readonly "@DuplojsLangDataStructure/strict-positive-constraint": () => string;
     readonly "@DuplojsLangDataStructure/string-length-equal-constraint": (source: import('@duplojs/lang/dataStructure').StringLengthEqualConstraint<number>) => string;
@@ -61,4 +66,4 @@ export declare const defaultErrorInterpreterDataStructureDictionary: {
     readonly "@DuplojsLangModeling/new-type-structure": () => string;
     readonly "@DuplojsLangModeling/tagged-object-structure": (source: import('@duplojs/lang/modeling').TaggedObjectStructure<import('@duplojs/lang/modeling').ObjectTag<string>>) => string;
 };
-export declare const defaultErrorInterpreterCodecDictionary: [[DDataStructure.Codec<DDataStructure.TheBigint, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheDate, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheTime, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheBigint, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheBoolean, "true" | "false">, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheDate, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheNull, "null">, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheNumber, string & import('@duplojs/lang/string').Number>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheTime, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheUndefined, "undefined" | undefined>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<import('../..').TheFile, string & import('@duplojs/lang/path').Path>, (_codec: DDataStructure.Codec<DDataStructure.FundamentalType<unknown>, unknown>, issue: DDataStructure.EncodeIssue | DDataStructure.DecodeIssue) => string]];
+export declare const defaultErrorInterpreterCodecDictionary: [[DDataStructure.Codec<DDataStructure.TheBigint, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheDate, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheTime, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheBigint, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheBoolean, "true" | "false">, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheDate, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheNull, "null">, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheNumber, string & import('@duplojs/lang/string').Number>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheTime, string>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<DDataStructure.TheUndefined, "undefined" | undefined>, (codec: import('@duplojs/lang/dataStructure').Codec, issue: import('@duplojs/lang/dataStructure').EncodeIssue | import('@duplojs/lang/dataStructure').DecodeIssue) => string], [DDataStructure.Codec<import('../..').TheFile, string>, (_codec: DDataStructure.Codec<DDataStructure.FundamentalType<unknown>, unknown>, issue: DDataStructure.EncodeIssue | DDataStructure.DecodeIssue) => string]];