@leojsandkotdev/korusjs 0.1.0

package/.si.json

@@ -0,0 +1,10 @@
+{
+  "plugin": "org.smartide.plugin.editor",
+  "run": "npx tsc src/index.ts", 
+  "intelligence": {
+    ".json": {
+      "enabled": true,
+      "run": "vscode-json-language-server --stdio"
+    }
+  }
+}

package/README.md

@@ -0,0 +1,54 @@
+# korusjs 🚀
+
+A **korusjs** é uma biblioteca leve e robusta para TypeScript, projetada para lidar com valores nulos, opcionais e transformações de dados de forma segura. 
+
+Este projeto é a evolução da **koruspy**, minha biblioteca original escrita em Python, agora trazendo a mesma filosofia de segurança para o ecossistema JavaScript/TypeScript.
+
+---
+
+## ✨ Características
+
+* **Type Safety:** Evite erros de `null` ou `undefined` em tempo de execução.
+* **Inspirada na koruspy:** Mantém a lógica de tratamento de dados que criei na versão Python.
+* **Leve e Rápida:** Sem dependências externas, perfeita para projetos de qualquer tamanho.
+* **Desenvolvida no Termux:** Criada e testada inteiramente em ambiente mobile (Android).
+
+---
+
+## 📦 Instalação
+
+```bash
+npm install korusjs
+```
+## 🛠️ Como Usar
+Usando o tipo Option
+O Option permite que você lide com valores que podem não existir sem quebrar o seu código.
+```typescript
+import { OptionOf } from 'korusjs';
+
+// Criando um valor seguro
+const nome = OptionOf("Usuário").unwrapOr("Desconhecido");
+
+// Lidando com valores nulos
+const nulo = OptionOf(null).unwrapOr("Valor Padrão");
+console.log(nulo); // "Valor Padrão"
+
+// Conversão segura de tipos
+const numero = OptionOf("42").toInt();
+console.log(numero.isSome()); // true
+```
+
+## Funções Úteis (println)
+A biblioteca também inclui utilitários práticos para saída de dados:
+```typescript
+import { println } from 'korusjs';
+
+println("Korusjs está pronta!", true); 
+// Imprime com quebra de linha
+```
+
+## 🧑‍💻 Sobre o Projeto
+Olá! Eu tenho 12 anos e sou o criador da koruspy e agora da korusjs. Desenvolvi esta biblioteca para aprender mais sobre TypeScript e para facilitar o meu próprio fluxo de trabalho no Android usando o Termux.
+Este projeto não busca ser "ultra-profissional", mas sim funcional, educativo e seguro. Foi feito de um estudante para outros desenvolvedores que gostam de simplicidade.
+📄 Licença
+Este projeto está sob a licença MIT.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./option.ts";
+export { println, advancedPrintln } from "./println.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./option.ts";
+export { println, advancedPrintln } from "./println.ts";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/option.d.ts

@@ -0,0 +1,35 @@
+export type Option<T> = Some<T> | Nothing;
+export declare class Nothing {
+    readonly kind: "nothing";
+    toString(): string;
+    map<U>(_fn: (v: any) => U): Option<U>;
+    getValue<T>(): null;
+    filter(_fn: (v: any) => boolean): Option<any>;
+    finalize<T>(): never;
+    unwrapOr<T>(defaultValue: T): T;
+    unwrapOrElse<T>(_fn: () => T): T;
+    isPresent(): boolean;
+    ifPresent(_fn: (v: any) => void): void;
+    andThen<U>(_fn: (v: never) => Option<U>): Option<U>;
+    toInt(): Option<number>;
+}
+export declare const _nothing: Nothing;
+export declare class Some<T> {
+    private readonly value;
+    readonly kind: "some";
+    constructor(value: T);
+    toString(): string;
+    unwrapOr(defaultValue: T): T;
+    toInt(): Option<number>;
+    finalize(): T;
+    filter(fn: (v: T) => boolean): Option<T>;
+    map<U>(fn: (v: T) => U): Option<U>;
+    unwrapOrElse(fn: () => T): T;
+    andThen<U>(fn: (v: T) => Option<U>): Option<U>;
+    ifPresent(fn: (v: T) => void): void;
+    isPresent(): boolean;
+    getValue(): Some<T>;
+}
+export declare function OptionOf<T>(value: T | null | undefined, defaultValue?: T): Option<T>;
+export { _nothing as nothing };
+//# sourceMappingURL=option.d.ts.map

package/dist/option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../src/option.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAE1C,qBAAa,OAAO;IAChB,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;IAClC,QAAQ,IAAI,MAAM;IAGlB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAGrC,QAAQ,CAAC,CAAC,KAAK,IAAI;IAGnB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC;IAG7C,QAAQ,CAAC,CAAC,KAAK,KAAK;IAGpB,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC;IAG/B,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;IAGhC,SAAS,IAAG,OAAO;IAGnB,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAGtC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAGnD,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;CAG1B;AACD,eAAO,MAAM,QAAQ,SAAgB,CAAC;AAEtC,qBAAa,IAAI,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAS;gBACF,KAAK,EAAE,CAAC;IACrC,QAAQ,IAAI,MAAM;IAGlB,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC;IAG5B,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;IAIvB,QAAQ,IAAI,CAAC;IAGb,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAGxC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAGjC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAG5B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAO9C,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAGnC,SAAS,IAAI,OAAO;IAGpB,QAAQ,IAAG,IAAI,CAAC,CAAC,CAAC;CAGrB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAQpF;AACD,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,CAAC"}

package/dist/option.js

@@ -0,0 +1,94 @@
+export class Nothing {
+    kind = "nothing";
+    toString() {
+        return "Nothing";
+    }
+    map(_fn) {
+        return this;
+    }
+    getValue() {
+        return null;
+    }
+    filter(_fn) {
+        return this;
+    }
+    finalize() {
+        throw new Error("tried to finalize value from Nothing type");
+    }
+    unwrapOr(defaultValue) {
+        return defaultValue;
+    }
+    unwrapOrElse(_fn) {
+        return _fn();
+    }
+    isPresent() {
+        return false;
+    }
+    ifPresent(_fn) {
+        return;
+    }
+    andThen(_fn) {
+        return this;
+    }
+    toInt() {
+        return this;
+    }
+}
+export const _nothing = new Nothing();
+export class Some {
+    value;
+    kind = "some";
+    constructor(value) {
+        this.value = value;
+    }
+    toString() {
+        return `Some(${JSON.stringify(this.value)})`;
+    }
+    unwrapOr(defaultValue) {
+        return this.value;
+    }
+    toInt() {
+        const n = Number(this.value);
+        return isNaN(n) ? _nothing : new Some(n);
+    }
+    finalize() {
+        return this.value;
+    }
+    filter(fn) {
+        return fn(this.value) ? this : _nothing;
+    }
+    map(fn) {
+        return new Some(fn(this.value));
+    }
+    unwrapOrElse(fn) {
+        return this.value;
+    }
+    andThen(fn) {
+        try {
+            return fn(this.value);
+        }
+        catch (e) {
+            return _nothing;
+        }
+    }
+    ifPresent(fn) {
+        fn(this.value);
+    }
+    isPresent() {
+        return true;
+    }
+    getValue() {
+        return new Some(this.value);
+    }
+}
+export function OptionOf(value, defaultValue) {
+    if (value != null) {
+        return new Some(value);
+    }
+    if (defaultValue != null) {
+        return new Some(defaultValue);
+    }
+    return _nothing;
+}
+export { _nothing as nothing };
+//# sourceMappingURL=option.js.map

package/dist/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../src/option.ts"],"names":[],"mappings":"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"}

package/dist/option.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=option.test.d.ts.map

package/dist/option.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.test.d.ts","sourceRoot":"","sources":["../src/option.test.ts"],"names":[],"mappings":""}

package/dist/option.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { Some, nothing, OptionOf } from './option.ts'; // ajuste o caminho
+describe('Option (korusjs)', () => {
+    it('deve converter string para int com sucesso', () => {
+        const s = new Some("10");
+        const result = s.toInt();
+        expect(result.finalize()).toBe(10);
+    });
+    it('deve retornar nothing ao falhar no toInt', () => {
+        const s = new Some("abc");
+        const result = s.toInt();
+        expect(result.kind).toBe("nothing");
+    });
+    it('deve lançar erro ao dar finalize num Nothing', () => {
+        expect(() => {
+            nothing.finalize();
+        }).toThrow("tried to finalize value from Nothing type");
+    });
+    it('deve funcionar o unwrapOr', () => {
+        expect(nothing.unwrapOr(50)).toBe(50);
+        expect(new Some(10).unwrapOr(50)).toBe(10);
+    });
+    it('deve manter o fluxo no andThen', () => {
+        const res = new Some(5)
+            .andThen(v => new Some(v * 2))
+            .finalize();
+        expect(res).toBe(10);
+    });
+});
+//# sourceMappingURL=option.test.js.map

package/dist/option.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.test.js","sourceRoot":"","sources":["../src/option.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC,CAAC,mBAAmB;AAE1E,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAE9B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,EAAE;YACR,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;aAClB,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aAC7B,QAAQ,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/println.d.ts

@@ -0,0 +1,6 @@
+export declare function println(...args: unknown[]): void;
+export declare function advancedPrintln(options?: {
+    newLine?: boolean;
+    decimals?: number;
+}, ...args: unknown[]): void;
+//# sourceMappingURL=println.d.ts.map

package/dist/println.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"println.d.ts","sourceRoot":"","sources":["../src/println.ts"],"names":[],"mappings":"AACA,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,QAqCzC;AACD,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAC,MAAM,CAAA;CAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAmCxG"}

package/dist/println.js

@@ -0,0 +1,77 @@
+import { Some, Nothing } from "./option.ts";
+export function println(...args) {
+    let outputs = [];
+    args.forEach(arg => {
+        switch (typeof (arg)) {
+            case "string":
+            case "boolean":
+                outputs.push(String(arg));
+                break;
+            case "number":
+                outputs.push(String(Number.isInteger(arg) ? arg : arg.toFixed(4)));
+                break;
+            case "object":
+                if (arg === null) {
+                    outputs.push("null");
+                    break;
+                }
+                else if (Array.isArray(arg)) {
+                    outputs.push("[" + arg.map(x => String(x)).join(", ") + "]");
+                    break;
+                }
+                else if (arg instanceof Some) {
+                    outputs.push(String(arg));
+                }
+                else if (arg instanceof Nothing) {
+                    outputs.push("Nothing");
+                }
+                else {
+                    outputs.push(JSON.stringify(arg, null, 2));
+                    break;
+                }
+            default:
+                outputs.push(String(arg));
+        }
+    });
+    outputs.forEach(output => {
+        process.stdout.write(JSON.stringify(output, null, 2));
+        process.stdout.write("\n");
+    });
+}
+export function advancedPrintln(options = {}, ...args) {
+    let outputs = [];
+    const newLine = options.newLine ?? true;
+    const decimals = options.decimals ?? 2;
+    args.forEach(arg => {
+        switch (typeof (arg)) {
+            case "string":
+            case "boolean":
+                outputs.push(String(arg));
+                break;
+            case "number":
+                outputs.push(String(Number.isInteger(arg) ? arg : arg.toFixed(Number(decimals))));
+                break;
+            case "object":
+                if (arg === null) {
+                    outputs.push("null");
+                    break;
+                }
+                else if (Array.isArray(arg)) {
+                    outputs.push("[" + arg.map(x => String(x)).join(", ") + "]");
+                    break;
+                }
+                else {
+                    outputs.push(JSON.stringify(arg, null, 2));
+                    break;
+                }
+            default:
+                outputs.push(String(arg));
+        }
+    });
+    const separador = newLine ? "\n" : " ";
+    const outputFinal = outputs.join(separador);
+    console.log(outputFinal);
+    if (newLine)
+        process.stdout.write("\n");
+}
+//# sourceMappingURL=println.js.map

package/dist/println.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"println.js","sourceRoot":"","sources":["../src/println.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@leojsandkotdev/korusjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.0",
+  "description": "Option / Result handling inspired and made by the author of koruspy library",
+  "main": "index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "debug": "npx tsx src/index.ts",
+    "runjscode": "node dist/index.js",
+    "build": "tsc --outDir dist",
+    "vitest": "vitest run",
+    "vitest:watch": "vitest"
+  },
+  "keywords": [],
+  "author": "leonardo",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "tsx": "latest",
+    "typescript": "latest",
+    "vitest": "^4.0.16"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./option.ts";
+export { println, advancedPrintln } from "./println.ts"

package/src/option.test.ts

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { Some, nothing, OptionOf } from './option.ts'; // ajuste o caminho
+
+describe('Option (korusjs)', () => {
+    
+    it('deve converter string para int com sucesso', () => {
+        const s = new Some("10");
+        const result = s.toInt();
+        expect(result.finalize()).toBe(10);
+    });
+
+    it('deve retornar nothing ao falhar no toInt', () => {
+        const s = new Some("abc");
+        const result = s.toInt();
+        expect(result.kind).toBe("nothing");
+    });
+
+    it('deve lançar erro ao dar finalize num Nothing', () => {
+        expect(() => {
+            nothing.finalize();
+        }).toThrow("tried to finalize value from Nothing type");
+    });
+
+    it('deve funcionar o unwrapOr', () => {
+        expect(nothing.unwrapOr(50)).toBe(50);
+        expect(new Some(10).unwrapOr(50)).toBe(10);
+    });
+
+    it('deve manter o fluxo no andThen', () => {
+        const res = new Some(5)
+            .andThen(v => new Some(v * 2))
+            .finalize();
+        expect(res).toBe(10);
+    });
+});

package/src/option.ts

@@ -0,0 +1,93 @@
+export type Option<T> = Some<T> | Nothing;
+
+export class Nothing{
+    readonly kind = "nothing" as const
+    toString(): string{
+        return "Nothing"
+    }
+    map<U>(_fn: (v: any) => U): Option<U>{
+        return this;
+    }
+    getValue<T>(): null{
+        return null;
+    }
+    filter(_fn: (v: any) => boolean): Option<any>{
+        return this;
+    }
+    finalize<T>(): never{
+        throw new Error("tried to finalize value from Nothing type");
+    }
+    unwrapOr<T>(defaultValue: T): T{
+        return defaultValue;
+    }
+    unwrapOrElse<T>(_fn: () => T): T {
+        return _fn();
+    }
+    isPresent():boolean{
+        return false;
+    }
+    ifPresent(_fn: (v: any) => void): void{
+        return;
+    }
+    andThen<U>(_fn: (v: never) => Option<U>): Option<U>{
+        return this;
+    }
+    toInt(): Option<number>{
+        return this;
+    }
+}
+export const _nothing = new Nothing();
+
+export class Some<T> {
+    readonly kind = "some" as const
+    constructor(private readonly value: T){}
+    toString(): string{
+        return `Some(${JSON.stringify(this.value)})`
+    }
+    unwrapOr(defaultValue: T): T {
+        return this.value;
+    }
+    toInt(): Option<number>{
+        const n = Number(this.value);
+        return isNaN(n) ? _nothing : new Some(n);
+    }
+    finalize(): T{
+        return this.value;
+    }
+    filter(fn: (v: T) => boolean): Option<T>{
+        return fn(this.value) ? this : _nothing
+    }
+    map<U>(fn: (v:T) => U): Option<U>{
+        return new Some(fn(this.value));
+    }
+    unwrapOrElse(fn: () => T): T{
+        return this.value;
+    }
+    andThen<U>(fn: (v: T) => Option<U>): Option<U> {
+        try{
+            return fn(this.value);
+        } catch(e){
+            return _nothing;
+        }
+    }
+    ifPresent(fn: (v: T) => void): void {
+        fn(this.value);
+    }
+    isPresent(): boolean{
+        return true;
+    }
+    getValue():Some<T>{
+        return new Some(this.value)
+    }
+}
+
+export function OptionOf<T>(value: T | null | undefined, defaultValue?: T): Option<T>{
+    if(value != null){
+        return new Some(value);
+    }
+    if(defaultValue != null){
+        return new Some(defaultValue);
+    }
+    return _nothing;
+}
+export { _nothing as nothing };

package/src/println.ts

@@ -0,0 +1,75 @@
+import { Some, Nothing } from "./option.ts";
+export function println(...args: unknown[]){
+    let outputs: unknown[] = [];
+    
+    args.forEach(arg => {
+        switch(typeof(arg)){
+            case "string":
+            case "boolean":
+                outputs.push(String(arg));
+                break;
+            case "number":
+                outputs.push(String(Number.isInteger(arg) ? arg : arg.toFixed(4)));
+                break;
+            case "object":
+                if(arg === null){
+                    outputs.push("null");
+                    break;
+                }
+                else if(Array.isArray(arg)){
+                    outputs.push("[" + arg.map(x => String(x)).join(", ")+"]");
+                    break;
+                }else if(arg instanceof Some){
+                    outputs.push(String(arg))
+                }else if(arg instanceof Nothing){
+                    outputs.push("Nothing")
+                }else{
+                    outputs.push(JSON.stringify(arg,null,2));
+                    break;
+                }
+            default:
+                outputs.push(String(arg));
+        }
+        
+    });
+    outputs.forEach(output => {
+        process.stdout.write(JSON.stringify(output,null,2));
+        process.stdout.write("\n")
+    });
+}
+export function advancedPrintln(options: { newLine?: boolean; decimals?:number } = {} ,...args: unknown[]){
+    let outputs: unknown[] = [];
+    const newLine = options.newLine?? true;
+    const decimals = options.decimals?? 2;
+    args.forEach(arg => {
+        switch(typeof(arg)){
+            case "string":
+            case "boolean":
+                outputs.push(String(arg));
+                break;
+            case "number":
+                outputs.push(String(Number.isInteger(arg) ? arg : arg.toFixed(Number(decimals))));
+                break;
+            case "object":
+                if(arg === null){
+                    outputs.push("null");
+                    break;
+                }
+                else if(Array.isArray(arg)){
+                    outputs.push("[" + arg.map(x => String(x)).join(", ")+"]");
+                    break;
+                }else{
+                    outputs.push(JSON.stringify(arg,null,2));
+                    break;
+                }
+            default:
+                outputs.push(String(arg));
+        }
+        
+    });
+    const separador = newLine ? "\n" : " ";
+    const outputFinal = outputs.join(separador);
+    
+    console.log(outputFinal);
+    if(newLine) process.stdout.write("\n");
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "target": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ESNext"],
+    "types": ["node"],
+    "allowImportingTsExtensions": true,
+    "rewriteRelativeImportExtensions": true,
+    "noEmit": true
+    },
+
+    
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+
+    
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+
+    "jsx": "react-jsx",
+  
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "output"]
+}