@sjunepark/fs 0.1.0

package/dist/validation/validate.js

@@ -0,0 +1,154 @@
+import { calculate } from "./calculate.js";
+import { inputLimitFailure, inputLimits } from "../limits.js";
+import { conformsToSchema, validateSchema } from "./schema.js";
+import { conformsSemantically, validateSemantics } from "./semantic.js";
+import { compareSnapshot } from "./snapshot.js";
+const nonemptyErrors = (errors) => {
+    const [first, ...rest] = errors;
+    if (first === undefined)
+        throw new Error("Nonconforming validation lost its diagnostics");
+    return [first, ...rest];
+};
+const nonconforming = (errors) => ({
+    formatVersion: "0.1",
+    conformance: { status: "nonconforming", errors: nonemptyErrors(errors) },
+    calculations: { status: "not-run", applications: [] }
+});
+const diagnosticBytes = (errors) => Buffer.byteLength(JSON.stringify(errors), "utf8");
+const diagnosticLimit = (errors) => diagnosticBytes(errors) > inputLimits.validationDiagnosticBytes
+    ? inputLimitFailure("validation-diagnostic-bytes", inputLimits.validationDiagnosticBytes)
+    : undefined;
+function* snapshotDecimals(snapshot) {
+    for (const application of snapshot.applications) {
+        if (application.status === "error")
+            continue;
+        yield application.actual;
+        yield application.expected;
+        yield application.difference;
+        yield application.tolerance;
+    }
+}
+function* documentDecimals(document) {
+    for (const unit of document.units) {
+        if (unit.defaultTolerance !== undefined)
+            yield unit.defaultTolerance;
+    }
+    for (const statement of document.statements) {
+        for (const item of statement.items) {
+            for (const value of Object.values(item.values)) {
+                if (typeof value === "string")
+                    yield value;
+            }
+        }
+    }
+    if (document.validationSnapshot !== undefined) {
+        yield* snapshotDecimals(document.validationSnapshot);
+    }
+}
+const decimalBudgetFor = (decimals) => {
+    let total = 0;
+    for (const decimal of decimals) {
+        const digits = decimal.length - (decimal.startsWith("-") ? 1 : 0) - (decimal.includes(".") ? 1 : 0);
+        if (digits > inputLimits.decimalDigits) {
+            return inputLimitFailure("decimal-digits", inputLimits.decimalDigits);
+        }
+        total += digits;
+        if (total > inputLimits.totalDecimalDigits) {
+            return inputLimitFailure("total-decimal-digits", inputLimits.totalDecimalDigits);
+        }
+    }
+    return undefined;
+};
+const snapshotDecimalBudget = (value) => {
+    if (value === null || typeof value !== "object" || !("validationSnapshot" in value))
+        return undefined;
+    const snapshot = value.validationSnapshot;
+    return snapshot === undefined ? undefined : decimalBudgetFor(snapshotDecimals(snapshot));
+};
+const structuralFailure = (value, schemaErrors) => {
+    const validation = nonconforming(schemaErrors);
+    const hasSnapshot = typeof value === "object" && value !== null && "validationSnapshot" in value;
+    const invalidSnapshot = schemaErrors.some((error) => error.path === "/validationSnapshot" || error.path.startsWith("/validationSnapshot/"));
+    if (hasSnapshot && invalidSnapshot) {
+        return {
+            validation,
+            snapshotDiff: { formatVersion: "0.1", status: "not-comparable", reason: "invalid-snapshot" }
+        };
+    }
+    const snapshot = hasSnapshot
+        ? value.validationSnapshot
+        : undefined;
+    return { validation, snapshotDiff: compareSnapshot(snapshot, validation) };
+};
+const conforming = (document) => {
+    const validation = {
+        formatVersion: "0.1",
+        conformance: { status: "conforming", errors: [] },
+        calculations: calculate(document)
+    };
+    return {
+        document,
+        validation,
+        snapshotDiff: compareSnapshot(document.validationSnapshot, validation)
+    };
+};
+const validateConformingShape = (document) => {
+    const semanticErrors = validateSemantics(document);
+    if (semanticErrors.length === 0)
+        return conforming(document);
+    const validation = nonconforming(semanticErrors);
+    return { validation, snapshotDiff: compareSnapshot(document.validationSnapshot, validation) };
+};
+const decimalBudget = (document) => {
+    return decimalBudgetFor(documentDecimals(document));
+};
+export const validateDocumentBounded = (value, jsonValues) => {
+    const complex = jsonValues > inputLimits.invalidDocumentValues;
+    const schemaErrors = complex
+        ? conformsToSchema(value)
+            ? []
+            : undefined
+        : validateSchema(value);
+    if (schemaErrors === undefined) {
+        return {
+            ok: false,
+            ...inputLimitFailure("invalid-document-values", inputLimits.invalidDocumentValues)
+        };
+    }
+    if (schemaErrors.length > 0) {
+        const invalidSnapshot = schemaErrors.some((error) => error.path === "/validationSnapshot" || error.path.startsWith("/validationSnapshot/"));
+        const snapshotLimit = invalidSnapshot ? undefined : snapshotDecimalBudget(value);
+        if (snapshotLimit !== undefined)
+            return { ok: false, ...snapshotLimit };
+        const limit = diagnosticLimit(schemaErrors);
+        return limit === undefined
+            ? { ok: true, result: structuralFailure(value, schemaErrors) }
+            : { ok: false, ...limit };
+    }
+    const document = value;
+    const limit = decimalBudget(document);
+    if (limit !== undefined)
+        return { ok: false, ...limit };
+    if (complex) {
+        return conformsSemantically(document)
+            ? { ok: true, result: conforming(document) }
+            : {
+                ok: false,
+                ...inputLimitFailure("invalid-document-values", inputLimits.invalidDocumentValues)
+            };
+    }
+    const semanticErrors = validateSemantics(document);
+    if (semanticErrors.length === 0)
+        return { ok: true, result: conforming(document) };
+    const semanticLimit = diagnosticLimit(semanticErrors);
+    return semanticLimit === undefined
+        ? { ok: true, result: structuralFailure(document, semanticErrors) }
+        : { ok: false, ...semanticLimit };
+};
+export const validateDocument = (value) => {
+    const schemaErrors = validateSchema(value);
+    return schemaErrors.length > 0
+        ? structuralFailure(value, schemaErrors)
+        : validateConformingShape(value);
+};
+//# sourceMappingURL=validate.js.map

package/dist/validation/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAA0B,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,eAAe,EAA4C,MAAM,eAAe,CAAA;AAiBzF,MAAM,cAAc,GAAG,CACrB,MAAsC,EACY,EAAE;IACpD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAA;IAC/B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IACzF,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA;AAOD,MAAM,aAAa,GAAG,CAAC,MAAsC,EAA2B,EAAE,CAAC,CAAC;IAC1F,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE;IACxE,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE;CACtD,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG,CAAC,MAAsC,EAAU,EAAE,CACzE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AAEnD,MAAM,eAAe,GAAG,CACtB,MAAsC,EACP,EAAE,CACjC,eAAe,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,yBAAyB;IAC7D,CAAC,CAAC,iBAAiB,CAAC,6BAA6B,EAAE,WAAW,CAAC,yBAAyB,CAAC;IACzF,CAAC,CAAC,SAAS,CAAA;AAEf,QAAQ,CAAC,CAAC,gBAAgB,CAAC,QAA4B;IACrD,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAChD,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO;YAAE,SAAQ;QAC5C,MAAM,WAAW,CAAC,MAAM,CAAA;QACxB,MAAM,WAAW,CAAC,QAAQ,CAAA;QAC1B,MAAM,WAAW,CAAC,UAAU,CAAA;QAC5B,MAAM,WAAW,CAAC,SAAS,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,CAAC,gBAAgB,CAAC,QAAkB;IAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;YAAE,MAAM,IAAI,CAAC,gBAAgB,CAAA;IACtE,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAA;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC9C,KAAK,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,QAA0B,EAAiC,EAAE;IACrF,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnG,IAAI,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC;YACvC,OAAO,iBAAiB,CAAC,gBAAgB,EAAE,WAAW,CAAC,aAAa,CAAC,CAAA;QACvE,CAAC;QACD,KAAK,IAAI,MAAM,CAAA;QACf,IAAI,KAAK,GAAG,WAAW,CAAC,kBAAkB,EAAE,CAAC;YAC3C,OAAO,iBAAiB,CAAC,sBAAsB,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAiC,EAAE;IAC9E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,oBAAoB,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACrG,MAAM,QAAQ,GAAI,KAA8D,CAAC,kBAAkB,CAAA;IACnG,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC1F,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CACxB,KAAc,EACd,YAA4C,EACxB,EAAE;IACtB,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;IAC9C,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,oBAAoB,IAAI,KAAK,CAAA;IAChG,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,CACjG,CAAA;IACD,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;QACnC,OAAO;YACL,UAAU;YACV,YAAY,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAC7F,CAAA;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW;QAC1B,CAAC,CAAE,KAA0E,CAAC,kBAAkB;QAChG,CAAC,CAAC,SAAS,CAAA;IACb,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAA;AAC5E,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAsB,EAAE;IAC5D,MAAM,UAAU,GAGZ;QACF,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QACjD,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;KAClC,CAAA;IACD,OAAO;QACL,QAAQ;QACR,UAAU;QACV,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,kBAAkB,EAAE,UAAU,CAAC;KACvE,CAAA;AACH,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,CAAC,QAAkB,EAAsB,EAAE;IACzE,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC5D,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,kBAAkB,EAAE,UAAU,CAAC,EAAE,CAAA;AAC/F,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,QAAkB,EAAiC,EAAE;IAC1E,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,KAAc,EACd,UAAkB,EACS,EAAE;IAC7B,MAAM,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAA;IAC9D,MAAM,YAAY,GAAG,OAAO;QAC1B,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,SAAS;QACb,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,GAAG,iBAAiB,CAAC,yBAAyB,EAAE,WAAW,CAAC,qBAAqB,CAAC;SACnF,CAAA;IACH,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,CACjG,CAAA;QACD,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAA;QAChF,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,aAAa,EAAE,CAAA;QACvE,MAAM,KAAK,GAAG,eAAe,CAAC,YAAY,CAAC,CAAA;QAC3C,OAAO,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE;YAC9D,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAA;IAC7B,CAAC;IACD,MAAM,QAAQ,GAAG,KAAiB,CAAA;IAClC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAA;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,oBAAoB,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE;YAC5C,CAAC,CAAC;gBACE,EAAE,EAAE,KAAK;gBACT,GAAG,iBAAiB,CAAC,yBAAyB,EAAE,WAAW,CAAC,qBAAqB,CAAC;aACnF,CAAA;IACP,CAAC;IACD,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAA;IAClF,MAAM,aAAa,GAAG,eAAe,CAAC,cAAc,CAAC,CAAA;IACrD,OAAO,aAAa,KAAK,SAAS;QAChC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE;QACnE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,aAAa,EAAE,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAsB,EAAE;IACrE,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAC1C,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC;QACxC,CAAC,CAAC,uBAAuB,CAAC,KAAiB,CAAC,CAAA;AAChD,CAAC,CAAA"}

package/dist/writer.js

@@ -0,0 +1,107 @@
+import { closeSync, fsyncSync, linkSync, lstatSync, openSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { dirname, join } from "node:path";
+export const outputEntryExists = (path) => {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch (error) {
+        const code = errorCode(error);
+        if (code === "ENOENT" || code === "ENOTDIR")
+            return false;
+        throw error;
+    }
+};
+export const nodeWriterServices = {
+    exists: outputEntryExists,
+    isDirectory: (path) => statSync(path).isDirectory(),
+    openExclusive: (path) => openSync(path, "wx", 0o600),
+    write: writeFileSync,
+    sync: fsyncSync,
+    close: closeSync,
+    link: linkSync,
+    unlink: unlinkSync,
+    suffix: () => randomBytes(8).toString("hex")
+};
+const errorCode = (error) => typeof error === "object" && error !== null && "code" in error && typeof error.code === "string"
+    ? error.code
+    : undefined;
+const closeWithoutMasking = (descriptor, services) => {
+    if (descriptor === null)
+        return;
+    try {
+        services.close(descriptor);
+    }
+    catch {
+        // The primary write outcome remains authoritative.
+    }
+};
+const unlinkWithoutMasking = (path, services) => {
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            services.unlink(path);
+            return;
+        }
+        catch {
+            // Retry transient close/antivirus races before preserving the primary
+            // operation outcome.
+        }
+    }
+};
+export const writeNewFile = (path, bytes, services = nodeWriterServices) => {
+    try {
+        if (services.exists(path))
+            return "output-exists";
+    }
+    catch {
+        return "write-failed";
+    }
+    const parent = dirname(path);
+    try {
+        if (!services.isDirectory(parent))
+            return "output-parent-not-found";
+    }
+    catch (error) {
+        const code = errorCode(error);
+        return code === "ENOENT" || code === "ENOTDIR" ? "output-parent-not-found" : "write-failed";
+    }
+    let temporary;
+    try {
+        temporary = join(parent, `.fs-${services.suffix()}.tmp`);
+    }
+    catch {
+        return "write-failed";
+    }
+    let descriptor = null;
+    let ownsTemporary = false;
+    try {
+        descriptor = services.openExclusive(temporary);
+        ownsTemporary = true;
+        services.write(descriptor, bytes);
+        services.sync(descriptor);
+        services.close(descriptor);
+        descriptor = null;
+    }
+    catch {
+        closeWithoutMasking(descriptor, services);
+        if (ownsTemporary)
+            unlinkWithoutMasking(temporary, services);
+        return "write-failed";
+    }
+    try {
+        services.link(temporary, path);
+    }
+    catch (error) {
+        unlinkWithoutMasking(temporary, services);
+        return errorCode(error) === "EEXIST" ? "output-exists" : "write-failed";
+    }
+    // Once the hard link succeeds, the destination is a synced, exact copy and
+    // the operation has committed. Cleanup must not turn that success into a
+    // reported failure or attempt to remove a destination another process can
+    // already observe. A persistent unlink fault can retain only the complete,
+    // private-mode temporary hard link; it cannot expose a partial destination.
+    unlinkWithoutMasking(temporary, services);
+    return null;
+};
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

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

package/examples/README.md

@@ -0,0 +1,37 @@
+# V0 Examples
+
+These examples provide conformance evidence for the current `0.1`
+[semantic specification](https://cpaikr.github.io/fs/spec/0.1/). They
+demonstrate complete artifacts rather than acting as partially completed
+authoring templates. See the [bundled authoring guide](../assets/guide/authoring.md)
+for the encoding workflow.
+
+## Files
+
+- `minimal.json` is the smallest complete statement-row document. It omits
+  optional identifiers, grouping columns, rollups, and validation snapshot, so
+  its calculation status is `not-defined`.
+- `manufacturing-group.json` combines income, balance-sheet, cash-flow, equity,
+  and manufacturing statements for one entity. It carries the optional
+  canonical `$schema` discovery pointer, is structurally conforming, and is
+  deliberately calculation-inconsistent.
+
+## Manufacturing Example Evidence
+
+- Statements own their ordered items and select their display periods.
+- Income uses a nested revenue and cost-of-sales subtotal graph; the explicit
+  2025 gross-profit value is deliberately inconsistent with its direct
+  children.
+- Balance sheet, cash flow, equity, and manufacturing statements include
+  satisfied rollups alongside that failure.
+- Item identifiers such as `materials` and `labor` repeat across statements,
+  proving item and rollup identity is statement-local.
+- `majorGroup` and `valuation` demonstrate exact grouping maps, including null
+  grouping cells.
+- Most rows use KRW millions while the EPS row uses KRW per share, proving
+  mixed-unit statement presentation without permitting mixed-unit rollup
+  edges.
+- Values include exact decimals, signs, zero, and explicit unavailability.
+
+Structural conformance and calculation consistency are separate outcomes; the
+example is valid even though one rollup application is unsatisfied.