@gukhanmun/stdict-cdb 0.4.0-dev.245 → 0.4.0-dev.248

package/dist/index.d.ts

@@ -1,5 +1,11 @@
-import { FileDictionarySource, FileDictionarySource as FileDictionarySource$1 } from "@gukhanmun/types";
-/** URL of the bundled Standard Korean Language Dictionary CDB binary. */
+import { FileDictionarySource, FileDictionarySource as FileDictionarySource$1, SourceRole } from "@gukhanmun/types";
+/**
+ * URL of the bundled, gzip-compressed Standard Korean Language Dictionary CDB.
+ *
+ * The URL now points to `stdict.cdb.gz` to fit registry per-file limits.
+ * {@link stdictCdbBytes} transparently returns the decompressed CDB bytes.
+ * The npm package also retains its raw `stdict.cdb` file export.
+ */
 export declare const stdictCdbUrl: URL;
 /**
  * Loads the bundled Standard Korean Language Dictionary as raw bytes.
@@ -15,7 +21,10 @@ export declare const stdictCdbUrl: URL;
  * wrongly take the `node:fs` path and `readFile` would reject the `https:`
  * URL with "The URL must be of scheme file".
  *
- * @param url Location of the CDB binary to read.  Defaults to the bundled
+ * Gzip is detected from the payload's magic bytes, so compressed files are
+ * inflated transparently and relocated raw CDB files remain supported.
+ *
+ * @param url Location of the raw or gzip-compressed CDB to read. Defaults to the bundled
  *   {@link stdictCdbUrl}; pass another URL to load a relocated copy.
  * @returns The CDB binary as a `Uint8Array`.
  */
@@ -24,7 +33,7 @@ export declare function stdictCdbBytes(url?: URL): Promise<Uint8Array<ArrayBuffe
  * Loads the bundled Standard Korean Language Dictionary as a
  * {@link FileDictionarySource} ready to pass to `load({ dictionaries: [...] })`.
  *
- * @returns A `FileDictionarySource` with `format: "cdb"`.
+ * @returns A `FileDictionarySource` with `format: "cdb"` and `role: "reference"`.
  */
 export declare function stdictCdb(): Promise<FileDictionarySource$1>;
-export type { FileDictionarySource };
+export type { FileDictionarySource, SourceRole };

package/dist/index.js

@@ -1,6 +1,12 @@
 // index.ts
-/** URL of the bundled Standard Korean Language Dictionary CDB binary. */
-const stdictCdbUrl = new URL("./stdict.cdb", import.meta.url);
+/**
+* URL of the bundled, gzip-compressed Standard Korean Language Dictionary CDB.
+*
+* The URL now points to `stdict.cdb.gz` to fit registry per-file limits.
+* {@link stdictCdbBytes} transparently returns the decompressed CDB bytes.
+* The npm package also retains its raw `stdict.cdb` file export.
+*/
+const stdictCdbUrl = new URL("./stdict.cdb.gz", import.meta.url);
 /**
 * Loads the bundled Standard Korean Language Dictionary as raw bytes.
 *
@@ -15,7 +21,10 @@ const stdictCdbUrl = new URL("./stdict.cdb", import.meta.url);
 * wrongly take the `node:fs` path and `readFile` would reject the `https:`
 * URL with "The URL must be of scheme file".
 *
-* @param url Location of the CDB binary to read.  Defaults to the bundled
+* Gzip is detected from the payload's magic bytes, so compressed files are
+* inflated transparently and relocated raw CDB files remain supported.
+*
+* @param url Location of the raw or gzip-compressed CDB to read. Defaults to the bundled
 *   {@link stdictCdbUrl}; pass another URL to load a relocated copy.
 * @returns The CDB binary as a `Uint8Array`.
 */
@@ -25,22 +34,28 @@ async function stdictCdbBytes(url = stdictCdbUrl) {
 			/* webpackIgnore: true */
 			"node:fs/promises"
 )).readFile(url);
-		return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+		return inflateIfGzip(new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
 	}
 	const response = await fetch(url);
 	if (!response.ok) throw new Error(`Failed to fetch stdict CDB: HTTP ${response.status}`);
-	return new Uint8Array(await response.arrayBuffer());
+	return inflateIfGzip(new Uint8Array(await response.arrayBuffer()));
+}
+async function inflateIfGzip(bytes) {
+	if (bytes.length < 2 || bytes[0] !== 31 || bytes[1] !== 139) return bytes;
+	const stream = new Blob([bytes]).stream().pipeThrough(new DecompressionStream("gzip"));
+	return new Uint8Array(await new Response(stream).arrayBuffer());
 }
 /**
 * Loads the bundled Standard Korean Language Dictionary as a
 * {@link FileDictionarySource} ready to pass to `load({ dictionaries: [...] })`.
 *
-* @returns A `FileDictionarySource` with `format: "cdb"`.
+* @returns A `FileDictionarySource` with `format: "cdb"` and `role: "reference"`.
 */
 async function stdictCdb() {
 	return {
 		data: await stdictCdbBytes(),
-		format: "cdb"
+		format: "cdb",
+		role: "reference"
 	};
 }
 export { stdictCdb, stdictCdbBytes, stdictCdbUrl };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gukhanmun/stdict-cdb",
-  "version": "0.4.0-dev.245",
+  "version": "0.4.0-dev.248",
   "description": "Standard Korean Language Dictionary bundled as a CDB binary for @gukhanmun/wasm and @gukhanmun/napi.",
   "type": "module",
   "exports": {
@@ -9,7 +9,8 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./stdict.cdb": "./dist/stdict.cdb"
+    "./stdict.cdb": "./dist/stdict.cdb",
+    "./stdict.cdb.gz": "./dist/stdict.cdb.gz"
   },
   "files": [
     "dist"
@@ -55,9 +56,9 @@
     "@gukhanmun/types": "*"
   },
   "devDependencies": {
-    "@gukhanmun/types": "0.4.0-dev.245+223a736"
+    "@gukhanmun/types": "0.4.0-dev.248+36997e7"
   },
   "scripts": {
-    "build": "tsdown && node -e \"require('node:fs').copyFileSync('stdict.cdb','dist/stdict.cdb')\""
+    "build": "tsdown && node -e \"const fs=require('node:fs');for(const f of ['stdict.cdb','stdict.cdb.gz'])fs.copyFileSync(f,'dist/'+f)\""
   }
 }