godown 3.0.0-canary.8 → 3.0.0

package/src/components/tooltip.ts

@@ -1,10 +1,8 @@
-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 { cssGlobalVars, scopePrefix } from "../core/global-style.js";
+import { scopePrefix } from "../core/global-style.js";
 import SuperOpenable, { type Direction8 } from "../core/super-openable.js";
 
 const protoName = "tooltip";
@@ -15,7 +13,7 @@ const cssScope = scopePrefix(protoName);
  *
  * If it has the tip property, ignore the slot tip.
  *
- * @slot tip - Tip element.
+ * @slot tip - Tip element if no `tip` provided.
  * @slot - Content.
  * @category feedback
  */
@@ -23,19 +21,22 @@ const cssScope = scopePrefix(protoName);
 @styles(
   css`
     :host {
-      ${cssScope}--tip-background: var(${cssGlobalVars.background});
-      display: inline-block;
+      ${cssScope}--tip-background: inherit;
       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,28 +45,32 @@ const cssScope = scopePrefix(protoName);
       user-select: none;
     }
 
-    :host([open]) [part="tip"],
-    :host(:hover) [part="tip"],
-    [part="tip"]:hover {
+    :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%;
     }
   `,
@@ -76,11 +81,13 @@ class Tooltip extends SuperOpenable {
    */
   @property()
   tip: string;
+
   /**
    * Direction of opening the tip.
    */
   @property()
   direction: Direction8 = "top";
+
   /**
    * Content alignment.
    */
@@ -91,7 +98,19 @@ class Tooltip extends SuperOpenable {
    * If true, allow penetration of the tip.
    */
   @property({ type: Boolean })
-  propagation: boolean;
+  propagation = false;
+
+  /**
+   * How can tips be triggered.
+   *
+   * If `focus`, element will be focusable, open tip when focused.
+   *
+   * If `hover`, element will open tip when hovered.
+   *
+   * @default "hover"
+   */
+  @property()
+  type: "hover" | "focus" = "hover";
 
   static aligns = {
     start: "flex-start",
@@ -101,18 +120,24 @@ class Tooltip extends SuperOpenable {
     "flex-end": "flex-end",
   };
 
-  protected render() {
+  protected render(): TemplateResult<1> {
     const align = Tooltip.aligns[this.align] || "inherit";
-    return html`<div part="root" style="justify-content:${align};align-items:${align}">
+    const isFocusable = this.type === "focus";
+    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}"
+    >
       ${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,11 +13,15 @@ const cssScope = scopePrefix(protoName);
  * @category effect
  */
 @godown(protoName)
-@styles(css`
+@styles(
+  css`
     :host {
       ${cssScope}--cursor-width: .05em;
-      font-family: monospace;
-      white-space: nowrap;
+    }
+
+    :host,
+    :host([contents]) [part="root"] {
+      display: inline-block;
     }
 
     i {
@@ -42,91 +42,84 @@ 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
    */
   @property({ type: Boolean })
   ended = false;
+
   /**
    * Maximum random time.
    */
   @property({ type: Number })
   max = 100;
+
   /**
    * Minimum random time.
    */
   @property({ type: Number })
   min = 50;
+
   /**
    * Fixed time.
    */
   @property({ type: Number })
   delay = 0;
+
   /**
    * The index at the beginning.
    */
   @property({ type: Number })
   index = 0;
-  /**
-   * Internal text.
-   */
+
   @state()
-  content = "";
+  contentInternal = "";
+
+  protected timeoutID: number;
 
-  timeoutID: number;
   @query("i")
-  _i: HTMLElement;
+  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;
@@ -135,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,26 +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 { 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),
@@ -45,17 +51,16 @@ GlobalStyle.styles = [
         const colorKey = scopePrefix("color", 2) + endKey;
         return `${colorKey}:rgb(${rgb});`;
       }, presetsRGB).join("")
+      + joinProperties({
+        [cssGlobalVars.background + ""]: `var(${cssGlobalVars._colors.darkgray[9]})`,
+        [cssGlobalVars.foreground + ""]: `var(${cssGlobalVars._colors.lightgray[0]})`,
+        [cssGlobalVars.active + ""]: `var(${cssGlobalVars._colors.blue[6]})`,
+        [cssGlobalVars.passive + ""]: `var(${cssGlobalVars._colors.darkgray[6]})`,
+        [cssGlobalVars.clipBackground + ""]:
+          `linear-gradient(to bottom, var(${cssGlobalVars.foreground}), var(${cssGlobalVars.passive}))`,
+      })
       + "}",
   ),
-  css`
-    :host {
-      ${cssGlobalVars.background}: var(${cssGlobalVars._colors.darkgray[9]});
-      ${cssGlobalVars.foreground}: var(${cssGlobalVars._colors.lightgray[0]});
-      ${cssGlobalVars.active}: var(${cssGlobalVars._colors.blue[6]});
-      ${cssGlobalVars.passive}: var(${cssGlobalVars._colors.darkgray[6]});
-      ${cssGlobalVars.clipBackground}: linear-gradient(180deg, var(${cssGlobalVars.foreground}), var(${cssGlobalVars.passive}));
-    }
-  `,
   css`
     * {
       border: 0;
@@ -82,5 +87,14 @@ GlobalStyle.styles = [
     svg {
       user-select: none;
     }
+
+    :host([contents]) {
+      display: contents;
+    }
+
+    :where(:host([contents]) [part=root]) {
+      all: inherit;
+      display: revert;
+    }
   `,
 ];

package/src/core/super-anchor.ts

@@ -1,32 +1,30 @@
-import { styles } from "@godown/element/decorators/index.js";
-import { htmlSlot } from "@godown/element/directives/html-slot.js";
-import { css, html } from "lit";
+import { attr, htmlSlot, styles } from "@godown/element";
+import { css, html, nothing, type TemplateResult } from "lit";
 import { property } from "lit/decorators.js";
-import { ifDefined } from "lit/directives/if-defined.js";
 
 import { GlobalStyle } from "./global-style.js";
 
-@styles(css`
-  :host {
-    display: inline-block;
-    color: currentColor;
-    text-decoration: none;
-    cursor: default;
-  }
+@styles(
+  css`
+    :host {
+      display: inline-block;
+      color: currentColor;
+      text-decoration: none;
+      cursor: default;
+    }
 
-  :host([href]) {
-    cursor: pointer;
-  }
+    :host([href]) {
+      cursor: pointer;
+    }
 
-  a {
-    width: 100%;
-    display: flex;
-    color: inherit;
-    text-decoration: inherit;
-    justify-content: space-between;
-    align-items: center;
-  }
-`)
+    [part=root] {
+      width: 100%;
+      color: inherit;
+      display: inline-block;
+      text-decoration: inherit;
+    }
+  `,
+)
 class SuperAnchor extends GlobalStyle {
   /**
    * A element href.
@@ -39,14 +37,20 @@ class SuperAnchor extends GlobalStyle {
   @property()
   target: "_blank" | "_self" | "_parent" | "_top" = "_self";
 
-  protected render() {
-    return html`<a part="root" href="${ifDefined(this.href)}" target="${this.target}" @click=${this._handleClick}>
+  protected render(): TemplateResult<1> {
+    return html`<a
+      part="root"
+      ${attr(this.observedRecord)}
+      href="${this.href || nothing}"
+      target="${this.target}"
+      @click=${this._handleClick}
+    >
       ${htmlSlot()}
     </a>`;
   }
 
   // eslint-disable-next-line
-  protected _handleClick(_: MouseEvent) {}
+  protected _handleClick(_: MouseEvent): void {}
 }
 
 export default SuperAnchor;