daisy-cotton 0.1.0__tar.gz

daisy_cotton-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Temporary and binary files
+*~
+*.ruff_cache
+*.mypy_cache
+*.py[cod]
+*.so
+*.cfg
+!.isort.cfg
+!setup.cfg
+*.orig
+*.log
+*.pot
+**/__pycache__
+.cache/*
+.*.swp
+*/.ipynb_checkpoints/*
+.DS_Store
+.vscode/
+.github/instructions/
+docs/api/
+
+# Unittest and coverage
+htmlcov
+.coverage
+.coverage.*
+.tox
+junit*.xml
+coverage.xml
+.pytest_cache/
+
+# Build and docs folder/files
+build/*
+dist/*
+sdist/*
+docs/_rst/*
+docs/_build/*
+cover/*
+MANIFEST
+
+# Per-project virtualenvs
+.venv*/
+.conda*/
+.python-version
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+media/
+/static/
+/*.sqlite3
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+dist

daisy_cotton-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Samuel Jennings
+
+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.

daisy_cotton-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.5
+Name: daisy-cotton
+Version: 0.1.0
+Summary: Base daisyUI-styled django-cotton components: buttons, inputs, cards, alerts and the rest of an application's furniture
+Project-URL: Homepage, https://github.com/SamuelJennings/daisy-cotton
+Project-URL: Repository, https://github.com/SamuelJennings/daisy-cotton
+Project-URL: Issues, https://github.com/SamuelJennings/daisy-cotton/issues
+Author-email: Samuel Jennings <samuel.scott.jennings@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: components,cotton,daisyui,django,tailwind
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: <4.0,>=3.12
+Requires-Dist: django-cotton>=2.6
+Requires-Dist: django>=5.2
+Description-Content-Type: text/markdown
+
+# daisy-cotton
+
+[![Tests](https://github.com/SamuelJennings/daisy-cotton/actions/workflows/tests.yml/badge.svg)](https://github.com/SamuelJennings/daisy-cotton/actions/workflows/tests.yml) [![Coverage](https://codecov.io/gh/SamuelJennings/daisy-cotton/branch/main/graph/badge.svg)](https://codecov.io/gh/SamuelJennings/daisy-cotton) ![Python 3.12 | 3.13](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue) ![Django 5.2 | 6.0 | 6.1](https://img.shields.io/badge/django-5.2%20%7C%206.0%20%7C%206.1-blue) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/SamuelJennings/daisy-cotton/blob/main/LICENSE)
+
+Base daisyUI-styled django-cotton components: buttons, inputs, cards, alerts and the rest of an application's furniture
+
+Built on [daisyUI](https://daisyui.com/) and [django-cotton](https://django-cotton.com/). A project that wants daisyUI-styled Cotton components depends on this package directly: install it, add it to `INSTALLED_APPS`, and each `<c-name>` tag is ready to use. It carries no settings, no menus, no icon registry and no views of its own — see [Scope & philosophy](https://github.com/SamuelJennings/daisy-cotton#scope--philosophy).
+
+## Status
+
+Version 0.0.1, pre-1.0: names, attributes and the set of classes a component emits can change between minor versions. The [CHANGELOG](https://github.com/SamuelJennings/daisy-cotton/blob/main/CHANGELOG.md) is how a project finds out what has landed.
+
+Eighty-two components are built so far: `accordion`, `alert`, `avatar`, `badge`, `breadcrumbs`, `button`, `card`, `carousel`, `chat`, `collapse`, `countdown`, `diff`, `divider`, `dock`, `drawer`, `dropdown`, `fab`, `footer`, `form.calendar`, `form.checkbox`, `form.fieldset`, `form.file-input`, `form.filter`, `form.input`, `form.label`, `form.otp`, `form.radio`, `form.range`, `form.rating`, `form.select`, `form.textarea`, `form.toggle`, `hero`, `hover-3d`, `hover-gallery`, `icon`, `indicator`, `join`, `kbd`, `link`, `list`, `loading`, `mask`, `megamenu`, `menu`, `modal`, `navbar`, `progress`, `radial-progress`, `skeleton`, `stack`, `stat`, `status`, `steps`, `swap`, `table`, `tabs`, `text-rotate`, `timeline`, `toast`, `tooltip` and `mockup.*`. Pagination has no component: daisyUI builds it from `join` and `btn` and gives it no class of its own, so write it with those two. Aura has no component either: it only decorates another element, so wrap the component to highlight in a `<div class="aura">` with daisyUI's style and size classes. Each one is documented live in the component gallery (`python manage.py runserver` from a checkout). More land as the need arises.
+
+`<c-icon>` renders `name` as a literal CSS class string and resolves nothing itself — a project wanting name-based icon resolution provides its own override (see [docs/adr/0001](https://github.com/SamuelJennings/daisy-cotton/blob/main/docs/adr/0001-icon-is-an-extension-point.md)).
+
+`<c-alert>` takes `variant` (info, success, warning, error), `soft`/`outline`/`dash` for style, and `horizontal`/`vertical` for direction, each accepting a breakpoint such as `sm`; a caller-given `role` replaces the default `role="alert"`, so `role="status"` gives a polite announcement instead of an interruption. Its icon and dismiss button are drawn by `<c-icon>` and `<c-button>`; the dismiss button's accessible name is the translatable "Dismiss" with its glyph hidden from assistive technology. `dismissible` and `delay` need [Alpine.js](https://alpinejs.dev/) on the page — this package doesn't ship or load it. Without Alpine, the alert still renders and reads fine, but the dismiss button does nothing and `delay` never fires.
+
+`<c-toast>` pins its content to a corner or edge of the screen and has no role or live region of its own, so put alerts inside it and each keeps its own. A project rendering Django's messages framework writes:
+
+```django
+<c-toast placement="top end">
+  {% for message in messages %}
+    <c-alert variant="{{ message.level_tag }}" dismissible>{{ message }}</c-alert>
+  {% endfor %}
+</c-toast>
+```
+
+Django's `debug` level tag has no matching alert colour, so a debug message falls back to the plain alert.
+
+## Requirements
+
+- Python 3.12+
+- Django 5.2, 6.0 or 6.1
+- django-cotton 2.6+
+- daisyUI 5, loaded by the project
+
+daisyUI is a hard requirement and this package does not ship it. Any project already running daisyUI satisfies it, through whatever Tailwind build the project already has.
+
+## Install
+
+```bash
+pip install daisy-cotton
+```
+
+Add it to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...,
+    "django_cotton",
+    "daisy_cotton",
+]
+```
+
+## Usage
+
+Each component is a Cotton tag named after its daisyUI component, configured through attributes that use daisyUI's own modifier names:
+
+```html
+<c-card title="Storage" border>
+  Almost full.
+  <c-slot name="actions">
+    <c-button variant="primary" size="sm" text="Upgrade" />
+  </c-slot>
+</c-card>
+```
+
+Classes passed with `class` are added to the component's own, and any other attribute passes through to its root element.
+
+## Calendar
+
+`<c-form.calendar>` writes Cally's `<calendar-date>` element, or `<calendar-range>` with `range`, carrying daisyUI's `cally` class. It shows nothing until the project loads Cally, and this package does not. Add the module script to the page's head, pinning the version you have tested or hosting the file yourself:
+
+```html
+<script type="module" src="https://unpkg.com/cally@0.9.2"></script>
+```
+
+Cally's own attributes (`value`, `min`, `max`, `locale`, `first-day-of-week`) go on the tag and reach the calendar unchanged, `months="2"` shows two months side by side, and `class` is added to the calendar's own. The previous and next buttons hold an icon drawn by `<c-icon>` and a visually hidden name, so pass icon classes through `previous_icon` and `next_icon` unless your project's `<c-icon>` resolves names:
+
+```html
+<c-form.calendar id="delivery-calendar" min="2026-09-01" previous_icon="bi bi-chevron-left" next_icon="bi bi-chevron-right" />
+<input type="hidden" name="delivery_date" id="delivery-date">
+```
+
+Cally does not write to a form itself. Its `change` event carries the chosen date in the calendar's `value`, so a few lines of script copy it into the hidden input:
+
+```html
+<script>
+  document.getElementById("delivery-calendar").addEventListener("change", (event) => {
+    document.getElementById("delivery-date").value = event.target.value;
+  });
+</script>
+```
+
+For a range the same `value` is the two dates joined with a slash, such as `2026-09-01/2026-09-07`.
+
+## Scope & philosophy
+
+**What this is.** One Cotton component for each base daisyUI component, and nothing else. A component that daisyUI builds out of other components, or a class that only modifies another component, gets no Cotton component of its own. The validator is one such class: add it to a control through its `class`, or to the OTP's input through `input_class`. Everything here is presentation: templates configured through attributes and themed by whatever daisyUI theme the project runs.
+
+**What this deliberately is not.**
+
+- **Not an application shell.** No settings, no menu system, no icon registry, no views.
+- **Not page-level layout.** The `hero` container ships, but composed hero sections (the heading, copy and calls to action inside it) and other page sections stay with the project, built from these components.
+- **Not a CSS framework.** daisyUI, its themes and Tailwind's preflight come from the project.
+- **Not a JavaScript layer.** The package ships no scripts. A project that wants behaviour daisyUI's CSS doesn't give, such as smarter dropdown placement, adds it by overriding the component. The calendar is the one component that needs a script to show anything: it is drawn by [Cally](https://github.com/WickyNilliams/cally), which the project loads itself (see [Calendar](#calendar)).
+- **Not coupled to Django objects.** Components take plain values. Wiring one up to a form, a paginator or the messages framework is the project's job.
+- **Not shaped for any particular project.** Nothing here exists because one adopter needed it.
+
+**Tie-breaks.** When two of these pull against each other:
+
+1. Following daisyUI beats convenience. A component's attributes use daisyUI's own names for its modifiers rather than a friendlier parallel vocabulary.
+2. Leaving it to the project beats doing it here. If only some adopters need it, they get it by overriding the component.
+3. Fewer attributes beat more. Anything a component doesn't need to decide passes straight through to the markup.
+
+## Prior art
+
+[labbhq/labb](https://github.com/labbhq/labb) is an actively maintained django-cotton + daisyUI 5 component library covering similar ground. It is a batteries-included framework — its own CLI, reactivity layer, icon system and project scaffolder — rather than a thin base layer, and daisy-cotton's purpose here is narrower: a dependency-free set of base primitives a project drops in alongside its own choices. See [docs/brainstorm.md](https://github.com/SamuelJennings/daisy-cotton/blob/main/docs/brainstorm.md) for the fuller reasoning.
+
+## Contributing
+
+To set up a checkout, open the component gallery, run the checks or add a component, see [CONTRIBUTING](https://github.com/SamuelJennings/daisy-cotton/blob/main/CONTRIBUTING.md).
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/SamuelJennings/daisy-cotton/blob/main/CHANGELOG.md).
+
+## License
+
+MIT. See [LICENSE](https://github.com/SamuelJennings/daisy-cotton/blob/main/LICENSE).

daisy_cotton-0.1.0/README.md

@@ -0,0 +1,131 @@
+# daisy-cotton
+
+[![Tests](https://github.com/SamuelJennings/daisy-cotton/actions/workflows/tests.yml/badge.svg)](https://github.com/SamuelJennings/daisy-cotton/actions/workflows/tests.yml) [![Coverage](https://codecov.io/gh/SamuelJennings/daisy-cotton/branch/main/graph/badge.svg)](https://codecov.io/gh/SamuelJennings/daisy-cotton) ![Python 3.12 | 3.13](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue) ![Django 5.2 | 6.0 | 6.1](https://img.shields.io/badge/django-5.2%20%7C%206.0%20%7C%206.1-blue) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/SamuelJennings/daisy-cotton/blob/main/LICENSE)
+
+Base daisyUI-styled django-cotton components: buttons, inputs, cards, alerts and the rest of an application's furniture
+
+Built on [daisyUI](https://daisyui.com/) and [django-cotton](https://django-cotton.com/). A project that wants daisyUI-styled Cotton components depends on this package directly: install it, add it to `INSTALLED_APPS`, and each `<c-name>` tag is ready to use. It carries no settings, no menus, no icon registry and no views of its own — see [Scope & philosophy](https://github.com/SamuelJennings/daisy-cotton#scope--philosophy).
+
+## Status
+
+Version 0.0.1, pre-1.0: names, attributes and the set of classes a component emits can change between minor versions. The [CHANGELOG](https://github.com/SamuelJennings/daisy-cotton/blob/main/CHANGELOG.md) is how a project finds out what has landed.
+
+Eighty-two components are built so far: `accordion`, `alert`, `avatar`, `badge`, `breadcrumbs`, `button`, `card`, `carousel`, `chat`, `collapse`, `countdown`, `diff`, `divider`, `dock`, `drawer`, `dropdown`, `fab`, `footer`, `form.calendar`, `form.checkbox`, `form.fieldset`, `form.file-input`, `form.filter`, `form.input`, `form.label`, `form.otp`, `form.radio`, `form.range`, `form.rating`, `form.select`, `form.textarea`, `form.toggle`, `hero`, `hover-3d`, `hover-gallery`, `icon`, `indicator`, `join`, `kbd`, `link`, `list`, `loading`, `mask`, `megamenu`, `menu`, `modal`, `navbar`, `progress`, `radial-progress`, `skeleton`, `stack`, `stat`, `status`, `steps`, `swap`, `table`, `tabs`, `text-rotate`, `timeline`, `toast`, `tooltip` and `mockup.*`. Pagination has no component: daisyUI builds it from `join` and `btn` and gives it no class of its own, so write it with those two. Aura has no component either: it only decorates another element, so wrap the component to highlight in a `<div class="aura">` with daisyUI's style and size classes. Each one is documented live in the component gallery (`python manage.py runserver` from a checkout). More land as the need arises.
+
+`<c-icon>` renders `name` as a literal CSS class string and resolves nothing itself — a project wanting name-based icon resolution provides its own override (see [docs/adr/0001](https://github.com/SamuelJennings/daisy-cotton/blob/main/docs/adr/0001-icon-is-an-extension-point.md)).
+
+`<c-alert>` takes `variant` (info, success, warning, error), `soft`/`outline`/`dash` for style, and `horizontal`/`vertical` for direction, each accepting a breakpoint such as `sm`; a caller-given `role` replaces the default `role="alert"`, so `role="status"` gives a polite announcement instead of an interruption. Its icon and dismiss button are drawn by `<c-icon>` and `<c-button>`; the dismiss button's accessible name is the translatable "Dismiss" with its glyph hidden from assistive technology. `dismissible` and `delay` need [Alpine.js](https://alpinejs.dev/) on the page — this package doesn't ship or load it. Without Alpine, the alert still renders and reads fine, but the dismiss button does nothing and `delay` never fires.
+
+`<c-toast>` pins its content to a corner or edge of the screen and has no role or live region of its own, so put alerts inside it and each keeps its own. A project rendering Django's messages framework writes:
+
+```django
+<c-toast placement="top end">
+  {% for message in messages %}
+    <c-alert variant="{{ message.level_tag }}" dismissible>{{ message }}</c-alert>
+  {% endfor %}
+</c-toast>
+```
+
+Django's `debug` level tag has no matching alert colour, so a debug message falls back to the plain alert.
+
+## Requirements
+
+- Python 3.12+
+- Django 5.2, 6.0 or 6.1
+- django-cotton 2.6+
+- daisyUI 5, loaded by the project
+
+daisyUI is a hard requirement and this package does not ship it. Any project already running daisyUI satisfies it, through whatever Tailwind build the project already has.
+
+## Install
+
+```bash
+pip install daisy-cotton
+```
+
+Add it to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...,
+    "django_cotton",
+    "daisy_cotton",
+]
+```
+
+## Usage
+
+Each component is a Cotton tag named after its daisyUI component, configured through attributes that use daisyUI's own modifier names:
+
+```html
+<c-card title="Storage" border>
+  Almost full.
+  <c-slot name="actions">
+    <c-button variant="primary" size="sm" text="Upgrade" />
+  </c-slot>
+</c-card>
+```
+
+Classes passed with `class` are added to the component's own, and any other attribute passes through to its root element.
+
+## Calendar
+
+`<c-form.calendar>` writes Cally's `<calendar-date>` element, or `<calendar-range>` with `range`, carrying daisyUI's `cally` class. It shows nothing until the project loads Cally, and this package does not. Add the module script to the page's head, pinning the version you have tested or hosting the file yourself:
+
+```html
+<script type="module" src="https://unpkg.com/cally@0.9.2"></script>
+```
+
+Cally's own attributes (`value`, `min`, `max`, `locale`, `first-day-of-week`) go on the tag and reach the calendar unchanged, `months="2"` shows two months side by side, and `class` is added to the calendar's own. The previous and next buttons hold an icon drawn by `<c-icon>` and a visually hidden name, so pass icon classes through `previous_icon` and `next_icon` unless your project's `<c-icon>` resolves names:
+
+```html
+<c-form.calendar id="delivery-calendar" min="2026-09-01" previous_icon="bi bi-chevron-left" next_icon="bi bi-chevron-right" />
+<input type="hidden" name="delivery_date" id="delivery-date">
+```
+
+Cally does not write to a form itself. Its `change` event carries the chosen date in the calendar's `value`, so a few lines of script copy it into the hidden input:
+
+```html
+<script>
+  document.getElementById("delivery-calendar").addEventListener("change", (event) => {
+    document.getElementById("delivery-date").value = event.target.value;
+  });
+</script>
+```
+
+For a range the same `value` is the two dates joined with a slash, such as `2026-09-01/2026-09-07`.
+
+## Scope & philosophy
+
+**What this is.** One Cotton component for each base daisyUI component, and nothing else. A component that daisyUI builds out of other components, or a class that only modifies another component, gets no Cotton component of its own. The validator is one such class: add it to a control through its `class`, or to the OTP's input through `input_class`. Everything here is presentation: templates configured through attributes and themed by whatever daisyUI theme the project runs.
+
+**What this deliberately is not.**
+
+- **Not an application shell.** No settings, no menu system, no icon registry, no views.
+- **Not page-level layout.** The `hero` container ships, but composed hero sections (the heading, copy and calls to action inside it) and other page sections stay with the project, built from these components.
+- **Not a CSS framework.** daisyUI, its themes and Tailwind's preflight come from the project.
+- **Not a JavaScript layer.** The package ships no scripts. A project that wants behaviour daisyUI's CSS doesn't give, such as smarter dropdown placement, adds it by overriding the component. The calendar is the one component that needs a script to show anything: it is drawn by [Cally](https://github.com/WickyNilliams/cally), which the project loads itself (see [Calendar](#calendar)).
+- **Not coupled to Django objects.** Components take plain values. Wiring one up to a form, a paginator or the messages framework is the project's job.
+- **Not shaped for any particular project.** Nothing here exists because one adopter needed it.
+
+**Tie-breaks.** When two of these pull against each other:
+
+1. Following daisyUI beats convenience. A component's attributes use daisyUI's own names for its modifiers rather than a friendlier parallel vocabulary.
+2. Leaving it to the project beats doing it here. If only some adopters need it, they get it by overriding the component.
+3. Fewer attributes beat more. Anything a component doesn't need to decide passes straight through to the markup.
+
+## Prior art
+
+[labbhq/labb](https://github.com/labbhq/labb) is an actively maintained django-cotton + daisyUI 5 component library covering similar ground. It is a batteries-included framework — its own CLI, reactivity layer, icon system and project scaffolder — rather than a thin base layer, and daisy-cotton's purpose here is narrower: a dependency-free set of base primitives a project drops in alongside its own choices. See [docs/brainstorm.md](https://github.com/SamuelJennings/daisy-cotton/blob/main/docs/brainstorm.md) for the fuller reasoning.
+
+## Contributing
+
+To set up a checkout, open the component gallery, run the checks or add a component, see [CONTRIBUTING](https://github.com/SamuelJennings/daisy-cotton/blob/main/CONTRIBUTING.md).
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/SamuelJennings/daisy-cotton/blob/main/CHANGELOG.md).
+
+## License
+
+MIT. See [LICENSE](https://github.com/SamuelJennings/daisy-cotton/blob/main/LICENSE).

daisy_cotton-0.1.0/daisy_cotton/__init__.py

@@ -0,0 +1,3 @@
+"""Base daisyUI-styled django-cotton components."""
+
+__version__ = "0.0.1"

daisy_cotton-0.1.0/daisy_cotton/apps.py

@@ -0,0 +1,12 @@
+"""App configuration for daisy-cotton."""
+
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class DaisyCottonConfig(AppConfig):
+    """Django app config for the daisy-cotton component library."""
+
+    name = "daisy_cotton"
+    label = "daisy_cotton"
+    verbose_name = _("Daisy Cotton components")

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/accordion.html

@@ -0,0 +1,7 @@
+{# @description A collapse used as an accordion item: items sharing a name form one group where opening one closes the others. In a browser without grouped <details> support, more than one item can stay open; give at most one item per group open. Accepts every collapse attribute and slot (arrow, plus, open, class, the title slot). See the card's gallery entry for a working group. #}
+{# @prop name:text | required | description:"Group name. Items sharing one form an exclusive group; an item given no name is not part of a group." #}
+{# @prop title:text | description:"Heading text, re-passed as the collapse's title slot. A title is expected: leaving both this and the title slot empty renders an unnamed control, an empty summary. Fill the title slot instead for rich content." #}
+{# @slot A short answer. — The item's content, forwarded to the collapse. #}
+{# @slot:title — A heading in place of the title attribute, for rich content such as an icon or badge. #}
+<c-vars name="" title="" />
+<c-collapse name="{{ name }}" :attrs="attrs">{% if title %}<c-slot name="title">{{ title }}</c-slot>{% endif %}{{ slot }}</c-collapse>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/alert.html

@@ -0,0 +1,23 @@
+{# @description A message banner for the result of an action, with an optional icon and an optional dismiss button. dismissible and delay both need Alpine.js on the page. Avoid delay on errors or on anything the reader must act on — the message can disappear before they've read it. See the toast entry for an alert shown with an icon and a dismissible alert. #}
+{# @prop variant:select['info','success','warning','error'] | description:"Colour variant. Also picks the icon when none is given." #}
+{# @prop icon:text | description:"Icon shown before the message, passed as the name of the icon component. Defaults to an icon named after variant." #}
+{# @prop soft:boolean | description:"Use the soft style." #}
+{# @prop outline:boolean | description:"Draw the alert as an outline." #}
+{# @prop dash:boolean | description:"Use a dashed border." #}
+{# @prop horizontal:select['sm','md','lg','xl','2xl'] | description:"Lay the alert out horizontally. The bare attribute applies it at every width, which this select cannot set." #}
+{# @prop vertical:select['sm','md','lg','xl','2xl'] | description:"Stack the alert vertically. The bare attribute applies it at every width, which this select cannot set." #}
+{# @prop dismissible:boolean | description:"Add a dismiss button that hides the alert." #}
+{# @prop delay:number | description:"Milliseconds before a dismissible alert hides itself." #}
+{# @prop role:text | default:"alert" | description:"Interrupts a screen reader by default. Pass role=\"status\" for a message that should be announced politely." #}
+{# @prop class:text | description:"Extra classes added to the alert." #}
+{# @slot Saved. — The alert message. #}
+{% load i18n daisy_cotton %}
+<c-vars variant="" icon="" soft="" outline="" dash="" horizontal="" vertical="" dismissible="" delay="" role="alert" class="" />
+{% trans "Dismiss" as dismiss_label %}
+{# djlint:off #}
+<div role="{{ role }}" class="alert {% variation variant "alert" "info,success,warning,error" %}{% if soft %} alert-soft{% endif %}{% if outline %} alert-outline{% endif %}{% if dash %} alert-dash{% endif %} {% responsive horizontal "alert-horizontal" %} {% responsive vertical "alert-vertical" %} {{ class }}"{% if dismissible %} x-data="{ show: true }" x-show="show" x-transition{% with ms=delay|add:0 %}{% if ms != "" %} x-init="setTimeout(() => show = false, {{ ms }})"{% endif %}{% endwith %}{% endif %} {{ attrs }}>
+  {% if icon %}<c-icon name="{{ icon }}" class="" aria-hidden="true" />{% elif variant %}<c-icon name="{{ variant }}" class="" aria-hidden="true" />{% endif %}
+  {{ slot }}
+  {% if dismissible %}<c-button type="button" ghost size="xs" circle x-on:click="show = false" aria-label="{{ dismiss_label }}"><span aria-hidden="true">✕</span></c-button>{% endif %}
+</div>
+{# djlint:on #}

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/avatar/group.html

@@ -0,0 +1,5 @@
+{# @description A row of overlapping avatars. #}
+{# @prop class:text | description:"Extra classes added to the group, such as the overlap (for example -space-x-6, as daisyUI's examples use). This is Tailwind's own class, so it needs the project's Tailwind build to see it, like any class a caller writes." #}
+{# @slot <c-avatar src="..." alt="Ada Lovelace" content_class="w-12 rounded-full" /><c-avatar placeholder="BM" content_class="w-16 rounded-xl" /><c-avatar content_class="w-10 rounded" /> — Several avatar widths and shapes: one photo, one placeholder, one silhouette. #}
+<c-vars class="" />
+<div class="avatar-group {{ class }}" {{ attrs }}>{{ slot }}</div>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/avatar/index.html

@@ -0,0 +1,29 @@
+{# @description daisyUI's avatar: a photo, initials, or a silhouette when neither is given, with an optional online or offline indicator. Give alt when the avatar is the only thing identifying the person — beside a name it is usually noise. Width, shape and placeholder colour go through content_class, not a size or variant attribute. #}
+{# @prop src:text | description:"URL of a profile photo. Falls back to placeholder text, then to a silhouette. This package resolves no URL itself; pass the resolved URL in." #}
+{# @prop alt:text | description:"Alt text of the photo. Leave empty unless the avatar is the only thing identifying the person." #}
+{# @prop placeholder:text | description:"Initials or short text shown when there is no src." #}
+{# @prop online:boolean | description:"Presence indicator: avatar-online." #}
+{# @prop offline:boolean | description:"Presence indicator: avatar-offline." #}
+{# @prop content_class:text | description:"Extra classes for the image frame, replacing the w-12 rounded-full default (plus bg-neutral text-neutral-content with no src) entirely. Sets the avatar's width and shape." #}
+{# @prop class:text | description:"Extra classes added to the avatar." #}
+<c-vars src="" alt="" placeholder="" online="" offline="" content_class="" class="" />
+<div class="avatar{% if not src %} avatar-placeholder{% endif %}{% if online %} avatar-online{% endif %}{% if offline %} avatar-offline{% endif %} {{ class }}"
+     {{ attrs }}>
+  <div class="{% if content_class %}{{ content_class }}{% else %}w-12 rounded-full{% if not src %} bg-neutral text-neutral-content{% endif %}{% endif %}">
+    {% if src %}
+      <img src="{{ src }}" alt="{{ alt }}" />
+    {% elif placeholder %}
+      <span>{{ placeholder }}</span>
+    {% else %}
+      <svg xmlns="http://www.w3.org/2000/svg"
+           width="80%"
+           height="80%"
+           fill="currentColor"
+           viewBox="0 0 16 16"
+           aria-hidden="true"
+           focusable="false">
+        <path d="M3 14s-1 0-1-1 1-4 6-4 6 3 6 4-1 1-1 1zm5-6a3 3 0 1 0 0-6 3 3 0 0 0 0 6" />
+      </svg>
+    {% endif %}
+  </div>
+</div>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/badge.html

@@ -0,0 +1,13 @@
+{# @description A small label, usually a status, a count or a tag. Shows text, then the default slot. #}
+{# @prop text:text | description:"Badge text, shown before the default slot." #}
+{# @prop variant:select['neutral','primary','secondary','accent','info','success','warning','error'] | description:"Colour variant. Leave empty for the default colour." #}
+{# @prop size:select['xs','sm','md','lg','xl'] | description:"Badge size." #}
+{# @prop outline:boolean | description:"Draw the badge as an outline." #}
+{# @prop dash:boolean | description:"Draw the badge with a dashed border." #}
+{# @prop soft:boolean | description:"Use the soft style." #}
+{# @prop ghost:boolean | description:"Draw the badge without a background." #}
+{# @prop class:text | description:"Extra classes added to the badge." #}
+{# @slot New — Content shown after the text. #}
+{% load daisy_cotton %}
+<c-vars text="" variant="" size="" outline="" dash="" soft="" ghost="" class="" />
+<span class="badge {% variation variant "badge" "neutral,primary,secondary,accent,info,success,warning,error" %} {% variation size "badge" "xs,sm,md,lg,xl" %}{% if outline %} badge-outline{% endif %}{% if dash %} badge-dash{% endif %}{% if soft %} badge-soft{% endif %}{% if ghost %} badge-ghost{% endif %} {{ class }}" {{ attrs }}>{{ text }}{{ slot }}</span>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/breadcrumbs/index.html

@@ -0,0 +1,19 @@
+{# @description A breadcrumb trail. Pass items to build it from data, or fill the default slot with breadcrumbs.item components; each item is one step of the trail. #}
+{# @prop items:text | description:"A list of dictionaries, each holding the attributes of one breadcrumbs.item (text, href, class). When given, the default slot is not shown." #}
+{# @prop class:text | description:"Extra classes added to the trail." #}
+{# @prop aria-label:text | description:"Accessible name of the trail. Defaults to a translated Breadcrumbs." #}
+{# @slot — The trail's steps, as breadcrumbs.item components. Shown when no items are passed. #}
+{% load i18n %}
+<c-vars items class aria-label />
+{# `only` is load-bearing: a Cotton child reads a prop it wasn't given (here `class`) from the parent, so every <li> would get the trail's class (#3). #}
+<nav class="breadcrumbs {{ class }}"
+     aria-label="{% if aria_label %}{{ aria_label }}{% else %}{% trans "Breadcrumbs" %}{% endif %}"
+     {{ attrs }}>
+  <ul>
+    {% if items %}
+      {% for item in items %}<c-breadcrumbs.item :attrs="item" only />{% endfor %}
+    {% else %}
+      {{ slot }}
+    {% endif %}
+  </ul>
+</nav>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/breadcrumbs/item.html

@@ -0,0 +1,13 @@
+{# @description One step of a breadcrumb trail, used inside breadcrumbs. Renders as a link when an href is given, and as the current page otherwise. Attributes other than the ones below land on the list item. #}
+{# @prop text:text | description:"The step's label." #}
+{# @prop class:text | description:"Extra classes added to the list item." #}
+{# @prop href:text | description:"Link address. Without it the step is the current page and not a link." #}
+{# @slot — Extra content shown after the label. #}
+<c-vars text class href />
+<li class="{{ class }}" {{ attrs }}>
+  {% if href %}
+    <a href="{{ href }}">{{ text }}{{ slot }}</a>
+  {% else %}
+    <span aria-current="page">{{ text }}{{ slot }}</span>
+  {% endif %}
+</li>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/button.html

@@ -0,0 +1,46 @@
+{# @description A button, or a link styled as one when an href is passed. Shows an optional icon and text, then the default slot. An icon-only button has no accessible name of its own — give it one with aria-label. #}
+{# @prop href:text | description:"When given, the button renders as a link with this href instead of a <button>." #}
+{# @prop text:text | description:"Button label, shown in a span after the icon and before the default slot." #}
+{# @prop icon:text | description:"Icon shown before the text, passed as the name of the icon component. Always hidden from assistive technology." #}
+{# @prop variant:select['neutral','primary','secondary','accent','info','success','warning','error'] | description:"Colour variant. Leave empty for the default colour." #}
+{# @prop size:select['xs','sm','md','lg','xl'] | description:"Button size." #}
+{# @prop outline:boolean | description:"Draw the button as an outline." #}
+{# @prop dash:boolean | description:"Draw the button with a dashed outline." #}
+{# @prop soft:boolean | description:"Draw the button with a soft, tinted background." #}
+{# @prop ghost:boolean | description:"Draw the button with no background until hovered." #}
+{# @prop link:boolean | description:"Draw the button styled as a plain link." #}
+{# @prop active:boolean | description:"Force the button's active (pressed) state." #}
+{# @prop disabled:boolean | description:"Disable the button. On a link this adds btn-disabled, aria-disabled, role=button and tabindex=-1 instead of the native attribute." #}
+{# @prop wide:boolean | description:"Widen the button." #}
+{# @prop block:boolean | description:"Stretch the button to the full width of its container." #}
+{# @prop square:boolean | description:"Make the button a fixed-size square, for a single icon." #}
+{# @prop circle:boolean | description:"Make the button a fixed-size circle, for a single icon." #}
+{# @prop class:text | description:"Extra classes added to the button." #}
+{# @slot Save — Content shown after the icon and text. #}
+{% load daisy_cotton %}
+<c-vars href=""
+        text=""
+        icon=""
+        variant=""
+        size=""
+        outline=""
+        dash=""
+        soft=""
+        ghost=""
+        link=""
+        active=""
+        disabled=""
+        wide=""
+        block=""
+        square=""
+        circle=""
+        class="" />
+{# djlint:off #}
+{% with element=href|yesno:"a,button" %}
+  <{{ element }}{% if href %} href="{{ href }}"{% endif %} class="btn {% variation variant "btn" "neutral,primary,secondary,accent,info,success,warning,error" %} {% variation size "btn" "xs,sm,md,lg,xl" %}{% if outline %} btn-outline{% endif %}{% if dash %} btn-dash{% endif %}{% if soft %} btn-soft{% endif %}{% if ghost %} btn-ghost{% endif %}{% if link %} btn-link{% endif %}{% if active %} btn-active{% endif %}{% if wide %} btn-wide{% endif %}{% if block %} btn-block{% endif %}{% if square %} btn-square{% endif %}{% if circle %} btn-circle{% endif %}{% if disabled and href %} btn-disabled{% endif %} {{ class }}"{% if disabled %}{% if href %} aria-disabled="true" role="button" tabindex="-1"{% else %} disabled{% endif %}{% endif %} {{ attrs }}>
+    {% if icon %}<c-icon name="{{ icon }}" aria-hidden="true" />{% endif %}
+    {% if text %}<span>{{ text }}</span>{% endif %}
+    {{ slot }}
+  </{{ element }}>
+  {# djlint:on #}
+{% endwith %}

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/card/index.html

@@ -0,0 +1,26 @@
+{# @description daisyUI's card: an optional figure, a body and an optional title and actions row. Every part is optional; it renders only what it is given. #}
+{# @prop title:text | description:"Heading text, shown as the card-title. Fill the title slot instead for an icon or badge alongside it." #}
+{# @prop figure:text | description:"Content shown in a <figure> before the body, usually an image. Fill the figure slot for markup." #}
+{# @prop actions:text | description:"Content shown in a card-actions row at the foot of the body, usually buttons. Fill the actions slot for markup." #}
+{# @prop size:select['xs','sm','md','lg','xl'] | description:"Card size." #}
+{# @prop border:boolean | description:"Draw the card with a border instead of a shadow." #}
+{# @prop dash:boolean | description:"Draw the card with a dashed border." #}
+{# @prop side:select['sm','md','lg','xl','2xl'] | description:"Lay the figure beside the body instead of above it. The bare attribute applies it at every width, which this select cannot set." #}
+{# @prop image-full:boolean | description:"Let the figure fill the card and place the body over it." #}
+{# @prop content_class:text | description:"Extra classes added to the card body." #}
+{# @prop class:text | description:"Extra classes added to the card surface." #}
+{# @slot <c-accordion name="shipping" title="Do you ship internationally?">Yes, to most countries.</c-accordion><c-accordion name="shipping" title="How long does delivery take?">Three to five business days.</c-accordion><c-accordion name="returns" class="bg-base-100 border border-base-300" title="What is your return policy?">Items can be returned within 30 days.</c-accordion><c-accordion name="returns" class="bg-base-100 border border-base-300" title="Do you offer refunds?">Yes, to the original payment method.</c-accordion> — An FAQ: two accordion groups, one plain and one bordered. #}
+{# @slot:title — A heading with card-title, in place of the title attribute. An icon-only title needs an accessible name of its own. #}
+{# @slot:figure <c-hover_gallery><img src="https://img.daisyui.com/images/stock/daisyui-hat-1.webp" alt="A brimmed felt hat"><img src="https://img.daisyui.com/images/stock/daisyui-hat-2.webp" alt="A knit beanie"><img src="https://img.daisyui.com/images/stock/daisyui-hat-3.webp" alt="A straw sun hat"><img src="https://img.daisyui.com/images/stock/daisyui-hat-4.webp" alt="A baseball cap"></c-hover_gallery> — Content in a <figure> before the body, here a gallery of four images. #}
+{# @slot:actions <c-button text="Cart "><c-badge variant="secondary">3</c-badge></c-button> — Content in a card-actions row at the foot of the body. #}
+{% load daisy_cotton %}
+<c-vars title="" figure="" actions="" size="" border="" dash="" side="" image-full="" content_class="" class="" />
+<div class="card {% variation size "card" "xs,sm,md,lg,xl" %}{% if border %} card-border{% endif %}{% if dash %} card-dash{% endif %} {% responsive side "card-side" %}{% if image_full %} image-full{% endif %} {{ class }}"
+     {{ attrs }}>
+  {% if figure %}<figure>{{ figure }}</figure>{% endif %}
+  <div class="card-body {{ content_class }}">
+    {% if title %}<h2 class="card-title">{{ title }}</h2>{% endif %}
+    {{ slot }}
+    {% if actions %}<div class="card-actions">{{ actions }}</div>{% endif %}
+  </div>
+</div>

daisy_cotton-0.1.0/daisy_cotton/templates/cotton/carousel/index.html

@@ -0,0 +1,20 @@
+{# @description daisyUI's carousel: a scrollable, snapping row or column of slides. With no controls of its own it is a focusable, named region, so keyboard users can tab to it and scroll it with the arrow keys, and screen readers announce it as a carousel of slides. Fill the default slot with carousel.item components. See the mockup.browser entry for a named carousel with previous/next and indicator controls. #}
+{# @prop snap:select['start','center','end'] | description:"Where the slides snap to." #}
+{# @prop horizontal:select['sm','md','lg','xl','2xl'] | description:"Scroll horizontally. The bare attribute applies it at every width, which this select cannot set." #}
+{# @prop vertical:select['sm','md','lg','xl','2xl'] | description:"Scroll vertically. The bare attribute applies it at every width, which this select cannot set." #}
+{# @prop aria-label:text | description:"Accessible name of the carousel. No default: the component cannot invent one, so give it one or the region is unnamed." #}
+{# @prop class:text | description:"Extra classes added to the carousel." #}
+{# @slot <c-carousel.item id="gallery-slide-1" class="relative w-full"><img class="w-full" src="https://img.daisyui.com/images/stock/photo-1625726411847-8cbb60cc71e6.webp" alt="A city skyline at dusk"><div class="absolute flex -translate-y-1/2 transform justify-between left-5 right-5 top-1/2"><c-button href="#gallery-slide-4" circle aria-label="Previous slide" text="❮" /><c-button href="#gallery-slide-2" circle aria-label="Next slide" text="❯" /></div></c-carousel.item><c-carousel.item id="gallery-slide-2" class="relative w-full"><img class="w-full" src="https://img.daisyui.com/images/stock/photo-1609621838510-5ad474b7d25d.webp" alt="A mountain trail in autumn"><div class="absolute flex -translate-y-1/2 transform justify-between left-5 right-5 top-1/2"><c-button href="#gallery-slide-1" circle aria-label="Previous slide" text="❮" /><c-button href="#gallery-slide-3" circle aria-label="Next slide" text="❯" /></div></c-carousel.item><c-carousel.item id="gallery-slide-3" class="relative w-full"><img class="w-full" src="https://img.daisyui.com/images/stock/photo-1414694762283-acccc27bca85.webp" alt="A row of colourful houses"><div class="absolute flex -translate-y-1/2 transform justify-between left-5 right-5 top-1/2"><c-button href="#gallery-slide-2" circle aria-label="Previous slide" text="❮" /><c-button href="#gallery-slide-4" circle aria-label="Next slide" text="❯" /></div></c-carousel.item><c-carousel.item id="gallery-slide-4" class="relative w-full"><img class="w-full" src="https://img.daisyui.com/images/stock/photo-1665553365602-b2fb8e5d1707.webp" alt="Ocean waves at sunset"><div class="absolute flex -translate-y-1/2 transform justify-between left-5 right-5 top-1/2"><c-button href="#gallery-slide-3" circle aria-label="Previous slide" text="❮" /><c-button href="#gallery-slide-1" circle aria-label="Next slide" text="❯" /></div></c-carousel.item> — Four full-width slides with daisyUI's previous/next pattern: each slide's controls are c-button href links to a neighbouring slide's id, drawn over the image. #}
+{% comment %}
+  Previous/next and indicator links to a slide's id sit beside the carousel,
+  not in it, and following one also scrolls the page to the carousel. The
+  gallery's inline preview cannot follow them; use this entry's raw view.
+{% endcomment %}
+{% load i18n daisy_cotton %}
+<c-vars snap="" horizontal="" vertical="" aria-label="" class="" />
+<div class="carousel {% variation snap "carousel" "start,center,end" %} {% responsive horizontal "carousel-horizontal" %} {% responsive vertical "carousel-vertical" %} {{ class }}"
+     role="region"
+     tabindex="0"
+     aria-roledescription="{% trans "carousel" %}"
+     {% if aria_label %}aria-label="{{ aria_label }}"{% endif %}
+     {{ attrs }}>{{ slot }}</div>