@septkit/ui 0.0.25 → 0.0.26

package/dist/dialecte/composables/index.js

@@ -0,0 +1,2 @@
+import "./use-live-data.js";
+import "./use-live-state.js";

package/dist/{composables → dialecte/composables}/use-live-data.js

@@ -1,7 +1,7 @@
-import { useDebounceFn as e } from "../external/.pnpm/@vueuse_shared@14.2.1_vue@3.5.32_typescript@5.8.3_/node_modules/@vueuse/shared/dist/index.js";
-import { useAsyncState as t } from "../external/.pnpm/@vueuse_core@14.2.1_vue@3.5.32_typescript@5.8.3_/node_modules/@vueuse/core/dist/index.js";
+import { useDebounceFn as e } from "../../external/.pnpm/@vueuse_shared@14.2.1_vue@3.5.32_typescript@5.8.3_/node_modules/@vueuse/shared/dist/index.js";
+import { useAsyncState as t } from "../../external/.pnpm/@vueuse_core@14.2.1_vue@3.5.32_typescript@5.8.3_/node_modules/@vueuse/core/dist/index.js";
 import { isRef as n, watch as r } from "vue";
-//#region lib/composables/use-live-data.ts
+//#region lib/dialecte/composables/use-live-data.ts
 function i(i) {
 	let { document: a, fetcher: o, initial: s } = i, { state: c, isLoading: l, error: u, execute: d } = t(o, s), f = e(d, 50);
 	return r(() => {

package/dist/{composables → dialecte/composables}/use-live-state.js

@@ -1,5 +1,5 @@
 import { computed as e, isRef as t, reactive as n } from "vue";
-//#region lib/composables/use-live-state.ts
+//#region lib/dialecte/composables/use-live-state.ts
 function r(r) {
 	return t(r) ? e(() => n(r.value.state)) : n(r.state);
 }

package/dist/dialecte/document-gate.js

@@ -0,0 +1,5 @@
+import e from "./document-gate.vue_vue_type_script_setup_true_lang.js";
+//#region lib/dialecte/document-gate.vue
+var t = e;
+//#endregion
+export { t as default };

package/dist/dialecte/document-gate.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,18 @@
+import { useDocumentStore as e } from "./use-document-store.js";
+import { defineComponent as t, onUnmounted as n, renderSlot as r, unref as i, watch as a } from "vue";
+//#region lib/dialecte/document-gate.vue?vue&type=script&setup=true&lang.ts
+var o = /* @__PURE__ */ t({
+	__name: "document-gate",
+	props: {
+		project: {},
+		documentId: {}
+	},
+	setup(t) {
+		let o = t, s = e();
+		return a(() => o.documentId, (e) => {
+			e ? s.hydrate(o.project.openDocument(e)) : s.clear();
+		}, { immediate: !0 }), n(() => s.clear()), (e, t) => i(s).isHydrated ? r(e.$slots, "default", { key: 0 }) : r(e.$slots, "loading", { key: 1 });
+	}
+});
+//#endregion
+export { o as default };

package/dist/dialecte/index.js

@@ -0,0 +1,5 @@
+import "./use-document-store.js";
+import "./document-gate.js";
+import "./composables/use-live-data.js";
+import "./composables/use-live-state.js";
+import "./composables/index.js";

package/dist/dialecte/use-document-store.js

@@ -0,0 +1,21 @@
+import { D as e } from "../external/.pnpm/@dialecte_core@0.2.11/node_modules/@dialecte/core/dist/index-DWV6tSGF.js";
+import { computed as t, shallowRef as n } from "vue";
+//#region lib/dialecte/use-document-store.ts
+var r = n(null);
+function i() {
+	let n = t(() => (e(r.value, { detail: "useDocumentStore: document accessed outside <DocumentGate>. Wrap the consuming subtree in <DocumentGate> or check isHydrated before reading." }), r.value)), i = t(() => r.value !== null);
+	function a(e) {
+		r.value = e;
+	}
+	function o() {
+		r.value = null;
+	}
+	return {
+		document: n,
+		isHydrated: i,
+		hydrate: a,
+		clear: o
+	};
+}
+//#endregion
+export { i as useDocumentStore };

package/dist/external/.pnpm/@dialecte_core@0.2.11/node_modules/@dialecte/core/dist/index-DWV6tSGF.js

@@ -0,0 +1,138 @@
+//#region node_modules/.pnpm/@dialecte+core@0.2.11/node_modules/@dialecte/core/dist/index-DWV6tSGF.js
+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"
+	},
+	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"
+	},
+	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"
+	}
+};
+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;
+}
+function r(e, n) {
+	if (e) return;
+	let { detail: r, key: i = "ASSERTION_FAILED", ref: a } = n;
+	t(i, {
+		detail: r,
+		ref: a
+	});
+}
+//#endregion
+export { r as D };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { AcceptableValue } from 'reka-ui';
+import { AllowedComponentProps } from 'vue';
 import { AnyDialecteConfig } from '@dialecte/core';
 import { Component } from 'vue';
+import { ComponentCustomProps } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
@@ -11,6 +13,9 @@ import { Project } from '@dialecte/core';
 import { ProjectState } from '@dialecte/core';
 import { PublicProps } from 'vue';
 import { Ref } from 'vue';
+import { ShallowUnwrapRef } from 'vue';
+import { VNode } from 'vue';
+import { VNodeProps } from 'vue';
 
 declare const __VLS_component: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLButtonElement>;
 
@@ -44,6 +49,10 @@ size: "xs" | "sm" | "md" | "lg" | "xl";
 color: "neutral" | "primary" | "secondary" | "accent" | "info" | "success" | "warning" | "error";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+declare type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
 declare type __VLS_Props = {
     color?: 'neutral' | 'primary' | 'secondary' | 'accent' | 'info' | 'success' | 'warning' | 'error';
     variant?: 'outline' | 'dash' | 'soft' | 'ghost' | 'link';
@@ -156,6 +165,22 @@ declare function closeDropdown(): void;
 
 export declare const Combobox: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
 
+export declare const DocumentGate: <GenericConfig extends AnyDialecteConfig>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, never> & {
+        project: Project<GenericConfig>;
+        documentId: string | undefined;
+    } & Partial<{}>> & PublicProps;
+    expose(exposed: ShallowUnwrapRef<    {}>): void;
+    attrs: any;
+    slots: {
+        default?(_: {}): any;
+        loading?(_: {}): any;
+    };
+    emit: {};
+}>) => VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+
 export declare const Dropdown: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
 
 export declare const ELEMENT_TO_COLOR: Record<string, ElementColor>;
@@ -188,7 +213,27 @@ export declare function useDocumentState<GenericConfig extends AnyDialecteConfig
 
 export declare function useDocumentState<GenericConfig extends AnyDialecteConfig>(document: Document_2<GenericConfig>): DocumentState;
 
-export declare function useLiveData<T, GenericConfig extends AnyDialecteConfig>(params: {
+/**
+ * Access the currently active Document.
+ *
+ * Must be called from within a <DocumentGate> subtree.
+ * Accessing `document` outside the gate throws.
+ *
+ * Generic on the dialecte config so consumers get fully typed
+ * query/transaction APIs without runtime overhead.
+ *
+ * @example
+ * const { document, isHydrated } = useDocumentStore<Scl.Config>()
+ * const root = await document.value.query.getRoot()
+ */
+export declare function useDocumentStore<GenericConfig extends AnyDialecteConfig = AnyDialecteConfig>(): {
+    document: ComputedRef<Document_2<GenericConfig>>;
+    isHydrated: ComputedRef<boolean>;
+    hydrate: (doc: Document_2<GenericConfig>) => void;
+    clear: () => void;
+};
+
+export declare function useLiveData<GenericConfig extends AnyDialecteConfig, T>(params: {
     document: Document_2<GenericConfig> | ComputedRef<Document_2<GenericConfig>>;
     fetcher: () => Promise<T>;
     initial: T;
@@ -199,7 +244,7 @@ export declare function useLiveData<T, GenericConfig extends AnyDialecteConfig>(
     refresh: (delay?: number) => Promise<T | undefined>;
 };
 
-export declare function useProjectLiveData<T, GenericConfig extends AnyDialecteConfig>(params: {
+export declare function useProjectLiveData<GenericConfig extends AnyDialecteConfig, T>(params: {
     project: Project<GenericConfig>;
     fetcher: () => Promise<T>;
     initial: T;

package/dist/index.js

@@ -1,11 +1,14 @@
-import { useLiveData as e, useProjectLiveData as t } from "./composables/use-live-data.js";
-import { useDocumentState as n, useProjectState as r } from "./composables/use-live-state.js";
-import i from "./button/button.js";
-import a from "./dropdown/dropdown.js";
-import o from "./dropdown/combobox.js";
+import { useDocumentStore as e } from "./dialecte/use-document-store.js";
+import t from "./dialecte/document-gate.js";
+import { useLiveData as n, useProjectLiveData as r } from "./dialecte/composables/use-live-data.js";
+import { useDocumentState as i, useProjectState as a } from "./dialecte/composables/use-live-state.js";
+import "./dialecte/index.js";
+import o from "./button/button.js";
+import s from "./dropdown/dropdown.js";
+import c from "./dropdown/combobox.js";
 import "./dropdown/index.js";
-import { CATEGORY_ELEMENTS as s, ELEMENT_TO_COLOR as c } from "./icons/element-color-map.generated.js";
-import { ELEMENT_TO_ICON as l } from "./icons/element-icon-mapper.js";
-import u from "./explorer/explorer.js";
+import { CATEGORY_ELEMENTS as l, ELEMENT_TO_COLOR as u } from "./icons/element-color-map.generated.js";
+import { ELEMENT_TO_ICON as d } from "./icons/element-icon-mapper.js";
+import f from "./explorer/explorer.js";
 import "./explorer/index.js";
-export { i as Button, s as CATEGORY_ELEMENTS, o as Combobox, a as Dropdown, c as ELEMENT_TO_COLOR, l as ELEMENT_TO_ICON, u as SclExplorer, n as useDocumentState, e as useLiveData, t as useProjectLiveData, r as useProjectState };
+export { o as Button, l as CATEGORY_ELEMENTS, c as Combobox, t as DocumentGate, s as Dropdown, u as ELEMENT_TO_COLOR, d as ELEMENT_TO_ICON, f as SclExplorer, i as useDocumentState, e as useDocumentStore, n as useLiveData, r as useProjectLiveData, a as useProjectState };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@septkit/ui",
-	"version": "0.0.25",
+	"version": "0.0.26",
 	"type": "module",
 	"source": "lib/index.ts",
 	"scripts": {