@avalanche-io/c4-node 1.0.10

package/dist/packages/core/src/diff.js

@@ -0,0 +1,169 @@
+import { canonicalEntry } from './entry.js';
+import { Manifest } from './manifest.js';
+/** Compute the diff between two manifests. */
+export function diff(oldManifest, newManifest) {
+    const result = { added: [], removed: [], modified: [] };
+    // Build path maps
+    const oldPaths = new Map();
+    for (const [path, entry] of oldManifest) {
+        oldPaths.set(path, entry);
+    }
+    const newPaths = new Map();
+    for (const [path, entry] of newManifest) {
+        newPaths.set(path, entry);
+    }
+    // Find removed and modified
+    for (const [path, oldEntry] of oldPaths) {
+        const newEntry = newPaths.get(path);
+        if (!newEntry) {
+            result.removed.push({ path, entry: oldEntry });
+        }
+        else if (!entriesEqual(oldEntry, newEntry)) {
+            result.modified.push({ path, oldEntry, newEntry });
+        }
+    }
+    // Find added
+    for (const [path, newEntry] of newPaths) {
+        if (!oldPaths.has(path)) {
+            result.added.push({ path, entry: newEntry });
+        }
+    }
+    return result;
+}
+/** Check if two entries are identical (all fields match). */
+function entriesEqual(a, b) {
+    return canonicalEntry(a) === canonicalEntry(b);
+}
+/** Three-way merge of manifests. */
+export function merge(base, local, remote) {
+    const localDiff = diff(base, local);
+    const remoteDiff = diff(base, remote);
+    const merged = base.copy();
+    const conflicts = [];
+    // Build sets of changed paths
+    const localChanges = new Map();
+    for (const { path, entry } of localDiff.added)
+        localChanges.set(path, entry);
+    for (const { path, newEntry } of localDiff.modified)
+        localChanges.set(path, newEntry);
+    const localRemoved = new Set(localDiff.removed.map(r => r.path));
+    const remoteChanges = new Map();
+    for (const { path, entry } of remoteDiff.added)
+        remoteChanges.set(path, entry);
+    for (const { path, newEntry } of remoteDiff.modified)
+        remoteChanges.set(path, newEntry);
+    const remoteRemoved = new Set(remoteDiff.removed.map(r => r.path));
+    // Apply non-conflicting changes
+    const allPaths = new Set([...localChanges.keys(), ...localRemoved, ...remoteChanges.keys(), ...remoteRemoved]);
+    for (const path of allPaths) {
+        const inLocal = localChanges.has(path) || localRemoved.has(path);
+        const inRemote = remoteChanges.has(path) || remoteRemoved.has(path);
+        if (inLocal && !inRemote) {
+            // Only local changed
+            if (localRemoved.has(path)) {
+                const entry = merged.get(path);
+                if (entry)
+                    merged.removeEntry(entry);
+            }
+            else {
+                applyChange(merged, path, localChanges.get(path));
+            }
+        }
+        else if (!inLocal && inRemote) {
+            // Only remote changed
+            if (remoteRemoved.has(path)) {
+                const entry = merged.get(path);
+                if (entry)
+                    merged.removeEntry(entry);
+            }
+            else {
+                applyChange(merged, path, remoteChanges.get(path));
+            }
+        }
+        else {
+            // Both changed — check if they agree
+            const localEntry = localChanges.get(path);
+            const remoteEntry = remoteChanges.get(path);
+            const localDel = localRemoved.has(path);
+            const remoteDel = remoteRemoved.has(path);
+            if (localDel && remoteDel) {
+                // Both deleted — no conflict
+                const entry = merged.get(path);
+                if (entry)
+                    merged.removeEntry(entry);
+            }
+            else if (localEntry && remoteEntry && entriesEqual(localEntry, remoteEntry)) {
+                // Same change — no conflict
+                applyChange(merged, path, localEntry);
+            }
+            else {
+                // Conflict
+                conflicts.push({
+                    path,
+                    base: merged.get(path),
+                    local: localEntry ?? merged.get(path),
+                    remote: remoteEntry ?? merged.get(path),
+                });
+            }
+        }
+    }
+    return { merged, conflicts };
+}
+function applyChange(m, path, entry) {
+    const existing = m.get(path);
+    if (existing) {
+        Object.assign(existing, entry);
+    }
+    else {
+        m.addEntry({ ...entry });
+    }
+}
+/** Apply a patch manifest to a base manifest.
+ * Patch semantics:
+ * - Entry exists only in patch: addition
+ * - Entry exists in both, any field differs: modification (patch replaces)
+ * - Entry exists in both, all fields identical: removal
+ */
+export function applyPatch(base, patch) {
+    const result = base.copy();
+    for (const patchEntry of patch.entries) {
+        // Find matching entry in result by name and depth
+        let found = false;
+        for (let i = 0; i < result.entries.length; i++) {
+            const existing = result.entries[i];
+            if (existing.name === patchEntry.name && existing.depth === patchEntry.depth) {
+                if (entriesEqual(existing, patchEntry)) {
+                    // Identical = removal
+                    result.entries.splice(i, 1);
+                }
+                else {
+                    // Different = modification
+                    result.entries[i] = { ...patchEntry };
+                }
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            // Addition
+            result.entries.push({ ...patchEntry });
+        }
+    }
+    result.sortEntries();
+    return result;
+}
+export async function patchDiff(oldManifest, newManifest) {
+    const d = diff(oldManifest, newManifest);
+    const patch = Manifest.create();
+    // Additions and modifications — use new entries
+    for (const { entry } of d.added)
+        patch.addEntry({ ...entry });
+    for (const { newEntry } of d.modified)
+        patch.addEntry({ ...newEntry });
+    // Removals — restate original entry exactly
+    for (const { entry } of d.removed)
+        patch.addEntry({ ...entry });
+    const oldID = await oldManifest.computeC4ID();
+    return { oldID: oldID.toString(), patch };
+}
+//# sourceMappingURL=diff.js.map

package/dist/packages/core/src/diff.js.map

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

package/dist/packages/core/src/encoder.d.ts

@@ -0,0 +1,13 @@
+import type { Manifest } from './manifest.js';
+/** Encoder options. */
+export interface EncoderOptions {
+    pretty?: boolean;
+    indentWidth?: number;
+}
+/** Encode a manifest to c4m text. */
+export declare function encode(m: Manifest, options?: EncoderOptions): string;
+/** Encode a manifest in canonical form (convenience). */
+export declare function dumps(m: Manifest, options?: {
+    pretty?: boolean;
+}): string;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/packages/core/src/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../../../core/src/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAW7C,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAiGD,qCAAqC;AACrC,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAkCxE;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAEzE"}

package/dist/packages/core/src/encoder.js

@@ -0,0 +1,125 @@
+import { formatMode, formatSizeWithCommas, formatEntry, flowOperator, } from './entry.js';
+import { formatName, formatTarget } from './safename.js';
+/** Format a timestamp in human-readable local time. */
+function formatTimestampPretty(d) {
+    if (d.getTime() === 0)
+        return '-                        ';
+    const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+    const month = months[d.getMonth()];
+    const day = d.getDate().toString().padStart(2, ' ');
+    const h = d.getHours().toString().padStart(2, '0');
+    const m = d.getMinutes().toString().padStart(2, '0');
+    const s = d.getSeconds().toString().padStart(2, '0');
+    const year = d.getFullYear();
+    // Get timezone abbreviation
+    const tzMatch = d.toTimeString().match(/\(([^)]+)\)/);
+    const tz = tzMatch ? tzMatch[1].split(' ').map(w => w[0]).join('') : 'UTC';
+    return `${month} ${day} ${h}:${m}:${s} ${year} ${tz}`;
+}
+/** Calculate the C4 ID column position for pretty printing. */
+function calculateC4IDColumn(entries, indentWidth) {
+    let maxSize = 0;
+    for (const entry of entries) {
+        if (entry.size > maxSize)
+            maxSize = entry.size;
+    }
+    const maxSizeWidth = formatSizeWithCommas(maxSize).length;
+    let maxLen = 0;
+    for (const entry of entries) {
+        const indent = ' '.repeat(entry.depth * indentWidth);
+        const modeStr = entry.mode === 0 && entry.modeType === '-'
+            ? '----------'
+            : formatMode(entry.modeType, entry.mode);
+        const timeStr = formatTimestampPretty(entry.timestamp);
+        const nameStr = formatName(entry.name, entry.isSequence);
+        let lineLen = indent.length + modeStr.length + 1 + timeStr.length + 1 + maxSizeWidth + 1 + nameStr.length;
+        if (entry.target !== '') {
+            lineLen += 4 + entry.target.length;
+        }
+        else if (entry.flowDirection !== 0 /* FlowDirection.None */) {
+            lineLen += 1 + flowOperator(entry.flowDirection).length + 1 + entry.flowTarget.length;
+        }
+        if (lineLen > maxLen)
+            maxLen = lineLen;
+    }
+    const minSpacing = 10;
+    let column = 80;
+    while (maxLen + minSpacing > column)
+        column += 10;
+    return column;
+}
+/** Format an entry with pretty printing. */
+function formatEntryPretty(entry, maxSize, c4IDColumn, indentWidth) {
+    const indent = ' '.repeat(entry.depth * indentWidth);
+    const modeStr = entry.mode === 0 && entry.modeType === '-'
+        ? '----------'
+        : formatMode(entry.modeType, entry.mode);
+    const timeStr = entry.timestamp.getTime() === 0
+        ? '-                        '
+        : formatTimestampPretty(entry.timestamp);
+    let sizeStr;
+    if (entry.size < 0) {
+        const maxSizeStr = formatSizeWithCommas(maxSize);
+        sizeStr = ' '.repeat(maxSizeStr.length - 1) + '-';
+    }
+    else {
+        const sizeWithCommas = formatSizeWithCommas(entry.size);
+        const maxSizeStr = formatSizeWithCommas(maxSize);
+        sizeStr = ' '.repeat(maxSizeStr.length - sizeWithCommas.length) + sizeWithCommas;
+    }
+    const nameStr = formatName(entry.name, entry.isSequence);
+    const parts = [indent + modeStr, timeStr, sizeStr, nameStr];
+    if (entry.target !== '') {
+        parts.push('->', formatTarget(entry.target));
+    }
+    else if (entry.hardLink !== 0) {
+        parts.push(entry.hardLink < 0 ? '->' : `->${entry.hardLink}`);
+    }
+    else if (entry.flowDirection !== 0 /* FlowDirection.None */) {
+        parts.push(flowOperator(entry.flowDirection), entry.flowTarget);
+    }
+    const baseLine = parts.join(' ');
+    let padding = c4IDColumn - baseLine.length;
+    if (padding < 10)
+        padding = 10;
+    const idStr = entry.c4id && !entry.c4id.isNil() ? entry.c4id.toString() : '-';
+    return baseLine + ' '.repeat(padding) + idStr;
+}
+/** Encode a manifest to c4m text. */
+export function encode(m, options = {}) {
+    const pretty = options.pretty ?? false;
+    const indentWidth = options.indentWidth ?? 2;
+    // Sort a copy
+    const sorted = m.copy();
+    sorted.sortEntries();
+    const lines = [];
+    if (pretty) {
+        let maxSize = 0;
+        for (const entry of sorted.entries) {
+            if (entry.size > maxSize)
+                maxSize = entry.size;
+        }
+        const c4IDColumn = calculateC4IDColumn(sorted.entries, indentWidth);
+        for (const entry of sorted.entries) {
+            lines.push(formatEntryPretty(entry, maxSize, c4IDColumn, indentWidth));
+        }
+    }
+    else {
+        for (const entry of sorted.entries) {
+            lines.push(formatEntry(entry, indentWidth, false));
+        }
+    }
+    // Inline range data
+    if (sorted.rangeData.size > 0) {
+        const keys = [...sorted.rangeData.keys()].sort();
+        for (const key of keys) {
+            lines.push(sorted.rangeData.get(key));
+        }
+    }
+    return lines.map(l => l + '\n').join('');
+}
+/** Encode a manifest in canonical form (convenience). */
+export function dumps(m, options) {
+    return encode(m, options);
+}
+//# sourceMappingURL=encoder.js.map

package/dist/packages/core/src/encoder.js.map

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

package/dist/packages/core/src/entry.d.ts

@@ -0,0 +1,59 @@
+import type { C4ID } from './id.js';
+/** Flow link direction for cross-location data relationships. */
+export declare const enum FlowDirection {
+    None = 0,
+    Outbound = 1,// -> content here propagates there
+    Inbound = 2,// <- content there propagates here
+    Bidirectional = 3
+}
+/** Canonical timestamp format (RFC 3339, UTC). */
+export declare const TIMESTAMP_FORMAT = "YYYY-MM-DDTHH:MM:SSZ";
+/** Unix epoch — the sentinel for null/unspecified timestamps. */
+export declare const NULL_TIMESTAMP: Date;
+/** Sentinel for null/unspecified size. */
+export declare const NULL_SIZE = -1;
+/** A single file or directory entry in a c4m manifest. */
+export interface Entry {
+    mode: number;
+    modeType: string;
+    timestamp: Date;
+    size: number;
+    name: string;
+    target: string;
+    c4id: C4ID | null;
+    depth: number;
+    hardLink: number;
+    flowDirection: FlowDirection;
+    flowTarget: string;
+    isSequence: boolean;
+    pattern: string;
+}
+/** Create a new Entry with defaults. */
+export declare function createEntry(partial?: Partial<Entry>): Entry;
+/** Returns true if the entry represents a directory. */
+export declare function isDir(e: Entry): boolean;
+/** Returns true if the entry represents a symbolic link. */
+export declare function isSymlink(e: Entry): boolean;
+/** Returns true if the entry has a flow link declaration. */
+export declare function isFlowLinked(e: Entry): boolean;
+/** Returns the string representation of the flow direction. */
+export declare function flowOperator(dir: FlowDirection): string;
+/** Returns true if entry has any null metadata values. */
+export declare function hasNullValues(e: Entry): boolean;
+/** Returns list of fields that have null values. */
+export declare function getNullFields(e: Entry): string[];
+/** Convert numeric mode + type char to Unix mode string (e.g. "-rw-r--r--"). */
+export declare function formatMode(modeType: string, mode: number): string;
+/** Parse a 10-char Unix mode string to [modeType, permBits]. */
+export declare function parseMode(s: string): [string, number];
+/** Format a Date as canonical c4m timestamp: YYYY-MM-DDTHH:MM:SSZ */
+export declare function formatTimestamp(d: Date): string;
+/** Parse a timestamp string to Date. Accepts canonical and ergonomic forms. */
+export declare function parseTimestamp(s: string): Date;
+/** Format size with comma separators (e.g. 1,234,567). */
+export declare function formatSizeWithCommas(size: number): string;
+/** Format an entry as a c4m line with indentation. */
+export declare function formatEntry(e: Entry, indentWidth: number, displayFormat: boolean): string;
+/** Format an entry in canonical form (no indentation, null mode as "-"). */
+export declare function canonicalEntry(e: Entry): string;
+//# sourceMappingURL=entry.d.ts.map

package/dist/packages/core/src/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../../../core/src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAGnC,iEAAiE;AACjE,0BAAkB,aAAa;IAC7B,IAAI,IAAI;IACR,QAAQ,IAAI,CAAI,mCAAmC;IACnD,OAAO,IAAI,CAAK,mCAAmC;IACnD,aAAa,IAAI;CAClB;AAED,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,yBAAyB,CAAA;AAEtD,iEAAiE;AACjE,eAAO,MAAM,cAAc,MAAc,CAAA;AAEzC,0CAA0C;AAC1C,eAAO,MAAM,SAAS,KAAK,CAAA;AAE3B,0DAA0D;AAC1D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,aAAa,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,OAAO,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK,CAiB/D;AAED,wDAAwD;AACxD,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAEvC;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAE3C;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAE9C;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAOvD;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAK/C;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,CAMhD;AAID,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBjE;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrD;AAID,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAQ/C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAM9C;AAID,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzD;AAID,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,CAqDzF;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CA6C/C"}

package/dist/packages/core/src/entry.js

@@ -0,0 +1,266 @@
+import { formatName, formatTarget } from './safename.js';
+/** Canonical timestamp format (RFC 3339, UTC). */
+export const TIMESTAMP_FORMAT = 'YYYY-MM-DDTHH:MM:SSZ';
+/** Unix epoch — the sentinel for null/unspecified timestamps. */
+export const NULL_TIMESTAMP = new Date(0);
+/** Sentinel for null/unspecified size. */
+export const NULL_SIZE = -1;
+/** Create a new Entry with defaults. */
+export function createEntry(partial = {}) {
+    return {
+        mode: 0,
+        modeType: '-',
+        timestamp: NULL_TIMESTAMP,
+        size: NULL_SIZE,
+        name: '',
+        target: '',
+        c4id: null,
+        depth: 0,
+        hardLink: 0,
+        flowDirection: 0 /* FlowDirection.None */,
+        flowTarget: '',
+        isSequence: false,
+        pattern: '',
+        ...partial,
+    };
+}
+/** Returns true if the entry represents a directory. */
+export function isDir(e) {
+    return e.modeType === 'd' || e.name.endsWith('/');
+}
+/** Returns true if the entry represents a symbolic link. */
+export function isSymlink(e) {
+    return e.modeType === 'l';
+}
+/** Returns true if the entry has a flow link declaration. */
+export function isFlowLinked(e) {
+    return e.flowDirection !== 0 /* FlowDirection.None */;
+}
+/** Returns the string representation of the flow direction. */
+export function flowOperator(dir) {
+    switch (dir) {
+        case 1 /* FlowDirection.Outbound */: return '->';
+        case 2 /* FlowDirection.Inbound */: return '<-';
+        case 3 /* FlowDirection.Bidirectional */: return '<>';
+        default: return '';
+    }
+}
+/** Returns true if entry has any null metadata values. */
+export function hasNullValues(e) {
+    const hasNullMode = e.mode === 0 && e.modeType === '-';
+    const hasNullTimestamp = e.timestamp.getTime() === 0;
+    const hasNullSize = e.size < 0;
+    return hasNullMode || hasNullTimestamp || hasNullSize;
+}
+/** Returns list of fields that have null values. */
+export function getNullFields(e) {
+    const fields = [];
+    if (e.mode === 0 && e.modeType === '-')
+        fields.push('Mode');
+    if (e.timestamp.getTime() === 0)
+        fields.push('Timestamp');
+    if (e.size < 0)
+        fields.push('Size');
+    return fields;
+}
+// ---- Mode formatting/parsing ----
+/** Convert numeric mode + type char to Unix mode string (e.g. "-rw-r--r--"). */
+export function formatMode(modeType, mode) {
+    const buf = [modeType];
+    const rwx = 'rwxrwxrwx';
+    for (let i = 0; i < 9; i++) {
+        if (mode & (1 << (8 - i))) {
+            buf.push(rwx[i]);
+        }
+        else {
+            buf.push('-');
+        }
+    }
+    // Special bits (setuid, setgid, sticky)
+    if (mode & 0o4000) { // setuid
+        buf[3] = buf[3] === 'x' ? 's' : 'S';
+    }
+    if (mode & 0o2000) { // setgid
+        buf[6] = buf[6] === 'x' ? 's' : 'S';
+    }
+    if (mode & 0o1000) { // sticky
+        buf[9] = buf[9] === 'x' ? 't' : 'T';
+    }
+    return buf.join('');
+}
+/** Parse a 10-char Unix mode string to [modeType, permBits]. */
+export function parseMode(s) {
+    if (s.length !== 10) {
+        throw new Error(`mode must be 10 characters, got ${s.length}`);
+    }
+    const modeType = s[0];
+    let perm = 0;
+    // Permission bits
+    if (s[1] === 'r')
+        perm |= 0o400;
+    if (s[2] === 'w')
+        perm |= 0o200;
+    if (s[3] === 'x' || s[3] === 's')
+        perm |= 0o100;
+    if (s[4] === 'r')
+        perm |= 0o040;
+    if (s[5] === 'w')
+        perm |= 0o020;
+    if (s[6] === 'x' || s[6] === 's')
+        perm |= 0o010;
+    if (s[7] === 'r')
+        perm |= 0o004;
+    if (s[8] === 'w')
+        perm |= 0o002;
+    if (s[9] === 'x' || s[9] === 't')
+        perm |= 0o001;
+    // Special bits
+    if (s[3] === 's' || s[3] === 'S')
+        perm |= 0o4000;
+    if (s[6] === 's' || s[6] === 'S')
+        perm |= 0o2000;
+    if (s[9] === 't' || s[9] === 'T')
+        perm |= 0o1000;
+    return [modeType, perm];
+}
+// ---- Timestamp formatting/parsing ----
+/** Format a Date as canonical c4m timestamp: YYYY-MM-DDTHH:MM:SSZ */
+export function formatTimestamp(d) {
+    const y = d.getUTCFullYear().toString().padStart(4, '0');
+    const m = (d.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = d.getUTCDate().toString().padStart(2, '0');
+    const h = d.getUTCHours().toString().padStart(2, '0');
+    const min = d.getUTCMinutes().toString().padStart(2, '0');
+    const sec = d.getUTCSeconds().toString().padStart(2, '0');
+    return `${y}-${m}-${day}T${h}:${min}:${sec}Z`;
+}
+/** Parse a timestamp string to Date. Accepts canonical and ergonomic forms. */
+export function parseTimestamp(s) {
+    if (s === '-' || s === '0')
+        return new Date(0);
+    // Try ISO 8601 / RFC 3339 (handles both Z and offset)
+    const d = new Date(s);
+    if (!isNaN(d.getTime()))
+        return d;
+    throw new Error(`cannot parse timestamp "${s}"`);
+}
+// ---- Size formatting ----
+/** Format size with comma separators (e.g. 1,234,567). */
+export function formatSizeWithCommas(size) {
+    if (size < 0)
+        return '-';
+    const s = size.toString();
+    if (s.length <= 3)
+        return s;
+    const parts = [];
+    for (let i = s.length - 1, count = 0; i >= 0; i--, count++) {
+        if (count > 0 && count % 3 === 0)
+            parts.push(',');
+        parts.push(s[i]);
+    }
+    return parts.reverse().join('');
+}
+// ---- Entry formatting ----
+/** Format an entry as a c4m line with indentation. */
+export function formatEntry(e, indentWidth, displayFormat) {
+    const indent = ' '.repeat(e.depth * indentWidth);
+    // Mode
+    let modeStr;
+    if (e.mode === 0 && e.modeType === '-') {
+        modeStr = displayFormat ? '----------' : '-';
+    }
+    else {
+        modeStr = formatMode(e.modeType, e.mode);
+    }
+    // Timestamp
+    let timeStr;
+    if (e.timestamp.getTime() === 0) {
+        timeStr = '-';
+    }
+    else {
+        timeStr = formatTimestamp(e.timestamp);
+    }
+    // Size
+    let sizeStr;
+    if (e.size < 0) {
+        sizeStr = '-';
+    }
+    else {
+        sizeStr = displayFormat ? formatSizeWithCommas(e.size) : e.size.toString();
+    }
+    // Name
+    const nameStr = formatName(e.name, e.isSequence);
+    const parts = [indent + modeStr, timeStr, sizeStr, nameStr];
+    // Link operators
+    if (e.target !== '') {
+        parts.push('->', formatTarget(e.target));
+    }
+    else if (e.hardLink !== 0) {
+        if (e.hardLink < 0) {
+            parts.push('->');
+        }
+        else {
+            parts.push(`->${e.hardLink}`);
+        }
+    }
+    else if (e.flowDirection !== 0 /* FlowDirection.None */) {
+        parts.push(flowOperator(e.flowDirection), e.flowTarget);
+    }
+    // C4 ID
+    if (e.c4id && !e.c4id.isNil()) {
+        parts.push(e.c4id.toString());
+    }
+    else {
+        parts.push('-');
+    }
+    return parts.join(' ');
+}
+/** Format an entry in canonical form (no indentation, null mode as "-"). */
+export function canonicalEntry(e) {
+    // No indentation
+    let modeStr;
+    if (e.mode === 0 && e.modeType === '-') {
+        modeStr = '-';
+    }
+    else {
+        modeStr = formatMode(e.modeType, e.mode);
+    }
+    let timeStr;
+    if (e.timestamp.getTime() === 0) {
+        timeStr = '-';
+    }
+    else {
+        timeStr = formatTimestamp(e.timestamp);
+    }
+    let sizeStr;
+    if (e.size < 0) {
+        sizeStr = '-';
+    }
+    else {
+        sizeStr = e.size.toString();
+    }
+    const nameStr = formatName(e.name, e.isSequence);
+    const parts = [modeStr, timeStr, sizeStr, nameStr];
+    if (e.target !== '') {
+        parts.push('->', formatTarget(e.target));
+    }
+    else if (e.hardLink !== 0) {
+        if (e.hardLink < 0) {
+            parts.push('->');
+        }
+        else {
+            parts.push(`->${e.hardLink}`);
+        }
+    }
+    else if (e.flowDirection !== 0 /* FlowDirection.None */) {
+        parts.push(flowOperator(e.flowDirection), e.flowTarget);
+    }
+    if (e.c4id && !e.c4id.isNil()) {
+        parts.push(e.c4id.toString());
+    }
+    else {
+        parts.push('-');
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=entry.js.map