@powerlines/schema 0.11.44 → 0.11.46

package/dist/bundle.cjs

@@ -15,7 +15,7 @@ let unplugin = require("unplugin");
 *
 * @param context - The context object containing the environment paths.
 * @param file - The file path to bundle.
-* @param options - Optional overrides for the ESBuild configuration.
+* @param options - Optional overrides for the Rolldown configuration.
 * @returns A promise that resolves to the bundled module.
 */
 async function bundle(context, file, options = {}) {

package/dist/bundle.d.cts

@@ -12,7 +12,7 @@ type BundleOptions = DeepPartial<Omit<BuildOptions, "input" | "write">> & {
  *
  * @param context - The context object containing the environment paths.
  * @param file - The file path to bundle.
- * @param options - Optional overrides for the ESBuild configuration.
+ * @param options - Optional overrides for the Rolldown configuration.
  * @returns A promise that resolves to the bundled module.
  */
 declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputChunk>;

package/dist/bundle.d.mts

@@ -12,7 +12,7 @@ type BundleOptions = DeepPartial<Omit<BuildOptions, "input" | "write">> & {
  *
  * @param context - The context object containing the environment paths.
  * @param file - The file path to bundle.
- * @param options - Optional overrides for the ESBuild configuration.
+ * @param options - Optional overrides for the Rolldown configuration.
  * @returns A promise that resolves to the bundled module.
  */
 declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputChunk>;

package/dist/bundle.mjs

@@ -13,7 +13,7 @@ import { createRolldownPlugin } from "unplugin";
 *
 * @param context - The context object containing the environment paths.
 * @param file - The file path to bundle.
-* @param options - Optional overrides for the ESBuild configuration.
+* @param options - Optional overrides for the Rolldown configuration.
 * @returns A promise that resolves to the bundled module.
 */
 async function bundle(context, file, options = {}) {

package/dist/bundle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.mjs","names":[],"sources":["../src/bundle.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  CreateUnpluginResolverOptions,\n  ResolveOptions,\n  UnresolvedContext\n} from \"@powerlines/core\";\nimport { createUnpluginResolver } from \"@powerlines/core/lib/unplugin\";\nimport { resolveOptions } from \"@powerlines/unplugin/rolldown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport type { BuildOptions, OutputChunk } from \"rolldown\";\nimport { build } from \"rolldown\";\nimport { createRolldownPlugin } from \"unplugin\";\n\nexport type BundleOptions = DeepPartial<\n  Omit<BuildOptions, \"input\" | \"write\">\n> & {\n  name?: string;\n  resolve?: DeepPartial<ResolveOptions>;\n};\n\n/**\n * Bundle a type definition to a module.\n *\n * @param context - The context object containing the environment paths.\n * @param file - The file path to bundle.\n * @param options - Optional overrides for the ESBuild configuration.\n * @returns A promise that resolves to the bundled module.\n */\nexport async function bundle<TContext extends UnresolvedContext>(\n  context: TContext,\n  file: string,\n  options: BundleOptions = {}\n): Promise<OutputChunk> {\n  const path = await context.fs.resolve(file);\n  if (!path || !context.fs.existsSync(path)) {\n    throw new Error(\n      `Module not found: \"${file}\". Please check the path and try again.`\n    );\n  }\n\n  const userOptions = omit(options, [\"name\", \"resolve\", \"plugins\"]);\n  const plugins = await Promise.resolve(options.plugins);\n\n  const resolvedOptions = resolveOptions(context);\n\n  const result = await build({\n    bundle: true,\n    platform: \"node\",\n    ...resolvedOptions,\n    ...userOptions,\n    logLevel: \"silent\",\n    output: {\n      dir: context.config.output.path,\n      format: \"es\",\n      sourcemap: false,\n      codeSplitting: false,\n      minify: false,\n      keepNames: true,\n      exports: \"named\",\n      ...userOptions.output\n    },\n    input: [path],\n    write: false,\n    plugins: [\n      ...(plugins ? toArray(plugins) : []),\n      createRolldownPlugin(\n        createUnpluginResolver(context, {\n          name: options.name ?? `${findFileName(file)} Bundler`,\n          prefix: false,\n          overrides: defu(\n            options.resolve ?? {},\n            { skipNodeModulesBundle: false },\n            context.config.resolve\n          ) as CreateUnpluginResolverOptions[\"overrides\"],\n          silenceHookLogging: true\n        })\n      )()\n    ].filter(Boolean)\n  } as BuildOptions);\n  if (!result.output || result.output.length === 0) {\n    throw new Error(\n      `No output files generated for ${\n        file\n      }. Please check the configuration and try again.`\n    );\n  }\n  if (result.output.length > 1) {\n    context.warn(\n      `Multiple output files generated for \"${\n        file\n      }\". Only the first file will be used. Please check the configuration to ensure only one output file is generated.`\n    );\n  }\n\n  return result.output[0];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiDA,eAAsB,OACpB,SACA,MACA,UAAyB,CAAC,GACJ;CACtB,MAAM,OAAO,MAAM,QAAQ,GAAG,QAAQ,IAAI;CAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,IAAI,GACtC,MAAM,IAAI,MACR,sBAAsB,KAAK,wCAC7B;CAGF,MAAM,cAAc,KAAK,SAAS;EAAC;EAAQ;EAAW;CAAS,CAAC;CAChE,MAAM,UAAU,MAAM,QAAQ,QAAQ,QAAQ,OAAO;CAIrD,MAAM,SAAS,MAAM,MAAM;EACzB,QAAQ;EACR,UAAU;EACV,GALsB,eAAe,OAKpB;EACjB,GAAG;EACH,UAAU;EACV,QAAQ;GACN,KAAK,QAAQ,OAAO,OAAO;GAC3B,QAAQ;GACR,WAAW;GACX,eAAe;GACf,QAAQ;GACR,WAAW;GACX,SAAS;GACT,GAAG,YAAY;EACjB;EACA,OAAO,CAAC,IAAI;EACZ,OAAO;EACP,SAAS,CACP,GAAI,UAAU,QAAQ,OAAO,IAAI,CAAC,GAClC,qBACE,uBAAuB,SAAS;GAC9B,MAAM,QAAQ,QAAQ,GAAG,aAAa,IAAI,EAAE;GAC5C,QAAQ;GACR,WAAW,KACT,QAAQ,WAAW,CAAC,GACpB,EAAE,uBAAuB,MAAM,GAC/B,QAAQ,OAAO,OACjB;GACA,oBAAoB;EACtB,CAAC,CACH,EAAE,CACJ,EAAE,OAAO,OAAO;CAClB,CAAiB;CACjB,IAAI,CAAC,OAAO,UAAU,OAAO,OAAO,WAAW,GAC7C,MAAM,IAAI,MACR,iCACE,KACD,gDACH;CAEF,IAAI,OAAO,OAAO,SAAS,GACzB,QAAQ,KACN,wCACE,KACD,iHACH;CAGF,OAAO,OAAO,OAAO;AACvB"}
+{"version":3,"file":"bundle.mjs","names":[],"sources":["../src/bundle.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  CreateUnpluginResolverOptions,\n  ResolveOptions,\n  UnresolvedContext\n} from \"@powerlines/core\";\nimport { createUnpluginResolver } from \"@powerlines/core/lib/unplugin\";\nimport { resolveOptions } from \"@powerlines/unplugin/rolldown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport type { BuildOptions, OutputChunk } from \"rolldown\";\nimport { build } from \"rolldown\";\nimport { createRolldownPlugin } from \"unplugin\";\n\nexport type BundleOptions = DeepPartial<\n  Omit<BuildOptions, \"input\" | \"write\">\n> & {\n  name?: string;\n  resolve?: DeepPartial<ResolveOptions>;\n};\n\n/**\n * Bundle a type definition to a module.\n *\n * @param context - The context object containing the environment paths.\n * @param file - The file path to bundle.\n * @param options - Optional overrides for the Rolldown configuration.\n * @returns A promise that resolves to the bundled module.\n */\nexport async function bundle<TContext extends UnresolvedContext>(\n  context: TContext,\n  file: string,\n  options: BundleOptions = {}\n): Promise<OutputChunk> {\n  const path = await context.fs.resolve(file);\n  if (!path || !context.fs.existsSync(path)) {\n    throw new Error(\n      `Module not found: \"${file}\". Please check the path and try again.`\n    );\n  }\n\n  const userOptions = omit(options, [\"name\", \"resolve\", \"plugins\"]);\n  const plugins = await Promise.resolve(options.plugins);\n\n  const resolvedOptions = resolveOptions(context);\n\n  const result = await build({\n    bundle: true,\n    platform: \"node\",\n    ...resolvedOptions,\n    ...userOptions,\n    logLevel: \"silent\",\n    output: {\n      dir: context.config.output.path,\n      format: \"es\",\n      sourcemap: false,\n      codeSplitting: false,\n      minify: false,\n      keepNames: true,\n      exports: \"named\",\n      ...userOptions.output\n    },\n    input: [path],\n    write: false,\n    plugins: [\n      ...(plugins ? toArray(plugins) : []),\n      createRolldownPlugin(\n        createUnpluginResolver(context, {\n          name: options.name ?? `${findFileName(file)} Bundler`,\n          prefix: false,\n          overrides: defu(\n            options.resolve ?? {},\n            { skipNodeModulesBundle: false },\n            context.config.resolve\n          ) as CreateUnpluginResolverOptions[\"overrides\"],\n          silenceHookLogging: true\n        })\n      )()\n    ].filter(Boolean)\n  } as BuildOptions);\n  if (!result.output || result.output.length === 0) {\n    throw new Error(\n      `No output files generated for ${\n        file\n      }. Please check the configuration and try again.`\n    );\n  }\n  if (result.output.length > 1) {\n    context.warn(\n      `Multiple output files generated for \"${\n        file\n      }\". Only the first file will be used. Please check the configuration to ensure only one output file is generated.`\n    );\n  }\n\n  return result.output[0];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiDA,eAAsB,OACpB,SACA,MACA,UAAyB,CAAC,GACJ;CACtB,MAAM,OAAO,MAAM,QAAQ,GAAG,QAAQ,IAAI;CAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,IAAI,GACtC,MAAM,IAAI,MACR,sBAAsB,KAAK,wCAC7B;CAGF,MAAM,cAAc,KAAK,SAAS;EAAC;EAAQ;EAAW;CAAS,CAAC;CAChE,MAAM,UAAU,MAAM,QAAQ,QAAQ,QAAQ,OAAO;CAIrD,MAAM,SAAS,MAAM,MAAM;EACzB,QAAQ;EACR,UAAU;EACV,GALsB,eAAe,OAKpB;EACjB,GAAG;EACH,UAAU;EACV,QAAQ;GACN,KAAK,QAAQ,OAAO,OAAO;GAC3B,QAAQ;GACR,WAAW;GACX,eAAe;GACf,QAAQ;GACR,WAAW;GACX,SAAS;GACT,GAAG,YAAY;EACjB;EACA,OAAO,CAAC,IAAI;EACZ,OAAO;EACP,SAAS,CACP,GAAI,UAAU,QAAQ,OAAO,IAAI,CAAC,GAClC,qBACE,uBAAuB,SAAS;GAC9B,MAAM,QAAQ,QAAQ,GAAG,aAAa,IAAI,EAAE;GAC5C,QAAQ;GACR,WAAW,KACT,QAAQ,WAAW,CAAC,GACpB,EAAE,uBAAuB,MAAM,GAC/B,QAAQ,OAAO,OACjB;GACA,oBAAoB;EACtB,CAAC,CACH,EAAE,CACJ,EAAE,OAAO,OAAO;CAClB,CAAiB;CACjB,IAAI,CAAC,OAAO,UAAU,OAAO,OAAO,WAAW,GAC7C,MAAM,IAAI,MACR,iCACE,KACD,gDACH;CAEF,IAAI,OAAO,OAAO,SAAS,GACzB,QAAQ,KACN,wCACE,KACD,iHACH;CAGF,OAAO,OAAO,OAAO;AACvB"}

package/dist/codegen.cjs

@@ -4,6 +4,7 @@ const require_type_checks = require('./type-checks.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_validate = require('./validate.cjs');
 let _stryke_convert_to_bool = require("@stryke/convert/to-bool");
+let _stryke_type_checks = require("@stryke/type-checks");
 let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
 let _stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
 let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
@@ -24,44 +25,49 @@ function stringifyValue(value, type) {
 */
 function stringifyType(schema) {
 	if (!schema) return "unknown";
-	if ((0, _stryke_type_checks_is_set_string.isSetString)(schema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(schema.$ref)?.[1] ?? schema.$ref;
+	if (typeof schema === "boolean") return schema ? "unknown" : "never";
+	const objectSchema = schema;
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(objectSchema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(objectSchema.$ref)?.[1] ?? objectSchema.$ref;
 	const primaryType = require_metadata.getPrimarySchemaType(schema);
 	if (primaryType) {
 		if (primaryType === "integer" || primaryType === "number") return "number";
 		return primaryType;
 	}
-	if (schema.type === "array" && Array.isArray(schema.enum)) return schema.enum.map((value) => JSON.stringify(value)).join(" | ");
-	if (schema.const !== void 0) return JSON.stringify(schema.const);
-	if (schema.type === "array" || schema.items) return `${stringifyType(Array.isArray(schema.items) ? schema.items[0] : schema.items)}[]`;
-	if (schema.type === "object" || schema.properties || schema.additionalProperties) {
-		if (require_type_checks.isJsonSchema(schema.additionalProperties)) return `{ [key: string]: ${stringifyType(schema.additionalProperties)} }`;
-		if (require_type_checks.isJsonSchemaObject(schema)) return `{ ${require_helpers.getPropertiesList(schema).map((property) => {
-			const suffix = schema.required?.includes(property.name) || property.nullable ? `${property.optional ? "?" : ""}${property.nullable ? " | null" : ""}` : "";
-			return `${property.name}${suffix}: ${stringifyType(property)}`;
-		}).join(";\n")} }`;
+	if (objectSchema.type === "array" && Array.isArray(objectSchema.enum)) return objectSchema.enum.map((value) => JSON.stringify(value)).join(" | ");
+	if (objectSchema.const !== void 0) return JSON.stringify(objectSchema.const);
+	if (objectSchema.type === "array" || objectSchema.items) return `${stringifyType(objectSchema.items)}[]`;
+	if (objectSchema.type === "object" || objectSchema.properties || objectSchema.additionalProperties) {
+		if (require_type_checks.isJsonSchema(objectSchema.additionalProperties)) return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;
+		if (require_type_checks.isJsonSchemaObject(objectSchema)) {
+			const required = objectSchema.required ?? [];
+			return `{ ${require_helpers.getPropertiesList(objectSchema).map((property) => {
+				const suffix = !required.includes(property.name) || require_helpers.isSchemaNullable(property) ? `${!required.includes(property.name) ? "?" : ""}${require_helpers.isSchemaNullable(property) ? " | null" : ""}` : "";
+				return `${property.name}${suffix}: ${stringifyType(property)}`;
+			}).join(";\n")} }`;
+		}
 	}
-	if (schema.oneOf || schema.anyOf) return (schema.oneOf ?? schema.anyOf ?? []).map((branch) => stringifyType(branch)).join(" | ");
-	if (schema.allOf) return "object";
+	if (objectSchema.oneOf || objectSchema.anyOf) return (objectSchema.oneOf ?? objectSchema.anyOf ?? []).map((branch) => stringifyType(branch)).join(" | ");
+	if (objectSchema.allOf) return "object";
 	return "unknown";
 }
 /**
-* Generates standalone JSON Schema validation code using Ajv.
+* Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+*
+* @param value - The value whose type is to be represented as a string.
+* @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
 */
-async function generateCode(schemas, refsOrFuncts) {
-	return (0, ajv_dist_standalone_index_js.default)(require_validate.getValidator(schemas), refsOrFuncts);
+function getJsonSchemaType(value) {
+	return (0, _stryke_type_checks_is_null.isNull)(value) ? "null" : (0, _stryke_type_checks_is_boolean.isBoolean)(value) ? "boolean" : (0, _stryke_type_checks.isInteger)(value) ? "integer" : (0, _stryke_type_checks_is_number.isNumber)(value) ? "number" : (0, _stryke_type_checks.isString)(value) ? "string" : (0, _stryke_type_checks.isObject)(value) ? "object" : Array.isArray(value) ? "array" : void 0;
 }
 /**
-* A helper function to determine if a JSON Schema fragment is nullable, for use in code generation.
-*
-* @param schema - The JSON Schema fragment to check.
-* @returns `true` if the schema is nullable, otherwise `false`. A schema is considered nullable if it has `nullable: true` or if its `type` includes `"null"`.
+* Generates standalone JSON Schema validation code using Ajv.
 */
-function isNullableSchema(schema) {
-	return require_metadata.isSchemaNullable(schema);
+async function generateCode(schemas, refsOrFuncts) {
+	return (0, ajv_dist_standalone_index_js.default)(require_validate.getValidator(schemas), refsOrFuncts);
 }
 
 //#endregion
 exports.generateCode = generateCode;
-exports.isNullableSchema = isNullableSchema;
+exports.getJsonSchemaType = getJsonSchemaType;
 exports.stringifyType = stringifyType;
 exports.stringifyValue = stringifyValue;

package/dist/codegen.d.cts

@@ -1,26 +1,26 @@
-import { JsonSchema, JsonSchemaPrimitiveType } from "./types.cjs";
+import { JsonSchema, JsonSchemaType } from "./types.cjs";
 import standaloneCode from "ajv/dist/standalone/index.js";
 
 //#region src/codegen.d.ts
 /**
  * Stringifies a value for generated TypeScript code.
  */
-declare function stringifyValue(value?: unknown, type?: JsonSchemaPrimitiveType | string): string;
+declare function stringifyValue(value?: unknown, type?: JsonSchemaType | string): string;
 /**
  * Stringifies a JSON Schema fragment into a TypeScript-like type string.
  */
-declare function stringifyType<T = unknown>(schema?: JsonSchema<T>): string;
+declare function stringifyType(schema?: JsonSchema): string;
 /**
- * Generates standalone JSON Schema validation code using Ajv.
+ * Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+ *
+ * @param value - The value whose type is to be represented as a string.
+ * @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
  */
-declare function generateCode<T = unknown>(schemas: JsonSchema<T>, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): Promise<string>;
+declare function getJsonSchemaType(value?: unknown): JsonSchemaType | undefined;
 /**
- * A helper function to determine if a JSON Schema fragment is nullable, for use in code generation.
- *
- * @param schema - The JSON Schema fragment to check.
- * @returns `true` if the schema is nullable, otherwise `false`. A schema is considered nullable if it has `nullable: true` or if its `type` includes `"null"`.
+ * Generates standalone JSON Schema validation code using Ajv.
  */
-declare function isNullableSchema(schema?: JsonSchema): boolean;
+declare function generateCode(schemas: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): Promise<string>;
 //#endregion
-export { generateCode, isNullableSchema, stringifyType, stringifyValue };
+export { generateCode, getJsonSchemaType, stringifyType, stringifyValue };
 //# sourceMappingURL=codegen.d.cts.map

package/dist/codegen.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.cts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAkCA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,uBAAuB;;;;iBAsBhB,aAAA,aAAA,CAA2B,MAAA,GAAS,UAAU,CAAC,CAAA;;;AAtBtB;iBA+FnB,YAAA,aAAA,CACpB,OAAA,EAAS,UAAA,CAAW,CAAA,GACpB,YAAA,GAAe,UAAA,QAAkB,cAAA,OAAkB,OAAA;;;;;;;iBAarC,gBAAA,CAAiB,MAAmB,GAAV,UAAU"}
+{"version":3,"file":"codegen.d.cts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAiDA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,cAAc;;;;iBAsBP,aAAA,CAAc,MAAmB,GAAV,UAAU;;;AAtBjB;AAsBhC;;;iBAsFgB,iBAAA,CAAkB,KAAA,aAAkB,cAAc;AAtFjB;AAsFjD;;AAtFiD,iBA2G3B,YAAA,CACpB,OAAA,EAAS,UAAA,EACT,YAAA,GAAe,UAAA,QAAkB,cAAA,OAAkB,OAAA"}

package/dist/codegen.d.mts

@@ -1,26 +1,26 @@
-import { JsonSchema, JsonSchemaPrimitiveType } from "./types.mjs";
+import { JsonSchema, JsonSchemaType } from "./types.mjs";
 import standaloneCode from "ajv/dist/standalone/index.js";
 
 //#region src/codegen.d.ts
 /**
  * Stringifies a value for generated TypeScript code.
  */
-declare function stringifyValue(value?: unknown, type?: JsonSchemaPrimitiveType | string): string;
+declare function stringifyValue(value?: unknown, type?: JsonSchemaType | string): string;
 /**
  * Stringifies a JSON Schema fragment into a TypeScript-like type string.
  */
-declare function stringifyType<T = unknown>(schema?: JsonSchema<T>): string;
+declare function stringifyType(schema?: JsonSchema): string;
 /**
- * Generates standalone JSON Schema validation code using Ajv.
+ * Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+ *
+ * @param value - The value whose type is to be represented as a string.
+ * @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
  */
-declare function generateCode<T = unknown>(schemas: JsonSchema<T>, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): Promise<string>;
+declare function getJsonSchemaType(value?: unknown): JsonSchemaType | undefined;
 /**
- * A helper function to determine if a JSON Schema fragment is nullable, for use in code generation.
- *
- * @param schema - The JSON Schema fragment to check.
- * @returns `true` if the schema is nullable, otherwise `false`. A schema is considered nullable if it has `nullable: true` or if its `type` includes `"null"`.
+ * Generates standalone JSON Schema validation code using Ajv.
  */
-declare function isNullableSchema(schema?: JsonSchema): boolean;
+declare function generateCode(schemas: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): Promise<string>;
 //#endregion
-export { generateCode, isNullableSchema, stringifyType, stringifyValue };
+export { generateCode, getJsonSchemaType, stringifyType, stringifyValue };
 //# sourceMappingURL=codegen.d.mts.map

package/dist/codegen.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.mts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAkCA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,uBAAuB;;;;iBAsBhB,aAAA,aAAA,CAA2B,MAAA,GAAS,UAAU,CAAC,CAAA;;;AAtBtB;iBA+FnB,YAAA,aAAA,CACpB,OAAA,EAAS,UAAA,CAAW,CAAA,GACpB,YAAA,GAAe,UAAA,QAAkB,cAAA,OAAkB,OAAA;;;;;;;iBAarC,gBAAA,CAAiB,MAAmB,GAAV,UAAU"}
+{"version":3,"file":"codegen.d.mts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAiDA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,cAAc;;;;iBAsBP,aAAA,CAAc,MAAmB,GAAV,UAAU;;;AAtBjB;AAsBhC;;;iBAsFgB,iBAAA,CAAkB,KAAA,aAAkB,cAAc;AAtFjB;AAsFjD;;AAtFiD,iBA2G3B,YAAA,CACpB,OAAA,EAAS,UAAA,EACT,YAAA,GAAe,UAAA,QAAkB,cAAA,OAAkB,OAAA"}

package/dist/codegen.mjs

@@ -1,13 +1,14 @@
-import { getPrimarySchemaType, isSchemaNullable } from "./metadata.mjs";
+import { getPrimarySchemaType } from "./metadata.mjs";
 import { isJsonSchema, isJsonSchemaObject } from "./type-checks.mjs";
-import { getPropertiesList } from "./helpers.mjs";
+import { getPropertiesList, isSchemaNullable } from "./helpers.mjs";
 import { getValidator } from "./validate.mjs";
 import { toBool } from "@stryke/convert/to-bool";
-import { isBoolean } from "@stryke/type-checks/is-boolean";
-import { isNull } from "@stryke/type-checks/is-null";
-import { isNumber } from "@stryke/type-checks/is-number";
-import { isSetString } from "@stryke/type-checks/is-set-string";
-import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { isInteger, isObject, isString } from "@stryke/type-checks";
+import { isBoolean as isBoolean$1 } from "@stryke/type-checks/is-boolean";
+import { isNull as isNull$1 } from "@stryke/type-checks/is-null";
+import { isNumber as isNumber$1 } from "@stryke/type-checks/is-number";
+import { isSetString as isSetString$1 } from "@stryke/type-checks/is-set-string";
+import { isUndefined as isUndefined$1 } from "@stryke/type-checks/is-undefined";
 import standaloneCode from "ajv/dist/standalone/index.js";
 
 //#region src/codegen.ts
@@ -15,49 +16,54 @@ import standaloneCode from "ajv/dist/standalone/index.js";
 * Stringifies a value for generated TypeScript code.
 */
 function stringifyValue(value, type) {
-	return isUndefined(value) ? "undefined" : isNull(value) ? "null" : type === "boolean" || isBoolean(value) ? String(toBool(value)) : type === "number" || isNumber(value) ? Number.parseFloat(String(value)).toLocaleString(void 0, { maximumFractionDigits: 20 }) : type === "integer" ? Number.parseInt(String(value)).toLocaleString() : type === "string" || type === "object" || type === "array" ? JSON.stringify(value) : String(value);
+	return isUndefined$1(value) ? "undefined" : isNull$1(value) ? "null" : type === "boolean" || isBoolean$1(value) ? String(toBool(value)) : type === "number" || isNumber$1(value) ? Number.parseFloat(String(value)).toLocaleString(void 0, { maximumFractionDigits: 20 }) : type === "integer" ? Number.parseInt(String(value)).toLocaleString() : type === "string" || type === "object" || type === "array" ? JSON.stringify(value) : String(value);
 }
 /**
 * Stringifies a JSON Schema fragment into a TypeScript-like type string.
 */
 function stringifyType(schema) {
 	if (!schema) return "unknown";
-	if (isSetString(schema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(schema.$ref)?.[1] ?? schema.$ref;
+	if (typeof schema === "boolean") return schema ? "unknown" : "never";
+	const objectSchema = schema;
+	if (isSetString$1(objectSchema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(objectSchema.$ref)?.[1] ?? objectSchema.$ref;
 	const primaryType = getPrimarySchemaType(schema);
 	if (primaryType) {
 		if (primaryType === "integer" || primaryType === "number") return "number";
 		return primaryType;
 	}
-	if (schema.type === "array" && Array.isArray(schema.enum)) return schema.enum.map((value) => JSON.stringify(value)).join(" | ");
-	if (schema.const !== void 0) return JSON.stringify(schema.const);
-	if (schema.type === "array" || schema.items) return `${stringifyType(Array.isArray(schema.items) ? schema.items[0] : schema.items)}[]`;
-	if (schema.type === "object" || schema.properties || schema.additionalProperties) {
-		if (isJsonSchema(schema.additionalProperties)) return `{ [key: string]: ${stringifyType(schema.additionalProperties)} }`;
-		if (isJsonSchemaObject(schema)) return `{ ${getPropertiesList(schema).map((property) => {
-			const suffix = schema.required?.includes(property.name) || property.nullable ? `${property.optional ? "?" : ""}${property.nullable ? " | null" : ""}` : "";
-			return `${property.name}${suffix}: ${stringifyType(property)}`;
-		}).join(";\n")} }`;
+	if (objectSchema.type === "array" && Array.isArray(objectSchema.enum)) return objectSchema.enum.map((value) => JSON.stringify(value)).join(" | ");
+	if (objectSchema.const !== void 0) return JSON.stringify(objectSchema.const);
+	if (objectSchema.type === "array" || objectSchema.items) return `${stringifyType(objectSchema.items)}[]`;
+	if (objectSchema.type === "object" || objectSchema.properties || objectSchema.additionalProperties) {
+		if (isJsonSchema(objectSchema.additionalProperties)) return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;
+		if (isJsonSchemaObject(objectSchema)) {
+			const required = objectSchema.required ?? [];
+			return `{ ${getPropertiesList(objectSchema).map((property) => {
+				const suffix = !required.includes(property.name) || isSchemaNullable(property) ? `${!required.includes(property.name) ? "?" : ""}${isSchemaNullable(property) ? " | null" : ""}` : "";
+				return `${property.name}${suffix}: ${stringifyType(property)}`;
+			}).join(";\n")} }`;
+		}
 	}
-	if (schema.oneOf || schema.anyOf) return (schema.oneOf ?? schema.anyOf ?? []).map((branch) => stringifyType(branch)).join(" | ");
-	if (schema.allOf) return "object";
+	if (objectSchema.oneOf || objectSchema.anyOf) return (objectSchema.oneOf ?? objectSchema.anyOf ?? []).map((branch) => stringifyType(branch)).join(" | ");
+	if (objectSchema.allOf) return "object";
 	return "unknown";
 }
 /**
-* Generates standalone JSON Schema validation code using Ajv.
+* Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+*
+* @param value - The value whose type is to be represented as a string.
+* @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
 */
-async function generateCode(schemas, refsOrFuncts) {
-	return standaloneCode(getValidator(schemas), refsOrFuncts);
+function getJsonSchemaType(value) {
+	return isNull$1(value) ? "null" : isBoolean$1(value) ? "boolean" : isInteger(value) ? "integer" : isNumber$1(value) ? "number" : isString(value) ? "string" : isObject(value) ? "object" : Array.isArray(value) ? "array" : void 0;
 }
 /**
-* A helper function to determine if a JSON Schema fragment is nullable, for use in code generation.
-*
-* @param schema - The JSON Schema fragment to check.
-* @returns `true` if the schema is nullable, otherwise `false`. A schema is considered nullable if it has `nullable: true` or if its `type` includes `"null"`.
+* Generates standalone JSON Schema validation code using Ajv.
 */
-function isNullableSchema(schema) {
-	return isSchemaNullable(schema);
+async function generateCode(schemas, refsOrFuncts) {
+	return standaloneCode(getValidator(schemas), refsOrFuncts);
 }
 
 //#endregion
-export { generateCode, isNullableSchema, stringifyType, stringifyValue };
+export { generateCode, getJsonSchemaType, stringifyType, stringifyValue };
 //# sourceMappingURL=codegen.mjs.map

package/dist/codegen.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.mjs","names":[],"sources":["../src/codegen.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toBool } from \"@stryke/convert/to-bool\";\nimport { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isNull } from \"@stryke/type-checks/is-null\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport standaloneCode from \"ajv/dist/standalone\";\nimport { getPropertiesList } from \"./helpers\";\nimport { getPrimarySchemaType, isSchemaNullable } from \"./metadata\";\nimport { isJsonSchema, isJsonSchemaObject } from \"./type-checks\";\nimport { JsonSchema, JsonSchemaPrimitiveType } from \"./types\";\nimport { getValidator } from \"./validate\";\n\n/**\n * Stringifies a value for generated TypeScript code.\n */\nexport function stringifyValue(\n  value?: unknown,\n  type?: JsonSchemaPrimitiveType | string\n): string {\n  return isUndefined(value)\n    ? \"undefined\"\n    : isNull(value)\n      ? \"null\"\n      : type === \"boolean\" || isBoolean(value)\n        ? String(toBool(value))\n        : type === \"number\" || isNumber(value)\n          ? Number.parseFloat(String(value)).toLocaleString(undefined, {\n              maximumFractionDigits: 20\n            })\n          : type === \"integer\"\n            ? Number.parseInt(String(value)).toLocaleString()\n            : type === \"string\" || type === \"object\" || type === \"array\"\n              ? JSON.stringify(value)\n              : String(value);\n}\n\n/**\n * Stringifies a JSON Schema fragment into a TypeScript-like type string.\n */\nexport function stringifyType<T = unknown>(schema?: JsonSchema<T>): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (isSetString(schema.$ref)) {\n    const match = /^#\\/(?:definitions|\\$defs)\\/(.+)$/.exec(schema.$ref);\n\n    return match?.[1] ?? schema.$ref;\n  }\n\n  const primaryType = getPrimarySchemaType(schema);\n  if (primaryType) {\n    if (primaryType === \"integer\" || primaryType === \"number\") {\n      return \"number\";\n    }\n\n    return primaryType;\n  }\n\n  if (schema.type === \"array\" && Array.isArray(schema.enum)) {\n    return schema.enum.map(value => JSON.stringify(value)).join(\" | \");\n  }\n\n  if (schema.const !== undefined) {\n    return JSON.stringify(schema.const);\n  }\n\n  if (schema.type === \"array\" || schema.items) {\n    const items = Array.isArray(schema.items) ? schema.items[0] : schema.items;\n\n    return `${stringifyType(items)}[]`;\n  }\n\n  if (\n    schema.type === \"object\" ||\n    schema.properties ||\n    schema.additionalProperties\n  ) {\n    if (isJsonSchema(schema.additionalProperties)) {\n      return `{ [key: string]: ${stringifyType(schema.additionalProperties)} }`;\n    }\n\n    if (isJsonSchemaObject(schema)) {\n      return `{ ${getPropertiesList(schema as JsonSchema<Record<string, any>>)\n        .map(property => {\n          const suffix =\n            schema.required?.includes(property.name) || property.nullable\n              ? `${property.optional ? \"?\" : \"\"}${property.nullable ? \" | null\" : \"\"}`\n              : \"\";\n\n          return `${property.name}${suffix}: ${stringifyType(property)}`;\n        })\n        .join(\";\\n\")} }`;\n    }\n  }\n\n  if (schema.oneOf || schema.anyOf) {\n    return ((schema.oneOf ?? schema.anyOf ?? []) as JsonSchema<T>[])\n      .map(branch => stringifyType(branch))\n      .join(\" | \");\n  }\n\n  if (schema.allOf) {\n    return \"object\";\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Generates standalone JSON Schema validation code using Ajv.\n */\nexport async function generateCode<T = unknown>(\n  schemas: JsonSchema<T>,\n  refsOrFuncts?: Parameters<typeof standaloneCode>[1]\n) {\n  const ajv = getValidator(schemas);\n\n  return standaloneCode(ajv, refsOrFuncts);\n}\n\n/**\n * A helper function to determine if a JSON Schema fragment is nullable, for use in code generation.\n *\n * @param schema - The JSON Schema fragment to check.\n * @returns `true` if the schema is nullable, otherwise `false`. A schema is considered nullable if it has `nullable: true` or if its `type` includes `\"null\"`.\n */\nexport function isNullableSchema(schema?: JsonSchema): boolean {\n  return isSchemaNullable(schema);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,SAAgB,eACd,OACA,MACQ;CACR,OAAO,YAAY,KAAK,IACpB,cACA,OAAO,KAAK,IACV,SACA,SAAS,aAAa,UAAU,KAAK,IACnC,OAAO,OAAO,KAAK,CAAC,IACpB,SAAS,YAAY,SAAS,KAAK,IACjC,OAAO,WAAW,OAAO,KAAK,CAAC,EAAE,eAAe,QAAW,EACzD,uBAAuB,GACzB,CAAC,IACD,SAAS,YACP,OAAO,SAAS,OAAO,KAAK,CAAC,EAAE,eAAe,IAC9C,SAAS,YAAY,SAAS,YAAY,SAAS,UACjD,KAAK,UAAU,KAAK,IACpB,OAAO,KAAK;AAC5B;;;;AAKA,SAAgB,cAA2B,QAAgC;CACzE,IAAI,CAAC,QACH,OAAO;CAGT,IAAI,YAAY,OAAO,IAAI,GAGzB,OAFc,oCAAoC,KAAK,OAAO,IAEnD,IAAI,MAAM,OAAO;CAG9B,MAAM,cAAc,qBAAqB,MAAM;CAC/C,IAAI,aAAa;EACf,IAAI,gBAAgB,aAAa,gBAAgB,UAC/C,OAAO;EAGT,OAAO;CACT;CAEA,IAAI,OAAO,SAAS,WAAW,MAAM,QAAQ,OAAO,IAAI,GACtD,OAAO,OAAO,KAAK,KAAI,UAAS,KAAK,UAAU,KAAK,CAAC,EAAE,KAAK,KAAK;CAGnE,IAAI,OAAO,UAAU,QACnB,OAAO,KAAK,UAAU,OAAO,KAAK;CAGpC,IAAI,OAAO,SAAS,WAAW,OAAO,OAGpC,OAAO,GAAG,cAFI,MAAM,QAAQ,OAAO,KAAK,IAAI,OAAO,MAAM,KAAK,OAAO,KAExC,EAAE;CAGjC,IACE,OAAO,SAAS,YAChB,OAAO,cACP,OAAO,sBACP;EACA,IAAI,aAAa,OAAO,oBAAoB,GAC1C,OAAO,oBAAoB,cAAc,OAAO,oBAAoB,EAAE;EAGxE,IAAI,mBAAmB,MAAM,GAC3B,OAAO,KAAK,kBAAkB,MAAyC,EACpE,KAAI,aAAY;GACf,MAAM,SACJ,OAAO,UAAU,SAAS,SAAS,IAAI,KAAK,SAAS,WACjD,GAAG,SAAS,WAAW,MAAM,KAAK,SAAS,WAAW,YAAY,OAClE;GAEN,OAAO,GAAG,SAAS,OAAO,OAAO,IAAI,cAAc,QAAQ;EAC7D,CAAC,EACA,KAAK,KAAK,EAAE;CAEnB;CAEA,IAAI,OAAO,SAAS,OAAO,OACzB,QAAS,OAAO,SAAS,OAAO,SAAS,CAAC,GACvC,KAAI,WAAU,cAAc,MAAM,CAAC,EACnC,KAAK,KAAK;CAGf,IAAI,OAAO,OACT,OAAO;CAGT,OAAO;AACT;;;;AAKA,eAAsB,aACpB,SACA,cACA;CAGA,OAAO,eAFK,aAAa,OAED,GAAG,YAAY;AACzC;;;;;;;AAQA,SAAgB,iBAAiB,QAA8B;CAC7D,OAAO,iBAAiB,MAAM;AAChC"}
+{"version":3,"file":"codegen.mjs","names":["isUndefined","isNull","isBoolean","isNumber","isSetString"],"sources":["../src/codegen.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toBool } from \"@stryke/convert/to-bool\";\nimport { isInteger, isObject, isString } from \"@stryke/type-checks\";\nimport { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isNull } from \"@stryke/type-checks/is-null\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport standaloneCode from \"ajv/dist/standalone\";\nimport { getPropertiesList, isSchemaNullable } from \"./helpers\";\nimport { getPrimarySchemaType } from \"./metadata\";\nimport { isJsonSchema, isJsonSchemaObject } from \"./type-checks\";\nimport { JsonSchema, JsonSchemaType } from \"./types\";\nimport { getValidator } from \"./validate\";\n\ninterface JsonSchemaObjectView {\n  $ref?: string;\n  type?: JsonSchemaType | readonly JsonSchemaType[];\n  enum?: readonly unknown[];\n  const?: unknown;\n  items?: JsonSchema;\n  properties?: Record<string, JsonSchema>;\n  additionalProperties?: boolean | JsonSchema;\n  required?: string[];\n  oneOf?: JsonSchema[];\n  anyOf?: JsonSchema[];\n  allOf?: JsonSchema[];\n}\n\n/**\n * Stringifies a value for generated TypeScript code.\n */\nexport function stringifyValue(\n  value?: unknown,\n  type?: JsonSchemaType | string\n): string {\n  return isUndefined(value)\n    ? \"undefined\"\n    : isNull(value)\n      ? \"null\"\n      : type === \"boolean\" || isBoolean(value)\n        ? String(toBool(value))\n        : type === \"number\" || isNumber(value)\n          ? Number.parseFloat(String(value)).toLocaleString(undefined, {\n              maximumFractionDigits: 20\n            })\n          : type === \"integer\"\n            ? Number.parseInt(String(value)).toLocaleString()\n            : type === \"string\" || type === \"object\" || type === \"array\"\n              ? JSON.stringify(value)\n              : String(value);\n}\n\n/**\n * Stringifies a JSON Schema fragment into a TypeScript-like type string.\n */\nexport function stringifyType(schema?: JsonSchema): string {\n  if (!schema) {\n    return \"unknown\";\n  }\n\n  if (typeof schema === \"boolean\") {\n    return schema ? \"unknown\" : \"never\";\n  }\n\n  const objectSchema = schema as JsonSchemaObjectView;\n\n  if (isSetString(objectSchema.$ref)) {\n    const match = /^#\\/(?:definitions|\\$defs)\\/(.+)$/.exec(objectSchema.$ref);\n\n    return match?.[1] ?? objectSchema.$ref;\n  }\n\n  const primaryType = getPrimarySchemaType(schema);\n  if (primaryType) {\n    if (primaryType === \"integer\" || primaryType === \"number\") {\n      return \"number\";\n    }\n\n    return primaryType;\n  }\n\n  if (objectSchema.type === \"array\" && Array.isArray(objectSchema.enum)) {\n    const enumValues = objectSchema.enum as readonly unknown[];\n\n    return enumValues\n      .map((value: unknown) => JSON.stringify(value))\n      .join(\" | \");\n  }\n\n  if (objectSchema.const !== undefined) {\n    return JSON.stringify(objectSchema.const);\n  }\n\n  if (objectSchema.type === \"array\" || objectSchema.items) {\n    return `${stringifyType(objectSchema.items)}[]`;\n  }\n\n  if (\n    objectSchema.type === \"object\" ||\n    objectSchema.properties ||\n    objectSchema.additionalProperties\n  ) {\n    if (isJsonSchema(objectSchema.additionalProperties)) {\n      return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;\n    }\n\n    if (isJsonSchemaObject(objectSchema)) {\n      const required = objectSchema.required ?? [];\n\n      return `{ ${getPropertiesList(objectSchema)\n        .map(property => {\n          const suffix =\n            !required.includes(property.name) || isSchemaNullable(property)\n              ? `${!required.includes(property.name) ? \"?\" : \"\"}${isSchemaNullable(property) ? \" | null\" : \"\"}`\n              : \"\";\n\n          return `${property.name}${suffix}: ${stringifyType(property)}`;\n        })\n        .join(\";\\n\")} }`;\n    }\n  }\n\n  if (objectSchema.oneOf || objectSchema.anyOf) {\n    return (objectSchema.oneOf ?? objectSchema.anyOf ?? [])\n      .map(branch => stringifyType(branch))\n      .join(\" | \");\n  }\n\n  if (objectSchema.allOf) {\n    return \"object\";\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.\n *\n * @param value - The value whose type is to be represented as a string.\n * @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.\n */\nexport function getJsonSchemaType(value?: unknown): JsonSchemaType | undefined {\n  return isNull(value)\n    ? \"null\"\n    : isBoolean(value)\n      ? \"boolean\"\n      : isInteger(value)\n        ? \"integer\"\n        : isNumber(value)\n          ? \"number\"\n          : isString(value)\n            ? \"string\"\n            : isObject(value)\n              ? \"object\"\n              : Array.isArray(value)\n                ? \"array\"\n                : undefined;\n}\n\n/**\n * Generates standalone JSON Schema validation code using Ajv.\n */\nexport async function generateCode(\n  schemas: JsonSchema,\n  refsOrFuncts?: Parameters<typeof standaloneCode>[1]\n) {\n  const ajv = getValidator(schemas);\n\n  return standaloneCode(ajv, refsOrFuncts);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiDA,SAAgB,eACd,OACA,MACQ;CACR,OAAOA,cAAY,KAAK,IACpB,cACAC,SAAO,KAAK,IACV,SACA,SAAS,aAAaC,YAAU,KAAK,IACnC,OAAO,OAAO,KAAK,CAAC,IACpB,SAAS,YAAYC,WAAS,KAAK,IACjC,OAAO,WAAW,OAAO,KAAK,CAAC,EAAE,eAAe,QAAW,EACzD,uBAAuB,GACzB,CAAC,IACD,SAAS,YACP,OAAO,SAAS,OAAO,KAAK,CAAC,EAAE,eAAe,IAC9C,SAAS,YAAY,SAAS,YAAY,SAAS,UACjD,KAAK,UAAU,KAAK,IACpB,OAAO,KAAK;AAC5B;;;;AAKA,SAAgB,cAAc,QAA6B;CACzD,IAAI,CAAC,QACH,OAAO;CAGT,IAAI,OAAO,WAAW,WACpB,OAAO,SAAS,YAAY;CAG9B,MAAM,eAAe;CAErB,IAAIC,cAAY,aAAa,IAAI,GAG/B,OAFc,oCAAoC,KAAK,aAAa,IAEzD,IAAI,MAAM,aAAa;CAGpC,MAAM,cAAc,qBAAqB,MAAM;CAC/C,IAAI,aAAa;EACf,IAAI,gBAAgB,aAAa,gBAAgB,UAC/C,OAAO;EAGT,OAAO;CACT;CAEA,IAAI,aAAa,SAAS,WAAW,MAAM,QAAQ,aAAa,IAAI,GAGlE,OAFmB,aAAa,KAG7B,KAAK,UAAmB,KAAK,UAAU,KAAK,CAAC,EAC7C,KAAK,KAAK;CAGf,IAAI,aAAa,UAAU,QACzB,OAAO,KAAK,UAAU,aAAa,KAAK;CAG1C,IAAI,aAAa,SAAS,WAAW,aAAa,OAChD,OAAO,GAAG,cAAc,aAAa,KAAK,EAAE;CAG9C,IACE,aAAa,SAAS,YACtB,aAAa,cACb,aAAa,sBACb;EACA,IAAI,aAAa,aAAa,oBAAoB,GAChD,OAAO,oBAAoB,cAAc,aAAa,oBAAoB,EAAE;EAG9E,IAAI,mBAAmB,YAAY,GAAG;GACpC,MAAM,WAAW,aAAa,YAAY,CAAC;GAE3C,OAAO,KAAK,kBAAkB,YAAY,EACvC,KAAI,aAAY;IACf,MAAM,SACJ,CAAC,SAAS,SAAS,SAAS,IAAI,KAAK,iBAAiB,QAAQ,IAC1D,GAAG,CAAC,SAAS,SAAS,SAAS,IAAI,IAAI,MAAM,KAAK,iBAAiB,QAAQ,IAAI,YAAY,OAC3F;IAEN,OAAO,GAAG,SAAS,OAAO,OAAO,IAAI,cAAc,QAAQ;GAC7D,CAAC,EACA,KAAK,KAAK,EAAE;EACjB;CACF;CAEA,IAAI,aAAa,SAAS,aAAa,OACrC,QAAQ,aAAa,SAAS,aAAa,SAAS,CAAC,GAClD,KAAI,WAAU,cAAc,MAAM,CAAC,EACnC,KAAK,KAAK;CAGf,IAAI,aAAa,OACf,OAAO;CAGT,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAA6C;CAC7E,OAAOH,SAAO,KAAK,IACf,SACAC,YAAU,KAAK,IACb,YACA,UAAU,KAAK,IACb,YACAC,WAAS,KAAK,IACZ,WACA,SAAS,KAAK,IACZ,WACA,SAAS,KAAK,IACZ,WACA,MAAM,QAAQ,KAAK,IACjB,UACA;AAClB;;;;AAKA,eAAsB,aACpB,SACA,cACA;CAGA,OAAO,eAFK,aAAa,OAED,GAAG,YAAY;AACzC"}

package/dist/constants.cjs

@@ -1,6 +1,6 @@
 
 //#region src/constants.ts
-const JsonSchemaTypes = {
+const JsonSchemaTypeNames = {
 	STRING: "string",
 	NUMBER: "number",
 	INTEGER: "integer",
@@ -9,14 +9,17 @@ const JsonSchemaTypes = {
 	OBJECT: "object",
 	ARRAY: "array"
 };
-const JSON_SCHEMA_DATA_TYPES = [
-	JsonSchemaTypes.STRING,
-	JsonSchemaTypes.NUMBER,
-	JsonSchemaTypes.INTEGER,
-	JsonSchemaTypes.BOOLEAN,
-	JsonSchemaTypes.ARRAY,
-	JsonSchemaTypes.OBJECT,
-	JsonSchemaTypes.NULL
+const JSON_SCHEMA_PRIMITIVE_TYPES = [
+	JsonSchemaTypeNames.STRING,
+	JsonSchemaTypeNames.NUMBER,
+	JsonSchemaTypeNames.INTEGER,
+	JsonSchemaTypeNames.BOOLEAN,
+	JsonSchemaTypeNames.NULL
+];
+const JSON_SCHEMA_TYPES = [
+	...JSON_SCHEMA_PRIMITIVE_TYPES,
+	JsonSchemaTypeNames.ARRAY,
+	JsonSchemaTypeNames.OBJECT
 ];
 const JSON_SCHEMA_METADATA_KEYS = [
 	"docs",
@@ -35,6 +38,7 @@ const JSON_SCHEMA_METADATA_KEYS = [
 ];
 
 //#endregion
-exports.JSON_SCHEMA_DATA_TYPES = JSON_SCHEMA_DATA_TYPES;
 exports.JSON_SCHEMA_METADATA_KEYS = JSON_SCHEMA_METADATA_KEYS;
-exports.JsonSchemaTypes = JsonSchemaTypes;
+exports.JSON_SCHEMA_PRIMITIVE_TYPES = JSON_SCHEMA_PRIMITIVE_TYPES;
+exports.JSON_SCHEMA_TYPES = JSON_SCHEMA_TYPES;
+exports.JsonSchemaTypeNames = JsonSchemaTypeNames;

package/dist/constants.d.cts

@@ -1,5 +1,5 @@
 //#region src/constants.d.ts
-declare const JsonSchemaTypes: {
+declare const JsonSchemaTypeNames: {
   readonly STRING: "string";
   readonly NUMBER: "number";
   readonly INTEGER: "integer";
@@ -8,8 +8,9 @@ declare const JsonSchemaTypes: {
   readonly OBJECT: "object";
   readonly ARRAY: "array";
 };
-declare const JSON_SCHEMA_DATA_TYPES: readonly ["string", "number", "integer", "boolean", "array", "object", "null"];
+declare const JSON_SCHEMA_PRIMITIVE_TYPES: readonly ["string", "number", "integer", "boolean", "null"];
+declare const JSON_SCHEMA_TYPES: readonly ["string", "number", "integer", "boolean", "null", "array", "object"];
 declare const JSON_SCHEMA_METADATA_KEYS: ("title" | "description" | "docs" | "examples" | "alias" | "tags" | "deprecated" | "hidden" | "ignore" | "internal" | "runtime" | "readOnly" | "writeOnly")[];
 //#endregion
-export { JSON_SCHEMA_DATA_TYPES, JSON_SCHEMA_METADATA_KEYS, JsonSchemaTypes };
+export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames };
 //# sourceMappingURL=constants.d.cts.map

package/dist/constants.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.cts","names":[],"sources":["../src/constants.ts"],"mappings":";cAoBa,eAAA;EAAA;;;;;;;;cAUA,sBAAA;AAAA,cAUA,yBAAA"}
+{"version":3,"file":"constants.d.cts","names":[],"sources":["../src/constants.ts"],"mappings":";cAoBa,mBAAA;EAAA;;;;;;;;cAUA,2BAAA;AAAA,cAQA,iBAAA;AAAA,cAMA,yBAAA"}

package/dist/constants.d.mts

@@ -1,5 +1,5 @@
 //#region src/constants.d.ts
-declare const JsonSchemaTypes: {
+declare const JsonSchemaTypeNames: {
   readonly STRING: "string";
   readonly NUMBER: "number";
   readonly INTEGER: "integer";
@@ -8,8 +8,9 @@ declare const JsonSchemaTypes: {
   readonly OBJECT: "object";
   readonly ARRAY: "array";
 };
-declare const JSON_SCHEMA_DATA_TYPES: readonly ["string", "number", "integer", "boolean", "array", "object", "null"];
+declare const JSON_SCHEMA_PRIMITIVE_TYPES: readonly ["string", "number", "integer", "boolean", "null"];
+declare const JSON_SCHEMA_TYPES: readonly ["string", "number", "integer", "boolean", "null", "array", "object"];
 declare const JSON_SCHEMA_METADATA_KEYS: ("title" | "description" | "docs" | "examples" | "alias" | "tags" | "deprecated" | "hidden" | "ignore" | "internal" | "runtime" | "readOnly" | "writeOnly")[];
 //#endregion
-export { JSON_SCHEMA_DATA_TYPES, JSON_SCHEMA_METADATA_KEYS, JsonSchemaTypes };
+export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames };
 //# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.mts","names":[],"sources":["../src/constants.ts"],"mappings":";cAoBa,eAAA;EAAA;;;;;;;;cAUA,sBAAA;AAAA,cAUA,yBAAA"}
+{"version":3,"file":"constants.d.mts","names":[],"sources":["../src/constants.ts"],"mappings":";cAoBa,mBAAA;EAAA;;;;;;;;cAUA,2BAAA;AAAA,cAQA,iBAAA;AAAA,cAMA,yBAAA"}

package/dist/constants.mjs

@@ -1,5 +1,5 @@
 //#region src/constants.ts
-const JsonSchemaTypes = {
+const JsonSchemaTypeNames = {
 	STRING: "string",
 	NUMBER: "number",
 	INTEGER: "integer",
@@ -8,14 +8,17 @@ const JsonSchemaTypes = {
 	OBJECT: "object",
 	ARRAY: "array"
 };
-const JSON_SCHEMA_DATA_TYPES = [
-	JsonSchemaTypes.STRING,
-	JsonSchemaTypes.NUMBER,
-	JsonSchemaTypes.INTEGER,
-	JsonSchemaTypes.BOOLEAN,
-	JsonSchemaTypes.ARRAY,
-	JsonSchemaTypes.OBJECT,
-	JsonSchemaTypes.NULL
+const JSON_SCHEMA_PRIMITIVE_TYPES = [
+	JsonSchemaTypeNames.STRING,
+	JsonSchemaTypeNames.NUMBER,
+	JsonSchemaTypeNames.INTEGER,
+	JsonSchemaTypeNames.BOOLEAN,
+	JsonSchemaTypeNames.NULL
+];
+const JSON_SCHEMA_TYPES = [
+	...JSON_SCHEMA_PRIMITIVE_TYPES,
+	JsonSchemaTypeNames.ARRAY,
+	JsonSchemaTypeNames.OBJECT
 ];
 const JSON_SCHEMA_METADATA_KEYS = [
 	"docs",
@@ -34,5 +37,5 @@ const JSON_SCHEMA_METADATA_KEYS = [
 ];
 
 //#endregion
-export { JSON_SCHEMA_DATA_TYPES, JSON_SCHEMA_METADATA_KEYS, JsonSchemaTypes };
+export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames };
 //# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { SchemaMetadata } from \"./types\";\n\nexport const JsonSchemaTypes = {\n  STRING: \"string\",\n  NUMBER: \"number\",\n  INTEGER: \"integer\",\n  BOOLEAN: \"boolean\",\n  NULL: \"null\",\n  OBJECT: \"object\",\n  ARRAY: \"array\"\n} as const;\n\nexport const JSON_SCHEMA_DATA_TYPES = [\n  JsonSchemaTypes.STRING,\n  JsonSchemaTypes.NUMBER,\n  JsonSchemaTypes.INTEGER,\n  JsonSchemaTypes.BOOLEAN,\n  JsonSchemaTypes.ARRAY,\n  JsonSchemaTypes.OBJECT,\n  JsonSchemaTypes.NULL\n] as const;\n\nexport const JSON_SCHEMA_METADATA_KEYS = [\n  \"docs\",\n  \"deprecated\",\n  \"title\",\n  \"description\",\n  \"examples\",\n  \"hidden\",\n  \"ignore\",\n  \"internal\",\n  \"runtime\",\n  \"readOnly\",\n  \"writeOnly\",\n  \"alias\",\n  \"tags\"\n] satisfies ReadonlyArray<keyof SchemaMetadata>;\n"],"mappings":";AAoBA,MAAa,kBAAkB;CAC7B,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,SAAS;CACT,MAAM;CACN,QAAQ;CACR,OAAO;AACT;AAEA,MAAa,yBAAyB;CACpC,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;AAClB;AAEA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"constants.mjs","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { JsonSchemaMetadataKeywords } from \"./types\";\n\nexport const JsonSchemaTypeNames = {\n  STRING: \"string\",\n  NUMBER: \"number\",\n  INTEGER: \"integer\",\n  BOOLEAN: \"boolean\",\n  NULL: \"null\",\n  OBJECT: \"object\",\n  ARRAY: \"array\"\n} as const;\n\nexport const JSON_SCHEMA_PRIMITIVE_TYPES = [\n  JsonSchemaTypeNames.STRING,\n  JsonSchemaTypeNames.NUMBER,\n  JsonSchemaTypeNames.INTEGER,\n  JsonSchemaTypeNames.BOOLEAN,\n  JsonSchemaTypeNames.NULL\n] as const;\n\nexport const JSON_SCHEMA_TYPES = [\n  ...JSON_SCHEMA_PRIMITIVE_TYPES,\n  JsonSchemaTypeNames.ARRAY,\n  JsonSchemaTypeNames.OBJECT\n] as const;\n\nexport const JSON_SCHEMA_METADATA_KEYS = [\n  \"docs\",\n  \"deprecated\",\n  \"title\",\n  \"description\",\n  \"examples\",\n  \"hidden\",\n  \"ignore\",\n  \"internal\",\n  \"runtime\",\n  \"readOnly\",\n  \"writeOnly\",\n  \"alias\",\n  \"tags\"\n] satisfies ReadonlyArray<keyof JsonSchemaMetadataKeywords>;\n"],"mappings":";AAoBA,MAAa,sBAAsB;CACjC,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,SAAS;CACT,MAAM;CACN,QAAQ;CACR,OAAO;AACT;AAEA,MAAa,8BAA8B;CACzC,oBAAoB;CACpB,oBAAoB;CACpB,oBAAoB;CACpB,oBAAoB;CACpB,oBAAoB;AACtB;AAEA,MAAa,oBAAoB;CAC/B,GAAG;CACH,oBAAoB;CACpB,oBAAoB;AACtB;AAEA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}