@unraven/env 1.0.0

package/README.md

@@ -0,0 +1 @@
+# Env

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+//#region src/types.d.ts
+interface EnvFlags {
+  override: boolean;
+  ignore: boolean;
+  commented: boolean;
+}
+//#endregion
+//#region src/formatters/types.d.ts
+interface Groupable {
+  name: string;
+}
+interface Formattable {
+  name: string;
+  value: string | null;
+  flags?: EnvFlags;
+  comments?: string[];
+}
+interface FormatterContract {
+  format(items: Formattable[], options?: object): string;
+}
+//#endregion
+//#region src/formatters/base.formatter.d.ts
+declare abstract class BaseFormatter {
+  protected type: string;
+  constructor(type: string);
+  static sort<T extends Groupable>(items: T[]): T[];
+  protected toSorted<T extends Groupable>(items: T[]): T[];
+}
+//#endregion
+//#region src/formatters/dotenv.formatter.d.ts
+interface EnvFormatterOptions {
+  headers?: string[];
+  eol?: string;
+}
+declare class DotenvFormatter extends BaseFormatter implements FormatterContract {
+  group<T extends Groupable>(items: T[]): T[][];
+  format(items: Formattable[], options?: EnvFormatterOptions): string;
+  private resolvePrefix;
+  private escapeValue;
+}
+//#endregion
+//#region src/formatters/json.formatter.d.ts
+declare class JsonFormatter extends BaseFormatter implements FormatterContract {
+  format(items: Formattable[]): string;
+  private asObject;
+  private asArray;
+}
+//#endregion
+//#region src/formatters/yaml.formatter.d.ts
+declare class YamlFormatter extends BaseFormatter implements FormatterContract {
+  format(items: Formattable[]): string;
+  private escapeValue;
+}
+//#endregion
+//#region src/formatter.d.ts
+declare class Formatter<T extends Record<string, new (type: string) => FormatterContract>, Format extends Extract<keyof T, string> = Extract<keyof T, string>> {
+  private formatters;
+  constructor(formatters: T);
+  use<Type extends Format>(type: Type): InstanceType<T[Type]>;
+  detect(file: string): string;
+  format<Type extends Format>(type: Type, items: Formattable[], options?: Parameters<InstanceType<T[Type]>['format']>[1]): string;
+}
+//#endregion
+//#region src/index.d.ts
+declare const formatter: Formatter<{
+  dotenv: typeof DotenvFormatter;
+  json: typeof JsonFormatter;
+  json_array: typeof JsonFormatter;
+  yaml: typeof YamlFormatter;
+}, "dotenv" | "json" | "json_array" | "yaml">;
+//#endregion
+export { formatter };

package/dist/index.js

@@ -0,0 +1,6 @@
+var e=class{constructor(e){this.formatters=e}use(e){if(!this.formatters[e])throw Error(`Invalid format "${e}".`);return new this.formatters[e](e)}detect(e){switch(e.split(`.`).slice(1).pop()?.toLowerCase()??``){case`json`:return`json`;case`yml`:case`yaml`:return`yaml`;default:return`dotenv`}}format(e,t,n={}){return this.use(e).format(t,n)}},t=class e{constructor(e){this.type=e}static sort(e){return e.toSorted((e,t)=>e.name.localeCompare(t.name))}toSorted(t){return e.sort(t)}};const n=[`NUXT`,`NUXT_PUBLIC`,`NEXT`,`NEXT_PUBLIC`,`VITE`];var r=class extends t{group(e){let t={},n=this.toSorted(e);for(let e of n){let{common:n,prefix:r}=this.resolvePrefix(e.name),i=t[r];i||(i={items:[],common:n,name:r},t[r]=i),i.items.push(e)}return Object.values(t).sort((e,t)=>e.common.localeCompare(t.common)).map(e=>e.items)}format(e,t={}){let n=[],r=t.eol??`
+`,i=t.headers??[];i.length>0&&n.push(...i,``);let a=this.group(e);for(let e of a){for(let t of e){n.push(...t.comments??[]);let e=Object.entries(t.flags??{}).filter(([e,t])=>t&&e!==`commented`);if(e.length>0){let t=e.map(([e])=>`@${e}`).join(` `);n.push(`# ${t}`)}let r=`${t.name}=${this.escapeValue(t.value??``)}`;t.flags?.commented&&(r=`# ${r}`),n.push(r)}n.push(``)}return n.join(r)}resolvePrefix(e){let t=e.split(`_`),r=[];do r.push(t.shift());while(t.length>0&&n.includes(r.join(`_`)));return{prefix:r.join(`_`),common:r.slice(0,r.length-1).join(`_`),name:r.slice(r.length-1).join(`_`)}}escapeValue(e){return/[ \n\r\t"'\\]/.test(e)?`"${e.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`).replace(/\n/g,`\\n`).replace(/\r/g,`\\r`).replace(/\t/g,`\\t`)}"`:e}},i=class extends t{format(e){let t=this.toSorted(e),n;switch(this.type){case`json_array`:n=this.asArray(t);break;default:n=this.asObject(t);break}return JSON.stringify(n,null,2)}asObject(e){return e.reduce((e,t)=>(e[t.name]=t.value,e),{})}asArray(e){return e.map(e=>({name:e.name,value:e.value}))}};const a=new e({dotenv:r,json:i,json_array:i,yaml:class extends t{format(e){return this.toSorted(e).map(e=>`${e.name}: ${this.escapeValue(e.value??``)}`).join(`
+`)}escapeValue(e){return e.includes(`
+`)?`|\n${e.split(`
+`).map(e=>`  ${e}`).join(`
+`)}`:/^\d/.test(e)||/[\n\r\t:#[\]{}&*!|>'"@`]/.test(e)||e.trim()!==e?`"${e.replace(/"/g,`\\"`)}"`:e}}});export{a as formatter};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@unraven/env",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Environment utilities for Unraven projects.",
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "source": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "imports": {
+    "#/*": "./src/*.js"
+  },
+  "devDependencies": {
+    "@outloud/eslint-config": "^3.0.0",
+    "@types/node": "^24.10.0",
+    "eslint": "^10.1.0",
+    "release-it": "^19.0.5",
+    "tsdown": "^0.15.12",
+    "typescript": "~5.8",
+    "vitest": "^1.5.0"
+  },
+  "scripts": {
+    "dev": "vitest dev",
+    "test": "vitest --config .config/vitest.config.ts",
+    "build": "tsdown --config .config/tsdown.config.ts",
+    "lint": "eslint .",
+    "typecheck": "tsc --project tsconfig.build.json --noEmit",
+    "release": "release-it --config .config/release-it.json"
+  }
+}