@shrkcrft/compress 0.1.0-alpha.16 → 0.1.0-alpha.17

package/dist/compress-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress-content.d.ts","sourceRoot":"","sources":["../src/compress-content.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAWrE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,kBAAkB,CA4B7F"}
+{"version":3,"file":"compress-content.d.ts","sourceRoot":"","sources":["../src/compress-content.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAYrE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,kBAAkB,CAS7F"}

package/dist/compress-content.js

@@ -3,6 +3,7 @@ import { detectContentType } from "./content/detect-content-type.js";
 import { segmentContent, isRichSegmentType } from "./content/segment.js";
 import { ECompressionStrategy } from "./result/compression-strategy.js";
 import { measureSavings } from "./tokens/estimate-tokens.js";
+import { passthroughResult } from "./text/finalize.js";
 import { compressJson } from "./json/compress-json.js";
 import { compressLog } from "./text/compress-log.js";
 import { compressSearch } from "./text/compress-search.js";
@@ -18,6 +19,16 @@ import { compressCode } from "./code/compress-code.js";
  * and options always yield the same output.
  */
 export function compressContent(text, opts = {}) {
+    const result = routeCompressContent(text, opts);
+    // `lossless` is a hard guard applied at the single entry point so it catches
+    // every lossy path (text elision, JSON row-sampling, mixed) uniformly: a
+    // result that drops information is replaced by the verbatim original.
+    if (opts.lossless && result.lossy) {
+        return passthroughResult(text, result.contentType, 'lossless requested — lossy reduction skipped');
+    }
+    return result;
+}
+function routeCompressContent(text, opts) {
     const type = opts.contentType ?? detectContentType(text);
     switch (type) {
         case EContentType.JsonArray:

package/dist/result/compress-options.d.ts

@@ -14,6 +14,13 @@ export interface ICompressOptions {
     contentType?: EContentType;
     /** Soft cap on retained items/lines/matches/hunks (compressor-specific). */
     maxItems?: number;
+    /**
+     * Refuse any lossy reduction: a pass that would drop lines/rows/hunks
+     * returns the input untouched (passthrough) instead. Provably-lossless
+     * transforms (JSON columnar, dedup that round-trips) still apply. Lets a
+     * caller demand "shrink only if fully reconstructable from the output alone".
+     */
+    lossless?: boolean;
     /** Below this many lines a lossy text pass returns the input untouched. */
     minLines?: number;
     /**

package/dist/result/compress-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress-options.d.ts","sourceRoot":"","sources":["../../src/result/compress-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"compress-options.d.ts","sourceRoot":"","sources":["../../src/result/compress-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/table/compact-object-array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact-object-array.d.ts","sourceRoot":"","sources":["../../src/table/compact-object-array.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqC9D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAwC1E"}
+{"version":3,"file":"compact-object-array.d.ts","sourceRoot":"","sources":["../../src/table/compact-object-array.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqC9D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CA2C1E"}

package/dist/table/compact-object-array.js

@@ -63,7 +63,10 @@ export function compactObjectArray(items) {
         const row = [];
         for (let c = 0; c < colNames.length; c += 1) {
             const key = colNames[c];
-            const present = key in item && item[key] !== undefined;
+            // `key in item` walks the prototype chain, so a column named after an
+            // Object.prototype member (`toString`, `hasOwnProperty`, …) would read the
+            // inherited member as a cell value. Own-property check keeps it lossless.
+            const present = Object.prototype.hasOwnProperty.call(item, key) && item[key] !== undefined;
             if (!present) {
                 absent.push([r, c]);
                 row.push(null);

package/dist/table/object-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-map.d.ts","sourceRoot":"","sources":["../../src/table/object-map.ts"],"names":[],"mappings":"AAyBA,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gFAAgF;IAChF,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAClB,yFAAyF;IACzF,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAmClE;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAU1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmB9E"}
+{"version":3,"file":"object-map.d.ts","sourceRoot":"","sources":["../../src/table/object-map.ts"],"names":[],"mappings":"AAyBA,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gFAAgF;IAChF,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAClB,yFAAyF;IACzF,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAqClE;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAU1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmB9E"}

package/dist/table/object-map.js

@@ -46,7 +46,9 @@ export function compactObjectMap(value) {
         const row = [];
         for (let c = 0; c < cols.length; c += 1) {
             const key = cols[c];
-            if (key in entry && entry[key] !== undefined) {
+            // Own-property check (not `key in entry`, which walks the prototype chain)
+            // so a column named after an Object.prototype member isn't read as a value.
+            if (Object.prototype.hasOwnProperty.call(entry, key) && entry[key] !== undefined) {
                 row.push(entry[key]);
             }
             else {

package/dist/text/finalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/text/finalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,YAAY,EACzB,IAAI,SAAmC,GACtC,kBAAkB,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,YAAY,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,kBAAkB,CAgCrB"}
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/text/finalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,YAAY,EACzB,IAAI,SAAmC,GACtC,kBAAkB,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,YAAY,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,kBAAkB,CAsCrB"}

package/dist/text/finalize.js

@@ -30,13 +30,19 @@ export function finalizeLossy(params) {
     let key;
     if (opts.store) {
         key = opts.store.put(original);
+        // Make inline `… N lines omitted` placeholders self-describing: a reader
+        // who only sees a clipped middle of the output otherwise can't tell the
+        // dropped detail is retrievable. Annotate each with the recovery key.
+        compressed = annotateElisionMarkers(body, key);
         // Skip the trailing marker when the body already references THIS key inline
         // (e.g. compressLog's per-drop elision hints) — no need to repeat it. A
         // different inline key (e.g. a diff's per-section keys) still gets the
         // whole-blob marker appended. The marker carries only the key: the human
         // `note` is shipped separately in the result, so repeating it on the wire
         // would just cost tokens.
-        compressed = body.includes(`<<ccr:${key}`) ? body : `${body}\n${formatCcrMarker(key)}`;
+        compressed = compressed.includes(`<<ccr:${key}`)
+            ? compressed
+            : `${compressed}\n${formatCcrMarker(key)}`;
     }
     const savings = measureSavings(original, compressed, contentType);
     if (savings.after >= savings.before) {
@@ -52,3 +58,16 @@ export function finalizeLossy(params) {
         note,
     };
 }
+/**
+ * Append the recovery key to each `… N line(s) omitted` placeholder produced by
+ * {@link elide} (used by the markdown/search/lines compressors), so a clipped
+ * view still advertises that the dropped detail is retrievable via `shrk expand`.
+ * Deterministic; leaves bodies without such markers (logs/diffs use their own
+ * keyed hints) untouched.
+ */
+function annotateElisionMarkers(body, key) {
+    // Match ONLY a standalone-line `… N lines omitted` (what elide() emits, on its
+    // own line). The lookahead for end-of-line excludes compressLog's inline-keyed
+    // markers (`… N lines omitted → <<ccr:KEY>>`), which already carry the key.
+    return body.replace(/(… \d+ lines? omitted)(?=\n|$)/g, (marker) => `${marker} (shrk expand ${key})`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/compress",
-  "version": "0.1.0-alpha.16",
+  "version": "0.1.0-alpha.17",
   "description": "SharkCraft deterministic context-compression engine: content routing, lossless columnar/table compaction, log/search/diff line reduction, and reversible Compress-Cache-Retrieve (CCR). No model inside — every transform is a pure function of its input.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -44,7 +44,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.16"
+    "@shrkcrft/core": "^0.1.0-alpha.17"
   },
   "publishConfig": {
     "access": "public"