diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000..1372fd4 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,2 @@ +# Maintainer review for every contribution, including CI and policy changes. +* @wilkinsantana diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml new file mode 100644 index 0000000..56f73fe --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -0,0 +1,36 @@ +name: Bug report +description: Report a reproducible problem in TendUI. +title: "[Bug]: " +labels: [bug] +body: + - type: markdown + attributes: + value: "For vulnerabilities, email security@tendstack.com privately. Do not include credentials or user data." + - type: input + id: version + attributes: + label: Version or commit + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: Minimal reproduction + description: Include steps and a small code example or public reproduction repository. + validations: + required: true + - type: textarea + id: behavior + attributes: + label: Expected and actual behavior + validations: + required: true + - type: textarea + id: environment + attributes: + label: Browser and environment + description: Browser/version, operating system, Go version, theme, viewport and reduced-motion settings when relevant. + - type: textarea + id: evidence + attributes: + label: Screenshots or sanitized diagnostics diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..782bf72 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: true +contact_links: + - name: Documentation and examples + url: https://tendui.com/docs + about: Start with the guides and working examples. + - name: Private security report + url: mailto:security@tendstack.com + about: Do not disclose vulnerabilities in public issues. diff --git a/.github/ISSUE_TEMPLATE/proposal.yml b/.github/ISSUE_TEMPLATE/proposal.yml new file mode 100644 index 0000000..594017e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/proposal.yml @@ -0,0 +1,24 @@ +name: Component or feature proposal +description: Discuss an addition before starting a large implementation. +title: "[Proposal]: " +labels: [enhancement] +body: + - type: textarea + id: problem + attributes: + label: User need + description: What task is difficult with the existing components? + validations: + required: true + - type: textarea + id: approach + attributes: + label: Proposed behavior and alternatives + description: Include native HTML semantics, keyboard/mobile behavior and the no-bundled-JavaScript contract. + validations: + required: true + - type: textarea + id: compatibility + attributes: + label: Compatibility and scope + description: Identify API changes, dependencies and a bounded first implementation. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..fb19001 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,17 @@ +## Problem and change + +Explain the user-visible problem and the resulting behavior. Link the issue. + +## Validation + +List checks actually run and results. Include screenshots for visual changes. + +## Compatibility and sources + +Describe API changes, migration steps, dependencies, reused material and significant +AI assistance. Omit private infrastructure, credentials and personal data. + +- [ ] I have read CONTRIBUTING.md and the DCO. +- [ ] My non-merge commits have my `Signed-off-by` trailer. +- [ ] Tests/docs and generated templ Go are updated where applicable. +- [ ] I checked keyboard, narrow-screen and theme behavior for UI changes. diff --git a/.github/scripts/check-dco.py b/.github/scripts/check-dco.py new file mode 100644 index 0000000..42ec9f5 --- /dev/null +++ b/.github/scripts/check-dco.py @@ -0,0 +1,42 @@ +#!/usr/bin/env python3 +"""Check author-matching DCO trailers without executing contribution code.""" +import re +import subprocess +import sys + + +def signed_off(name, email, message): + trailers = subprocess.run( + ["git", "interpret-trailers", "--parse"], input=message, + text=True, capture_output=True, check=True, + ).stdout + for line in trailers.splitlines(): + match = re.fullmatch(r"Signed-off-by:\s*(.+?)\s*<([^<>\s]+@[^<>\s]+)>", line, re.I) + if match and match[1].strip() == name.strip() and match[2].casefold() == email.casefold(): + return True + return False + + +def main(): + if len(sys.argv) != 3 or not all(re.fullmatch(r"[0-9a-f]{40}", s) for s in sys.argv[1:]): + raise SystemExit("Usage: check-dco.py BASE_SHA HEAD_SHA (full commit hashes)") + commits = subprocess.check_output( + ["git", "rev-list", "--no-merges", sys.argv[1] + ".." + sys.argv[2]], text=True, + ).splitlines() + failed = [] + for commit in commits: + author, email, message = subprocess.check_output( + ["git", "show", "-s", "--format=%an%x00%ae%x00%B", commit], text=True, + ).split("\0", 2) + if not signed_off(author, email, message): + failed.append(commit[:12]) + if failed: + print("Missing author-matching DCO sign-off in: " + ", ".join(failed)) + print("Read CONTRIBUTING.md; sign only your own contributions with git commit -s.") + return 1 + print(f"DCO: {len(commits)} non-merge commits have author-matching sign-offs.") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/.github/scripts/test_dco.py b/.github/scripts/test_dco.py new file mode 100644 index 0000000..241ca58 --- /dev/null +++ b/.github/scripts/test_dco.py @@ -0,0 +1,22 @@ +#!/usr/bin/env python3 +import importlib.util +from pathlib import Path +import unittest + +spec = importlib.util.spec_from_file_location("dco", Path(__file__).with_name("check-dco.py")) +dco = importlib.util.module_from_spec(spec) +spec.loader.exec_module(dco) + +class DCOTests(unittest.TestCase): + def test_matching_trailer(self): + self.assertTrue(dco.signed_off("Example Contributor", "123+dev@users.noreply.github.com", "Fix spacing\n\nSigned-off-by: Example Contributor <123+dev@users.noreply.github.com>\n")) + def test_missing_or_wrong_author(self): + self.assertFalse(dco.signed_off("Dev", "dev@example.com", "Fix spacing\n")) + self.assertFalse(dco.signed_off("Dev", "dev@example.com", "Fix\n\nSigned-off-by: Someone Else \n")) + def test_body_text_is_not_a_trailer(self): + self.assertFalse(dco.signed_off("Dev", "dev@example.com", "Signed-off-by: Dev \n\nThis is an example, not a sign-off.\n")) + def test_another_trailer_can_follow(self): + self.assertTrue(dco.signed_off("Dev", "dev@example.com", "Fix\n\nSigned-off-by: Dev \nReviewed-by: Reviewer \n")) + +if __name__ == "__main__": + unittest.main() diff --git a/.github/settings/PROJECT_BOARD.md b/.github/settings/PROJECT_BOARD.md new file mode 100644 index 0000000..00fd23f --- /dev/null +++ b/.github/settings/PROJECT_BOARD.md @@ -0,0 +1,46 @@ +# Shared TendUI project board + +The GitHub connector used for preparation cannot create Projects. The issues +below already exist; this file describes the owner setup still needed, not a +claim that a board is active. + +Create an organization-level **TendUI** project at +https://github.com/orgs/Tend-Stack/projects using the Board layout. It should +track both `Tend-Stack/TendUI` and `Tend-Stack/TendUI-web`. + +## Fields and views + +- Status columns: Backlog, Ready, In progress, In review, Done. +- Priority: High, Normal, Low. Reserve High for reproducible defects, security + coordination and launch blockers; do not disclose private vulnerabilities. +- Use GitHub's Repository, Labels, Assignees and linked PR fields. +- Views: All work (board), Bugs (filter label:bug), Ready for contribution + (filter label:"help wanted"), and Launch (the launch checklist and linked tasks). +- Set public visibility only after repository publication/privacy review. A + public project does not make private repository issues public automatically. + +## Seed issues + +- https://github.com/Tend-Stack/TendUI/issues/3 — launch and protections; High, In progress. +- https://github.com/Tend-Stack/TendUI/issues/4 — manual accessibility review; Normal, Ready. +- https://github.com/Tend-Stack/TendUI/issues/5 — html/template recipe; Normal, Ready, good first issue. +- https://github.com/Tend-Stack/TendUI-web/issues/3 — visual baselines; Normal, Backlog. + +Link the current preview PRs as In review. Add the board URL to each repository's +About/Projects area and CONTRIBUTING.md once the board exists. + +## Automation and triage + +Enable built-in workflows that mark closed issues and merged PRs Done. Configure +auto-add for open issues/PRs from both repositories if the organization plan +supports the required workflows. Otherwise add items during weekly triage. + +Keep untriaged reports in Backlog. Move a task to Ready only when it has a clear +scope and acceptance criteria. Assign one owner when work starts; move to In +review when a PR is ready. Closing a PR without merging does not necessarily +resolve its linked issue. Use a bounded archive of completed items rather than +deleting issue history. + +Check duplicates before creating issues. Maintain real bugs as issues with +reproduction steps; never use the public board to track confidential security +reports or private infrastructure identifiers. diff --git a/.github/settings/README.md b/.github/settings/README.md new file mode 100644 index 0000000..7250ed5 --- /dev/null +++ b/.github/settings/README.md @@ -0,0 +1,27 @@ +# Owner-applied repository settings + +This directory is a reviewable configuration, not proof that GitHub settings +are active. An owner with repository administration access should apply the +main ruleset once the contribution workflow is merged and its check names exist. + +```sh +gh api --method POST repos/Tend-Stack/TendUI-web/rulesets --input .github/settings/main-ruleset.json +``` + +Read existing rulesets first. If one already has this name, update it by its ID +with PUT rather than creating duplicates. The ruleset requires DCO and all CI, +one approving code-owner review, dismissal of stale approvals, approval of the +latest push, resolved conversations and an up-to-date branch. It blocks force +pushes and deletion. Repository admins have an explicit PR-only bypass for +maintainer exceptions; record the reason in the PR and preserve contributor DCO. + +Also enable GitHub private vulnerability reporting and web commit sign-off, +disable squash/rebase merges to preserve commit trailers, and allow merge commits. +Require approval for fork workflows according to the organization's trust policy. +Never run untrusted fork code on private self-hosted runners or with deployment +secrets. Workflows use hosted runners, read-only PR permissions and no +`pull_request_target` code execution. Tag release credentials run only on maintainer tags. + +Use existing `bug`, `enhancement`, `documentation`, `good first issue` and +`help wanted` labels. Curate bounded starter tasks; do not label complex API or +security changes as beginner work merely to attract contributions. diff --git a/.github/settings/main-ruleset.json b/.github/settings/main-ruleset.json new file mode 100644 index 0000000..3e5a32b --- /dev/null +++ b/.github/settings/main-ruleset.json @@ -0,0 +1,59 @@ +{ + "name": "Reviewed main contributions", + "target": "branch", + "enforcement": "active", + "bypass_actors": [ + { + "actor_id": 5, + "actor_type": "RepositoryRole", + "bypass_mode": "pull_request" + } + ], + "conditions": { + "ref_name": { + "include": [ + "refs/heads/main" + ], + "exclude": [] + } + }, + "rules": [ + { + "type": "deletion" + }, + { + "type": "non_fast_forward" + }, + { + "type": "pull_request", + "parameters": { + "required_approving_review_count": 1, + "dismiss_stale_reviews_on_push": true, + "require_code_owner_review": true, + "require_last_push_approval": true, + "required_review_thread_resolution": true + } + }, + { + "type": "required_status_checks", + "parameters": { + "strict_required_status_checks_policy": true, + "do_not_enforce_on_create": false, + "required_status_checks": [ + { + "context": "verify", + "integration_id": 15368 + }, + { + "context": "browser", + "integration_id": 15368 + }, + { + "context": "DCO", + "integration_id": 15368 + } + ] + } + } + ] +} diff --git a/.github/workflows/contributions.yml b/.github/workflows/contributions.yml new file mode 100644 index 0000000..eb3a428 --- /dev/null +++ b/.github/workflows/contributions.yml @@ -0,0 +1,36 @@ +name: Contribution checks +on: + pull_request: +permissions: + contents: read +concurrency: + group: dco-${{ github.event.pull_request.number }} + cancel-in-progress: true +jobs: + dco: + name: DCO + runs-on: ubuntu-24.04 + timeout-minutes: 5 + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 + with: + ref: ${{ github.event.pull_request.head.sha }} + fetch-depth: 0 + persist-credentials: false + - name: Verify contributor sign-offs using the base branch policy + env: + BASE_SHA: ${{ github.event.pull_request.base.sha }} + HEAD_SHA: ${{ github.event.pull_request.head.sha }} + shell: bash + run: | + set -euo pipefail + # Read policy from the trusted base; never execute contributor scripts. + if ! git cat-file -e "$BASE_SHA:.github/scripts/check-dco.py" 2>/dev/null; then + echo "DCO policy bootstrap: enforcement begins after this policy merges." + exit 0 + fi + test "$(git rev-parse HEAD)" = "$HEAD_SHA" + git show "$BASE_SHA:.github/scripts/check-dco.py" > "$RUNNER_TEMP/check-dco.py" + git show "$BASE_SHA:.github/scripts/test_dco.py" > "$RUNNER_TEMP/test_dco.py" + python3 "$RUNNER_TEMP/test_dco.py" + python3 "$RUNNER_TEMP/check-dco.py" "$BASE_SHA" "$HEAD_SHA" diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..aaa091e --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,19 @@ +# Community code of conduct + +Treat participants with respect regardless of experience, identity or background. +Discuss ideas and code constructively, accept good-faith feedback, and give credit +for other people's work. Respect maintainers' and contributors' time and boundaries. + +Harassment, threats, discriminatory abuse, sexualized conduct, doxxing, and +publication of another person's private information are not acceptable. This +policy applies to repository issues, pull requests and other project-run spaces. + +Report concerns privately to **conduct@tendstack.com**. Include links and relevant +context, avoiding unnecessary personal information. Reports will be handled as +privately as practicable; information may be shared where needed to investigate +or protect participants. No response-time guarantee is promised. + +Maintainers may request changes, remove content, close a discussion, restrict +participation or ban an account depending on the severity and pattern of conduct. +A person involved in a report should not decide its outcome. The reporter or +subject may request reconsideration through the same private contact address. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..94c484f --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,82 @@ +# Contributing to TendUI-web + +Thank you for helping improve TendUI. Start with a bug, documentation fix, +accessibility improvement or an issue labeled `good first issue` or `help wanted`. +Discuss new components, public API changes, dependencies and large refactors in an +issue before implementation. A proposal should explain the use case, native HTML +semantics, keyboard behavior, narrow-screen behavior and alternatives considered. + +## Contribution terms: MIT + DCO + +Contributions are submitted under this repository's [MIT license](LICENSE). +You keep your copyright; no copyright assignment or separate CLA is required. +Every non-merge commit must include a sign-off certifying the [Developer +Certificate of Origin 1.1](DCO). Read it before signing. Obtain any employer or +third-party permission needed, retain attribution, and do not submit incompatible +licensed material. The sign-off is a certification, not a cryptographic signature. + +```sh +git commit -s -m "Describe the change" +``` + +Use your own name and the same email as the commit author. A GitHub-provided +noreply address is accepted. Names, commit emails and sign-offs become public +and remain in history. Never add another person's sign-off without authorization. +For your own last commit, use `git commit --amend --signoff`; coordinate with +reviewers before rewriting an already-pushed contribution branch. Maintainers do +not add missing contributor certifications on someone else's behalf. + +AI-assisted contributions follow exactly the same rules: a human contributor +must understand, review and test the result and certify the right to submit it. +Identify significant generated material or reused sources in the PR description. + +## Workflow + +1. Fork the repository and create a focused branch from current `main`. +2. Make the smallest complete change; keep unrelated cleanup separate. +3. Add proportionate tests and update documentation for changed behavior. +4. Regenerate templ output when templates change; commit both source and generated Go. +5. Open a draft PR early when feedback would help. Link the issue and describe validation. +6. Respond to review; maintainers merge after required checks and approval. + +Go 1.26 or newer is required. Template authors use templ v0.3.1100. Node/npm are +only used for optional contributor browser tooling, never the shipped UI. + +```sh +go test -race ./... +go vet ./... +# If templates change: +templ generate +# Website browser tooling is development-only: +cd tests/browser +npm ci --ignore-scripts +npx playwright install chromium webkit +npm test +``` + +CI supplies native-platform and browser coverage. Do not claim a check ran when +it did not; explain unavailable checks in the PR. Keep generated test evidence +under ignored `tests/results/` and remove owned disposable artifacts after use. + +## Design and compatibility + +- Semantic HTML and native browser behavior first; no bundled client JavaScript, + remote fonts or runtime asset downloads. +- Keep Go configuration typed. Applications own routing, persistence, sessions, + request protection and any optional HTMX runtime. +- Preserve keyboard access, accessible names, theme behavior and reduced motion. +- Public API changes need an explicit compatibility review and migration notes, + even during preview. Never silently replace old tags. +- Include screenshots for visual changes and narrow-screen checks where relevant. +- Never commit credentials, private infrastructure details, personal datasets or logs. + +## Reviews and releases + +CODEOWNERS identifies the maintainer. External contributions require maintainer +approval, DCO and applicable CI. An administrator may make a documented exception +through a PR; never use an exception to accept an unsigned contributor submission. +Prefer merge commits to preserve contributor sign-offs. Release tags are created +by maintainers after exact-source checks; previews use `YEAR.RELEASE.FIX-preview.N`. + +Report security issues privately using [SECURITY.md](SECURITY.md). Community +participation follows [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). diff --git a/DCO b/DCO new file mode 100644 index 0000000..49b8cb0 --- /dev/null +++ b/DCO @@ -0,0 +1,34 @@ +Developer Certificate of Origin +Version 1.1 + +Copyright (C) 2004, 2006 The Linux Foundation and its contributors. + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + + +Developer's Certificate of Origin 1.1 + +By making a contribution to this project, I certify that: + +(a) The contribution was created in whole or in part by me and I + have the right to submit it under the open source license + indicated in the file; or + +(b) The contribution is based upon previous work that, to the best + of my knowledge, is covered under an appropriate open source + license and I have the right under that license to submit that + work with modifications, whether created in whole or in part + by me, under the same open source license (unless I am + permitted to submit under a different license), as indicated + in the file; or + +(c) The contribution was provided directly to me by some other + person who certified (a), (b) or (c) and I have not modified + it. + +(d) I understand and agree that this project and the contribution + are public and that a record of the contribution (including all + personal information I submit with it, including my sign-off) is + maintained indefinitely and may be redistributed consistent with + this project or the open source license(s) involved. diff --git a/README.md b/README.md index 5073b50..e281427 100644 --- a/README.md +++ b/README.md @@ -16,13 +16,12 @@ share TendUI’s example handler through `site.HandlerWithOptions`. All assets a external fonts, tracking, database, or runtime downloads are required to build or serve it. The test-only browser suite is separate from the shipped application. -Documentation lives under `/docs`, the searchable 36-component reference under +Documentation lives under `/docs`, the searchable 37-component reference under `/catalog`, application examples under `/examples`, and native state/appearance controls under `/playground`. The public canonical origin is https://tendui.com. The library and templ runtime are vendored at the exact revision recorded in -`library-version.json`. Docker builds use `GOPROXY=off` and need no private-repo -credentials. To refresh from a clean library checkout, run +`library-version.json`. Docker builds use `GOPROXY=off` and require no module-registry access. To refresh from a clean library checkout, run `python3 tools/vendor-library.py /path/to/TendUI`. This uses the local Go module cache for already-downloaded dependencies, records a tag or exact pseudo-version, and removes its temporary proxy and cache. Commit the resulting module metadata, @@ -100,3 +99,9 @@ Normal builds need only Go. Website styles use content-hashed URLs; the library stylesheet URL is tied to the vendored revision. This prevents cached landing-page CSS from being reused after a documentation deployment, even when an edge proxy sets a longer browser cache lifetime. + +## Contributing + +See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, review and MIT + DCO sign-off. +Report vulnerabilities privately using [SECURITY.md](SECURITY.md); community +participation follows [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..e394653 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,14 @@ +# Security policy + +Email **security@tendstack.com** privately with suspected vulnerabilities. Include +version/commit, affected component, a minimal reproduction and the likely impact. +Do not open a public issue, attach production credentials or include real user data. +We will coordinate disclosure and a fix with the reporter; no response-time SLA +is promised during preview. Sanitized examples are preferable to sensitive logs. + +Security fixes currently target the latest TendUI preview. Historical pre-rename +versions are not an actively supported security line. Applications remain +responsible for authentication, request protection and their Go dependencies. + +If GitHub private vulnerability reporting is enabled for the repository, its +“Report a vulnerability” form is also an appropriate private channel. diff --git a/content/html.html b/content/html.html new file mode 100644 index 0000000..fa056db --- /dev/null +++ b/content/html.html @@ -0,0 +1,41 @@ +{{define "body"}} +

Two files. Any HTML stack.

+

TendUI's stylesheet works with static HTML, server templates and existing applications. Go and templ are optional. No Node.js, npm, JavaScript or CSS compilation is needed.

+

1. Download the files

+

Download index.html and download tendui.css. Save both in the same folder, then open index.html in your browser.

+

These downloads use the website's pinned v2026.2.0-preview.2 library. For a permanent version reference, use the tagged source. Retain the library's MIT copyright and permission notice when redistributing it.

+

Open the live plain-HTML example →

+

2. Use semantic HTML

+
<!doctype html>
+<html lang="en" data-theme="light">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="light dark">
+  <title>TendUI with plain HTML</title>
+  <link rel="stylesheet" href="./tendui.css">
+</head>
+<body>
+  <main>
+    <h1>Hello, semantic HTML.</h1>
+    <p>No Go runtime, templ generator, Node.js, or JavaScript is needed for this page.</p>
+    <article>
+      <header><h2>A card is an article</h2></header>
+      <p>The stylesheet gives ordinary HTML a consistent appearance.</p>
+      <label for="name">Try a text field</label>
+      <input id="name" name="name" placeholder="Your name" autocomplete="name">
+      <details>
+        <summary>Does this work without JavaScript?</summary>
+        <p>Yes. The browser opens this disclosure using native HTML.</p>
+      </details>
+      <footer><a href="https://tendui.com/docs">Explore the documentation</a></footer>
+    </article>
+  </main>
+</body>
+</html>
+
+

3. Make it yours

+

Change data-theme="light" to dark, or omit it to follow the system preference. Serve the two files with any static web host, or copy the stylesheet into your existing application's assets.

+

The text field and disclosure use native browser behavior. Your application supplies form handlers, authentication and persistence. Optional HTMX requires a runtime that you supply.

+

For typed components and CSS embedded into a single Go binary, follow the Go and templ quickstart.

+{{end}} diff --git a/content/install.html b/content/install.html index aed9c5b..3f2914c 100644 --- a/content/install.html +++ b/content/install.html @@ -1,54 +1,74 @@ {{define "body"}} -

1. Add the module

-

Use Go 1.26 or newer. Choose a patched compiler for deployed applications. Install the TendUI development branch while the renamed release is being prepared:

-
go mod init example.com/myapp
-go get github.com/Tend-Stack/TendUI/v2026@main
+

1. Add the preview module

+

Use Go 1.26 or newer. Pin this preview version for reproducible builds:

+
mkdir my-tendui-app
+cd my-tendui-app
+go mod init example.com/my-tendui-app
+go get github.com/Tend-Stack/TendUI/v2026@v2026.2.0-preview.2
 go install github.com/a-h/templ/cmd/templ@v0.3.1100
-

The repository currently requires GitHub access. For private-module downloads, configure your normal Git credentials and GOPRIVATE=github.com/Tend-Stack/TendUI. Never put credentials in source or import URLs.

-

2. Create a page

Save this as page.templ. Go structs configure the component; ordinary HTML supplies the content.

+

Using another stack? Start with plain HTML and CSS.

+

2. Create a page

Save this as page.templ. Go structs configure components; ordinary HTML supplies the content.

package main
 
-import "github.com/Tend-Stack/TendUI/v2026/components"
+import "github.com/Tend-Stack/TendUI/v2026/components"
 
 templ page() {
-    @components.Layout(components.LayoutProps{
-        Title: "My TendUI app",
-        Language: "en",
-        Theme: components.ThemeSystem,
-    }, body())
+	@components.Layout(components.LayoutProps{
+		Title:    "My TendUI app",
+		Language: "en",
+		Theme:    components.ThemeSystem,
+	}, body())
 }
 
 templ body() {
-    <main>
-        <h1>Hello, TendUI.</h1>
-        @components.Card(components.CardProps{}) {
-            <p>A little less setup. A little more making.</p>
-        }
-    </main>
-}
-

3. Serve the page and stylesheet

Save this as main.go. The layout links the same stylesheet path served by AssetHandler.

-
package main
+	<main>
+		<h1>Hello, TendUI.</h1>
+		@components.Card(components.CardProps{}) {
+			<p>This page and its stylesheet ship in one Go binary.</p>
+			<details>
+				<summary>What does the browser need?</summary>
+				<p>Just HTML and CSS. This disclosure works without JavaScript.</p>
+			</details>
+		}
+	</main>
+}
+
+

3. Serve the page and stylesheet

Save this as main.go.

+
// A complete TendUI application. The generated page and CSS ship in its binary.
+package main
 
 import (
-    "log"
-    "net/http"
-    "time"
+	"log"
+	"net/http"
+	"time"
 
-    "github.com/Tend-Stack/TendUI/v2026"
-    "github.com/a-h/templ"
+	"github.com/Tend-Stack/TendUI/v2026"
+	"github.com/a-h/templ"
 )
 
+func handler() http.Handler {
+	mux := http.NewServeMux()
+	mux.Handle(tendui.AssetPath, tendui.AssetHandler())
+	mux.Handle("GET /{$}", templ.Handler(page()))
+	return mux
+}
+
 func main() {
-    mux := http.NewServeMux()
-    mux.Handle(tendui.AssetPath, tendui.AssetHandler())
-    mux.Handle("GET /{$}", templ.Handler(page()))
-    server := &http.Server{
-        Addr: ":8080", Handler: mux,
-        ReadHeaderTimeout: 5 * time.Second,
-    }
-    log.Fatal(server.ListenAndServe())
-}
-

4. Generate and run

templ generate
-go run .

Open http://localhost:8080. To ship the app, run go build. Your generated Go and embedded CSS become one executable.

-

Versioning

Releases use YEAR.RELEASE.FIX, using tags such as v2026.2.0. Existing pre-rename tags retain their original module path; use @main for TendUI until its first renamed release. The module suffix /v2026 follows Go’s major-version rules. Fixes on this line retain the suffix.

+ server := &http.Server{ + Addr: "127.0.0.1:8080", Handler: handler(), + ReadHeaderTimeout: 5 * time.Second, + } + log.Fatal(server.ListenAndServe()) +} +
+

4. Generate and run

+
templ generate
+go run .
+

Open http://127.0.0.1:8080. If templ is not on your PATH, use the executable in $(go env GOPATH)/bin/templ. The generator is needed when authoring your own templ pages; the library includes its generated Go.

+

5. Ship one binary

+
go build -o my-tendui-app .
+

Your generated page and TendUI stylesheet are compiled into the executable using Go's native embedding. No runtime asset directory, Node.js, npm or bundled JavaScript is needed. Add application-specific storage, routing and production server configuration as required.

+

This is the tested quickstart in the preview source.

+

Versioning

+

Releases use YEAR.RELEASE.FIX. This prerelease is v2026.2.0-preview.2; API changes remain possible before stable release. The /v2026 module suffix follows Go's major-version rules. Historical pre-rename tags are not TendUI installation targets.

{{end}} diff --git a/content/overview.html b/content/overview.html index 914133e..c9856e9 100644 --- a/content/overview.html +++ b/content/overview.html @@ -2,7 +2,7 @@

Beautiful interfaces. No build pipeline.

Pure CSS. Semantic HTML. No Node.js, no npm, no bundled JavaScript. First-class Go and templ support.

Use the standalone stylesheet with any HTML-producing stack. In Go, the asset package uses //go:embed to bundle it in your binary, and typed templ components make composition convenient. Your application owns routing, data, and behavior. HTMX is optional and supplied by your application.

-
Start with a working page.

Follow the installation guide, then choose a component from the catalog. Every component has a compiled preview and a downloadable templ recipe.

+
Start with a working page.

Choose the Go/templ quickstart or plain HTML/CSS guide, then choose a component from the catalog. Every component has a compiled preview and a downloadable templ recipe.

What you get

  • 37 composable components for layouts, forms, navigation, feedback, and data.
  • Light, dark, and system color modes with configurable density and typography.
  • Embedded semantic CSS and 24 inline SVG icons.
  • Native interactions, optional bounded CSS motion, and explicit HTMX attributes.

What your application supplies

diff --git a/docs.go b/docs.go index db30cc8..d068048 100644 --- a/docs.go +++ b/docs.go @@ -19,6 +19,7 @@ type guide struct { var guides = []guide{ {"/docs", "Build something thoughtful.", "A practical guide to semantic interfaces with Go, templ, and optional HTMX.", "overview"}, {"/docs/install", "From module to interface.", "Install TendUI, serve its embedded CSS, and render your first page.", "install"}, + {"/docs/html", "Start with HTML. Add your stack.", "Use TendUI with two static files and no build tools.", "html"}, {"/docs/theming", "Make it feel like yours.", "Choose a color mode, compose appearance settings, or override the tokens.", "theming"}, {"/docs/forms", "Forms that work with the browser.", "Native submission first. Validation and persistence belong to your application.", "forms"}, {"/docs/htmx", "Enhance a working page.", "Use optional HTMX attributes with explicit full-page and fragment responses.", "htmx"}, @@ -36,7 +37,7 @@ func registerDocs(mux *http.ServeMux) { } var buf bytes.Buffer navigation := make([]components.NavItem, 0, len(guides)+1) - labels := []string{"Introduction", "Installation", "Appearance", "Forms & validation", "HTMX", "Accessibility", "Deployment", "Examples"} + labels := []string{"Introduction", "Installation", "HTML & CSS", "Appearance", "Forms & validation", "HTMX", "Accessibility", "Deployment", "Examples"} for i, entry := range guides { navigation = append(navigation, components.NavItem{Label: labels[i], Href: entry.Path, Current: entry.Path == g.Path}) } diff --git a/docs/brand-assets.json b/docs/brand-assets.json index 5a5b91a..312b99d 100644 --- a/docs/brand-assets.json +++ b/docs/brand-assets.json @@ -72,6 +72,12 @@ "source": "02_mascot_icons/android-chrome-512x512.png", "bytes": 43943, "processing": "Copied unchanged" + }, + { + "file": "site_header.templ (inline site-source-icon)", + "source": "https://github.com/primer/octicons/blob/main/icons/mark-github-16.svg", + "license": "MIT; docs/licenses/octicons.txt", + "processing": "Original path; currentColor and decorative accessible attributes" } ] } diff --git a/docs/licenses/octicons.txt b/docs/licenses/octicons.txt new file mode 100644 index 0000000..aa1fa80 --- /dev/null +++ b/docs/licenses/octicons.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 GitHub Inc. + +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. diff --git a/go.mod b/go.mod index 25a8623..e9584ec 100644 --- a/go.mod +++ b/go.mod @@ -2,6 +2,6 @@ module github.com/Tend-Stack/TendUI-web go 1.26.0 -require github.com/Tend-Stack/TendUI/v2026 v2026.1.1-0.20261106181325-ede5aa9f4356 +require github.com/Tend-Stack/TendUI/v2026 v2026.2.0-preview.2 require github.com/a-h/templ v0.3.1100 diff --git a/go.sum b/go.sum index 5566048..84b2774 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/Tend-Stack/TendUI/v2026 v2026.1.1-0.20261106181325-ede5aa9f4356 h1:GWQd3atUrkN+9TLZzx/57LAAlePXIQP7AbkbT0fYCec= -github.com/Tend-Stack/TendUI/v2026 v2026.1.1-0.20261106181325-ede5aa9f4356/go.mod h1:zkQFMTpvYR8YsMHiBLfDg8KJdR7Mr9o0Py6y+h7jpws= +github.com/Tend-Stack/TendUI/v2026 v2026.2.0-preview.2 h1:RFz9rLBEzO6vdMQD9ptjoWhu+MpD6nK4/wxgETk18sA= +github.com/Tend-Stack/TendUI/v2026 v2026.2.0-preview.2/go.mod h1:zkQFMTpvYR8YsMHiBLfDg8KJdR7Mr9o0Py6y+h7jpws= github.com/a-h/templ v0.3.1100 h1:lQhjVs1IL+M6QWUvojaFBd21+kzwATppSyWkWB9oHoM= github.com/a-h/templ v0.3.1100/go.mod h1:j1WAOR7749mlo1AxFLQ7qbDFW5VwyoqszRTlKqEHN9M= github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= diff --git a/library-version.json b/library-version.json index afd221f..ac0ffda 100644 --- a/library-version.json +++ b/library-version.json @@ -1,5 +1,5 @@ { "module": "github.com/Tend-Stack/TendUI/v2026", - "version": "v2026.1.1-0.20261106181325-ede5aa9f4356", - "commit": "ede5aa9f4356c6c63754503c7307938a8ca79e9d" + "version": "v2026.2.0-preview.2", + "commit": "02802524a507e706248052a46728160a449d2adf" } diff --git a/main.go b/main.go index 5f4463a..3e352c9 100644 --- a/main.go +++ b/main.go @@ -76,6 +76,11 @@ func handler() http.Handler { demos := site.HandlerWithOptions(demoOptions()) registerDocs(mux) libraryAssets := tendui.AssetHandler() + mux.HandleFunc("/quickstart/tendui.css", func(w http.ResponseWriter, r *http.Request) { + clone := r.Clone(r.Context()) + clone.URL.Path = tendui.StylesheetURL + libraryAssets.ServeHTTP(w, clone) + }) mux.HandleFunc(libraryStylesheetURL, func(w http.ResponseWriter, r *http.Request) { clone := r.Clone(r.Context()) clone.URL.Path = tendui.StylesheetURL @@ -99,6 +104,7 @@ func handler() http.Handler { } }) assetRoutes := []struct{ route, file, contentType string }{ + {"/quickstart/index.html", "quickstart.html", "text/html; charset=utf-8"}, {"/site.css", "site.css", "text/css; charset=utf-8"}, {siteStylesheetURL, "site.css", "text/css; charset=utf-8"}, {docsStylesheetURL, "docs.css", "text/css; charset=utf-8"}, diff --git a/main_test.go b/main_test.go index d924b9b..ea7f8d4 100644 --- a/main_test.go +++ b/main_test.go @@ -84,7 +84,7 @@ func TestProxyPreservesCodeAndCachePolicy(t *testing.T) { t.Errorf("%s: lost cache policy", path) } } - if method == "GET" && path == "/docs/install" && !strings.Contains(w.Body.String(), "TendUI/v2026@main") { + if method == "GET" && path == "/docs/install" && !strings.Contains(w.Body.String(), "TendUI/v2026@v2026.2.0-preview.2") { t.Fatal("release installation command missing") } } diff --git a/site_header.templ b/site_header.templ index ae23475..9407379 100644 --- a/site_header.templ +++ b/site_header.templ @@ -25,7 +25,12 @@ templ siteBrand() { } templ siteSourceLink() { - Source + + + Source + } templ siteHead() { diff --git a/site_header_templ.go b/site_header_templ.go index 45e5341..04d6938 100644 --- a/site_header_templ.go +++ b/site_header_templ.go @@ -103,7 +103,7 @@ func siteSourceLink() templ.Component { } ctx = templ.InitializeContext(ctx) ctx = templ.ClearChildren(ctx) - templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 3, "Source ↗") + templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 3, " Source ↗") if templ_7745c5c3_Err != nil { return templ_7745c5c3_Err } @@ -139,7 +139,7 @@ func siteHead() templ.Component { var templ_7745c5c3_Var6 string templ_7745c5c3_Var6, templ_7745c5c3_Err = templruntime.NewAttributeExpression(templ.SafeURL(headerStylesheetURL)).ResolveURL(ctx) if templ_7745c5c3_Err != nil { - return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 33, Col: 65} + return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 38, Col: 65} } _, templ_7745c5c3_Err = templ_7745c5c3_Buffer.WriteString(templ_7745c5c3_Var6) if templ_7745c5c3_Err != nil { @@ -179,7 +179,7 @@ func siteIcons() templ.Component { var templ_7745c5c3_Var8 string templ_7745c5c3_Var8, templ_7745c5c3_Err = templruntime.NewAttributeExpression(templ.SafeURL(brandURL("favicon.ico"))).ResolveURL(ctx) if templ_7745c5c3_Err != nil { - return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 39, Col: 63} + return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 44, Col: 63} } _, templ_7745c5c3_Err = templ_7745c5c3_Buffer.WriteString(templ_7745c5c3_Var8) if templ_7745c5c3_Err != nil { @@ -192,7 +192,7 @@ func siteIcons() templ.Component { var templ_7745c5c3_Var9 string templ_7745c5c3_Var9, templ_7745c5c3_Err = templruntime.NewAttributeExpression(templ.SafeURL(brandURL("favicon-32.png"))).ResolveURL(ctx) if templ_7745c5c3_Err != nil { - return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 40, Col: 66} + return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 45, Col: 66} } _, templ_7745c5c3_Err = templ_7745c5c3_Buffer.WriteString(templ_7745c5c3_Var9) if templ_7745c5c3_Err != nil { @@ -205,7 +205,7 @@ func siteIcons() templ.Component { var templ_7745c5c3_Var10 string templ_7745c5c3_Var10, templ_7745c5c3_Err = templruntime.NewAttributeExpression(templ.SafeURL(brandURL("favicon.svg"))).ResolveURL(ctx) if templ_7745c5c3_Err != nil { - return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 41, Col: 63} + return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 46, Col: 63} } _, templ_7745c5c3_Err = templ_7745c5c3_Buffer.WriteString(templ_7745c5c3_Var10) if templ_7745c5c3_Err != nil { @@ -218,7 +218,7 @@ func siteIcons() templ.Component { var templ_7745c5c3_Var11 string templ_7745c5c3_Var11, templ_7745c5c3_Err = templruntime.NewAttributeExpression(templ.SafeURL(brandURL("apple-touch-icon.png"))).ResolveURL(ctx) if templ_7745c5c3_Err != nil { - return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 42, Col: 84} + return templ.Error{Err: templ_7745c5c3_Err, FileName: `site_header.templ`, Line: 47, Col: 84} } _, templ_7745c5c3_Err = templ_7745c5c3_Buffer.WriteString(templ_7745c5c3_Var11) if templ_7745c5c3_Err != nil { diff --git a/static/header.css b/static/header.css index b963546..7a22580 100644 --- a/static/header.css +++ b/static/header.css @@ -5,3 +5,6 @@ @media (max-width: 56rem) { .site-version { display: none; } } .site-brand > img { inline-size: 2.5rem; block-size: 2.5rem; object-fit: contain; } + +.site-source-link { display: inline-flex; align-items: center; gap: .5rem; } +.site-source-icon { flex: none; inline-size: 1rem; block-size: 1rem; } diff --git a/static/quickstart.html b/static/quickstart.html new file mode 100644 index 0000000..1255c9b --- /dev/null +++ b/static/quickstart.html @@ -0,0 +1,27 @@ + + + + + + + TendUI with plain HTML + + + +
+

Hello, semantic HTML.

+

No Go runtime, templ generator, Node.js, or JavaScript is needed for this page.

+
+

A card is an article

+

The stylesheet gives ordinary HTML a consistent appearance.

+ + +
+ Does this work without JavaScript? +

Yes. The browser opens this disclosure using native HTML.

+
+ +
+
+ + diff --git a/tests/browser/site.spec.js b/tests/browser/site.spec.js index de1433f..6ca510c 100644 --- a/tests/browser/site.spec.js +++ b/tests/browser/site.spec.js @@ -12,7 +12,7 @@ async function siteNavigation(page) { test('guides, examples, and homepage remain accessible and contained', async ({ page }, testInfo) => { test.setTimeout(180000); - for (const route of ['/', '/docs', '/docs/install', '/docs/theming', '/docs/forms', '/docs/htmx', '/docs/accessibility', '/docs/deploy', '/examples']) { + for (const route of ['/', '/docs', '/docs/install', '/docs/html', '/docs/theming', '/docs/forms', '/docs/htmx', '/docs/accessibility', '/docs/deploy', '/examples']) { const response = await page.goto(route); expect(response.status()).toBe(200); await expect(page.locator('main')).toHaveCount(1); @@ -195,3 +195,21 @@ test('brand icons load on every surface and the taller mascot fits the header', await expect(page.locator('link[rel="manifest"]')).toHaveCount(1); } }); + + +test('HTML onboarding downloads match the working example', async ({ browser, request }) => { + const guide = await request.get('/docs/html'); + expect(guide.status()).toBe(200); + expect(await guide.text()).toContain('v2026.2.0-preview.2'); + const css = await request.get('/quickstart/tendui.css'); + expect(css.status()).toBe(200); + expect(await css.text()).toContain('--tendui-primary'); + const context = await browser.newContext({ javaScriptEnabled: false }); + const page = await context.newPage(); + await page.goto('http://127.0.0.1:8080/quickstart/index.html'); + await expect(page.getByRole('heading', { name: 'Hello, semantic HTML.' })).toBeVisible(); + await page.getByText('Does this work without JavaScript?', { exact: true }).click(); + await expect(page.getByText('Yes. The browser opens this disclosure using native HTML.')).toBeVisible(); + await expect(page.locator('script')).toHaveCount(0); + await context.close(); +}); diff --git a/tools/vendor-library.py b/tools/vendor-library.py index 61858bf..107d9b8 100644 --- a/tools/vendor-library.py +++ b/tools/vendor-library.py @@ -30,7 +30,7 @@ def git(*args): revision = git("rev-parse", "HEAD").decode().strip() stamp = datetime.datetime.fromtimestamp(int(git("show", "-s", "--format=%ct", "HEAD")), datetime.timezone.utc) tags = git("tag", "--points-at", "HEAD").decode().splitlines() -release = next((tag for tag in tags if tag.startswith("v2026.") and "-" not in tag), None) +release = next((tag for tag in tags if re.fullmatch(r"v2026\.[1-9][0-9]*\.[0-9]+(?:-[0-9A-Za-z.-]+)?", tag)), None) if release: version = release else: diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/CODE_OF_CONDUCT.md b/vendor/github.com/Tend-Stack/TendUI/v2026/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..aaa091e --- /dev/null +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/CODE_OF_CONDUCT.md @@ -0,0 +1,19 @@ +# Community code of conduct + +Treat participants with respect regardless of experience, identity or background. +Discuss ideas and code constructively, accept good-faith feedback, and give credit +for other people's work. Respect maintainers' and contributors' time and boundaries. + +Harassment, threats, discriminatory abuse, sexualized conduct, doxxing, and +publication of another person's private information are not acceptable. This +policy applies to repository issues, pull requests and other project-run spaces. + +Report concerns privately to **conduct@tendstack.com**. Include links and relevant +context, avoiding unnecessary personal information. Reports will be handled as +privately as practicable; information may be shared where needed to investigate +or protect participants. No response-time guarantee is promised. + +Maintainers may request changes, remove content, close a discussion, restrict +participation or ban an account depending on the severity and pattern of conduct. +A person involved in a report should not decide its outcome. The reporter or +subject may request reconsideration through the same private contact address. diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/CONTRIBUTING.md b/vendor/github.com/Tend-Stack/TendUI/v2026/CONTRIBUTING.md new file mode 100644 index 0000000..28ab089 --- /dev/null +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/CONTRIBUTING.md @@ -0,0 +1,78 @@ +# Contributing to TendUI + +Thank you for helping improve TendUI. Start with a bug, documentation fix, +accessibility improvement or an issue labeled `good first issue` or `help wanted`. +Discuss new components, public API changes, dependencies and large refactors in an +issue before implementation. A proposal should explain the use case, native HTML +semantics, keyboard behavior, narrow-screen behavior and alternatives considered. + +## Contribution terms: MIT + DCO + +Contributions are submitted under this repository's [MIT license](LICENSE). +You keep your copyright; no copyright assignment or separate CLA is required. +Every non-merge commit must include a sign-off certifying the [Developer +Certificate of Origin 1.1](DCO). Read it before signing. Obtain any employer or +third-party permission needed, retain attribution, and do not submit incompatible +licensed material. The sign-off is a certification, not a cryptographic signature. + +```sh +git commit -s -m "Describe the change" +``` + +Use your own name and the same email as the commit author. A GitHub-provided +noreply address is accepted. Names, commit emails and sign-offs become public +and remain in history. Never add another person's sign-off without authorization. +For your own last commit, use `git commit --amend --signoff`; coordinate with +reviewers before rewriting an already-pushed contribution branch. Maintainers do +not add missing contributor certifications on someone else's behalf. + +AI-assisted contributions follow exactly the same rules: a human contributor +must understand, review and test the result and certify the right to submit it. +Identify significant generated material or reused sources in the PR description. + +## Workflow + +1. Fork the repository and create a focused branch from current `main`. +2. Make the smallest complete change; keep unrelated cleanup separate. +3. Add proportionate tests and update documentation for changed behavior. +4. Regenerate templ output when templates change; commit both source and generated Go. +5. Open a draft PR early when feedback would help. Link the issue and describe validation. +6. Respond to review; maintainers merge after required checks and approval. + +Go 1.26 or newer is required. Template authors use templ v0.3.1100. Node/npm are +only used for optional contributor browser tooling, never the shipped UI. + +```sh +go run ./cmd/tendui-dev check +go run ./cmd/tendui-dev generated +go run ./cmd/tendui-dev recipes +# After committing, verify isolated consumption: +go run ./cmd/tendui-dev consumer +``` + +CI supplies native-platform and browser coverage. Do not claim a check ran when +it did not; explain unavailable checks in the PR. Keep generated test evidence +under ignored `tests/results/` and remove owned disposable artifacts after use. + +## Design and compatibility + +- Semantic HTML and native browser behavior first; no bundled client JavaScript, + remote fonts or runtime asset downloads. +- Keep Go configuration typed. Applications own routing, persistence, sessions, + request protection and any optional HTMX runtime. +- Preserve keyboard access, accessible names, theme behavior and reduced motion. +- Public API changes need an explicit compatibility review and migration notes, + even during preview. Never silently replace old tags. +- Include screenshots for visual changes and narrow-screen checks where relevant. +- Never commit credentials, private infrastructure details, personal datasets or logs. + +## Reviews and releases + +CODEOWNERS identifies the maintainer. External contributions require maintainer +approval, DCO and applicable CI. An administrator may make a documented exception +through a PR; never use an exception to accept an unsigned contributor submission. +Prefer merge commits to preserve contributor sign-offs. Release tags are created +by maintainers after exact-source checks; previews use `YEAR.RELEASE.FIX-preview.N`. + +Report security issues privately using [SECURITY.md](SECURITY.md). Community +participation follows [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/DCO b/vendor/github.com/Tend-Stack/TendUI/v2026/DCO new file mode 100644 index 0000000..49b8cb0 --- /dev/null +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/DCO @@ -0,0 +1,34 @@ +Developer Certificate of Origin +Version 1.1 + +Copyright (C) 2004, 2006 The Linux Foundation and its contributors. + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + + +Developer's Certificate of Origin 1.1 + +By making a contribution to this project, I certify that: + +(a) The contribution was created in whole or in part by me and I + have the right to submit it under the open source license + indicated in the file; or + +(b) The contribution is based upon previous work that, to the best + of my knowledge, is covered under an appropriate open source + license and I have the right under that license to submit that + work with modifications, whether created in whole or in part + by me, under the same open source license (unless I am + permitted to submit under a different license), as indicated + in the file; or + +(c) The contribution was provided directly to me by some other + person who certified (a), (b) or (c) and I have not modified + it. + +(d) I understand and agree that this project and the contribution + are public and that a record of the contribution (including all + personal information I submit with it, including my sign-off) is + maintained indefinitely and may be redistributed consistent with + this project or the open source license(s) involved. diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/HANDOFF.md b/vendor/github.com/Tend-Stack/TendUI/v2026/HANDOFF.md index 0a2b259..3904676 100644 --- a/vendor/github.com/Tend-Stack/TendUI/v2026/HANDOFF.md +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/HANDOFF.md @@ -29,19 +29,16 @@ run `./tests/results/demos/tendui-demo -open` on a host with browser access. ## Release boundary -The historical pre-rename v2026.1.0 candidate at `2f622c95fbf7` passed the six native Go/OS jobs, -the vulnerability scan, and 53 browser checks in Chromium, Firefox and WebKit. -One WebKit forced-color emulation check is explicitly unsupported/skipped. -The documentation website passed all eight desktop/mobile browser checks and -its native/container workflow. See [release verification](docs/release-verification.md) -for exact runs, tag installation evidence and the scope of accessibility review. -Manual screen-reader and physical-device testing remain application-level work; -automated accessibility checks are not a conformance certification. - -Keep focused local test evidence under ignored `tests/results/`. Reuse one -review binary, remove completed disposable build environments, and preserve -active work. Fetch and integrate GitHub `main` before publishing changes. - -The TendUI rename and shared SiteHeader are development changes after that tag. -See [migration notes](docs/tendui-migration.md); historical release evidence is -not validation of these changes. +The current renamed preview is `v2026.2.0-preview.2`. Install that explicit tag; +see [release notes](docs/releases/2026.2.0-preview.2.md) and +[quickstarts](docs/quickstart.md). +Historical pre-rename tags and evidence remain immutable and are clearly labeled. + +Require passing native Go/OS, security and browser CI on the preview source. +The release workflow must also prove installation from the published Git tag, +separately from the local file-proxy packaging check. Automated accessibility +checks do not constitute a screen-reader or physical-device conformance review. + +Keep focused evidence under ignored `tests/results/`; fetch and integrate +GitHub `main` before publishing. Private infrastructure references remain in +older library history, so review publication separately before changing visibility. diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/README.md b/vendor/github.com/Tend-Stack/TendUI/v2026/README.md index aa747c3..15e10b1 100644 --- a/vendor/github.com/Tend-Stack/TendUI/v2026/README.md +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/README.md @@ -28,14 +28,12 @@ runtime. The asset package imports only the standard library; the components have one direct Go dependency, templ. It is not a literally dependency-free module, and this version does not support Go 1.21. -The renamed TendUI module is currently available from the development branch: +Install the pinned TendUI preview (API changes remain possible before a stable release): ```sh -go get github.com/Tend-Stack/TendUI/v2026@main +go get github.com/Tend-Stack/TendUI/v2026@v2026.2.0-preview.2 ``` -The GitHub repository is currently private. Until that changes, Go downloads -require repository credentials and `GOPRIVATE=github.com/Tend-Stack/TendUI`. Generated `*_templ.go` files ship with the module, so consumers do not need the templ CLI to use these components from Go. @@ -70,6 +68,10 @@ func main() { } ``` +For a complete, tested Go/templ application, see [the quickstart](docs/quickstart.md) +and [`examples/quickstart`](examples/quickstart). To use CSS with any stack, see +[the plain HTML example](examples/html); Go and templ are optional for that path. + Run the local demos, including a component playground, form lab, dashboard, appearance editor, workspace, native interactions, inline editing, motion and surfaces, and theme endpoint: @@ -521,20 +523,20 @@ The checked-in declaration baseline catches changed props, constants, signatures and method sets. See [API review and migration](docs/api-compatibility.md) for intentional updates and the limits of this check. -The [CI matrix](docs/ci.md) passed native verification on Linux, macOS and -Windows with Go 1.26.0 and 1.27.3, together with the vulnerability scan, at the -v2026.1.0 release commit. Chromium, Firefox and WebKit passed 53 browser checks; -one unsupported WebKit forced-color emulation check was skipped. See -[release verification](docs/release-verification.md) for exact evidence and limits. +The [CI matrix](docs/ci.md) checks native Linux, macOS and Windows with Go 1.26.0 +and 1.27.3, plus a vulnerability scan. Browser checks cover Chromium, Firefox and +WebKit. These jobs must pass on the preview source; see +[preview release notes](docs/releases/2026.2.0-preview.2.md). The older +[release verification](docs/release-verification.md) documents the pre-rename +release only and is not evidence for the current preview. -Versions follow `YEAR.RELEASE.FIX` (initial line: `2026.1.0`). Development builds -embed the Git development identifier; uncommitted work is marked dirty. +Versions follow `YEAR.RELEASE.FIX`, with SemVer prerelease suffixes for previews: +`v2026.2.0-preview.2`. Install the explicit tag; a preview is not a stable API promise. +Development builds use `git describe --tags --long --dirty`. Go treats 2026 as the semantic major version, so the module path ends in -`/v2026`. This is required for the `v2026.1.0` tag to resolve correctly. -A new annual line such as 2027 will need `/v2027` and consumer import updates; -fixes on the 2026 line keep `/v2026`. See Go's -[major version rules](https://go.dev/doc/modules/major-version). +`/v2026`. A new annual line such as 2027 will need `/v2027` and consumer import +updates. Fixes and previews on the 2026 line retain `/v2026`. ## Project links @@ -547,3 +549,9 @@ current development entry points and remaining release checks. ## License MIT. See [LICENSE](LICENSE). + +## Contributing + +See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, review and MIT + DCO sign-off. +Report vulnerabilities privately using [SECURITY.md](SECURITY.md); community +participation follows [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/ROADMAP.md b/vendor/github.com/Tend-Stack/TendUI/v2026/ROADMAP.md index 268c79f..28ed687 100644 --- a/vendor/github.com/Tend-Stack/TendUI/v2026/ROADMAP.md +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/ROADMAP.md @@ -28,7 +28,7 @@ inline editing with native fallback; short CSS motion; card surfaces; loading, empty and metric states; reusable DataTable with native selection review; page tabs, step indicators and grouped disclosures; composable fields/input addons; a native three-step form with final revalidation; and a searchable catalog -covering all 36 public templ components with compiled/downloadable recipes. +covering all 37 public templ components with compiled/downloadable recipes. The Icon component includes 24 original inline SVG drawings and optional button/link adornments with explicit accessible naming for icon-only actions. A bounded CSV upload preview exercises native multipart forms and Go validation @@ -41,11 +41,11 @@ generated-source reproducibility and independent catalog recipe compilation. It records rendering/HTTP benchmarks and enforces CSS/demo size budgets, with Git version stamping and checked atomic replacement of the review executable. See docs/development.md and docs/performance.md for current evidence and limits. -A compiler-resolved public API baseline now guards 242 declarations/method-set +A compiler-resolved public API baseline now guards 246 declarations/method-set entries across the three public packages. It flags additions and changes for review without claiming semantic compatibility; docs/api-compatibility.md defines the update and migration process. -A six-job GitHub verification matrix is prepared for Go 1.26.0/1.27.3 on Linux, +A six-job GitHub verification matrix is configured for Go 1.26.0/1.27.3 on Linux, macOS and Windows. Local native Linux checks pass on both Go versions, including the minimum compiler's API, consumer installation and executable smoke checks. Foreign-target builds pass; GitHub runs the native matrix for pushed source. @@ -67,10 +67,11 @@ Expanded asset HTTP coverage verifies content-derived ETags, stale validators, HEAD, single/multipart ranges and concurrent readers. docs/assets.md records the stable-URL cache contract and distinguishes in-process checks from live delivery. -The first release baseline now has a complete documentation website, shared +The current preview has a complete documentation website, shared component catalog, examples and playground, plus passing native, security and browser verification. See [release verification](docs/release-verification.md) -for exact commits, runs, published-tag installation and remaining coverage limits. +for historical pre-rename evidence. Current preview details are in +[preview release notes](docs/releases/2026.2.0-preview.2.md). The development tracks below describe continuing product work beyond this baseline. ## Next development tracks @@ -97,8 +98,8 @@ The development tracks below describe continuing product work beyond this baseli also in place. Next: release-specific migration guidance and broader consumer compatibility evidence. Keep demos runnable from one binary. 5. **Evidence and release.** Local benchmarks, asset/binary size budgets and - generated-source consistency checks are implemented. Next: browser matrix - and visual regression baselines; keyboard/screen-reader/contrast checks; + generated-source consistency checks are implemented. The browser matrix is implemented. Next: stable visual regression baselines + and manual screen-reader/device checks; passing GitHub CI at the release SHA; versioned release documentation and installation proof. Table allocation profiling and the first optimization are complete; profile representative application work diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/SECURITY.md b/vendor/github.com/Tend-Stack/TendUI/v2026/SECURITY.md new file mode 100644 index 0000000..e394653 --- /dev/null +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/SECURITY.md @@ -0,0 +1,14 @@ +# Security policy + +Email **security@tendstack.com** privately with suspected vulnerabilities. Include +version/commit, affected component, a minimal reproduction and the likely impact. +Do not open a public issue, attach production credentials or include real user data. +We will coordinate disclosure and a fix with the reporter; no response-time SLA +is promised during preview. Sanitized examples are preferable to sensitive logs. + +Security fixes currently target the latest TendUI preview. Historical pre-rename +versions are not an actively supported security line. Applications remain +responsible for authentication, request protection and their Go dependencies. + +If GitHub private vulnerability reporting is enabled for the repository, its +“Report a vulnerability” form is also an appropriate private channel. diff --git a/vendor/github.com/Tend-Stack/TendUI/v2026/tendui.go b/vendor/github.com/Tend-Stack/TendUI/v2026/tendui.go index 7e4a2e4..84d47ec 100644 --- a/vendor/github.com/Tend-Stack/TendUI/v2026/tendui.go +++ b/vendor/github.com/Tend-Stack/TendUI/v2026/tendui.go @@ -16,7 +16,7 @@ const ( // StylesheetURL is the stylesheet used by components.Layout. StylesheetURL = AssetPath + "tendui.css" // Version identifies the current release line; development binaries should use git describe. - Version = "2026.1.0" + Version = "2026.2.0-preview.2" ) //go:embed static diff --git a/vendor/modules.txt b/vendor/modules.txt index 28bf41f..014a02e 100644 --- a/vendor/modules.txt +++ b/vendor/modules.txt @@ -1,4 +1,4 @@ -# github.com/Tend-Stack/TendUI/v2026 v2026.1.1-0.20261106181325-ede5aa9f4356 +# github.com/Tend-Stack/TendUI/v2026 v2026.2.0-preview.2 ## explicit; go 1.26.0 github.com/Tend-Stack/TendUI/v2026 github.com/Tend-Stack/TendUI/v2026/components