godown 3.0.0-canary.9 → 3.0.0

package/src/components/switch.ts

@@ -1,6 +1,5 @@
-import { godown } from "@godown/element/decorators/godown.js";
-import { styles } from "@godown/element/decorators/styles.js";
-import { css, html } from "lit";
+import { attr, godown, styles } from "@godown/element";
+import { css, html, type TemplateResult } from "lit";
 import { property, query } from "lit/decorators.js";
 
 import { cssGlobalVars, scopePrefix } from "../core/global-style.js";
@@ -15,11 +14,19 @@ const cssScope = scopePrefix(protoName);
  * The switch is rectangular by default,
  * set the round property to rounded switch.
  *
+ * @fires change - Fires when the switch is switched.
  * @category input
  */
 @godown(protoName)
 @styles(
   css`
+    :host,
+    :host([contents]) [part=root] {
+      width: var(${cssScope}-width);
+      height: var(${cssScope}-height);
+      display: inline-block;
+    }
+
     :host {
       ${cssScope}-width: 3em;
       ${cssScope}-height: calc(var(${cssScope}-width) / 2);
@@ -27,36 +34,29 @@ const cssScope = scopePrefix(protoName);
       ${cssScope}-handle-space: .125em;
       ${cssScope}-transition: .2s ease-in-out;
       background: var(${cssGlobalVars.input}-background);
-      width: var(${cssScope}-width);
-      height: var(${cssScope}-height);
-      display: inline-block;
       vertical-align: bottom;
       border-radius: 0;
     }
 
-    [part="root"],
-    span {
+    [part=root],
+    [part=handle] {
       transition: var(${cssScope}-transition);
     }
 
-    [part="root"] {
+    [part=root] {
       border-radius: inherit;
       position: relative;
       height: inherit;
     }
-
-    [part="root"],
-    input {
-      width: 100%;
-    }
-
-    input {
+    
+    [part=input] {
       opacity: 0;
+      width: 100%;
       height: 100%;
       appearance: none;
     }
 
-    span {
+    [part=handle] {
       height: 100%;
       display: inline-flex;
       align-items: center;
@@ -70,9 +70,10 @@ const cssScope = scopePrefix(protoName);
 
     :host([round]) {
       border-radius: calc(var(${cssScope}-height) / 2);
+      background: var(${cssGlobalVars.passive});
     }
 
-    :host([checked]) span {
+    :host([checked]) [part=handle] {
       left: 50%;
     }
 
@@ -84,7 +85,7 @@ const cssScope = scopePrefix(protoName);
       background: var(${cssGlobalVars.passive});
     }
 
-    .round span{
+    .round [part=handle] {
       --size: var(${cssScope}-handle-size);
       border-radius: 100%;
       background: var(--godown--input-control);
@@ -93,10 +94,6 @@ const cssScope = scopePrefix(protoName);
       margin: var(${cssScope}-handle-space);
     }
 
-    .round {
-      background: var(${cssGlobalVars.passive});
-    }
-
     :host([checked]) .round {
       background: var(${cssGlobalVars.active});
     }
@@ -104,7 +101,7 @@ const cssScope = scopePrefix(protoName);
 )
 class Switch extends SuperInput {
   /**
-   * Border style.
+   * Display rounded.
    */
   @property({ type: Boolean, reflect: true })
   round = false;
@@ -136,8 +133,8 @@ class Switch extends SuperInput {
   @query("input")
   protected _input: HTMLInputElement;
 
-  protected render() {
-    return html`<div part="root" class="${this.round ? "round" : "rect"}">
+  protected render(): TemplateResult<1> {
+    return html`<div part="root" ${attr(this.observedRecord)} class="${this.round ? "round" : "rect"}">
       <input
         part="input"
         @change="${this._handleChange}"
@@ -151,12 +148,12 @@ class Switch extends SuperInput {
     </div>`;
   }
 
-  reset() {
+  reset(): void {
     this.checked = this.default === "true";
     this._input.checked = this.checked;
   }
 
-  connectedCallback() {
+  connectedCallback(): void {
     super.connectedCallback();
     if (this.checked) {
       this.default = "true";
@@ -166,9 +163,8 @@ class Switch extends SuperInput {
     }
   }
 
-  protected _handleChange() {
+  protected _handleChange(): void {
     this.checked = this._input.checked;
-    this.dispatchEvent(new CustomEvent("input", { detail: this.checked, bubbles: true, composed: true }));
     this.dispatchEvent(new CustomEvent("change", { detail: this.checked, composed: true }));
   }
 
@@ -178,3 +174,4 @@ class Switch extends SuperInput {
 }
 
 export default Switch;
+export { Switch };

package/src/components/text.ts

@@ -1,8 +1,5 @@
-import { godown } from "@godown/element/decorators/godown.js";
-import { styles } from "@godown/element/decorators/styles.js";
-import { classList } from "@godown/element/directives/class-list.js";
-import { htmlSlot } from "@godown/element/directives/html-slot.js";
-import { css, html } from "lit";
+import { attr, classList, godown, htmlSlot, styles } from "@godown/element";
+import { css, html, type TemplateResult } from "lit";
 import { property } from "lit/decorators.js";
 
 import { cssGlobalVars, GlobalStyle, scopePrefix } from "../core/global-style.js";
@@ -17,7 +14,8 @@ const cssScope = scopePrefix(protoName);
  * @category display
  */
 @godown(protoName)
-@styles(css`
+@styles(
+  css`
     :host {
       ${cssScope}--color: currentColor;
       ${cssScope}--color-hover: currentColor;
@@ -27,7 +25,7 @@ const cssScope = scopePrefix(protoName);
       overflow-wrap: break-word;
     }
 
-    [part="root"] {
+    [part=root] {
       white-space: nowrap;
       width: 100%;
       vertical-align: bottom;
@@ -38,11 +36,11 @@ const cssScope = scopePrefix(protoName);
       color: var(${cssScope}--color);
     }
 
-    [part="root"]:hover {
+    [part=root]:hover {
       color: var(${cssScope}--color-hover, var(${cssScope}--color));
     }
 
-    [part="root"]:active {
+    [part=root]:active {
       color: var(${cssScope}--color-active, var(${cssScope}--color));
     }
 
@@ -56,7 +54,7 @@ const cssScope = scopePrefix(protoName);
       text-decoration: none;
     }
 
-    .clip{
+    [clip] {
       background: var(${cssGlobalVars.clipBackground});
       display: inline-block;
       color: transparent;
@@ -64,7 +62,8 @@ const cssScope = scopePrefix(protoName);
       background-clip: text;
       -webkit-background-clip: text;
     }
-`)
+  `,
+)
 class Text extends GlobalStyle {
   /**
    * Underline behavior.
@@ -76,20 +75,14 @@ class Text extends GlobalStyle {
    * Set background-clip to text.
    */
   @property({ type: Boolean })
-  clip: boolean;
+  clip = false;
 
-  protected render() {
-    return html`<span
-      part="root"
-      class="${
-      classList(this.underline, {
-        clip: this.clip,
-      })
-    }"
-    >
+  protected render(): TemplateResult<1> {
+    return html`<span part="root" ${attr(this.observedRecord)} class="${classList(this.underline)}">
       ${htmlSlot()}
     </span>`;
   }
 }
 
 export default Text;
+export { Text };

package/src/components/time.ts

@@ -1,7 +1,6 @@
-import { godown } from "@godown/element/decorators/godown.js";
-import { styles } from "@godown/element/decorators/styles.js";
+import { attr, godown, styles } from "@godown/element";
 import fmtime from "fmtime";
-import { css, type PropertyValues } from "lit";
+import { css, html, type PropertyValues, type TemplateResult } from "lit";
 import { property } from "lit/decorators.js";
 
 import { GlobalStyle } from "../core/global-style.js";
@@ -11,6 +10,7 @@ const protoName = "time";
 /**
  * {@linkcode Time} renders a formatting time.
  *
+ * @fires time - Fires when the time changes.
  * @category display
  */
 @godown(protoName)
@@ -32,27 +32,27 @@ class Time extends GlobalStyle {
    * Time.
    */
   @property({ type: Object })
-  time = new Date();
+  time: Date = new Date();
 
   /**
    * If there is a value, update every gap or timeout.
    */
   @property({ type: Number })
-  timeout;
+  timeout: any;
 
   /**
    * The number of milliseconds that change with each update.
    */
   @property({ type: Number })
-  gap;
+  gap: any;
 
   protected timeoutId: number;
 
-  protected render(): string {
-    return fmtime(this.format, this.time, this.escape);
+  protected render(): TemplateResult<1> {
+    return html`<span part="root" ${attr(this.observedRecord)}>${fmtime(this.format, this.time, this.escape)}</span>`;
   }
 
-  protected firstUpdated() {
+  protected firstUpdated(): void {
     if (this.timeout) {
       this.timeoutId = this.startTimeout();
     }
@@ -67,15 +67,17 @@ class Time extends GlobalStyle {
     }
   }
 
-  disconnectedCallback() {
+  disconnectedCallback(): void {
     clearInterval(this.timeoutId);
   }
 
-  startTimeout() {
-    return window.setInterval(() => {
+  startTimeout(): number {
+    return setInterval(() => {
+      this.dispatchEvent(new CustomEvent("time", { detail: this.time, composed: true }));
       this.time = new Date(this.time.getTime() + (this.gap || this.timeout));
     }, Math.abs(this.timeout));
   }
 }
 
 export default Time;
+export { Time };

package/src/components/tooltip.ts

@@ -1,7 +1,5 @@
-import { godown } from "@godown/element/decorators/godown.js";
-import { styles } from "@godown/element/decorators/styles.js";
-import { htmlSlot } from "@godown/element/directives/html-slot.js";
-import { css, html } from "lit";
+import { attr, godown, htmlSlot, styles } from "@godown/element";
+import { css, html, type TemplateResult } from "lit";
 import { property } from "lit/decorators.js";
 
 import { scopePrefix } from "../core/global-style.js";
@@ -15,7 +13,7 @@ const cssScope = scopePrefix(protoName);
  *
  * If it has the tip property, ignore the slot tip.
  *
- * @slot tip - Tip element if no `tim` provided.
+ * @slot tip - Tip element if no `tip` provided.
  * @slot - Content.
  * @category feedback
  */
@@ -24,18 +22,21 @@ const cssScope = scopePrefix(protoName);
   css`
     :host {
       ${cssScope}--tip-background: inherit;
-      display: inline-block;
       width: fit-content;
     }
+    
+    :host,
+    [part=root] {
+      display: inline-flex;
+    }
 
-    [part="root"] {
-      display: flex;
+    [part=root] {
       position: relative;
       transition: inherit;
       border-radius: inherit;
     }
 
-    [part="tip"] {
+    [part=tip] {
       width: fit-content;
       height: fit-content;
       position: absolute;
@@ -44,26 +45,32 @@ const cssScope = scopePrefix(protoName);
       user-select: none;
     }
 
-    :host([open]) [part="tip"] {
+    :host([open]) [part=tip] {
       visibility: visible;
     }
 
-    .passive{
+    .passive {
       background: var(${cssScope}--tip-background);
-      padding: 0 .5em;
+    }
+
+    [propagation] [part=tip] {
+      pointer-events: none;
     }
   `,
   css`
-    [direction^="top"] {
+    [direction^=top] [part=tip] {
       bottom: 100%;
     }
-    [direction^="bottom"] {
+
+    [direction^=bottom] [part=tip] {
       top: 100%;
     }
-    [direction$="right"] {
+
+    [direction$=right] [part=tip] {
       left: 100%;
     }
-    [direction$="left"] {
+
+    [direction$=left] [part=tip] {
       right: 100%;
     }
   `,
@@ -91,7 +98,7 @@ class Tooltip extends SuperOpenable {
    * If true, allow penetration of the tip.
    */
   @property({ type: Boolean })
-  propagation: boolean;
+  propagation = false;
 
   /**
    * How can tips be triggered.
@@ -113,27 +120,24 @@ class Tooltip extends SuperOpenable {
     "flex-end": "flex-end",
   };
 
-  protected render() {
+  protected render(): TemplateResult<1> {
     const align = Tooltip.aligns[this.align] || "inherit";
     const isFocusable = this.type === "focus";
-    return html`<div part="root"
+    return html`<div
+      part="root"
+      ${attr(this.observedRecord)}
       tabindex="${isFocusable ? 0 : -1}"
-      @focus="${isFocusable ? () => this.open = true : null}"
-      @blur="${isFocusable ? () => this.open = false : null}"
-      @mouseenter="${isFocusable ? null : () => this.open = true}"
-      @mouseleave="${isFocusable ? null : () => this.open = false}"
-      style="justify-content:${align};align-items:${align}">
+      @focus="${isFocusable ? () => (this.open = true) : null}"
+      @blur="${isFocusable ? () => (this.open = false) : null}"
+      @mouseenter="${isFocusable ? null : () => (this.open = true)}"
+      @mouseleave="${isFocusable ? null : () => (this.open = false)}"
+      style="justify-content:${align};align-items:${align}"
+    >
       ${htmlSlot()}
-      <div part="tip"
-      direction="${this.direction}"
-      style="pointer-events:${this.propagation ? "none" : "all"}">
-    ${
-      this.tip
-        ? html`<span class="passive">${this.tip}</span>`
-        : htmlSlot("tip")
-    }</div>
+      <div part="tip">${this.tip ? html`<span class="passive">${this.tip}</span>` : htmlSlot("tip")}</div>
     </div>`;
   }
 }
 
 export default Tooltip;
+export { Tooltip };

package/src/components/typewriter.ts

@@ -1,9 +1,5 @@
-import { godown } from "@godown/element/decorators/godown.js";
-import { styles } from "@godown/element/decorators/styles.js";
-import { classList } from "@godown/element/directives/class-list.js";
-import { htmlSlot } from "@godown/element/directives/html-slot.js";
-import { random } from "@godown/element/tools/lib.js";
-import { css, html, type PropertyValueMap } from "lit";
+import { attr, godown, htmlSlot, random, styles } from "@godown/element";
+import { css, html, type PropertyValueMap, type TemplateResult } from "lit";
 import { property, query, state } from "lit/decorators.js";
 
 import { GlobalStyle, scopePrefix } from "../core/global-style.js";
@@ -17,10 +13,15 @@ const cssScope = scopePrefix(protoName);
  * @category effect
  */
 @godown(protoName)
-@styles(css`
+@styles(
+  css`
     :host {
       ${cssScope}--cursor-width: .05em;
-      white-space: nowrap;
+    }
+
+    :host,
+    :host([contents]) [part="root"] {
+      display: inline-block;
     }
 
     i {
@@ -41,23 +42,14 @@ const cssScope = scopePrefix(protoName);
     slot {
       display: none;
     }
-
-    .hidden {
-      visibility: hidden;
-    }
-  `)
+  `,
+)
 class Typewriter extends GlobalStyle {
   /**
    * Raw text.
    */
   @property()
-  text = "";
-
-  /**
-   * Start immediately after {@linkcode Typewriter.firstUpdated}.
-   */
-  @property({ type: Boolean })
-  stopped = false;
+  content = "";
 
   /**
    * If true, hide the cursor
@@ -89,11 +81,8 @@ class Typewriter extends GlobalStyle {
   @property({ type: Number })
   index = 0;
 
-  /**
-   * Internal text.
-   */
   @state()
-  content = "";
+  contentInternal = "";
 
   protected timeoutID: number;
 
@@ -101,39 +90,36 @@ class Typewriter extends GlobalStyle {
   protected _i: HTMLElement;
 
   /**
-   * {@linkcode Typewriter.text} length.
+   * {@linkcode Typewriter.content} length.
    */
-  get len() {
-    return this.text.length;
+  get len(): number {
+    return this.content.length;
   }
 
-  protected render() {
-    return html`${htmlSlot()}${this.content}<i part="cursor" class="${
-      classList({
-        hidden: this.ended,
-      })
-    }"></i>`;
+  protected render(): TemplateResult<1> {
+    return html`<div part="root" ${attr(this.observedRecord)}>
+      ${htmlSlot()} ${this.contentInternal}
+      <i part="cursor" ?hidden="${this.ended}"></i>
+    </div>`;
   }
 
-  protected firstUpdated() {
-    if (!this.text) {
-      this.text = this._slot?.assignedNodes()[0]?.textContent.trim() || "";
-    }
-    if (!this.stopped && this.len) {
+  protected firstUpdated(): void {
+    this.content ||= this._slot?.assignedNodes()[0]?.textContent.trim() || "";
+    if (!this.ended && this.len) {
       this.write();
     }
   }
 
-  protected updated(changedProperties: PropertyValueMap<this>) {
+  protected updated(changedProperties: PropertyValueMap<this>): void {
     if (changedProperties.has("index")) {
-      this.dispatchEvent(new CustomEvent(this.index === this.len ? "done" : "write", { detail: this.content }));
+      this.dispatchEvent(new CustomEvent(this.index === this.len ? "done" : "write", { detail: this.contentInternal }));
     }
   }
 
-  write(at = this.index) {
-    this.content = this.text.slice(0, at + 1);
+  write(at: number = this.index): void {
+    this.contentInternal = this.content.slice(0, at + 1);
     const timeout = this.delay || random(this.max, this.min);
-    this.timeoutID = window.setTimeout(() => {
+    this.timeoutID = setTimeout(() => {
       const nx = at + 1;
       if (nx <= this.len) {
         this.index = nx;
@@ -142,13 +128,14 @@ class Typewriter extends GlobalStyle {
     }, timeout);
   }
 
-  stop() {
+  stop(): void {
     clearTimeout(this.timeoutID);
   }
 
-  end() {
+  end(): void {
     this.ended = true;
   }
 }
 
 export default Typewriter;
+export { Typewriter };

package/src/core/global-style.ts

@@ -1,27 +1,32 @@
 import { type Gradients, presetsRGB } from "@godown/colors/presets-rgb.js";
 import { travel } from "@godown/colors/travel.js";
-import GodownElement from "@godown/element";
-import GodownConfig from "@godown/element/config.js";
-import { joinProperties } from "@godown/element/tools/css.js";
-import { trim } from "@godown/element/tools/lib.js";
-import { css, CSSResult, unsafeCSS } from "lit";
-
-GodownElement.godownConfig ||= new GodownConfig();
+import { GodownElement, joinProperties, trim } from "@godown/element";
+import { css, type CSSResult, unsafeCSS } from "lit";
 
 export class GlobalStyle extends GodownElement {
 }
 
 const cssvar = trim(GlobalStyle.godownConfig.prefix, "-");
 
-export function scopePrefix(scope: string, len = 1) {
+export function scopePrefix(scope: string, len = 1): CSSResult {
   return variablePrefix(cssvar + "-".repeat(len) + scope);
 }
 
-export function variablePrefix(variable: string) {
-  return unsafeCSS("--" + variable);
+export function variablePrefix(variable: string): CSSResult {
+  return unsafeCSS(`--${variable}`);
 }
 
-export const cssGlobalVars = {
+export const cssGlobalVars: {
+  foreground: CSSResult;
+  background: CSSResult;
+  clipBackground: CSSResult;
+  active: CSSResult;
+  passive: CSSResult;
+  _colors: PresetsGradientsCSSResult;
+  input: CSSResult;
+  white: CSSResult;
+  black: CSSResult;
+} = {
   foreground: scopePrefix("foreground", 2),
   background: scopePrefix("background", 2),
   clipBackground: scopePrefix("clip-background", 2),
@@ -82,5 +87,14 @@ GlobalStyle.styles = [
     svg {
       user-select: none;
     }
+
+    :host([contents]) {
+      display: contents;
+    }
+
+    :where(:host([contents]) [part=root]) {
+      all: inherit;
+      display: revert;
+    }
   `,
 ];