@jolly-pixel/ui 1.0.1

package/dist/feedback/Progress.js

@@ -0,0 +1,120 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+// Import Third-party Dependencies
+import { LitElement, html, nothing } from "lit";
+import { classMap } from "lit/directives/class-map.js";
+import { customElement, property } from "lit/decorators.js";
+// Import Internal Dependencies
+import { progressStyles } from "./Progress.styles.js";
+import { normalizeProgress } from "./normalizeProgress.js";
+// CONSTANTS
+const kVelocityThreshold = 0.1;
+/**
+ * Displays determinate or indeterminate progress for a long-running operation.
+ * Omit value for the indeterminate state.
+ */
+let Progress = class Progress extends LitElement {
+    static styles = progressStyles;
+    #lastProgressUpdate = 0;
+    #normalized;
+    #speeding = false;
+    constructor() {
+        super();
+        this.value = null;
+        this.max = 1;
+        this.label = "";
+        this.valueText = "";
+        this.animated = false;
+        this.completed = false;
+        this.#normalized = normalizeProgress(this.value, this.max);
+    }
+    willUpdate(changedProperties) {
+        if (changedProperties.has("value") ||
+            changedProperties.has("max")) {
+            this.#updateVelocity(changedProperties);
+            this.#normalized = normalizeProgress(this.value, this.max);
+        }
+    }
+    render() {
+        const ratio = this.#normalized.ratio;
+        const trackClasses = classMap({
+            track: true,
+            indeterminate: ratio === null
+        });
+        const indicatorClasses = classMap({
+            indicator: true,
+            speeding: this.#speeding
+        });
+        return html `
+      <div
+        class=${trackClasses}
+        part="track"
+        role="progressbar"
+        aria-label=${this.label === "" ? nothing : this.label}
+        aria-valuemin="0"
+        aria-valuemax=${this.#normalized.max}
+        aria-valuenow=${this.#normalized.value ?? nothing}
+        aria-valuetext=${this.valueText === "" ? nothing : this.valueText}
+      >
+        <div
+          class=${indicatorClasses}
+          part="indicator"
+          style=${ratio === null
+            ? nothing
+            : `--jolly-progress-ratio:${ratio}`}
+        ></div>
+      </div>
+    `;
+    }
+    #updateVelocity(changedProperties) {
+        const previousValue = changedProperties.get("value");
+        const now = performance.now();
+        const elapsed = now - this.#lastProgressUpdate;
+        this.#lastProgressUpdate = now;
+        if (previousValue === undefined ||
+            previousValue === null ||
+            this.value === null ||
+            elapsed <= 0) {
+            this.#speeding = false;
+            return;
+        }
+        this.#speeding = ((this.value - previousValue) / elapsed) > kVelocityThreshold;
+    }
+};
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Object)
+], Progress.prototype, "value", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Number)
+], Progress.prototype, "max", void 0);
+__decorate([
+    property({ type: String }),
+    __metadata("design:type", String)
+], Progress.prototype, "label", void 0);
+__decorate([
+    property({ type: String, attribute: "value-text" }),
+    __metadata("design:type", String)
+], Progress.prototype, "valueText", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true }),
+    __metadata("design:type", Boolean)
+], Progress.prototype, "animated", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true }),
+    __metadata("design:type", Boolean)
+], Progress.prototype, "completed", void 0);
+Progress = __decorate([
+    customElement("jolly-progress"),
+    __metadata("design:paramtypes", [])
+], Progress);
+export { Progress };
+//# sourceMappingURL=Progress.js.map

package/dist/feedback/Progress.js.map

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

package/dist/feedback/Progress.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const progressStyles: import("lit").CSSResult;
+//# sourceMappingURL=Progress.styles.d.ts.map

package/dist/feedback/Progress.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.styles.d.ts","sourceRoot":"","sources":["../../src/feedback/Progress.styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,yBAkJ1B,CAAC"}

package/dist/feedback/Progress.styles.js

@@ -0,0 +1,150 @@
+// Import Third-party Dependencies
+import { css } from "lit";
+export const progressStyles = css `
+  :host {
+    --jolly-progress-height: 4px;
+    --jolly-progress-track: var(--jolly-groove, rgb(0 0 0 / 0.2));
+    --jolly-progress-fill: var(--jolly-accent-fill, #4488ff);
+    --jolly-progress-duration: var(--jolly-duration-base, 160ms);
+    --jolly-progress-easing: var(--jolly-easing, ease);
+    --jolly-progress-track-shadow: none;
+    --jolly-progress-shadow: none;
+    --jolly-progress-shadow-active: var(--jolly-progress-shadow);
+
+    display: block;
+    width: 100%;
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+
+  .track {
+    position: relative;
+    height: var(--jolly-progress-height);
+    overflow: hidden;
+    border-radius: calc(var(--jolly-progress-height) / 2);
+    background: var(--jolly-progress-track);
+    box-shadow: var(--jolly-progress-track-shadow);
+  }
+
+  .indicator {
+    position: absolute;
+    inset: 0;
+    background: var(--jolly-progress-fill);
+    box-shadow: var(--jolly-progress-shadow);
+    transform: scaleX(var(--jolly-progress-ratio, 0));
+    transform-origin: left center;
+    transition:
+      transform var(--jolly-progress-duration)
+      var(--jolly-progress-easing);
+    will-change: transform;
+  }
+
+  :host([animated]:not([completed])) .indicator {
+    animation: progress-pulse 1.5s ease-in-out infinite;
+  }
+
+  :host([animated]:not([completed])) .indicator::before {
+    content: "";
+    position: absolute;
+    inset: 0;
+    background: linear-gradient(
+      90deg,
+      transparent 0%,
+      rgb(255 255 255 / 0.15) 30%,
+      rgb(255 255 255 / 0.4) 50%,
+      rgb(255 255 255 / 0.15) 70%,
+      transparent 100%
+    );
+    animation: progress-shimmer 2s cubic-bezier(0.4, 0, 0.2, 1) infinite;
+  }
+
+  :host([animated]:not([completed])) .indicator::after {
+    content: "";
+    position: absolute;
+    inset: 0;
+    background: linear-gradient(
+      180deg,
+      rgb(255 255 255 / 0.2) 0%,
+      transparent 50%,
+      rgb(0 0 0 / 0.1) 100%
+    );
+  }
+
+  :host([animated]:not([completed])) .indicator.speeding {
+    animation: progress-speed 300ms ease;
+  }
+
+  .track.indeterminate .indicator {
+    width: 45%;
+    animation: progress-indeterminate 1.2s ease-in-out infinite;
+    transform: translateX(-120%);
+  }
+
+  @keyframes progress-pulse {
+    0%, 100% {
+      box-shadow: var(--jolly-progress-shadow);
+    }
+    50% {
+      box-shadow: var(--jolly-progress-shadow-active);
+    }
+  }
+
+  @keyframes progress-shimmer {
+    from {
+      transform: translateX(-100%);
+    }
+    to {
+      transform: translateX(100%);
+    }
+  }
+
+  @keyframes progress-speed {
+    0%, 100% {
+      filter: blur(0);
+    }
+    50% {
+      filter: blur(1px);
+    }
+  }
+
+  @keyframes progress-indeterminate {
+    0% {
+      transform: translateX(-120%);
+    }
+    50% {
+      transform: translateX(120%);
+    }
+    100% {
+      transform: translateX(280%);
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .indicator,
+    .indicator::before {
+      animation: none !important;
+      transition-duration: 0ms;
+    }
+
+    .track.indeterminate .indicator {
+      width: 100%;
+      opacity: 0.55;
+      transform: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    .track {
+      border: 1px solid CanvasText;
+      background: Canvas;
+    }
+
+    .indicator {
+      background: Highlight;
+      forced-color-adjust: none;
+    }
+  }
+`;
+//# sourceMappingURL=Progress.styles.js.map

package/dist/feedback/Progress.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.styles.js","sourceRoot":"","sources":["../../src/feedback/Progress.styles.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJhC,CAAC"}

package/dist/feedback/index.d.ts

@@ -0,0 +1,6 @@
+export { Loading } from "./Loading.ts";
+export { LogElement, type LogLiveness } from "./Log.ts";
+export { LogQueue } from "./LogQueue.ts";
+export type { LogContent, LogEntry, LogListener, LogQueueOptions, LogScheduler } from "./LogQueue.types.ts";
+export { Progress } from "./Progress.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACT,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,QAAQ,EACT,MAAM,eAAe,CAAC"}

package/dist/feedback/index.js

@@ -0,0 +1,5 @@
+export { Loading } from "./Loading.js";
+export { LogElement } from "./Log.js";
+export { LogQueue } from "./LogQueue.js";
+export { Progress } from "./Progress.js";
+//# sourceMappingURL=index.js.map

package/dist/feedback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feedback/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,UAAU,EAEX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACT,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,QAAQ,EACT,MAAM,eAAe,CAAC"}

package/dist/feedback/normalizeProgress.d.ts

@@ -0,0 +1,11 @@
+export interface NormalizedProgress {
+    readonly max: number;
+    readonly value: number | null;
+    readonly ratio: number | null;
+}
+/**
+ * Normalizes progress for rendering without changing the caller's raw values.
+ * A missing value is indeterminate. Invalid numeric values render from zero.
+ */
+export declare function normalizeProgress(value: number | null, max: number): NormalizedProgress;
+//# sourceMappingURL=normalizeProgress.d.ts.map

package/dist/feedback/normalizeProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeProgress.d.ts","sourceRoot":"","sources":["../../src/feedback/normalizeProgress.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,EAAE,MAAM,GACV,kBAAkB,CAuBpB"}

package/dist/feedback/normalizeProgress.js

@@ -0,0 +1,24 @@
+/**
+ * Normalizes progress for rendering without changing the caller's raw values.
+ * A missing value is indeterminate. Invalid numeric values render from zero.
+ */
+export function normalizeProgress(value, max) {
+    const normalizedMax = Number.isFinite(max) && max > 0
+        ? max
+        : 1;
+    if (value === null) {
+        return {
+            max: normalizedMax,
+            value: null,
+            ratio: null
+        };
+    }
+    const finiteValue = Number.isFinite(value) ? value : 0;
+    const normalizedValue = Math.min(normalizedMax, Math.max(0, finiteValue));
+    return {
+        max: normalizedMax,
+        value: normalizedValue,
+        ratio: normalizedValue / normalizedMax
+    };
+}
+//# sourceMappingURL=normalizeProgress.js.map

package/dist/feedback/normalizeProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeProgress.js","sourceRoot":"","sources":["../../src/feedback/normalizeProgress.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,GAAW;IAEX,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QACnD,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,CAAC,CAAC;IACN,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,aAAa,EACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CACzB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,eAAe,GAAG,aAAa;KACvC,CAAC;AACJ,CAAC"}

package/dist/field/DraftController.d.ts

@@ -0,0 +1,24 @@
+import type { ReactiveControllerHost } from "lit";
+export type DraftResult<TValue> = {
+    ok: true;
+    value: TValue;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Manages the common input, keyboard, blur, and parse lifecycle of a draft.
+ */
+export declare class DraftController<TValue> {
+    #private;
+    constructor(host: ReactiveControllerHost);
+    get draft(): string | null;
+    get error(): string | null;
+    setDraft(text: string | null): void;
+    setError(message: string | null): void;
+    clear(): void;
+    onInput(event: Event): void;
+    onKeyDown(event: KeyboardEvent, commit: () => void): void;
+    commit(parse: (text: string) => DraftResult<TValue> | null, editable: boolean, onCommit: (value: TValue) => void): void;
+}
+//# sourceMappingURL=DraftController.d.ts.map

package/dist/field/DraftController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DraftController.d.ts","sourceRoot":"","sources":["../../src/field/DraftController.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAKlD,MAAM,MAAM,WAAW,CAAC,MAAM,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE,CAAC;AAElC;;GAEG;AACH,qBAAa,eAAe,CAAC,MAAM;;gBAM/B,IAAI,EAAE,sBAAsB;IAK9B,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,QAAQ,CACN,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,IAAI;IASP,QAAQ,CACN,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,IAAI;IASP,KAAK,IAAI,IAAI;IAKb,OAAO,CACL,KAAK,EAAE,KAAK,GACX,IAAI;IASP,SAAS,CACP,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,IAAI,GACjB,IAAI;IAWP,MAAM,CACJ,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,EACnD,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,IAAI;CAqBR"}

package/dist/field/DraftController.js

@@ -0,0 +1,72 @@
+// Import Internal Dependencies
+import { isInputElement } from "../dom.js";
+/**
+ * Manages the common input, keyboard, blur, and parse lifecycle of a draft.
+ */
+export class DraftController {
+    #host;
+    #draft = null;
+    #error = null;
+    constructor(host) {
+        this.#host = host;
+    }
+    get draft() {
+        return this.#draft;
+    }
+    get error() {
+        return this.#error;
+    }
+    setDraft(text) {
+        if (this.#draft === text) {
+            return;
+        }
+        this.#draft = text;
+        this.#host.requestUpdate();
+    }
+    setError(message) {
+        if (this.#error === message) {
+            return;
+        }
+        this.#error = message;
+        this.#host.requestUpdate();
+    }
+    clear() {
+        this.setDraft(null);
+        this.setError(null);
+    }
+    onInput(event) {
+        if (!isInputElement(event.target)) {
+            return;
+        }
+        this.setDraft(event.target.value);
+        this.setError(null);
+    }
+    onKeyDown(event, commit) {
+        if (event.key === "Enter") {
+            commit();
+        }
+        else if (event.key === "Escape") {
+            // Keep parent popovers open while discarding a draft.
+            event.stopPropagation();
+            this.clear();
+        }
+    }
+    commit(parse, editable, onCommit) {
+        const draft = this.#draft;
+        if (draft === null || !editable) {
+            return;
+        }
+        const result = parse(draft);
+        if (result === null) {
+            this.clear();
+            return;
+        }
+        if (!result.ok) {
+            this.setError(result.error);
+            return;
+        }
+        this.clear();
+        onCommit(result.value);
+    }
+}
+//# sourceMappingURL=DraftController.js.map

package/dist/field/DraftController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DraftController.js","sourceRoot":"","sources":["../../src/field/DraftController.ts"],"names":[],"mappings":"AAGA,+BAA+B;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAM3C;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAyB;IAC9B,MAAM,GAAkB,IAAI,CAAC;IAC7B,MAAM,GAAkB,IAAI,CAAC;IAE7B,YACE,IAA4B;QAE5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ,CACN,IAAmB;QAEnB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,QAAQ,CACN,OAAsB;QAEtB,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,CACL,KAAY;QAEZ,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,SAAS,CACP,KAAoB,EACpB,MAAkB;QAElB,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,EAAE,CAAC;QACX,CAAC;aACI,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAChC,sDAAsD;YACtD,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM,CACJ,KAAmD,EACnD,QAAiB,EACjB,QAAiC;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,EAAE,CAAC;YAEb,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/field/JollyField.d.ts

@@ -0,0 +1,101 @@
+import { LitElement, nothing, type PropertyValues, type TemplateResult } from "lit";
+import { type DraftResult } from "./DraftController.ts";
+import { type FieldValue } from "./mixed.ts";
+import type { CollaboratorPresence } from "../peer/types.ts";
+import "../icon/Icon.ts";
+/**
+ * Which edge a field's value sits against. Logical, so it follows writing
+ * direction rather than naming a physical side.
+ */
+export type FieldAlign = "start" | "end";
+/**
+ * `"top"` puts the label on its own line above the value, trading label/value
+ * column alignment for more breathing room between rows.
+ */
+export type FieldLabelPosition = "inline" | "top";
+export type { DraftResult } from "./DraftController.ts";
+/**
+ * Shared field chrome. Subclasses render only the value area.
+ */
+export declare abstract class JollyField<TValue> extends LitElement {
+    #private;
+    static styles: import("lit").CSSResult[];
+    label: string;
+    description: string;
+    value: FieldValue<TValue>;
+    default: TValue | undefined;
+    lockedBy: CollaboratorPresence | null;
+    peers: CollaboratorPresence[];
+    /**
+     * Stable lock identity shared by clients; null disables field locking.
+     */
+    path: string | null;
+    error: string | null;
+    disabled: boolean;
+    readonly: boolean;
+    /** Uses the theme accent for supported controls and the modified indicator. */
+    colored: boolean;
+    /**
+     * Numeric and monitor-style rows often read better against the trailing edge,
+     * where the digits line up down the pane.
+     */
+    align: FieldAlign;
+    labelPosition: FieldLabelPosition;
+    constructor();
+    /**
+     * Renders the control's value area.
+     */
+    protected abstract renderValue(): TemplateResult;
+    /**
+     * Numeric controls opt in to label scrubbing.
+     */
+    protected get scrubbable(): boolean;
+    /**
+     * Compares values for the revert state.
+     */
+    protected valuesEqual(a: TValue, b: TValue): boolean;
+    protected get modified(): boolean;
+    protected get editable(): boolean;
+    protected get mixed(): boolean;
+    /**
+     * `undefined` for a mixed value.
+     */
+    protected get concreteValue(): TValue | undefined;
+    protected get draft(): string | null;
+    /**
+     * Keeps a focused draft ahead of incoming values.
+     */
+    protected setDraft(text: string | null): void;
+    protected setParseError(message: string | null): void;
+    /**
+     * Clears the draft and parse error.
+     */
+    protected clearDraft(): void;
+    /** Updates a text input draft and clears an earlier local parse error. */
+    protected onDraftInput(event: Event): void;
+    /** Handles the standard Enter and Escape draft lifecycle. */
+    protected onDraftKeyDown(event: KeyboardEvent, commit: () => void): void;
+    /** Commits a draft through a control-specific parser. */
+    protected commitDraft(parse: (text: string) => DraftResult<TValue> | null): void;
+    protected emitInput(value: TValue): void;
+    /**
+     * Emits a committed value after clearing the draft.
+     */
+    protected emitChange(value: TValue): void;
+    protected get inputReadonly(): boolean;
+    /**
+     * Avoids the ARIAMixin `ariaReadOnly` member.
+     */
+    protected get readonlyAria(): "true" | typeof nothing;
+    protected get lockedAria(): "true" | typeof nothing;
+    protected get lockDescription(): string | typeof nothing;
+    /**
+     * Current lock holder.
+     */
+    protected get holder(): CollaboratorPresence | null;
+    connectedCallback(): void;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    protected get displayError(): string | null;
+    render(): TemplateResult;
+}
+//# sourceMappingURL=JollyField.d.ts.map

package/dist/field/JollyField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JollyField.d.ts","sourceRoot":"","sources":["../../src/field/JollyField.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EAEV,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,KAAK,CAAC;AAKb,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK7D,OAAO,iBAAiB,CAAC;AAMzB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,8BAAsB,UAAU,CAAC,MAAM,CAAE,SAAQ,UAAU;;IACzD,OAAgB,MAAM,4BAGpB;IAGM,KAAK,EAAE,MAAM,CAAC;IAGd,WAAW,EAAE,MAAM,CAAC;IAGpB,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAG1B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAG5B,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAGtC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAEtC;;OAEG;IAEK,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,QAAQ,EAAE,OAAO,CAAC;IAGlB,QAAQ,EAAE,OAAO,CAAC;IAE1B,+EAA+E;IAEvE,OAAO,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IAEK,KAAK,EAAE,UAAU,CAAC;IAOlB,aAAa,EAAE,kBAAkB,CAAC;;IAsB1C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,cAAc;IAEhD;;OAEG;IACH,SAAS,KAAK,UAAU,IAAI,OAAO,CAElC;IAED;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO;IAIV,SAAS,KAAK,QAAQ,IAAI,OAAO,CAMhC;IAED,SAAS,KAAK,QAAQ,IAAI,OAAO,CAEhC;IAED,SAAS,KAAK,KAAK,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,SAAS,KAAK,aAAa,IAAI,MAAM,GAAG,SAAS,CAIhD;IAED,SAAS,KAAK,KAAK,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED;;OAEG;IACH,SAAS,CAAC,QAAQ,CAChB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,IAAI;IAIP,SAAS,CAAC,aAAa,CACrB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,IAAI;IAIP;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,IAAI;IAI5B,0EAA0E;IAC1E,SAAS,CAAC,YAAY,CACpB,KAAK,EAAE,KAAK,GACX,IAAI;IAIP,6DAA6D;IAC7D,SAAS,CAAC,cAAc,CACtB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,IAAI,GACjB,IAAI;IAIP,yDAAyD;IACzD,SAAS,CAAC,WAAW,CACnB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAClD,IAAI;IAQP,SAAS,CAAC,SAAS,CACjB,KAAK,EAAE,MAAM,GACZ,IAAI;IAQP;;OAEG;IACH,SAAS,CAAC,UAAU,CAClB,KAAK,EAAE,MAAM,GACZ,IAAI;IASP,SAAS,KAAK,aAAa,IAAI,OAAO,CAErC;IAED;;OAEG;IACH,SAAS,KAAK,YAAY,IAAI,MAAM,GAAG,OAAO,OAAO,CAEpD;IAED,SAAS,KAAK,UAAU,IAAI,MAAM,GAAG,OAAO,OAAO,CAElD;IAED,SAAS,KAAK,eAAe,IAAI,MAAM,GAAG,OAAO,OAAO,CAIvD;IAED;;OAEG;IACH,SAAS,KAAK,MAAM,IAAI,oBAAoB,GAAG,IAAI,CAMlD;IAEQ,iBAAiB,IAAI,IAAI;cASf,UAAU,CAC3B,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,IAAI;IA8CP,SAAS,KAAK,YAAY,IAAI,MAAM,GAAG,IAAI,CAE1C;IAEQ,MAAM,IAAI,cAAc;CAwJlC"}