base128-ascii 0.0.1

package/LICENSE.txt

@@ -0,0 +1,8 @@
+The MIT License (MIT)
+Copyright © 2025 bddjr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+Smaller than Base64, only use ASCII, can run in web browser.
+
+---
+
+Char Code (ASCII) :
+
+```js
+'\0\1\2\3\4\5\6\7\b\t\n\v\f\r\x0E\x0F\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1A\x1B\x1C\x1D\x1E\x1F !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~\x7F';
+```
+
+The first byte indicates the length of the last incomplete block, 0 means no incomplete block.
+
+```js
+`4LF3 `
+`0LF3!Tl7`
+```
+
+Test effect, Base128 is 10KB smaller than Base64:
+
+```
+screenshot-45.519.jpg
+file length: 682086
+
+encodeToTemplateLiterals:
+bytes length: 804861
+eval length: 779528
+decoded length: 682086
+equal: true
+
+base64:
+length: 909448
+```
+
+---
+
+The project was born for [vite-plugin-singlefile-compression](https://github.com/bddjr/vite-plugin-singlefile-compression).
+
+Made by bddjr, using MIT License.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export declare function encode(input: Uint8Array): string;
+export declare function stringToTemplateLiterals(input: string): string;
+export declare function encodeToTemplateLiterals(input: Uint8Array): string;
+export declare function decode(input: string): Uint8Array<ArrayBuffer>;
+declare const base128: {
+    encode: typeof encode;
+    encodeToTemplateLiterals: typeof encodeToTemplateLiterals;
+    decode: typeof decode;
+};
+export default base128;

package/dist/index.js

@@ -0,0 +1,68 @@
+export function encode(input) {
+    let out = new Uint8Array(Math.ceil(input.length / 7) * 8 + 1);
+    const suffixSize = input.length % 7;
+    out[0] = suffixSize + 48;
+    for (let ii = 0, oi = 1; ii < input.length;) {
+        let chunk = BigInt(input[ii++] || 0) << 48n;
+        chunk |= BigInt(input[ii++] || 0) << 40n;
+        chunk |= BigInt(input[ii++] || 0) << 32n;
+        chunk |= BigInt(input[ii++] || 0) << 24n;
+        chunk |= BigInt(input[ii++] || 0) << 16n;
+        chunk |= BigInt(input[ii++] || 0) << 8n;
+        chunk |= BigInt(input[ii++] || 0);
+        out[oi++] = Number(chunk >> 49n);
+        out[oi++] = Number((chunk >> 42n) & 127n);
+        out[oi++] = Number((chunk >> 35n) & 127n);
+        out[oi++] = Number((chunk >> 28n) & 127n);
+        out[oi++] = Number((chunk >> 21n) & 127n);
+        out[oi++] = Number((chunk >> 14n) & 127n);
+        out[oi++] = Number((chunk >> 7n) & 127n);
+        out[oi++] = Number(chunk & 127n);
+    }
+    if (suffixSize)
+        out = out.slice(0, Math.ceil(suffixSize / 7 * 8) - 8);
+    return new TextDecoder().decode(out);
+}
+export function stringToTemplateLiterals(input) {
+    return '`' + input.replace(/[\r\\`]|\${|\0\d?/g, (match) => match[0] == '\0'
+        ? match.length == 2
+            ? '\\x00' + match[1]
+            : '\\0'
+        : match == '\r'
+            ? '\\r'
+            : '\\' + match) + '`';
+}
+export function encodeToTemplateLiterals(input) {
+    return stringToTemplateLiterals(encode(input));
+}
+export function decode(input) {
+    const u8a = new TextEncoder().encode(input);
+    const out = new Uint8Array(Math.ceil((u8a.length - 1) / 8) * 7);
+    for (let ii = 1, oi = 0; ii < u8a.length;) {
+        let chunk = BigInt(u8a[ii++] || 0) << 49n;
+        chunk |= BigInt(u8a[ii++] || 0) << 42n;
+        chunk |= BigInt(u8a[ii++] || 0) << 35n;
+        chunk |= BigInt(u8a[ii++] || 0) << 28n;
+        chunk |= BigInt(u8a[ii++] || 0) << 21n;
+        chunk |= BigInt(u8a[ii++] || 0) << 14n;
+        chunk |= BigInt(u8a[ii++] || 0) << 7n;
+        chunk |= BigInt(u8a[ii++] || 0);
+        out[oi++] = Number(chunk >> 48n);
+        out[oi++] = Number((chunk >> 40n) & 255n);
+        out[oi++] = Number((chunk >> 32n) & 255n);
+        out[oi++] = Number((chunk >> 24n) & 255n);
+        out[oi++] = Number((chunk >> 16n) & 255n);
+        out[oi++] = Number((chunk >> 8n) & 255n);
+        out[oi++] = Number(chunk & 255n);
+    }
+    const suffixSize = u8a[0] - 48;
+    if (suffixSize)
+        return out.slice(0, suffixSize - 7);
+    return out;
+}
+const base128 = {
+    encode,
+    encodeToTemplateLiterals,
+    decode
+};
+export default base128;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "base128-ascii",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "test": "npm run build && node test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bddjr/base128.git"
+  },
+  "author": "bddjr",
+  "license": "MIT",
+  "description": "",
+  "files": [
+    "dist",
+    "README.md",
+    "package.json",
+    "package-lock.json"
+  ],
+  "dependencies": {
+    "@types/node": "^22.10.5",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.2"
+  }
+}