@dialecte/core 0.2.12 → 0.2.15

package/dist/types/blob.d.ts

@@ -0,0 +1,35 @@
+/**
+ * BlobRecord — registry entry for a binary attachment stored alongside XML documents.
+ *
+ * The binary data lives in a partitioned table `blob_{documentId}` (storage owner).
+ * `attachedTo` describes logical references from XML records; the array is independent
+ * of the storage owner and may include zero (standalone), one, or many references.
+ */
+export type BlobAttachment = {
+    /** The XML document this blob is referenced from */
+    documentId: string;
+    /** Record id (e.g. element uuid) inside that document */
+    recordRef: string;
+    /** Optional attribute name on the record where the filename is referenced */
+    attribute?: string;
+};
+export type BlobRecord = {
+    /** Blob identifier (crypto.randomUUID()) */
+    id: string;
+    /** Storage owner: binary data lives in `blob_{documentId}` */
+    documentId: string;
+    /** Original filename (e.g. "diagram.pdf") */
+    name: string;
+    /** MIME type (e.g. "application/pdf") */
+    mimeType?: string;
+    /** Size in bytes, for UI display without loading data */
+    size?: number;
+    /** Creation timestamp (ms since epoch) */
+    createdAt: number;
+    /**
+     * Logical references from XML records.
+     * Empty array = standalone project blob (not linked to any XML record).
+     */
+    attachedTo: BlobAttachment[];
+};
+//# sourceMappingURL=blob.d.ts.map

package/dist/types/blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/types/blob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,EAAE,cAAc,EAAE,CAAA;CAC5B,CAAA"}

package/dist/types/index.d.ts

@@ -3,4 +3,5 @@ export type * from './records';
 export type * from './operations';
 export type * from './io';
 export type * from './definition';
+export type * from './blob';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,MAAM,CAAA;AACzB,mBAAmB,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,MAAM,CAAA;AACzB,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,QAAQ,CAAA"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './invariant';
+export * from './save-to-disk';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA"}

package/dist/utils/save-to-disk.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Save a Blob to disk using the native File System Access API when available
+ * (Chrome / Edge) and falling back to a hidden anchor download (Safari /
+ * Firefox).
+ *
+ * Browser-only: relies on `window`, `document`, and `URL`.
+ */
+export declare function saveToDisk(params: {
+    data: Blob;
+    filename: string;
+    /** Optional picker type descriptor for `showSaveFilePicker`. */
+    pickerType?: {
+        description: string;
+        accept: Record<string, string[]>;
+    };
+}): Promise<void>;
+//# sourceMappingURL=save-to-disk.d.ts.map

package/dist/utils/save-to-disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-to-disk.d.ts","sourceRoot":"","sources":["../../src/utils/save-to-disk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAChC,CAAA;CACD,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB"}

package/dist/utils-B_-lXlpE.js

@@ -0,0 +1,177 @@
+//#region src/errors/codes.ts
+var e = {
+	UNKNOWN: {
+		code: "D0001",
+		message: "An unknown error occurred"
+	},
+	ASSERTION_FAILED: {
+		code: "D0002",
+		message: "Assertion failed"
+	},
+	STORE_CONNECTION_FAILED: {
+		code: "D1001",
+		message: "Failed to open database"
+	},
+	STORE_COMMIT_FAILED: {
+		code: "D1002",
+		message: "Failed to commit changes"
+	},
+	STORE_RECORD_NOT_FOUND: {
+		code: "D1003",
+		message: "Record not found in database"
+	},
+	STORE_BULK_ADD_FAILED: {
+		code: "D1004",
+		message: "Failed to add records to database"
+	},
+	STORE_BULK_UPDATE_FAILED: {
+		code: "D1005",
+		message: "Failed to update records in database"
+	},
+	STORE_DELETE_FAILED: {
+		code: "D1006",
+		message: "Failed to delete records from database"
+	},
+	STORE_NOT_WRITABLE: {
+		code: "D1007",
+		message: "Store is not writable"
+	},
+	STORE_BLOB_NOT_FOUND: {
+		code: "D1008",
+		message: "Blob not found"
+	},
+	ELEMENT_NOT_FOUND: {
+		code: "D2001",
+		message: "Element not found"
+	},
+	ROOT_NOT_FOUND: {
+		code: "D2002",
+		message: "Root element not found"
+	},
+	DUPLICATE_ID: {
+		code: "D2003",
+		message: "Duplicate element ID"
+	},
+	ELEMENT_TAGNAME_MISMATCH: {
+		code: "D2004",
+		message: "Element tagName does not match the expected type"
+	},
+	INVALID_PARENT_CHILD: {
+		code: "D3001",
+		message: "Invalid parent-child relationship"
+	},
+	INVALID_ATTRIBUTE: {
+		code: "D3002",
+		message: "Invalid attribute for element"
+	},
+	PROTECTED_ROOT: {
+		code: "D3003",
+		message: "Root element cannot be deleted"
+	},
+	REQUIRED_ATTRIBUTE_MISSING: {
+		code: "D3004",
+		message: "Required attribute is missing"
+	},
+	UNIQUE_CONSTRAINT_VIOLATION: {
+		code: "D3005",
+		message: "Value is already used within its scope"
+	},
+	ALREADY_COMMITTED: {
+		code: "D4001",
+		message: "Transaction already committed"
+	},
+	ALREADY_FAILED: {
+		code: "D4002",
+		message: "Transaction already failed"
+	},
+	DATABASE_COMMIT_ERROR: {
+		code: "D4003",
+		message: "An error occurred while committing changes to the database"
+	},
+	CONCURRENT_TRANSACTION: {
+		code: "D4004",
+		message: "A transaction is already in progress. Concurrent transactions are not supported yet — serialize them or implement a transaction queue."
+	},
+	EXPORT_ROOT_NOT_FOUND: {
+		code: "D5001",
+		message: "Root element not found in records during export"
+	},
+	EXPORT_ORPHAN_CHILD_REF: {
+		code: "D5002",
+		message: "Parent references non-existent child record"
+	},
+	EXTENSION_METHOD_COLLISION: {
+		code: "D6001",
+		message: "Extension method name collision detected"
+	},
+	UNKNOWN_CONFIG_KEY: {
+		code: "D7001",
+		message: "Unknown config key"
+	},
+	DOCUMENT_NOT_REGISTERED: {
+		code: "D7002",
+		message: "Document not registered in project"
+	},
+	PROJECT_NOT_OPENED: {
+		code: "D7003",
+		message: "Project not opened"
+	},
+	BLOB_NOT_FOUND: {
+		code: "D7004",
+		message: "Blob not found in store"
+	}
+};
+//#endregion
+//#region src/errors/errors.ts
+function t(t, r) {
+	let i = e[t], a = {
+		code: i.code,
+		key: t,
+		message: r.message ?? i.message,
+		detail: r.detail,
+		method: n((/* @__PURE__ */ Error()).stack),
+		ref: r.ref,
+		cause: r.cause
+	}, o = Error(r.detail);
+	throw o.cause = a, o;
+}
+function n(e) {
+	if (!e) return "unknown";
+	let t = e.split("\n").slice(1).find((e) => !/\b(throwDialecteError|assert)\b/.test(e));
+	if (!t) return "unknown";
+	let n = t.match(/\bat\s+(\S+)\s+\(([^)]+)\)/), r = n?.[1], i = n?.[2];
+	if (!i || !r) return r ?? "unknown";
+	let a = i.match(/(\w[\w-]*\/src\/[^?:]+)/);
+	return a ? `${a[1].replace(/\.[^/.]+$/, "")}::${r}` : r;
+}
+//#endregion
+//#region src/utils/invariant.ts
+function r(e, n) {
+	if (e) return;
+	let { detail: r, key: i = "ASSERTION_FAILED", ref: a } = n;
+	t(i, {
+		detail: r,
+		ref: a
+	});
+}
+//#endregion
+//#region src/utils/save-to-disk.ts
+async function i(e) {
+	let { data: t, filename: n, pickerType: r } = e;
+	if ("showSaveFilePicker" in window) try {
+		let e = await (await window.showSaveFilePicker({
+			suggestedName: n,
+			...r ? { types: [r] } : {}
+		})).createWritable();
+		await e.write(t), await e.close();
+		return;
+	} catch (e) {
+		if (e.name === "AbortError") return;
+		console.error("Save failed:", e);
+		return;
+	}
+	let i = URL.createObjectURL(t), a = document.createElement("a");
+	a.href = i, a.download = n, document.body.appendChild(a), a.click(), a.remove(), URL.revokeObjectURL(i);
+}
+//#endregion
+export { e as i, r as n, t as r, i as t };

package/dist/utils.d.ts

@@ -1,2 +1,2 @@
-export * from './utils/index'
+export * from './utils/index.js'
 export {}

package/dist/utils.js

@@ -1,4 +1,2 @@
-import { i as r } from "./index-BgyMtFE-.js";
-export {
-  r as invariant
-};
+import { n as e, t } from "./utils-B_-lXlpE.js";
+export { e as invariant, t as saveToDisk };

package/dist/xml/build/download-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download-file.d.ts","sourceRoot":"","sources":["../../../src/xml/build/download-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,wBAAsB,YAAY,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACnF,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;IACjE,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;CAChB,iBA4CA"}
+{"version":3,"file":"download-file.d.ts","sourceRoot":"","sources":["../../../src/xml/build/download-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,wBAAsB,YAAY,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IACnF,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;IACjE,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;CAChB,iBAoBA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dialecte/core",
-	"version": "0.2.12",
+	"version": "0.2.15",
 	"description": "Dialecte - Core functionality for Dialecte SDK",
 	"license": "MIT",
 	"repository": {
@@ -56,25 +56,24 @@
 		"xml-formatter": "^3.6.7"
 	},
 	"devDependencies": {
-		"@tsconfig/node22": "^22.0.2",
-		"@types/node": "^22.15.32",
+		"@tsconfig/node24": "^24.0.4",
+		"@types/node": "^24.12.4",
 		"@types/sax": "^1.2.7",
-		"@vitest/browser": "^3.2.4",
+		"@vitest/browser-playwright": "^4.1.8",
 		"@xmldom/xmldom": "^0.8.11",
 		"husky": "^9.1.7",
 		"jiti": "^2.4.2",
 		"npm-run-all2": "^8.0.4",
-		"oxfmt": "^0.38.0",
-		"oxlint": "^1.60.0",
-		"oxlint-tsgolint": "^0.21.1",
-		"playwright": "^1.53.2",
-		"tsx": "^4.21.0",
-		"typescript": "^5.9.3",
-		"vite": "^7.3.1",
-		"vite-plugin-dts": "^4.5.4",
-		"vitepress": "^2.0.0-alpha.16",
-		"vitepress-plugin-llms": "^1.11.1",
-		"vitest": "^3.2.4",
-		"vitest-browser-vue": "^1.0.0"
+		"oxfmt": "^0.53.0",
+		"oxlint": "^1.68.0",
+		"oxlint-tsgolint": "^0.23.0",
+		"playwright": "^1.60.0",
+		"tsx": "^4.22.4",
+		"typescript": "^6.0.3",
+		"vite": "^8.0.16",
+		"vite-plugin-dts": "^5.0.2",
+		"vitepress": "^2.0.0-alpha.17",
+		"vitepress-plugin-llms": "^1.13.1",
+		"vitest": "^4.1.8"
 	}
 }

package/dist/index-BgyMtFE-.js

@@ -1,150 +0,0 @@
-const c = {
-  // D0xxx — Generic
-  UNKNOWN: {
-    code: "D0001",
-    message: "An unknown error occurred"
-  },
-  ASSERTION_FAILED: {
-    code: "D0002",
-    message: "Assertion failed"
-  },
-  // D1xxx — Store/persistence
-  STORE_CONNECTION_FAILED: {
-    code: "D1001",
-    message: "Failed to open database"
-  },
-  STORE_COMMIT_FAILED: {
-    code: "D1002",
-    message: "Failed to commit changes"
-  },
-  STORE_RECORD_NOT_FOUND: {
-    code: "D1003",
-    message: "Record not found in database"
-  },
-  STORE_BULK_ADD_FAILED: {
-    code: "D1004",
-    message: "Failed to add records to database"
-  },
-  STORE_BULK_UPDATE_FAILED: {
-    code: "D1005",
-    message: "Failed to update records in database"
-  },
-  STORE_DELETE_FAILED: {
-    code: "D1006",
-    message: "Failed to delete records from database"
-  },
-  STORE_NOT_WRITABLE: {
-    code: "D1007",
-    message: "Store is not writable"
-  },
-  // D2xxx — Element lookup
-  ELEMENT_NOT_FOUND: {
-    code: "D2001",
-    message: "Element not found"
-  },
-  ROOT_NOT_FOUND: {
-    code: "D2002",
-    message: "Root element not found"
-  },
-  DUPLICATE_ID: {
-    code: "D2003",
-    message: "Duplicate element ID"
-  },
-  ELEMENT_TAGNAME_MISMATCH: {
-    code: "D2004",
-    message: "Element tagName does not match the expected type"
-  },
-  // D3xxx — Constraint violations
-  INVALID_PARENT_CHILD: {
-    code: "D3001",
-    message: "Invalid parent-child relationship"
-  },
-  INVALID_ATTRIBUTE: {
-    code: "D3002",
-    message: "Invalid attribute for element"
-  },
-  PROTECTED_ROOT: {
-    code: "D3003",
-    message: "Root element cannot be deleted"
-  },
-  REQUIRED_ATTRIBUTE_MISSING: {
-    code: "D3004",
-    message: "Required attribute is missing"
-  },
-  // D4xxx — Transaction lifecycle
-  ALREADY_COMMITTED: {
-    code: "D4001",
-    message: "Transaction already committed"
-  },
-  ALREADY_FAILED: {
-    code: "D4002",
-    message: "Transaction already failed"
-  },
-  DATABASE_COMMIT_ERROR: {
-    code: "D4003",
-    message: "An error occurred while committing changes to the database"
-  },
-  CONCURRENT_TRANSACTION: {
-    code: "D4004",
-    message: "A transaction is already in progress. Concurrent transactions are not supported yet — serialize them or implement a transaction queue."
-  },
-  // D5xxx — Import/Export
-  EXPORT_ROOT_NOT_FOUND: {
-    code: "D5001",
-    message: "Root element not found in records during export"
-  },
-  EXPORT_ORPHAN_CHILD_REF: {
-    code: "D5002",
-    message: "Parent references non-existent child record"
-  },
-  // D6xxx — Config
-  EXTENSION_METHOD_COLLISION: {
-    code: "D6001",
-    message: "Extension method name collision detected"
-  },
-  // D7xxx — Project
-  UNKNOWN_CONFIG_KEY: {
-    code: "D7001",
-    message: "Unknown config key"
-  },
-  DOCUMENT_NOT_REGISTERED: {
-    code: "D7002",
-    message: "Document not registered in project"
-  },
-  PROJECT_NOT_OPENED: {
-    code: "D7003",
-    message: "Project not opened"
-  }
-};
-function d(o, e) {
-  const s = c[o], t = {
-    code: s.code,
-    key: o,
-    message: e.message ?? s.message,
-    detail: e.detail,
-    method: i(new Error().stack),
-    ref: e.ref,
-    cause: e.cause
-  }, a = new Error(e.detail);
-  throw a.cause = t, a;
-}
-function i(o) {
-  if (!o) return "unknown";
-  const e = o.split(`
-`).slice(1).find((r) => !/\b(throwDialecteError|assert)\b/.test(r));
-  if (!e) return "unknown";
-  const s = e.match(/\bat\s+(\S+)\s+\(([^)]+)\)/), t = s?.[1], a = s?.[2];
-  if (!a || !t) return t ?? "unknown";
-  const n = a.match(/(\w[\w-]*\/src\/[^?:]+)/);
-  return n ? `${n[1].replace(/\.[^/.]+$/, "")}::${t}` : t;
-}
-function D(o, e) {
-  if (o) return;
-  const { detail: s, key: t = "ASSERTION_FAILED", ref: a } = e;
-  d(t, { detail: s, ref: a });
-}
-export {
-  c as E,
-  D as i,
-  d as t
-};