Merge pull request #2 from ZON-Format/copilot/update-zonf-extension

Standardize format identifiers to 'zonf' throughout codebase and bump version to 1.3.1

Author: ronibhakta1

benchmarks/scripts/comprehensive-benchmark.js

@@ -81,21 +81,21 @@ for (const datasetName of datasetNames) {
 
   results.byDataset[datasetName] = {
     gpt4o: {
-      zon: zonTokensGPT,
+      zonf: zonTokensGPT,
       toon: toonTokensGPT,
       json: jsonTokensGPT,
       savingsVsTOON: parseFloat(savingsVsTOON_GPT),
       savingsVsJSON: parseFloat(savingsVsJSON_GPT)
     },
     claude: {
-      zon: zonTokensClaude,
+      zonf: zonTokensClaude,
       toon: toonTokensClaude,
       json: jsonTokensClaude,
       savingsVsTOON: parseFloat(savingsVsTOON_Claude),
       savingsVsJSON: parseFloat(savingsVsJSON_Claude)
     },
     llama: {
-      zon: zonTokensLlama,
+      zonf: zonTokensLlama,
       toon: toonTokensLlama,
       json: jsonTokensLlama,
       savingsVsTOON: parseFloat(savingsVsTOON_Llama),

docs/cli-guide.md

@@ -221,18 +221,14 @@ diff <(zon format data.zonf) data.zonf
 
 ### `.zonf`
 
-**ZON Format** - The standard extension for ZON files.
+**ZON Format** - The standard and only extension for ZON files.
 
 ```bash
 users.zonf
 config.zonf
 data.zonf
 ```
 
-### `.zon`
-
-Alternative extension (also supported by VS Code extension).
-
 ---
 
 ## Pipeline Examples

docs/production-architecture.md

@@ -254,8 +254,8 @@ function logFormatStats(data: any, label: string) {
   const stats = compareFormats(data);
 
   console.log(`[${label}] Format Sizes:`);
-  console.log(`  ZON:    ${stats.zon} bytes`);
-  console.log(`  Binary: ${stats.binary} bytes (${stats.savings.binaryVsZon.toFixed(1)}% savings)`);
+  console.log(`  ZON:    ${stats.zonf} bytes`);
+  console.log(`  Binary: ${stats.binary} bytes (${stats.savings.binaryVsZonf.toFixed(1)}% savings)`);
   console.log(`  JSON:   ${stats.json} bytes`);
 }
 ```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "zon-format",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "ZON: The most token-efficient serialization format for LLMs - beats CSV, TOON, JSON, and all competitors",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package.json

@@ -24,7 +24,7 @@ describe('ZON Versioning', () => {
       expect(versioned.__zon_meta).toBeDefined();
       expect(versioned.__zon_meta.version).toBe('2.0.0');
       expect(versioned.__zon_meta.schemaId).toBe('user-schema');
-      expect(versioned.__zon_meta.encoding).toBe('zon');
+      expect(versioned.__zon_meta.encoding).toBe('zonf');
       expect(versioned.__zon_meta.timestamp).toBeDefined();
       expect(versioned.users).toEqual(data.users);
     });
@@ -50,7 +50,7 @@ describe('ZON Versioning', () => {
         __zon_meta: {
           version: '1.5.0',
           schemaId: 'test-schema',
-          encoding: 'zon',
+          encoding: 'zonf',
           timestamp: 1234567890
         },
         users: []
@@ -79,7 +79,7 @@ describe('ZON Versioning', () => {
   describe('stripVersion', () => {
     it('should remove version metadata', () => {
       const data = {
-        __zon_meta: { version: '1.0.0', encoding: 'zon', timestamp: 123 },
+        __zon_meta: { version: '1.0.0', encoding: 'zonf', timestamp: 123 },
         users: [{ id: 1 }]
       };
 

src/__tests__/versioning.test.ts

@@ -32,7 +32,7 @@ function printUsage() {
   console.error('  diff     Compare two ZON files');
   console.error('Options:');
   console.error('  --format <json|csv|yaml|binary>  Specify format');
-  console.error('  --to <zon|json|binary>           Target format for convert');
+  console.error('  --to <zonf|json|binary>          Target format for convert');
   console.error('  --colors                          Use syntax highlighting');
   console.error('  --strict                          Strict validation mode');
 }
@@ -171,9 +171,9 @@ try {
     console.log(`Types Found:    ${Array.from(stats.types).join(', ')}`);
     console.log('');
     console.log('Format Sizes:');
-    console.log(`  ZON:    ${sizes.zon} bytes`);
-    console.log(`  Binary: ${sizes.binary} bytes (-${sizes.savings.binaryVsZon.toFixed(1)}%)`);
-    console.log(`  JSON:   ${sizes.json} bytes (+${((sizes.json/sizes.zon - 1) * 100).toFixed(1)}%)`);
+    console.log(`  ZON:    ${sizes.zonf} bytes`);
+    console.log(`  Binary: ${sizes.binary} bytes (-${sizes.savings.binaryVsZonf.toFixed(1)}%)`);
+    console.log(`  JSON:   ${sizes.json} bytes (+${((sizes.json/sizes.zonf - 1) * 100).toFixed(1)}%)`);
   } else if (command === 'diff') {
     const file2 = args[2];
     if (!file2) {
@@ -230,7 +230,7 @@ try {
     const formatArg = args.find(a => a.startsWith('--format='));
     const toArg = args.find(a => a.startsWith('--to='));
     const format = formatArg ? formatArg.split('=')[1] : ext.replace('.', '');
-    const targetFormat = toArg ? toArg.split('=')[1] : 'zon';
+    const targetFormat = toArg ? toArg.split('=')[1] : 'zonf';
 
     let data;
     if (format === 'binary' || format === 'zonb') {
@@ -249,7 +249,7 @@ try {
       process.exit(1);
     }
 
-    if (targetFormat === 'zon') {
+    if (targetFormat === 'zonf') {
       console.log(encode(data));
     } else if (targetFormat === 'binary') {
       const binary = encodeBinary(data);

src/cli.ts

@@ -12,7 +12,7 @@ export interface ZonDocumentMetadata {
   /** Optional schema identifier (e.g., "user-profile-v2") */
   schemaId?: string;
 
-  /** Encoding format used ("zon" | "zon-binary") */
+  /** Encoding format used ("zonf" | "zonf-binary") */
   encoding?: string;
 
   /** Unix timestamp when document was created */
@@ -42,7 +42,7 @@ export function embedVersion(
   data: any,
   version: string,
   schemaId?: string,
-  encoding: string = 'zon'
+  encoding: string = 'zonf'
 ): any {
   if (typeof data !== 'object' || data === null || Array.isArray(data)) {
     throw new Error('Can only embed version in root objects');

src/core/versioning.ts

@@ -80,7 +80,7 @@ export class BatchConverter {
   /**
    * Queue a conversion
    */
-  add(data: any, from: 'json' | 'zon' | 'binary', to: 'json' | 'zon' | 'binary'): void {
+  add(data: any, from: 'json' | 'zonf' | 'binary', to: 'json' | 'zonf' | 'binary'): void {
     this.conversions.push({ from, to, data });
   }
 
@@ -102,7 +102,7 @@ export class BatchConverter {
 
     if (from === 'json') {
       normalized = typeof data === 'string' ? JSON.parse(data) : data;
-    } else if (from === 'zon') {
+    } else if (from === 'zonf') {
       normalized = decode(data);
     } else if (from === 'binary') {
       normalized = decodeBinary(data);
@@ -111,7 +111,7 @@ export class BatchConverter {
 
     if (to === 'json') {
       return JSON.stringify(normalized, null, 2);
-    } else if (to === 'zon') {
+    } else if (to === 'zonf') {
       return encode(normalized);
     } else if (to === 'binary') {
       return encodeBinary(normalized);
@@ -133,18 +133,18 @@ export class BatchConverter {
  */
 export function autoConvert(
   input: string | Uint8Array,
-  targetFormat: 'json' | 'zon' | 'binary',
+  targetFormat: 'json' | 'zonf' | 'binary',
   options?: ConversionOptions
 ): string | Uint8Array {
 
-  let sourceFormat: 'json' | 'zon' | 'binary';
+  let sourceFormat: 'json' | 'zonf' | 'binary';
 
   if (input instanceof Uint8Array) {
     sourceFormat = 'binary';
   } else if (input.trim().startsWith('{') || input.trim().startsWith('[')) {
     sourceFormat = 'json';
   } else {
-    sourceFormat = 'zon';
+    sourceFormat = 'zonf';
   }
 
 

src/tools/converter.ts

@@ -12,9 +12,9 @@ import type { ZonSchema } from '../schema/schema';
 /**
  * Calculate the encoded size of data in different formats
  */
-export function size(data: any, format: 'zon' | 'binary' | 'json' = 'zon'): number {
+export function size(data: any, format: 'zonf' | 'binary' | 'json' = 'zonf'): number {
   switch (format) {
-    case 'zon':
+    case 'zonf':
       return encode(data).length;
     case 'binary':
       return encodeBinary(data).length;
@@ -27,27 +27,27 @@ export function size(data: any, format: 'zon' | 'binary' | 'json' = 'zon'): numb
  * Compare sizes across all formats
  */
 export function compareFormats(data: any): {
-  zon: number;
+  zonf: number;
   binary: number;
   json: number;
   savings: {
-    zonVsJson: number;
+    zonfVsJson: number;
     binaryVsJson: number;
-    binaryVsZon: number;
+    binaryVsZonf: number;
   };
 } {
-  const zonSize = size(data, 'zon');
+  const zonfSize = size(data, 'zonf');
   const binarySize = size(data, 'binary');
   const jsonSize = size(data, 'json');
 
   return {
-    zon: zonSize,
+    zonf: zonfSize,
     binary: binarySize,
     json: jsonSize,
     savings: {
-      zonVsJson: ((1 - zonSize / jsonSize) * 100),
+      zonfVsJson: ((1 - zonfSize / jsonSize) * 100),
       binaryVsJson: ((1 - binarySize / jsonSize) * 100),
-      binaryVsZon: ((1 - binarySize / zonSize) * 100)
+      binaryVsZonf: ((1 - binarySize / zonfSize) * 100)
     }
   };
 }