@pindoba/astro-textarea 0.0.0-alpha-20260829223243

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright 2025 Eduardo Lopes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

package/index.ts

@@ -0,0 +1,12 @@
+// Do not write code directly here, instead use the `src` folder!
+// Then, use this file to export everything you want your user to access.
+
+import Textarea from "./src/Textarea.astro";
+import TextareaRoot from "./src/TextareaRoot.astro";
+import TextareaField from "./src/TextareaField.astro";
+
+export * from "./src/Textarea.astro";
+export * from "./src/TextareaRoot.astro";
+export * from "./src/TextareaField.astro";
+export { TextareaRoot, TextareaField };
+export default Textarea;

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@pindoba/astro-textarea",
+  "version": "0.0.0-alpha-20260829223243",
+  "homepage": "https://github.com/EduardoLopes/pindoba/tree/main/packages/ui/astro/textarea#README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EduardoLopes/pindoba.git",
+    "directory": "packages/ui/astro/textarea"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./demos": "./src/demos/index.ts",
+    "./demos/feedback": "./src/demos/feedback.astro",
+    "./demos/size": "./src/demos/size.astro",
+    "./demos/leading-trailing-sizes": "./src/demos/leading-trailing-sizes.astro",
+    "./demos/auto-resize": "./src/demos/auto-resize.astro",
+    "./demos/character-count": "./src/demos/character-count.astro",
+    "./demos/custom": "./src/demos/custom.astro"
+  },
+  "files": [
+    "src",
+    "index.ts"
+  ],
+  "keywords": [
+    "astro-component"
+  ],
+  "devDependencies": {
+    "@astrojs/check": "^0.9.10",
+    "@pindoba/astro-affix": "0.0.0-alpha-20260829223243",
+    "@pindoba/astro-attachment": "0.0.0-alpha-20260829223243",
+    "@pindoba/astro-badge": "0.0.0-alpha-20260829223243",
+    "@pindoba/astro-stamp": "0.0.0-alpha-20260829223243",
+    "astro": "^7.2.9",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "astro": "^4.0.0"
+  },
+  "dependencies": {
+    "@lucide/astro": "^1.35.0",
+    "@pindoba/core-textarea": "0.0.0-alpha-20260829223243",
+    "@pindoba/styled-system": "0.0.0-alpha-20260829223243"
+  },
+  "scripts": {
+    "lint": "TIMING=1 eslint . --max-warnings 0",
+    "lint:fix": "TIMING=1 eslint . --fix --max-warnings 0",
+    "link": "pnpm link",
+    "unlink": "pnpm unlink",
+    "check": "astro check",
+    "dev": "astro check --watch",
+    "clean": "rm -rf .astro && rm -rf node_modules && rm -rf .turbo",
+    "format": "prettier --check . --ignore-path \"$PRETTIER_IGNORE_PATH\"",
+    "format:fix": "prettier --write . --ignore-path \"$PRETTIER_IGNORE_PATH\""
+  }
+}

package/src/Textarea.astro

@@ -0,0 +1,143 @@
+---
+import {
+  connectTextarea,
+  type TextareaBaseProps,
+} from "@pindoba/core-textarea";
+import type { HTMLAttributes } from "astro/types";
+
+type TextareaElementHTMLAttributes = HTMLAttributes<"textarea">;
+
+// `rows` is redeclared on `TextareaBaseProps` (typed `number`), so omit the
+// native attribute to avoid an incompatible-extends clash.
+type DefaultTextareaProps = Omit<
+  HTMLAttributes<"textarea">,
+  "size" | "background" | "rows"
+>;
+
+export interface TextareaProps
+  extends DefaultTextareaProps, TextareaBaseProps {}
+
+const {
+  feedback,
+  size,
+  background,
+  border,
+  fullWidth,
+  passThrough,
+  class: className,
+  rows,
+  resize,
+  autoResize,
+  value,
+  ...rest
+}: TextareaProps = Astro.props;
+
+const api = connectTextarea({
+  // Claim marker for this file's boot script. `data-textarea-root` is baked by
+  // the CORE connect, so a React/Svelte/Vue root carries it too — a
+  // document-wide query would adopt their instances on any page that mixes
+  // frameworks. Only Astro-rendered roots carry this one.
+  "data-astro-textarea": "",
+  feedback,
+  size,
+  background,
+  border,
+  fullWidth,
+  passThrough,
+  rows,
+  resize,
+  autoResize,
+  class: className,
+  textareaAttrs: rest,
+});
+---
+
+{
+  /* Declarative sugar: `leading`/`trailing` slots render an affix box (the
+    `[data-affix]` span the Control Var Contract aligns) around the field — no
+    `<Affix>` import needed. Customize the box via `passThrough.leading` (e.g.
+    `{ props: { decorative: true } }`). For multiple addons / custom layout,
+    compose the parts: `<TextareaRoot>` + `<Affix>` + `<TextareaField>`. */
+}
+<div {...api.rootProps}>
+  {
+    Astro.slots.has("leading") && (
+      <span {...api.leadingAffixProps}>
+        {/* Leading addon content (icon/badge), rendered inside an affix box the Control Var Contract aligns. Pass a `<Stamp emphasis="ghost">` for icons; style the box via `passThrough.leading`. @group Slots */}
+        <slot name="leading" />
+      </span>
+    )
+  }
+  <textarea {...api.textareaProps as TextareaElementHTMLAttributes}
+    >{value}</textarea
+  >
+  {
+    Astro.slots.has("trailing") && (
+      <span {...api.trailingAffixProps}>
+        {/* Trailing addon content, rendered inside an end-pinned affix box. @group Slots */}
+        <slot name="trailing" />
+      </span>
+    )
+  }
+</div>
+
+<script>
+  // Keep the interactive-affix selector in sync with `connect-textarea.ts`
+  // (`TEXTAREA_INTERACTIVE_AFFIX_SELECTOR`). Clicking dead chrome / a decorative
+  // affix focuses the field; clicking an interactive addon is left alone.
+  const INTERACTIVE =
+    "button:not([tabindex='-1']), a[href]:not([tabindex='-1']), input, select, textarea, [role='button']:not([tabindex='-1']), [tabindex]:not([tabindex='-1'])";
+  function boot() {
+    document
+      .querySelectorAll<HTMLElement>("[data-astro-textarea]")
+      .forEach((root) => {
+        // Only wire Astro-rendered instances. React/Svelte/Vue islands emit the
+        // same `data-textarea-root` (baked by the core) but get click-to-focus
+        // from the core `onclick` and hydrate their own DOM — mutating them here
+        // would race hydration and throw a mismatch. Astro's own demos render as
+        // static server HTML (no `<astro-island>` wrapper).
+        if (root.closest("astro-island")) return;
+        // Guard against double-wiring when Textarea and TextareaRoot share a
+        // page — both ship this script keyed on the same selector.
+        if (root.dataset.textareaRootWired) return;
+        root.dataset.textareaRootWired = "true";
+        root.addEventListener("click", (e) => {
+          const textarea = root.querySelector("textarea");
+          if (!textarea) return;
+          const target = e.target;
+          if (target === textarea) return;
+          if (target instanceof Element && target.closest(INTERACTIVE)) return;
+          textarea.focus();
+        });
+      });
+  }
+
+  boot();
+  document.addEventListener("astro:page-load", boot);
+</script>
+
+<script>
+  // Auto-grow textareas flagged with `data-auto-resize` (set by the connect
+  // when `autoResize` is truthy). Size to fit content on mount and on input.
+  function boot() {
+    document
+      .querySelectorAll<HTMLTextAreaElement>("textarea[data-auto-resize]")
+      .forEach((el) => {
+        // Skip hydrated islands (React/Svelte/Vue self-wire auto-resize); only
+        // grow Astro's own static textareas so we don't mutate island DOM
+        // pre-hydration.
+        if (el.closest("astro-island")) return;
+        if (el.dataset.autoResizeWired) return;
+        el.dataset.autoResizeWired = "true";
+        const fit = () => {
+          el.style.height = "auto";
+          el.style.height = el.scrollHeight + "px";
+        };
+        fit();
+        el.addEventListener("input", fit);
+      });
+  }
+
+  boot();
+  document.addEventListener("astro:page-load", boot);
+</script>

package/src/TextareaField.astro

@@ -0,0 +1,63 @@
+---
+import {
+  connectTextareaField,
+  type TextareaFieldBaseProps,
+} from "@pindoba/core-textarea";
+import type { HTMLAttributes } from "astro/types";
+
+type TextareaElementHTMLAttributes = HTMLAttributes<"textarea">;
+
+export interface TextareaFieldProps
+  extends
+    Omit<HTMLAttributes<"textarea">, "rows">,
+    TextareaFieldBaseProps<HTMLAttributes<"textarea">> {}
+
+const {
+  class: className,
+  passThrough,
+  rows,
+  resize,
+  autoResize,
+  value,
+  ...rest
+}: TextareaFieldProps = Astro.props;
+
+const api = connectTextareaField({
+  passThrough,
+  rows,
+  resize,
+  autoResize,
+  class: className,
+  textareaAttrs: rest,
+});
+---
+
+{
+  /* The bare field part — render inside a <TextareaRoot>, which owns the
+    chrome, the row sizing (data-control-size), and click-to-focus. */
+}
+<textarea {...api.rootProps as TextareaElementHTMLAttributes}>{value}</textarea>
+
+<script>
+  // Auto-grow textareas flagged with `data-auto-resize` (set by the connect
+  // when `autoResize` is truthy). Size to fit content on mount and on input.
+  function boot() {
+    document
+      .querySelectorAll<HTMLTextAreaElement>("textarea[data-auto-resize]")
+      .forEach((el) => {
+        // Skip hydrated islands (React/Svelte/Vue self-wire auto-resize).
+        if (el.closest("astro-island")) return;
+        if (el.dataset.autoResizeWired) return;
+        el.dataset.autoResizeWired = "true";
+        const fit = () => {
+          el.style.height = "auto";
+          el.style.height = el.scrollHeight + "px";
+        };
+        fit();
+        el.addEventListener("input", fit);
+      });
+  }
+
+  boot();
+  document.addEventListener("astro:page-load", boot);
+</script>

package/src/TextareaRoot.astro

@@ -0,0 +1,62 @@
+---
+import {
+  connectTextareaRoot,
+  type TextareaRootBaseProps,
+} from "@pindoba/core-textarea";
+import type { HTMLAttributes } from "astro/types";
+
+export type TextareaRootProps = HTMLAttributes<"div"> &
+  TextareaRootBaseProps<HTMLAttributes<"div">>;
+
+const { class: className, ...rest }: TextareaRootProps = Astro.props;
+
+const api = connectTextareaRoot({
+  // Claim marker for this file's boot script. `data-textarea-root` is baked by
+  // the CORE connect, so a React/Svelte/Vue root carries it too — a
+  // document-wide query would adopt their instances on any page that mixes
+  // frameworks. Only Astro-rendered roots carry this one.
+  "data-astro-textarea": "",
+  ...rest,
+  class: className,
+});
+---
+
+{
+  /* The chrome-carrying frame of the textarea family. Compose `<Affix>` boxes
+    and a `<TextareaField>` in the default slot — the Control Var Contract
+    aligns them and a click anywhere in the frame focuses the field (script
+    below). */
+}
+<div {...api.rootProps}>
+  <slot />
+</div>
+
+<script>
+  // Keep the interactive-affix selector in sync with `connect-textarea.ts`
+  // (`TEXTAREA_INTERACTIVE_AFFIX_SELECTOR`). Clicking dead chrome / a decorative
+  // affix focuses the field; clicking an interactive addon is left alone.
+  const INTERACTIVE =
+    "button:not([tabindex='-1']), a[href]:not([tabindex='-1']), input, select, textarea, [role='button']:not([tabindex='-1']), [tabindex]:not([tabindex='-1'])";
+  function boot() {
+    document
+      .querySelectorAll<HTMLElement>("[data-astro-textarea]")
+      .forEach((root) => {
+        // Only wire Astro-rendered instances — hydrated islands
+        // (`<astro-island>`) get click-to-focus from the core `onclick`.
+        if (root.closest("astro-island")) return;
+        if (root.dataset.textareaRootWired) return;
+        root.dataset.textareaRootWired = "true";
+        root.addEventListener("click", (e) => {
+          const textarea = root.querySelector("textarea");
+          if (!textarea) return;
+          const target = e.target;
+          if (target === textarea) return;
+          if (target instanceof Element && target.closest(INTERACTIVE)) return;
+          textarea.focus();
+        });
+      });
+  }
+
+  boot();
+  document.addEventListener("astro:page-load", boot);
+</script>

package/src/demos/auto-resize.astro

@@ -0,0 +1,14 @@
+---
+import Textarea from "../Textarea.astro";
+import { stack } from "@pindoba/styled-system/patterns";
+---
+
+<div class={stack({ gap: "md", direction: "column" })}>
+  <Textarea
+    autoResize
+    resize="none"
+    rows={2}
+    placeholder="Type multiple lines…"
+    fullWidth
+  />
+</div>

package/src/demos/character-count.astro

@@ -0,0 +1,29 @@
+---
+import Textarea from "../Textarea.astro";
+import Attachment from "@pindoba/astro-attachment";
+import { css } from "@pindoba/styled-system/css";
+
+// The counter floats below the field via the Attachment component. Astro
+// renders statically, so the count is illustrative — the Svelte / React / Vue
+// tabs update it live.
+const MAX = 280;
+
+const field = {
+  root: { style: { display: "block", width: "20rem", maxWidth: "100%" } },
+};
+
+const counter = css({
+  fontSize: "xs",
+  fontVariantNumeric: "tabular-nums",
+  color: "neutral.text.muted",
+  background: "neutral.surface.hill",
+  borderRadius: "sm",
+  paddingInline: "2xs",
+  paddingBlock: "3xs",
+});
+---
+
+<Attachment placement="bottom-end" anchor="outside" passThrough={field}>
+  <Textarea rows={4} fullWidth maxlength={MAX} placeholder="Write a message…" />
+  <span slot="content" class={counter}>0 / {MAX}</span>
+</Attachment>

package/src/demos/custom.astro

@@ -0,0 +1,32 @@
+---
+import Textarea from "../Textarea.astro";
+import { stack } from "@pindoba/styled-system/patterns";
+---
+
+<div class={stack({ gap: "xl", direction: "column" })}>
+  <div>
+    <h3>Custom style via passThrough</h3>
+    <Textarea
+      placeholder="Custom root style"
+      passThrough={{
+        root: { style: { borderRadius: "full" } },
+        textarea: { style: { fontStyle: "italic" } },
+      }}
+    />
+  </div>
+
+  <div>
+    <h3>Custom props via passThrough</h3>
+    <Textarea
+      placeholder="Message..."
+      passThrough={{
+        textarea: {
+          props: {
+            "aria-label": "Message textarea",
+            "data-testid": "message-textarea",
+          },
+        },
+      }}
+    />
+  </div>
+</div>

package/src/demos/feedback.astro

@@ -0,0 +1,12 @@
+---
+import Textarea from "../Textarea.astro";
+import { stack } from "@pindoba/styled-system/patterns";
+---
+
+<div class={stack({ gap: "md", direction: "column" })}>
+  <Textarea feedback="neutral" placeholder="Neutral" />
+  <Textarea feedback="primary" placeholder="Primary" />
+  <Textarea feedback="success" placeholder="Success" />
+  <Textarea feedback="danger" placeholder="Danger" />
+  <Textarea feedback="warning" placeholder="Warning" />
+</div>

package/src/demos/index.ts

@@ -0,0 +1,6 @@
+export { default as Feedback } from "./feedback.astro";
+export { default as Size } from "./size.astro";
+export { default as LeadingTrailingSizes } from "./leading-trailing-sizes.astro";
+export { default as AutoResize } from "./auto-resize.astro";
+export { default as CharacterCount } from "./character-count.astro";
+export { default as Custom } from "./custom.astro";

package/src/demos/leading-trailing-sizes.astro

@@ -0,0 +1,42 @@
+---
+import TextareaRoot from "../TextareaRoot.astro";
+import TextareaField from "../TextareaField.astro";
+import Affix from "@pindoba/astro-affix";
+import Stamp from "@pindoba/astro-stamp";
+import { MessageSquare, Search, Paperclip } from "@lucide/astro";
+import { stack } from "@pindoba/styled-system/patterns";
+
+const sizes = ["xs", "sm", "md", "lg"] as const;
+---
+
+<div class={stack({ gap: "md", direction: "column" })}>
+  {
+    sizes.map((size) => (
+      <TextareaRoot size={size}>
+        <Affix>
+          <Stamp emphasis="ghost" border="muted">
+            <MessageSquare />
+          </Stamp>
+        </Affix>
+        <TextareaField placeholder={`Message (${size})`} />
+        <Affix side="end">
+          <Stamp emphasis="ghost" border="muted">
+            <Paperclip />
+          </Stamp>
+        </Affix>
+      </TextareaRoot>
+    ))
+  }
+  {
+    sizes.map((size) => (
+      <TextareaRoot size={size}>
+        <Affix>
+          <Stamp emphasis="ghost" border="muted">
+            <Search />
+          </Stamp>
+        </Affix>
+        <TextareaField placeholder={`Search (${size})`} />
+      </TextareaRoot>
+    ))
+  }
+</div>

package/src/demos/size.astro

@@ -0,0 +1,11 @@
+---
+import Textarea from "../Textarea.astro";
+import { stack } from "@pindoba/styled-system/patterns";
+---
+
+<div class={stack({ gap: "md", direction: "column" })}>
+  <Textarea size="xs" placeholder="Extra Small" />
+  <Textarea size="sm" placeholder="Small" />
+  <Textarea size="md" placeholder="Medium" />
+  <Textarea size="lg" placeholder="Large" />
+</div>

package/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="astro/client" />