@ecoma-io/loom 0.2.0 → 0.4.0

package/dist/primitives/Editable/Editable.vue.d.ts

@@ -1,200 +0,0 @@
-import { type LabelOverrides } from "../../lib/labels";
-import type { LabelOf } from "../../lib/labels";
-/**
- * Everything this control publishes to assistive technology — and every one of
- * these replaces a name Reka UI would otherwise supply in English of its own
- * accord.
- *
- * `input` stands in for the `aria-label="editable input"` Reka writes into
- * `EditableInput`'s own vnode; `submit` and `cancel` for the `aria-label`s and
- * the visible `Submit` / `Cancel` text its two triggers render. A binding on
- * the Loom side arrives as a fallthrough attribute, which Vue merges onto the
- * root vnode *after* the render function produced it, and `mergeProps` is
- * last-write-wins for everything that is not `class`, `style` or `on*` — so
- * these replace Reka's rather than competing with it. Removing one does not
- * fall back to nothing: it falls back to Reka's English, which no test of
- * Loom's own strings would catch, and which `Editable.test.ts` therefore pins
- * by reading the rendered attribute back.
- *
- * `edit` is Loom's own, and it is the one that decides whether this component
- * is accessible at all. Edit-in-place fails a screen reader by looking like
- * text and therefore reading like text; this word is what the preview appends
- * to its value so it announces as something a reader can act on.
- */
-export interface EditableLabels {
-    /**
-     * Appended to the preview's accessible name, after the value, so the text
-     * announces as a control rather than as prose. It is what a reader hears at
-     * the end of "Quarterly report, Edit, button".
-     */
-    readonly edit: string;
-    /**
-     * The editor's own name, used only where nothing else names it — no
-     * wrapping [Field](../Field/Field.vue), no `ariaLabel`, no `aria-labelledby`.
-     * Naming the *kind* of value it holds beats naming the widget.
-     */
-    readonly input: string;
-    /** The button that commits the edit. */
-    readonly submit: string;
-    /** The button that abandons it and restores the previous value. */
-    readonly cancel: string;
-    /**
-     * Announced when a submit is refused because the box was left empty and
-     * `allowEmpty` is off. The value is the one that was restored, so a host can
-     * say what came back rather than only that something did — see `LabelOf` in
-     * `src/lib/labels.ts` for why it arrives as a value and not as a sentence.
-     */
-    readonly restored: LabelOf<{
-        value: string;
-    }>;
-}
-/**
- * Loom's English, co-located with the component so it tree-shakes with it: a
- * consumer who never imports Editable ships none of these bytes.
- *
- * Exported so a host can build a partial vocabulary against the real thing
- * rather than a transcription of it.
- */
-export declare const EDITABLE_LABELS: EditableLabels;
-/**
- * What a pointer has to do to open the editor. The keyboard is deliberately
- * not on this axis — Enter and Space open it in all three, because a mode a
- * reader cannot reach by keyboard is a control they cannot use.
- *
- *   • `click` — one click on the text opens it. The default: it is the whole
- *     promise of edit-in-place, and the only mode a touch reader can perform.
- *   • `dblclick` — for a row or a cell where a single click already means
- *     something else, selecting it.
- *   • `focus` — landing on it opens it, so Tab walks straight into the
- *     editor. For a column of fields being filled in order, and the mode that
- *     makes Escape's restore-and-hand-focus-back path load-bearing.
- */
-export type EditableActivationMode = "click" | "dblclick" | "focus";
-/**
- * What commits the edit.
- *
- *   • `both` — Enter, or focus leaving the control. The default: a reader who
- *     typed a value and clicked away meant to keep it.
- *   • `enter` — Enter alone; leaving discards, which suits an edit that is a
- *     deliberate act rather than an incidental one.
- *   • `blur` — leaving alone, for a control inside something that has its own
- *     Enter.
- *
- * Escape abandons under all three.
- */
-export type EditableSubmitMode = "blur" | "enter" | "both";
-declare const _default: typeof __VLS_export;
-export default _default;
-declare const __VLS_export: import("vue").DefineComponent<{
-    /** The committed value. Pair with `@update:modelValue` for `v-model`. */
-    modelValue?: string;
-    /** Shown in place of an empty value, in both the preview and the editor. */
-    placeholder?: string;
-    /** What a pointer does to open the editor. The keyboard opens it in every mode. */
-    activationMode?: EditableActivationMode;
-    /** What commits the edit. Escape abandons it under all three. */
-    submitMode?: EditableSubmitMode;
-    /**
-     * Sizes the control to its own text and stacks the two states in one grid
-     * cell, for an editable sitting inline in a sentence rather than in a
-     * column. It measures the committed value, not what is being typed.
-     */
-    autoResize?: boolean;
-    /** The longest value the editor will accept, in characters. */
-    maxLength?: number;
-    /**
-     * Lets a submitted empty value through. Off by default: an empty submit
-     * restores the previous value and reports `cancel` instead, because the
-     * damage is asymmetric — a value wrongly kept is on screen and can be
-     * edited again, a title wrongly emptied is gone.
-     */
-    allowEmpty?: boolean;
-    /** Unavailable: the preview drops out of the tab order and refuses to open. Unset defers to a wrapping Field. */
-    disabled?: boolean | undefined;
-    /** Shows the value without allowing an edit, while staying focusable. Unset defers to a wrapping Field. */
-    readonly?: boolean | undefined;
-    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */
-    invalid?: boolean | undefined;
-    /** Marks the value mandatory to assistive tech (`aria-required`). Unset defers to a wrapping Field. */
-    required?: boolean | undefined;
-    /** The field name for a native form post or `FormData`. Unset defers to a wrapping Field. */
-    name?: string;
-    /** The editor's accessible name, when no visible element already labels it. */
-    ariaLabel?: string;
-    /**
-     * Names for everything this control says out loud, as any subset of
-     * `EditableLabels` — the rest stay as the host's `provideLoomLabels`
-     * vocabulary left them, and then as Loom's English.
-     *
-     * This is the per-instance correction, not the place to localise an
-     * application: the case it exists for is `edit`, where a page of
-     * editables reads better as "Rename" or "Correct" than as the same verb
-     * five times.
-     */
-    labels?: LabelOverrides<EditableLabels>;
-}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => any;
-    submit: (value: string) => any;
-    cancel: () => any;
-}, string, import("vue").PublicProps, Readonly<{
-    /** The committed value. Pair with `@update:modelValue` for `v-model`. */
-    modelValue?: string;
-    /** Shown in place of an empty value, in both the preview and the editor. */
-    placeholder?: string;
-    /** What a pointer does to open the editor. The keyboard opens it in every mode. */
-    activationMode?: EditableActivationMode;
-    /** What commits the edit. Escape abandons it under all three. */
-    submitMode?: EditableSubmitMode;
-    /**
-     * Sizes the control to its own text and stacks the two states in one grid
-     * cell, for an editable sitting inline in a sentence rather than in a
-     * column. It measures the committed value, not what is being typed.
-     */
-    autoResize?: boolean;
-    /** The longest value the editor will accept, in characters. */
-    maxLength?: number;
-    /**
-     * Lets a submitted empty value through. Off by default: an empty submit
-     * restores the previous value and reports `cancel` instead, because the
-     * damage is asymmetric — a value wrongly kept is on screen and can be
-     * edited again, a title wrongly emptied is gone.
-     */
-    allowEmpty?: boolean;
-    /** Unavailable: the preview drops out of the tab order and refuses to open. Unset defers to a wrapping Field. */
-    disabled?: boolean | undefined;
-    /** Shows the value without allowing an edit, while staying focusable. Unset defers to a wrapping Field. */
-    readonly?: boolean | undefined;
-    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */
-    invalid?: boolean | undefined;
-    /** Marks the value mandatory to assistive tech (`aria-required`). Unset defers to a wrapping Field. */
-    required?: boolean | undefined;
-    /** The field name for a native form post or `FormData`. Unset defers to a wrapping Field. */
-    name?: string;
-    /** The editor's accessible name, when no visible element already labels it. */
-    ariaLabel?: string;
-    /**
-     * Names for everything this control says out loud, as any subset of
-     * `EditableLabels` — the rest stay as the host's `provideLoomLabels`
-     * vocabulary left them, and then as Loom's English.
-     *
-     * This is the per-instance correction, not the place to localise an
-     * application: the case it exists for is `edit`, where a page of
-     * editables reads better as "Rename" or "Correct" than as the same verb
-     * five times.
-     */
-    labels?: LabelOverrides<EditableLabels>;
-}> & Readonly<{
-    "onUpdate:modelValue"?: (value: string) => any;
-    onSubmit?: (value: string) => any;
-    onCancel?: () => any;
-}>, {
-    disabled: boolean | undefined;
-    invalid: boolean | undefined;
-    readonly: boolean | undefined;
-    required: boolean | undefined;
-    activationMode: EditableActivationMode;
-    submitMode: EditableSubmitMode;
-    autoResize: boolean;
-    allowEmpty: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-//# sourceMappingURL=Editable.vue.d.ts.map

package/dist/primitives/Editable/Editable.vue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Editable.vue.d.ts","sourceRoot":"","sources":["../../../src/primitives/Editable/Editable.vue"],"names":[],"mappings":"AAynBA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;wBACtC,OAAO,YAAY;AAAxC,wBAAyC;AACzC,QAAA,MAAM,YAAY;IAsDd,yEAAyE;iBAC5D,MAAM;IACnB,4EAA4E;kBAC9D,MAAM;IACpB,mFAAmF;qBAClE,sBAAsB;IACvC,iEAAiE;iBACpD,kBAAkB;IAC/B;;;;OAIG;iBACU,OAAO;IACpB,+DAA+D;gBACnD,MAAM;IAClB;;;;;OAKG;iBACU,OAAO;IACpB,iHAAiH;eACtG,OAAO,GAAG,SAAS;IAC9B,2GAA2G;eAChG,OAAO,GAAG,SAAS;IAC9B,gIAAgI;cACtH,OAAO,GAAG,SAAS;IAC7B,uGAAuG;eAC5F,OAAO,GAAG,SAAS;IAC9B,6FAA6F;WACtF,MAAM;IACb,+EAA+E;gBACnE,MAAM;IAClB;;;;;;;;;OASG;aACM,cAAc,CAAC,cAAc,CAAC;;;;;;IA7CvC,yEAAyE;iBAC5D,MAAM;IACnB,4EAA4E;kBAC9D,MAAM;IACpB,mFAAmF;qBAClE,sBAAsB;IACvC,iEAAiE;iBACpD,kBAAkB;IAC/B;;;;OAIG;iBACU,OAAO;IACpB,+DAA+D;gBACnD,MAAM;IAClB;;;;;OAKG;iBACU,OAAO;IACpB,iHAAiH;eACtG,OAAO,GAAG,SAAS;IAC9B,2GAA2G;eAChG,OAAO,GAAG,SAAS;IAC9B,gIAAgI;cACtH,OAAO,GAAG,SAAS;IAC7B,uGAAuG;eAC5F,OAAO,GAAG,SAAS;IAC9B,6FAA6F;WACtF,MAAM;IACb,+EAA+E;gBACnE,MAAM;IAClB;;;;;;;;;OASG;aACM,cAAc,CAAC,cAAc,CAAC;;;;;;cArB5B,OAAO,GAAG,SAAS;aAIpB,OAAO,GAAG,SAAS;cAFlB,OAAO,GAAG,SAAS;cAInB,OAAO,GAAG,SAAS;oBAzBb,sBAAsB;gBAE1B,kBAAkB;gBAMlB,OAAO;gBASP,OAAO;6EA+pBpB,CAAC"}

package/dist/primitives/Editable/Editable.vue_vue_type_script_setup_true_lang.js

@@ -1,275 +0,0 @@
-import { cn } from "../../lib/cn.js";
-import { optional } from "../../lib/props.js";
-import { useLabels } from "../../lib/labels.js";
-import { useSplitAttrs } from "../../lib/attrs.js";
-import { buttonVariants } from "../Button/Button.vue_vue_type_script_setup_true_lang.js";
-import { useFieldControl } from "../../lib/field-context.js";
-import { Check, Pencil, X } from "@lucide/vue";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeProps, nextTick, normalizeClass, openBlock, ref, toDisplayString, unref, watch, withCtx } from "vue";
-import { EditableArea, EditableCancelTrigger, EditableInput, EditablePreview, EditableRoot, EditableSubmitTrigger } from "reka-ui";
-//#region src/primitives/Editable/Editable.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = { class: "sr-only" };
-var _hoisted_2 = {
-	role: "status",
-	class: "sr-only"
-};
-/**
-* Loom's English, co-located with the component so it tree-shakes with it: a
-* consumer who never imports Editable ships none of these bytes.
-*
-* Exported so a host can build a partial vocabulary against the real thing
-* rather than a transcription of it.
-*/
-var EDITABLE_LABELS = {
-	edit: "Edit",
-	input: "Editable text",
-	submit: "Save",
-	cancel: "Cancel",
-	restored: ({ value }) => `Empty value discarded, ${value} restored`
-};
-var Editable_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
-	inheritAttrs: false,
-	__name: "Editable",
-	props: {
-		modelValue: {},
-		placeholder: {},
-		activationMode: { default: "click" },
-		submitMode: { default: "both" },
-		autoResize: {
-			type: Boolean,
-			default: false
-		},
-		maxLength: {},
-		allowEmpty: {
-			type: Boolean,
-			default: false
-		},
-		disabled: {
-			type: Boolean,
-			default: void 0
-		},
-		readonly: {
-			type: Boolean,
-			default: void 0
-		},
-		invalid: {
-			type: Boolean,
-			default: void 0
-		},
-		required: {
-			type: Boolean,
-			default: void 0
-		},
-		name: {},
-		ariaLabel: {},
-		labels: {}
-	},
-	emits: [
-		"update:modelValue",
-		"submit",
-		"cancel"
-	],
-	setup(__props, { emit: __emit }) {
-		const props = __props;
-		const emit = __emit;
-		const { attrs, rest: inputAttrs } = useSplitAttrs();
-		const field = useFieldControl(() => ({
-			id: attrs.id,
-			describedBy: attrs["aria-describedby"],
-			name: props.name,
-			disabled: props.disabled,
-			readonly: props.readonly,
-			invalid: props.invalid,
-			required: props.required
-		}));
-		const text = useLabels("editable", EDITABLE_LABELS, () => props.labels);
-		const value = ref(props.modelValue ?? "");
-		watch(() => props.modelValue, (next) => {
-			if (next !== void 0) value.value = next;
-		});
-		const editing = ref(false);
-		const previewRef = ref(null);
-		const rootRef = ref(null);
-		function elementOf(instance) {
-			const el = instance?.$el;
-			return el instanceof HTMLElement ? el : null;
-		}
-		let suppressFocusActivation = false;
-		function activate(edit) {
-			if (field.disabled || field.readonly || editing.value) return;
-			edit();
-		}
-		function onPreviewClick(event, edit) {
-			if (props.activationMode === "dblclick" && event.detail !== 0) return;
-			activate(edit);
-		}
-		function onPreviewDoubleClick(edit) {
-			if (props.activationMode !== "dblclick") return;
-			activate(edit);
-		}
-		function onPreviewFocus(edit) {
-			if (props.activationMode !== "focus" || suppressFocusActivation) return;
-			activate(edit);
-		}
-		function onPreviewBlur() {
-			suppressFocusActivation = false;
-		}
-		function restoreFocus() {
-			nextTick(() => {
-				const preview = elementOf(previewRef.value);
-				const root = elementOf(rootRef.value);
-				if (preview === null) return;
-				const active = document.activeElement;
-				if (!(active === null || active === document.body || (root?.contains(active) ?? false))) return;
-				suppressFocusActivation = true;
-				preview.focus();
-			});
-		}
-		function onState(state) {
-			editing.value = state === "edit";
-			if (state === "edit") return;
-			if (state === "cancel") emit("cancel");
-			restoreFocus();
-		}
-		const restored = ref("");
-		watch(editing, (isEditing) => {
-			if (isEditing) restored.value = "";
-		});
-		function onSubmit(submitted) {
-			const next = submitted ?? "";
-			if (next === "" && !props.allowEmpty) {
-				restored.value = text.value.restored({ value: value.value });
-				emit("cancel");
-				return;
-			}
-			if (props.modelValue === void 0) value.value = next;
-			emit("update:modelValue", next);
-			emit("submit", next);
-		}
-		const previewAs = computed(() => field.readonly ? "span" : "button");
-		const rootProps = computed(() => optional({
-			name: field.name,
-			maxLength: props.maxLength
-		}));
-		const editorAttrs = computed(() => {
-			const aria = { ...field.attrs };
-			delete aria.name;
-			return aria;
-		});
-		const editorLabel = computed(() => {
-			if (props.ariaLabel !== void 0) return props.ariaLabel;
-			if (field.id !== void 0) return void 0;
-			if (attrs["aria-label"] !== void 0 || attrs["aria-labelledby"] !== void 0) return void 0;
-			return text.value.input;
-		});
-		const areaClass = computed(() => cn("flex min-h-9 min-w-0 items-center rounded-md border border-transparent px-2 py-1", props.autoResize ? "w-auto" : "w-full", "text-inherit transition-[color,background-color,border-color,box-shadow] duration-fast ease-out", "focus-within:outline-2 focus-within:outline-offset-2 focus-within:outline-ring", !field.invalid && "focus-within:shadow-halo", editing.value && "border-input bg-background", !editing.value && !field.disabled && !field.readonly && "cursor-text hover:bg-subtle", field.readonly && "border-input bg-subtle", field.disabled && "cursor-not-allowed border-border bg-muted text-muted-foreground", "in-[fieldset:disabled]:cursor-not-allowed in-[fieldset:disabled]:bg-muted in-[fieldset:disabled]:text-muted-foreground", !field.invalid && "in-[fieldset:disabled]:border-border", field.invalid && "border-destructive focus-within:outline-destructive"));
-		const triggerClass = cn(buttonVariants({
-			variant: "ghost",
-			size: "icon-sm"
-		}), "disabled:cursor-not-allowed disabled:opacity-50");
-		return (_ctx, _cache) => {
-			return openBlock(), createBlock(unref(EditableRoot), mergeProps({
-				ref_key: "rootRef",
-				ref: rootRef
-			}, rootProps.value, {
-				"model-value": value.value,
-				placeholder: __props.placeholder ?? "",
-				"activation-mode": "none",
-				disabled: unref(field).disabled,
-				readonly: unref(field).readonly,
-				required: unref(field).required,
-				"submit-mode": __props.submitMode,
-				"auto-resize": __props.autoResize,
-				"data-editing": editing.value || void 0,
-				"data-invalid": unref(field).invalid || void 0,
-				"data-readonly": unref(field).readonly || void 0,
-				"data-disabled": unref(field).disabled || void 0,
-				class: unref(cn)("inline-flex items-center gap-1", __props.autoResize ? "w-auto align-baseline" : "w-full", unref(attrs).class),
-				"onUpdate:state": onState,
-				onSubmit
-			}), {
-				default: withCtx(({ edit }) => [
-					createVNode(unref(EditableArea), { class: normalizeClass(areaClass.value) }, {
-						default: withCtx(() => [createVNode(unref(EditablePreview), {
-							ref_key: "previewRef",
-							ref: previewRef,
-							as: previewAs.value,
-							type: unref(field).readonly ? void 0 : "button",
-							tabindex: unref(field).readonly ? 0 : void 0,
-							disabled: !unref(field).readonly && unref(field).disabled ? true : void 0,
-							"aria-describedby": unref(field).attrs["aria-describedby"],
-							"aria-invalid": unref(field).attrs["aria-invalid"],
-							class: "flex min-w-0 flex-1 items-center gap-1.5 text-start outline-none",
-							onClick: (event) => onPreviewClick(event, edit),
-							onDblclick: () => onPreviewDoubleClick(edit),
-							onFocus: () => onPreviewFocus(edit),
-							onBlur: onPreviewBlur
-						}, {
-							default: withCtx(() => [createElementVNode("span", { class: normalizeClass(unref(cn)("truncate", !value.value && "text-muted-foreground")) }, toDisplayString(value.value || __props.placeholder), 3), !unref(field).readonly ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createVNode(unref(Pencil), {
-								class: "h-3.5 w-3.5 shrink-0 text-muted-foreground",
-								"aria-hidden": "true"
-							}), createElementVNode("span", _hoisted_1, toDisplayString(unref(text).edit), 1)], 64)) : createCommentVNode("", true)]),
-							_: 2
-						}, 1032, [
-							"as",
-							"type",
-							"tabindex",
-							"disabled",
-							"aria-describedby",
-							"aria-invalid",
-							"onClick",
-							"onDblclick",
-							"onFocus"
-						]), createVNode(unref(EditableInput), mergeProps({
-							...unref(inputAttrs),
-							...editorAttrs.value
-						}, {
-							"aria-label": editorLabel.value,
-							class: "min-w-0 flex-1 bg-transparent text-inherit outline-none placeholder:text-muted-foreground"
-						}), null, 16, ["aria-label"])]),
-						_: 2
-					}, 1032, ["class"]),
-					createVNode(unref(EditableSubmitTrigger), {
-						"aria-label": unref(text).submit,
-						class: normalizeClass(unref(triggerClass))
-					}, {
-						default: withCtx(() => [createVNode(unref(Check), {
-							class: "h-4 w-4",
-							"aria-hidden": "true"
-						})]),
-						_: 1
-					}, 8, ["aria-label", "class"]),
-					createVNode(unref(EditableCancelTrigger), {
-						"aria-label": unref(text).cancel,
-						class: normalizeClass(unref(triggerClass))
-					}, {
-						default: withCtx(() => [createVNode(unref(X), {
-							class: "h-4 w-4",
-							"aria-hidden": "true"
-						})]),
-						_: 1
-					}, 8, ["aria-label", "class"]),
-					createElementVNode("span", _hoisted_2, toDisplayString(restored.value), 1)
-				]),
-				_: 1
-			}, 16, [
-				"model-value",
-				"placeholder",
-				"disabled",
-				"readonly",
-				"required",
-				"submit-mode",
-				"auto-resize",
-				"data-editing",
-				"data-invalid",
-				"data-readonly",
-				"data-disabled",
-				"class"
-			]);
-		};
-	}
-});
-//#endregion
-export { EDITABLE_LABELS, Editable_vue_vue_type_script_setup_true_lang_default as default };
-
-//# sourceMappingURL=Editable.vue_vue_type_script_setup_true_lang.js.map

package/dist/primitives/Editable/Editable.vue_vue_type_script_setup_true_lang.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Editable.vue_vue_type_script_setup_true_lang.js","names":[],"sources":["../../../src/primitives/Editable/Editable.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { LabelOf } from \"../../lib/labels\";\n\n/**\n * Everything this control publishes to assistive technology — and every one of\n * these replaces a name Reka UI would otherwise supply in English of its own\n * accord.\n *\n * `input` stands in for the `aria-label=\"editable input\"` Reka writes into\n * `EditableInput`'s own vnode; `submit` and `cancel` for the `aria-label`s and\n * the visible `Submit` / `Cancel` text its two triggers render. A binding on\n * the Loom side arrives as a fallthrough attribute, which Vue merges onto the\n * root vnode *after* the render function produced it, and `mergeProps` is\n * last-write-wins for everything that is not `class`, `style` or `on*` — so\n * these replace Reka's rather than competing with it. Removing one does not\n * fall back to nothing: it falls back to Reka's English, which no test of\n * Loom's own strings would catch, and which `Editable.test.ts` therefore pins\n * by reading the rendered attribute back.\n *\n * `edit` is Loom's own, and it is the one that decides whether this component\n * is accessible at all. Edit-in-place fails a screen reader by looking like\n * text and therefore reading like text; this word is what the preview appends\n * to its value so it announces as something a reader can act on.\n */\nexport interface EditableLabels {\n  /**\n   * Appended to the preview's accessible name, after the value, so the text\n   * announces as a control rather than as prose. It is what a reader hears at\n   * the end of \"Quarterly report, Edit, button\".\n   */\n  readonly edit: string;\n  /**\n   * The editor's own name, used only where nothing else names it — no\n   * wrapping [Field](../Field/Field.vue), no `ariaLabel`, no `aria-labelledby`.\n   * Naming the *kind* of value it holds beats naming the widget.\n   */\n  readonly input: string;\n  /** The button that commits the edit. */\n  readonly submit: string;\n  /** The button that abandons it and restores the previous value. */\n  readonly cancel: string;\n  /**\n   * Announced when a submit is refused because the box was left empty and\n   * `allowEmpty` is off. The value is the one that was restored, so a host can\n   * say what came back rather than only that something did — see `LabelOf` in\n   * `src/lib/labels.ts` for why it arrives as a value and not as a sentence.\n   */\n  readonly restored: LabelOf<{ value: string }>;\n}\n\n/**\n * Loom's English, co-located with the component so it tree-shakes with it: a\n * consumer who never imports Editable ships none of these bytes.\n *\n * Exported so a host can build a partial vocabulary against the real thing\n * rather than a transcription of it.\n */\nexport const EDITABLE_LABELS: EditableLabels = {\n  edit: \"Edit\",\n  input: \"Editable text\",\n  submit: \"Save\",\n  cancel: \"Cancel\",\n  restored: ({ value }) => `Empty value discarded, ${value} restored`,\n};\n\n/**\n * What a pointer has to do to open the editor. The keyboard is deliberately\n * not on this axis — Enter and Space open it in all three, because a mode a\n * reader cannot reach by keyboard is a control they cannot use.\n *\n *   • `click` — one click on the text opens it. The default: it is the whole\n *     promise of edit-in-place, and the only mode a touch reader can perform.\n *   • `dblclick` — for a row or a cell where a single click already means\n *     something else, selecting it.\n *   • `focus` — landing on it opens it, so Tab walks straight into the\n *     editor. For a column of fields being filled in order, and the mode that\n *     makes Escape's restore-and-hand-focus-back path load-bearing.\n */\nexport type EditableActivationMode = \"click\" | \"dblclick\" | \"focus\";\n\n/**\n * What commits the edit.\n *\n *   • `both` — Enter, or focus leaving the control. The default: a reader who\n *     typed a value and clicked away meant to keep it.\n *   • `enter` — Enter alone; leaving discards, which suits an edit that is a\n *     deliberate act rather than an incidental one.\n *   • `blur` — leaving alone, for a control inside something that has its own\n *     Enter.\n *\n * Escape abandons under all three.\n */\nexport type EditableSubmitMode = \"blur\" | \"enter\" | \"both\";\n</script>\n\n<script setup lang=\"ts\">\nimport { computed, nextTick, ref, watch, type ComponentPublicInstance } from \"vue\";\nimport {\n  EditableRoot,\n  EditableArea,\n  EditablePreview,\n  EditableInput,\n  EditableSubmitTrigger,\n  EditableCancelTrigger,\n} from \"reka-ui\";\nimport { Check, Pencil, X } from \"@lucide/vue\";\nimport { buttonVariants } from \"../Button/Button.vue\";\nimport { cn } from \"../../lib/cn\";\nimport { optional } from \"../../lib/props\";\nimport { useSplitAttrs } from \"../../lib/attrs\";\nimport { useFieldControl } from \"../../lib/field-context\";\nimport { useLabels, type LabelOverrides } from \"../../lib/labels\";\n\n/**\n * Editable — text that becomes an input where it stands: a record's title, a\n * name on a card, a cell in a table. It is the control that makes an\n * operations screen feel direct, because the value is edited where it is read\n * rather than in a dialog opened to hold one field.\n *\n * Reach for a [TextField](../TextField/TextField.vue) instead whenever the\n * value is being *entered* rather than corrected — a form is a set of empty\n * boxes and should look like one. This is for a value that already exists,\n * that is usually right, and that is occasionally wrong.\n *\n * **It takes no `size`, and that is the point.** Every other control in the\n * library picks a height off the shared scale; this one inherits the\n * typography around it, so an editable page title stays the size of a page\n * title and an editable table cell stays the size of a cell. What it pins\n * instead is that the two states are the same size as each other: the preview\n * and the editor are the only two children of one padded box, both single-line\n * and both inheriting that box's type, so the swap cannot move the row below\n * it. The box carries a transparent border at rest and a visible one while\n * editing — the same border width either way, for the same reason.\n *\n * **Escape restores and hands focus back.** Ending an edit hides the editor,\n * and a browser drops focus to `<body>` when the focused node goes away, so\n * without the hand-off a reader who abandoned an edit would lose their place\n * in the document. With `activationMode: \"focus\"` that hand-off would then\n * re-open the editor it just closed, which is why activation is Loom's rather\n * than Reka's here — the returning focus is suppressed exactly once, until the\n * reader leaves and comes back deliberately.\n *\n * **The model moves on submit, not on keystrokes.** `update:modelValue` fires\n * once, with the committed value, alongside `submit`; `cancel` fires when an\n * edit is abandoned. A control whose whole purpose is that an edit can be\n * taken back cannot publish every intermediate character as though it were\n * the value.\n *\n * Inside a [Field](../Field/Field.vue) it wires itself: the row's id, the id\n * of its hint or error line, `required`, `invalid`, `disabled`, `readonly` and\n * the name the value is submitted under all arrive through `useFieldControl()`.\n * Every prop below still wins over the row when it is set, in both directions\n * — which is why the four booleans default to `undefined` rather than `false`.\n *\n * `readonly` and `disabled` are different states, so the box has **three**\n * resting appearances rather than two. Read-only is a value on show: still\n * focusable, still copyable, still submitted, and lifted onto a fill with its\n * text at full strength. Disabled is unavailable, and drained a step further in\n * fill, in text colour and in border weight together. Three channels rather\n * than one is the point — see `areaClass`.\n *\n * Built on Reka UI's Editable, which owns the state machine — what is showing,\n * what the editor holds before it is committed, and what a dismiss means under\n * each submit mode.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** The committed value. Pair with `@update:modelValue` for `v-model`. */\n    modelValue?: string;\n    /** Shown in place of an empty value, in both the preview and the editor. */\n    placeholder?: string;\n    /** What a pointer does to open the editor. The keyboard opens it in every mode. */\n    activationMode?: EditableActivationMode;\n    /** What commits the edit. Escape abandons it under all three. */\n    submitMode?: EditableSubmitMode;\n    /**\n     * Sizes the control to its own text and stacks the two states in one grid\n     * cell, for an editable sitting inline in a sentence rather than in a\n     * column. It measures the committed value, not what is being typed.\n     */\n    autoResize?: boolean;\n    /** The longest value the editor will accept, in characters. */\n    maxLength?: number;\n    /**\n     * Lets a submitted empty value through. Off by default: an empty submit\n     * restores the previous value and reports `cancel` instead, because the\n     * damage is asymmetric — a value wrongly kept is on screen and can be\n     * edited again, a title wrongly emptied is gone.\n     */\n    allowEmpty?: boolean;\n    /** Unavailable: the preview drops out of the tab order and refuses to open. Unset defers to a wrapping Field. */\n    disabled?: boolean | undefined;\n    /** Shows the value without allowing an edit, while staying focusable. Unset defers to a wrapping Field. */\n    readonly?: boolean | undefined;\n    /** Error state: paints the destructive border and ring, and sets `aria-invalid`. Unset defers to a wrapping Field's `error`. */\n    invalid?: boolean | undefined;\n    /** Marks the value mandatory to assistive tech (`aria-required`). Unset defers to a wrapping Field. */\n    required?: boolean | undefined;\n    /** The field name for a native form post or `FormData`. Unset defers to a wrapping Field. */\n    name?: string;\n    /** The editor's accessible name, when no visible element already labels it. */\n    ariaLabel?: string;\n    /**\n     * Names for everything this control says out loud, as any subset of\n     * `EditableLabels` — the rest stay as the host's `provideLoomLabels`\n     * vocabulary left them, and then as Loom's English.\n     *\n     * This is the per-instance correction, not the place to localise an\n     * application: the case it exists for is `edit`, where a page of\n     * editables reads better as \"Rename\" or \"Correct\" than as the same verb\n     * five times.\n     */\n    labels?: LabelOverrides<EditableLabels>;\n  }>(),\n  {\n    activationMode: \"click\",\n    submitMode: \"both\",\n    autoResize: false,\n    allowEmpty: false,\n    // Not `false`, for any of the four. `false` is a caller saying \"this value\n    // is fine / available / editable even though its row is not\"; absent is a\n    // caller saying nothing, and only `undefined` survives to mean that past\n    // Vue's absent-Boolean-casts-to-false rule — see TextField.vue, which\n    // carries the full reasoning.\n    disabled: undefined,\n    readonly: undefined,\n    invalid: undefined,\n    required: undefined,\n  },\n);\n\nconst emit = defineEmits<{\n  /** The committed value. Fires on submit only, never per keystroke. */\n  \"update:modelValue\": [value: string];\n  /** The edit was committed, with the value that was accepted. */\n  submit: [value: string];\n  /** The edit was abandoned — Escape, the cancel button, or a refused empty submit. */\n  cancel: [];\n}>();\n\ndefineOptions({ inheritAttrs: false });\n\n// `class` lands on the root rather than on the bordered box inside it: the\n// root is what participates in the caller's layout, and it holds the box and\n// the two commit controls beside it, so a caller's `w-64` has to size all\n// three. Everything else — `id`, `aria-describedby`, `aria-labelledby`,\n// `data-testid`, `autocomplete` — describes the *editor*, and lands there.\nconst { attrs, rest: inputAttrs } = useSplitAttrs();\n\n// `id` and `aria-describedby` reach a bare control as fallthrough attrs rather\n// than props, so they are read off `attrs` and handed in as this caller's own\n// values — a caller who sets either still beats the row, and the row's\n// description is merged into theirs rather than replacing it.\nconst field = useFieldControl(() => ({\n  id: attrs.id as string | undefined,\n  describedBy: attrs[\"aria-describedby\"] as string | undefined,\n  name: props.name,\n  disabled: props.disabled,\n  readonly: props.readonly,\n  invalid: props.invalid,\n  required: props.required,\n}));\n\n// `text`, not `labels`: the prop of that name is one of the three sources this\n// resolves, and a template reading the raw prop would be reading the overrides\n// rather than the answer.\nconst text = useLabels(\"editable\", EDITABLE_LABELS, () => props.labels);\n\n// The value as this component knows it, which is also what Reka is fed. Two\n// things need it. A defined `model-value` is what puts Reka in controlled\n// mode, and controlled is what lets a submit be *refused* — Reka's own commit\n// then only announces the new value rather than adopting it, so the preview\n// keeps showing the old one with nothing to undo. And a host using this\n// without `v-model` still needs the value to move, which is what the\n// optimistic write in `onSubmit` is for.\nconst value = ref(props.modelValue ?? \"\");\nwatch(\n  () => props.modelValue,\n  (next) => {\n    // `undefined` is a host that never controlled the value, not a host\n    // clearing it — adopting it would blank the box on any unrelated re-render.\n    if (next !== undefined) value.value = next;\n  },\n);\n\n// Mirrors Reka's own `isEditing`, off the state event rather than out of the\n// slot, because the class bindings and the activation guard both need it in\n// the script half as well as in the template.\nconst editing = ref(false);\n\nconst previewRef = ref<ComponentPublicInstance | null>(null);\nconst rootRef = ref<ComponentPublicInstance | null>(null);\n\n// Reka's parts are components, so the only handle on their DOM node is `$el`,\n// which Vue types as `any`. Narrowing through `unknown` keeps that `any` from\n// spreading into everything it touches — and answers the SSR case honestly,\n// where there is no element at all.\nfunction elementOf(instance: ComponentPublicInstance | null): HTMLElement | null {\n  const el = instance?.$el as unknown;\n  return el instanceof HTMLElement ? el : null;\n}\n\n// Set only when focus was actually handed back to the preview, and cleared the\n// moment the reader leaves it. Without it, `activationMode: \"focus\"` would\n// read that hand-off as a fresh arrival and re-open the editor the reader just\n// escaped from — a control that cannot be abandoned, which is precisely the\n// trap Escape exists to avoid.\nlet suppressFocusActivation = false;\n\nfunction activate(edit: () => void): void {\n  if (field.disabled || field.readonly || editing.value) return;\n  edit();\n}\n\n// Reka's own activation is switched off in the template\n// (`activation-mode=\"none\"`) and rebuilt in these three handlers, rather than\n// passed through. Two things need that. Reka has no click mode at all and no\n// keyboard path on its preview, so two of the three modes this component\n// publishes would be unreachable without a pointer. And its focus mode cannot\n// tell a reader arriving on the control from the focus this component hands\n// back after an Escape — which would re-open the editor that Escape just\n// abandoned, forever.\n//\n// A `<button>` turns Enter and Space into a click carrying `detail === 0`,\n// which is what lets one handler serve the keyboard in every activation mode:\n// `dblclick` cannot be typed, and `focus` must not be the only way in for a\n// reader who arrived on the control without meaning to edit yet. `detail` is\n// the same signal Pagination reads to tell a synthesised click from a pointer\n// one.\nfunction onPreviewClick(event: MouseEvent, edit: () => void): void {\n  if (props.activationMode === \"dblclick\" && event.detail !== 0) return;\n  activate(edit);\n}\n\nfunction onPreviewDoubleClick(edit: () => void): void {\n  if (props.activationMode !== \"dblclick\") return;\n  activate(edit);\n}\n\nfunction onPreviewFocus(edit: () => void): void {\n  if (props.activationMode !== \"focus\" || suppressFocusActivation) return;\n  activate(edit);\n}\n\nfunction onPreviewBlur(): void {\n  suppressFocusActivation = false;\n}\n\n// The editor is hidden the instant an edit ends, and a browser drops focus to\n// `<body>` when the focused node goes away — so a reader who pressed Escape or\n// Enter would be left with no position in the document at all.\n//\n// Only focus that was actually lost is rescued. A submit caused by clicking\n// somewhere else has already put the reader where they meant to be, and\n// stealing focus back from them would be the worse bug; the same reasoning,\n// and the same `<body>` check, as Pagination's edge-control hand-off. jsdom\n// leaves focus on the hidden node rather than dropping it, and a click on the\n// commit button leaves it on a button that is about to be hidden too, so\n// anything still inside this control counts as lost.\nfunction restoreFocus(): void {\n  void nextTick(() => {\n    const preview = elementOf(previewRef.value);\n    const root = elementOf(rootRef.value);\n    if (preview === null) return;\n\n    const active = document.activeElement;\n    const lost = active === null || active === document.body || (root?.contains(active) ?? false);\n    if (!lost) return;\n\n    suppressFocusActivation = true;\n    preview.focus();\n  });\n}\n\nfunction onState(state: \"edit\" | \"submit\" | \"cancel\"): void {\n  editing.value = state === \"edit\";\n  if (state === \"edit\") return;\n  if (state === \"cancel\") emit(\"cancel\");\n  restoreFocus();\n}\n\n// The refusal, held for one announcement rather than derived, so the live\n// region says something only when a submit was actually turned away — and is\n// cleared when the next edit opens, so a second identical refusal is still a\n// change to the region and still gets announced.\nconst restored = ref(\"\");\nwatch(editing, (isEditing) => {\n  if (isEditing) restored.value = \"\";\n});\n\n// Reka's `submit` is an announcement rather than a request — in controlled\n// mode it has already told us what it would like the value to be and left the\n// deciding here, which is what makes the empty case answerable at all.\nfunction onSubmit(submitted: string | null | undefined): void {\n  const next = submitted ?? \"\";\n\n  // An empty submit is the one genuinely ambiguous outcome: a reader who\n  // cleared the box and pressed Enter may have meant to blank the value, and\n  // under `submitMode: \"blur\"` may have meant nothing at all. Loom restores\n  // rather than clears, and `allowEmpty` is how a field that can legitimately\n  // be emptied says so. `restored` announces it, because a refusal that only\n  // shows up as text snapping back is a refusal a screen reader never hears.\n  if (next === \"\" && !props.allowEmpty) {\n    restored.value = text.value.restored({ value: value.value });\n    emit(\"cancel\");\n    return;\n  }\n\n  // Optimistic only while uncontrolled. With a `modelValue` prop the host owns\n  // the value, and echoing it here would show a value they may be about to\n  // reject — the prop watcher above is what applies the one they accept.\n  if (props.modelValue === undefined) value.value = next;\n  emit(\"update:modelValue\", next);\n  emit(\"submit\", next);\n}\n\n// A read-only preview is not a control, so it is not rendered as one: a\n// `<button>` that refuses to act is worse than plain text. It keeps a\n// `tabindex` of its own instead — a read-only value is one a reader may reach\n// and copy, the same contract TextField's read-only input keeps — while the\n// button state drops Reka's hardcoded `tabindex=\"0\"` entirely, because a\n// `<button>` is focusable without it and a *disabled* one carrying it is\n// focusable when it should not be.\nconst previewAs = computed(() => (field.readonly ? \"span\" : \"button\"));\n\nconst rootProps = computed(() => optional({ name: field.name, maxLength: props.maxLength }));\n\n// `name` is dropped from the bag before it reaches the editor. Reka already\n// renders a hidden input under that name for any Editable inside a `<form>`,\n// and an editor carrying it as well would post the field twice — once with the\n// committed value and once with whatever the box held. Removed from a copy\n// rather than listed positively, so a key added to the resolved bag later\n// reaches this input without anyone remembering to come back here.\nconst editorAttrs = computed(() => {\n  const aria: Record<string, unknown> = { ...field.attrs };\n  delete aria.name;\n  return aria;\n});\n\n// `aria-label` outranks a `<label for>` in the accessible-name order, so a\n// generic fallback would silently replace the name a Field row already gives\n// the editor. It is supplied only where nothing else names it at all — which\n// is also the state Reka would otherwise fill with \"editable input\".\nconst editorLabel = computed<string | undefined>(() => {\n  if (props.ariaLabel !== undefined) return props.ariaLabel;\n  if (field.id !== undefined) return undefined;\n  if (attrs[\"aria-label\"] !== undefined || attrs[\"aria-labelledby\"] !== undefined) return undefined;\n  return text.value.input;\n});\n\nconst areaClass = computed(() =>\n  cn(\n    // One box, two children. The border is present in both states and only\n    // changes colour, the padding never changes, and the floor height keeps an\n    // empty value from collapsing the row it sits in — between them, nothing\n    // below this control moves when it switches.\n    \"flex min-h-9 min-w-0 items-center rounded-md border border-transparent px-2 py-1\",\n    // A control that sizes to its own text cannot also fill its parent: under\n    // `autoResize` Reka makes this box an `inline-grid` measured by the two\n    // states stacked inside it, and a width of 100% would measure the row\n    // instead.\n    props.autoResize ? \"w-auto\" : \"w-full\",\n    \"text-inherit transition-[color,background-color,border-color,box-shadow] duration-fast ease-out\",\n    // Rim-lit at rest, the weave blooms on focus (Signature law), and it blooms\n    // for the preview as much as for the editor: at rest the preview is the\n    // focusable node, and a control a reader can tab to has to show it.\n    \"focus-within:outline-2 focus-within:outline-offset-2 focus-within:outline-ring\",\n    !field.invalid && \"focus-within:shadow-halo\",\n    editing.value && \"border-input bg-background\",\n    // The affordance for a pointer, since the resting state is deliberately\n    // just text: the box lights under the cursor and the caret says the text\n    // can be typed into. Never the only signal — the preview announces itself,\n    // and carries a glyph.\n    !editing.value && !field.disabled && !field.readonly && \"cursor-text hover:bg-subtle\",\n    // Lifted rather than dimmed, exactly as a read-only text field is: the\n    // value is the whole reason the control is on the page, so it stays at\n    // full contrast — 13.45:1 over this fill — whether or not it can be\n    // changed. The rim comes up with it, from the resting `transparent` to\n    // `input`: at rest this control is deliberately just text, so without a\n    // border there is nothing but hue to say the value is on show, and the box\n    // was already reserving the width for one.\n    field.readonly && \"border-input bg-subtle\",\n    // Drained, not faded, and a step further down all three channels: the fill\n    // to `muted`, the text to `muted-foreground` (4.67:1 over it) and the rim\n    // to the lighter `border`. Half-opacity text on this box measures under\n    // 4.5:1, and a value nobody can read is worse than one nobody can edit.\n    //\n    // Read-only and disabled used to share `bg-muted` and part on the text\n    // colour alone — a distinction made in hue and nothing else, which is the\n    // one a reader with a colour deficiency does not receive.\n    field.disabled && \"cursor-not-allowed border-border bg-muted text-muted-foreground\",\n    // The same appearance, reached from the other direction: a\n    // `<fieldset disabled>` above this control disables the preview `<button>`\n    // and the `<input>` behind it natively — both are on the list a fieldset\n    // reaches — and never touches `field.disabled`, so the rule above cannot\n    // fire and the value rendered byte-identical to an editable one.\n    //\n    // `in-[fieldset:disabled]:` reads the attribute that did the disabling, so\n    // the fill and the native inertness cannot disagree. See TextField.vue for\n    // why it is preferred to a `has-[:disabled]:` rule reading this box's own\n    // contents.\n    \"in-[fieldset:disabled]:cursor-not-allowed in-[fieldset:disabled]:bg-muted in-[fieldset:disabled]:text-muted-foreground\",\n    // Gated for the reason the rule below is ordered: Tailwind emits the\n    // ancestor half of `in-*` inside `:where()`, so this carries no more\n    // specificity than `border-destructive` and would win on emission order\n    // alone.\n    !field.invalid && \"in-[fieldset:disabled]:border-border\",\n    // Last of the rules naming a border colour: `cn()` resolves one by\n    // whichever class it saw last, so a control both in error and unavailable\n    // would lose its destructive rim if this sat above them.\n    field.invalid && \"border-destructive focus-within:outline-destructive\",\n  ),\n);\n\nconst triggerClass = cn(\n  buttonVariants({ variant: \"ghost\", size: \"icon-sm\" }),\n  \"disabled:cursor-not-allowed disabled:opacity-50\",\n);\n</script>\n\n<template>\n  <EditableRoot\n    ref=\"rootRef\"\n    v-slot=\"{ edit }\"\n    v-bind=\"rootProps\"\n    :model-value=\"value\"\n    :placeholder=\"placeholder ?? ''\"\n    activation-mode=\"none\"\n    :disabled=\"field.disabled\"\n    :readonly=\"field.readonly\"\n    :required=\"field.required\"\n    :submit-mode=\"submitMode\"\n    :auto-resize=\"autoResize\"\n    :data-editing=\"editing || undefined\"\n    :data-invalid=\"field.invalid || undefined\"\n    :data-readonly=\"field.readonly || undefined\"\n    :data-disabled=\"field.disabled || undefined\"\n    :class=\"\n      cn(\n        'inline-flex items-center gap-1',\n        autoResize ? 'w-auto align-baseline' : 'w-full',\n        attrs.class as string,\n      )\n    \"\n    @update:state=\"onState\"\n    @submit=\"onSubmit\"\n  >\n    <EditableArea :class=\"areaClass\">\n      <!-- The preview is the control, and Reka's `EditableEditTrigger` is\n           deliberately not rendered beside it: a second button doing the same\n           job costs a second Tab stop on one value, and its click handler\n           fires in every activation mode, which would make `dblclick` and\n           `focus` lies. A real `<button>` rather than a `role`, so Enter and\n           Space are the browser's job and the affordance survives\n           forced-colors mode. -->\n      <EditablePreview\n        ref=\"previewRef\"\n        :as=\"previewAs\"\n        :type=\"field.readonly ? undefined : 'button'\"\n        :tabindex=\"field.readonly ? 0 : undefined\"\n        :disabled=\"!field.readonly && field.disabled ? true : undefined\"\n        :aria-describedby=\"field.attrs['aria-describedby']\"\n        :aria-invalid=\"field.attrs['aria-invalid']\"\n        class=\"flex min-w-0 flex-1 items-center gap-1.5 text-start outline-none\"\n        @click=\"(event: MouseEvent) => onPreviewClick(event, edit)\"\n        @dblclick=\"() => onPreviewDoubleClick(edit)\"\n        @focus=\"() => onPreviewFocus(edit)\"\n        @blur=\"onPreviewBlur\"\n      >\n        <!-- Single-line and truncated, because the editor it swaps with is a\n             single-line input: a preview that wrapped would be a taller box\n             than the thing replacing it. -->\n        <span :class=\"cn('truncate', !value && 'text-muted-foreground')\">\n          {{ value || placeholder }}\n        </span>\n        <template v-if=\"!field.readonly\">\n          <!-- The affordance for a sighted reader, and the counterpart to the\n               span below it: the resting state is text, so something has to\n               say it is more than text. Hidden from assistive tech, which is\n               told the same thing in words. -->\n          <Pencil class=\"h-3.5 w-3.5 shrink-0 text-muted-foreground\" aria-hidden=\"true\" />\n          <!-- The whole accessibility problem of edit-in-place, in one span.\n               The value reads first so it stays the start of the accessible\n               name (WCAG 2.5.3, and what a voice-control reader says out\n               loud); the verb follows, so the text announces as something\n               that can be acted on rather than as prose. -->\n          <span class=\"sr-only\">{{ text.edit }}</span>\n        </template>\n      </EditablePreview>\n\n      <EditableInput\n        v-bind=\"{ ...inputAttrs, ...editorAttrs }\"\n        :aria-label=\"editorLabel\"\n        class=\"min-w-0 flex-1 bg-transparent text-inherit outline-none placeholder:text-muted-foreground\"\n      />\n    </EditableArea>\n\n    <!-- Both triggers hide themselves while the preview is showing, so there\n         is nothing to guard here. They exist for the reader who has no way to\n         know that Enter commits and Escape abandons — an invisible keyboard\n         contract is not an affordance. -->\n    <EditableSubmitTrigger :aria-label=\"text.submit\" :class=\"triggerClass\">\n      <Check class=\"h-4 w-4\" aria-hidden=\"true\" />\n    </EditableSubmitTrigger>\n    <EditableCancelTrigger :aria-label=\"text.cancel\" :class=\"triggerClass\">\n      <X class=\"h-4 w-4\" aria-hidden=\"true\" />\n    </EditableCancelTrigger>\n\n    <!-- A refused empty submit changes the screen without moving focus or\n         opening anything, which a screen reader would otherwise never\n         announce. Empty until there is something to say, so it never repeats\n         itself on an unrelated re-render. -->\n    <span role=\"status\" class=\"sr-only\">{{ restored }}</span>\n  </EditableRoot>\n</template>\n"],"mappings":"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"}

package/dist/primitives/Field/Field.js

@@ -1,7 +0,0 @@
-import Field_vue_vue_type_script_setup_true_lang_default from "./Field.vue_vue_type_script_setup_true_lang.js";
-//#region src/primitives/Field/Field.vue
-var Field_default = Field_vue_vue_type_script_setup_true_lang_default;
-//#endregion
-export { Field_default as default };
-
-//# sourceMappingURL=Field.js.map

package/dist/primitives/Field/Field.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Field.js","names":[],"sources":["../../../src/primitives/Field/Field.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/* eslint vuejs-accessibility/label-has-for: [\"error\", { \"required\": \"id\" }] */\n/*\n * The workspace default for this rule requires BOTH a `for`/id pairing AND\n * the control physically nested inside the `<label>` (`required: {every:\n * [\"nesting\",\"id\"]}`). Field labels a control passed through the default\n * slot — never nested inside the `<label>` — so \"nesting\" can never be\n * satisfied by any slot-based composition, regardless of how the label is\n * written. The `for`/id pairing below is itself a fully valid, standard\n * accessible-name association (WCAG 1.3.1 / 4.1.2); this override scopes the\n * rule to that single valid strategy for this file only.\n */\nimport { computed, useId, useSlots } from \"vue\";\nimport InlineError from \"../InlineError/InlineError.vue\";\nimport { provideFieldContext, useOuterFieldContext } from \"../../lib/field-context\";\n\n/**\n * Field — the form-row wrapper: label + control + one hint-or-error line, so\n * a consumer stops hand-assembling that layout at every call site. Pure\n * composition, not a Reka component — the default slot is the control\n * (TextField, Textarea, a select, …). Setting `error` swaps InlineError in\n * for `hint`, because a row shows one message at a time, never both stacked.\n *\n * **A Loom control in the slot wires itself.** Field publishes the row's id,\n * the id of whichever message is showing, and `required` / `invalid` /\n * `disabled` / `readonly` / `name`; every Loom form control picks those up\n * through `useFieldControl()`. So the three attributes this component used to\n * ask a caller to copy by hand — `id`, `aria-describedby`, `invalid` — are now\n * the default, and forgetting one is no longer a silent defect:\n *\n * ```vue\n * <Field label=\"Email\" error=\"Invalid address\" required>\n *   <TextField />\n * </Field>\n * ```\n *\n * A prop set on the control always wins, in both directions: `undefined` is\n * the only value that yields, `false` is a decision. One control inside a row\n * that is showing an error can still declare itself individually fine.\n *\n * **`for` is not a legacy path.** `provide`/`inject` only reaches a component\n * that injects, so a bare `<input>`, a product's own control or a third-party\n * widget in the slot cannot be wired this way — and that is the case `for` has\n * always answered. Pass it and the label points at your id, the message line\n * publishes `${for}-description` for your own `aria-describedby`, and a Loom\n * control adopts that id rather than a generated one, so an existing call site\n * keeps every id it published.\n */\nconst props = withDefaults(\n  defineProps<{\n    /** The visible label text. Renders as a real `<label>` once there is a control for it to name. */\n    label?: string;\n    /** Supporting text shown below the control. Hidden while `error` is set. */\n    hint?: string;\n    /** The error message. Renders through InlineError, replaces `hint`, and marks a Loom control inside invalid. */\n    error?: string;\n    /** Marks the row mandatory: a destructive asterisk on the label, and `aria-required` on a Loom control inside. */\n    required?: boolean;\n    /** Disables a Loom control inside. Leave unset to let the control decide for itself. */\n    disabled?: boolean | undefined;\n    /** Renders a Loom control inside read-only: still focusable, still submitted, not editable. */\n    readonly?: boolean | undefined;\n    /** The name a Loom control inside submits under, for a native form post or `FormData`. */\n    name?: string;\n    /** The id of the control in the default slot. Omit it and Field generates one for a Loom control. */\n    for?: string;\n  }>(),\n  {\n    // `disabled` and `readonly` carry an explicit `undefined` because absent\n    // has to stay tellable from `false` all the way down: a Field saying\n    // nothing must not overrule a control that disabled itself, and Vue casts\n    // an absent Boolean prop with no declared default to `false`. `required`\n    // stays a plain boolean — Field is the only thing that claims a row is\n    // mandatory, so there is no lower opinion for a `false` to beat.\n    required: false,\n    disabled: undefined,\n    readonly: undefined,\n  },\n);\n\n// Called unconditionally, even when `for` makes it unused: `useId()` draws\n// from a per-app counter walked in setup order, and a conditional call makes\n// that sequence depend on props — every id after it shifts, and the server's\n// walk stops matching the client's.\nconst generatedId = useId();\n\n// Whether the call site wrote children at all is a fact about the template,\n// not about state, so it is read once rather than computed — `slots` is not a\n// reactive source and a `computed` over it would cache and go stale. It also\n// has to be answerable during *this* component's render: the server renders a\n// component's own output before any of its slot children, so anything Field\n// learned from the mounted controls would arrive after the label and the hint\n// were already written on the server and before them on the client, which is a\n// hydration mismatch by construction.\nconst hasControl = useSlots().default !== undefined;\n\n// The row's control id is what you passed, or a generated one when there is a\n// control in the slot to give it to. Nothing in the slot means nothing to name\n// and nothing to describe — a `<label for>` pointing at no control names\n// nobody, and an id nothing references is a landmark for no one.\nconst controlId = computed(() => props.for ?? (hasControl ? generatedId : undefined));\n\n// The label's own id, for group controls that name themselves with\n// `aria-labelledby` rather than by `label for`. Follows the same `-label`\n// convention as the description line's `-description`, and it exists for the\n// same reason: a group element inside the slot cannot be pointed at by `<label\n// for>` (that element is not a labelable element), so it needs a second way to\n// learn the label's id.\nconst labelId = computed(() => (controlId.value ? `${controlId.value}-label` : undefined));\n\n// The hint and the error are mutually exclusive, so one id covers whichever is\n// showing.\nconst descriptionId = computed(() =>\n  controlId.value ? `${controlId.value}-description` : undefined,\n);\n\n// A Fieldset above answers exactly one key this Field also answers, and its\n// `readonly` is a claim about the whole group that a row does not get to\n// forget. Everything else a Fieldset knows either stops there deliberately\n// (`required`, `invalid`, the group's own description) or travels natively\n// (`disabled`, through the real `<fieldset>`) — see Fieldset.vue. Merging it\n// here rather than inside the context keeps the one overlapping key visible.\nconst group = useOuterFieldContext();\n\nprovideFieldContext({\n  controlId: () => controlId.value,\n  // Group controls name themselves with `aria-labelledby`, not `label for`, so\n  // they need the label's own id. Only when the label is actually rendered: an\n  // IDREF that resolves to nothing is worse than no attribute at all.\n  labelledBy: () => (props.label ? labelId.value : undefined),\n  // Only while a message is actually rendered. An IDREF resolving to nothing\n  // is a worse answer than no attribute — the same reasoning Fieldset already\n  // carries for its own `aria-describedby`.\n  describedBy: () => ((props.error ?? props.hint) ? descriptionId.value : undefined),\n  name: () => props.name,\n  required: () => props.required || undefined,\n  // The row's message and the control's `aria-invalid` are two halves of one\n  // state; two independent switches for it is how they come to disagree.\n  invalid: () => (props.error ? true : undefined),\n  disabled: () => props.disabled,\n  readonly: () => props.readonly ?? group?.readonly.value,\n});\n</script>\n\n<template>\n  <div class=\"flex flex-col gap-1.5\">\n    <label\n      v-if=\"label && controlId\"\n      :id=\"labelId\"\n      :for=\"controlId\"\n      class=\"text-sm font-medium text-foreground\"\n    >\n      {{ label }} <span v-if=\"required\" class=\"text-destructive\">*</span>\n    </label>\n    <span v-else-if=\"label\" class=\"text-sm font-medium text-foreground\">\n      {{ label }} <span v-if=\"required\" class=\"text-destructive\">*</span>\n    </span>\n    <slot />\n    <p v-if=\"hint && !error\" :id=\"descriptionId\" class=\"text-xs text-muted-foreground\">\n      {{ hint }}\n    </p>\n    <InlineError v-if=\"error\" :id=\"descriptionId\" :message=\"error\" />\n  </div>\n</template>\n"],"mappings":""}

package/dist/primitives/Field/Field.vue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Field.vue.d.ts","sourceRoot":"","sources":["../../../src/primitives/Field/Field.vue"],"names":[],"mappings":"AAsLA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,KAAK,WAAW,GAAG;IACf,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gHAAgH;IAChH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA2KJ,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;cAzLD,OAAO,GAAG,SAAS;cAEnB,OAAO,GAAG,SAAS;cAJnB,OAAO;6EA8LpB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}