@septkit/ui 0.0.26 → 0.0.27

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

@@ -0,0 +1,20 @@
+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/create-document-store.ts
+function r() {
+	let r = n(null), i = t(() => (e(r.value, { detail: "createDocumentStore: document accessed before hydration. Ensure hydrate() is called before consumers read document, or guard with isHydrated." }), r.value)), a = t(() => r.value !== null);
+	function o(e) {
+		r.value = e;
+	}
+	function s() {
+		r.value = null;
+	}
+	return {
+		document: i,
+		isHydrated: a,
+		hydrate: o,
+		clear: s
+	};
+}
+//#endregion
+export { r as createDocumentStore };

package/dist/dialecte/index.js

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

package/dist/index.d.ts

@@ -1,8 +1,6 @@
 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';
@@ -13,9 +11,6 @@ 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>;
 
@@ -49,10 +44,6 @@ 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';
@@ -165,20 +156,35 @@ 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>;
+/**
+ * Build a per-extension reactive document store.
+ *
+ * Each call returns an isolated singleton (closure-scoped state). Extensions
+ * should invoke this once at module level and re-export the returned bindings.
+ *
+ * The store has no knowledge of the shell. The extension is responsible for
+ * calling `hydrate(doc)` whenever the active document changes, and `clear()`
+ * when no document is selected.
+ *
+ * `document.value` throws if accessed before hydration. Use `isHydrated` to
+ * guard render paths that depend on a real document.
+ *
+ * @example
+ * // per-extension: src/document-store.ts
+ * import type { Scl } from '@dialecte/scl/v2019C1'
+ * export const { document, isHydrated, hydrate, clear } =
+ *     createDocumentStore<Scl.Document>()
+ *
+ * // bootstrap (e.g. set-editor.ts), wired before app.mount:
+ * api.activeDocumentId.subscribe((id) => {
+ *     id ? hydrate(api.project.openDocument(id)) : clear()
+ * })
+ */
+export declare function createDocumentStore<GenericDocument>(): {
+    document: ComputedRef<GenericDocument>;
+    isHydrated: ComputedRef<boolean>;
+    hydrate: (doc: GenericDocument) => void;
+    clear: () => void;
 };
 
 export declare const Dropdown: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
@@ -213,26 +219,6 @@ export declare function useDocumentState<GenericConfig extends AnyDialecteConfig
 
 export declare function useDocumentState<GenericConfig extends AnyDialecteConfig>(document: Document_2<GenericConfig>): DocumentState;
 
-/**
- * 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>;

package/dist/index.js

@@ -1,14 +1,13 @@
-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 { createDocumentStore as e } from "./dialecte/create-document-store.js";
+import { useLiveData as t, useProjectLiveData as n } from "./dialecte/composables/use-live-data.js";
+import { useDocumentState as r, useProjectState as i } 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 a from "./button/button.js";
+import o from "./dropdown/dropdown.js";
+import s from "./dropdown/combobox.js";
 import "./dropdown/index.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 { CATEGORY_ELEMENTS as c, ELEMENT_TO_COLOR as l } from "./icons/element-color-map.generated.js";
+import { ELEMENT_TO_ICON as u } from "./icons/element-icon-mapper.js";
+import d from "./explorer/explorer.js";
 import "./explorer/index.js";
-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 };
+export { a as Button, c as CATEGORY_ELEMENTS, s as Combobox, o as Dropdown, l as ELEMENT_TO_COLOR, u as ELEMENT_TO_ICON, d as SclExplorer, e as createDocumentStore, r as useDocumentState, t as useLiveData, n as useProjectLiveData, i as useProjectState };

package/package.json

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

package/dist/dialecte/document-gate.js

@@ -1,5 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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/use-document-store.js

@@ -1,21 +0,0 @@
-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 };