authfly-jinja2 0.4.0__tar.gz

authfly_jinja2-0.4.0/LICENSE

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

authfly_jinja2-0.4.0/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: authfly-jinja2
+Version: 0.4.0
+Summary: Authfly widgets for Jinja2 on UI8Kit 3 primitives (CLI 3.2.1, registry 3.2.0)
+License-Expression: MIT
+Project-URL: Repository, https://github.com/authfly/authkit
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Jinja2<4,>=3.1
+Dynamic: license-file
+
+# Authfly widgets — Jinja2 (UI8Kit 3)
+
+Primitives from `npx ui8kit@3` (CLI 3.2.1, registry 3.2.0):
+
+    npx ui8kit@3 init --yes --framework jinja2 --runtime jinja2 --dir . --registry-version 3.2.0
+    npx ui8kit@3 add --all --runtime jinja2 --registry-version 3.2.0
+    pip install "Jinja2>=3.1,<4"
+
+Installed from PyPI (`pip install authfly-jinja2`), the templates ship inside the wheel as `authfly_jinja2_templates`
+and `environment()` finds them; in a checkout it uses this folder. Build: `python -m build && twine check dist/*`.
+
+`ui/` (templates) and `ui8kit_jinja/` (runtime) are CLI-owned — never edit; `npx ui8kit@3 check`.
+Authfly layer: `authfly_jinja/` (`environment()`, `skin.py`, `lucide_icons.py`), `authfly/components.html.j2`
+(macros: card, stack, group, form, hidden, title, alert, badge, icon_badge, field, icon, head, messages),
+`blocks/authfly-*.html.j2` (same `p` props as the React widgets).
+
+    from authfly_jinja import environment
+    html = environment().get_template("blocks/authfly-sign-in.html.j2").render(p=props)
+
+Text is passed via props and autoescaped; children Markup is only built by the macros. Tests:
+`python3 -m unittest discover -s tests`; parity HTML: `python3 tools/render.py ../react/tests/states.json /tmp/out`.

authfly_jinja2-0.4.0/README.md

@@ -0,0 +1,21 @@
+# Authfly widgets — Jinja2 (UI8Kit 3)
+
+Primitives from `npx ui8kit@3` (CLI 3.2.1, registry 3.2.0):
+
+    npx ui8kit@3 init --yes --framework jinja2 --runtime jinja2 --dir . --registry-version 3.2.0
+    npx ui8kit@3 add --all --runtime jinja2 --registry-version 3.2.0
+    pip install "Jinja2>=3.1,<4"
+
+Installed from PyPI (`pip install authfly-jinja2`), the templates ship inside the wheel as `authfly_jinja2_templates`
+and `environment()` finds them; in a checkout it uses this folder. Build: `python -m build && twine check dist/*`.
+
+`ui/` (templates) and `ui8kit_jinja/` (runtime) are CLI-owned — never edit; `npx ui8kit@3 check`.
+Authfly layer: `authfly_jinja/` (`environment()`, `skin.py`, `lucide_icons.py`), `authfly/components.html.j2`
+(macros: card, stack, group, form, hidden, title, alert, badge, icon_badge, field, icon, head, messages),
+`blocks/authfly-*.html.j2` (same `p` props as the React widgets).
+
+    from authfly_jinja import environment
+    html = environment().get_template("blocks/authfly-sign-in.html.j2").render(p=props)
+
+Text is passed via props and autoescaped; children Markup is only built by the macros. Tests:
+`python3 -m unittest discover -s tests`; parity HTML: `python3 tools/render.py ../react/tests/states.json /tmp/out`.

authfly_jinja2-0.4.0/authfly/components.html.j2

@@ -0,0 +1,91 @@
+{#- Authfly middle layer for Jinja2: macros over the UI8Kit 3 primitives (ui/*), classes from authfly_jinja.skin.
+    Text arguments are escaped; `children` arguments are trusted Markup built by these macros only. -#}
+
+{%- macro prim(path, p, children='') -%}{% include path %}{%- endmacro -%}
+
+{%- macro icon(name, size='sm') -%}
+{%- set svg -%}<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" width="100%" height="100%" aria-hidden="true" focusable="false">{{ af_lucide(name) }}</svg>{%- endset -%}
+{{ prim('ui/icon/icon.html.j2', {'Size': size or 'sm', 'Attrs': {'data-lucide': name}}, svg) }}
+{%- endmacro -%}
+
+{%- macro box(tag='', cls='', attrs={}, children='') -%}
+{{ prim('ui/box/box.html.j2', {'Tag': tag, 'Class': cls, 'Attrs': af_attrs(attrs)}, children) }}
+{%- endmacro -%}
+
+{%- macro text(tag='', cls='', attrs={}, children='') -%}
+{{ prim('ui/text/text.html.j2', {'Tag': tag, 'Class': cls, 'Attrs': af_attrs(attrs)}, children) }}
+{%- endmacro -%}
+
+{%- macro card(cls='', attrs={}, children='') -%}{{ box('section', af_skin('card', cls), attrs, children) }}{%- endmacro -%}
+
+{%- macro stack(gap='', align='', justify='', cls='', attrs={}, children='') -%}
+{{ box('', af_cn('flex flex-col', af_gap(gap, '4'), af_align(align, 'stretch'), af_justify(justify), cls), attrs, children) }}
+{%- endmacro -%}
+
+{%- macro group(gap='', align='', justify='', cls='', attrs={}, children='') -%}
+{{ box('', af_cn('flex min-w-0', af_gap(gap, '2'), af_align(align, 'center'), af_justify(justify), cls), attrs, children) }}
+{%- endmacro -%}
+
+{#- form: the Form primitive (method post) with the Authfly grid; the form error id is passed to each field. -#}
+{%- macro form(action='', cls='', attrs={}, children='') -%}
+{{ prim('ui/form/form.html.j2', {'Action': action, 'Method': 'post', 'Class': af_cn('grid gap-4', cls), 'Attrs': af_attrs(attrs)}, children) }}
+{%- endmacro -%}
+
+{#- hidden: value always emitted (an empty value goes through Attrs; the primitive drops value=""). -#}
+{%- macro hidden(name, value='') -%}
+{%- if value is none or value == '' -%}{{ prim('ui/input/input.html.j2', {'Type': 'hidden', 'Name': name, 'Attrs': {'value': ''}}) }}
+{%- else -%}{{ prim('ui/input/input.html.j2', {'Type': 'hidden', 'Name': name, 'Value': value}) }}{%- endif -%}
+{%- endmacro -%}
+
+{%- macro title(level, id, role, title) -%}
+{{ text('h1' if level == 1 else 'h2', af_text('title' if level == 1 else 'subtitle'), {'id': id, 'role': role}, af_esc(title)) }}
+{%- endmacro -%}
+
+{%- macro alert(tone, icon_name, id, testid, message) -%}
+{%- set c -%}{% if icon_name %}{{ icon(icon_name) }}{% endif %}{{ message }}{%- endset -%}
+{{ box('', af_skin('alert', tone), {'role': 'alert' if tone == 'destructive' else 'status', 'aria-live': 'polite', 'data-slot': 'alert', 'id': id, 'data-testid': testid}, c) }}
+{%- endmacro -%}
+
+{%- macro badge(variant, testid, label) -%}
+{{ text('span', af_skin('badge', variant or 'default'), {'data-slot': 'badge', 'data-testid': testid}, af_esc(label)) }}
+{%- endmacro -%}
+
+{%- macro icon_badge(icon_name, tone='default') -%}
+{{ text('span', af_skin('iconBadge', tone or 'default'), {'data-slot': 'icon-badge'}, icon(icon_name, 'lg')) }}
+{%- endmacro -%}
+
+{#- field: label + Input + hint + error. f = {label, for, hint, error, formError, input: {type, name, required, attrs},
+    describe: own ids, suffix: trusted Markup after the input, in a Group}. aria-describedby = own + hint + error +
+    form error; aria-invalid="true" when the field or the form shows an error. -#}
+{%- macro field(f) -%}
+{%- set hint_id = f.for ~ '-hint' if f.hint else none -%}
+{%- set err_id = f.for ~ '-error' if f.error else none -%}
+{%- set inp = f.input or {} -%}
+{%- set attrs = dict(inp.attrs or {}) -%}{%- set _ = attrs.update({'data-testid': 'field'}) -%}
+{%- set ctl -%}{{ prim('ui/input/input.html.j2', {'Type': inp.type, 'Name': inp.name, 'Required': inp.required or false, 'ID': f.for, 'Class': af_skin('input'), 'AriaDescribedBy': af_describe(f.describe, hint_id, err_id, f.formError), 'AriaInvalid': 'true' if (f.error or f.formError) else '', 'Attrs': af_attrs(attrs)}) }}{%- endset -%}
+{%- if f.suffix -%}{%- set ctl = group('2', '', '', '', {}, ctl ~ f.suffix) -%}{%- endif -%}
+{%- set c -%}
+{{ prim('ui/label/label.html.j2', {'For': f.for, 'Class': af_skin('label')}, af_esc(f.label)) }}{{ ctl }}
+{%- if hint_id %}{{ text('', af_text('hint'), {'id': hint_id}, af_esc(f.hint)) }}{% endif -%}
+{%- if err_id %}{{ text('', 'text-xs font-semibold text-destructive', {'id': err_id}, af_esc(f.error)) }}{% endif -%}
+{%- endset -%}
+{{ box('', 'flex min-w-0 flex-col gap-2', {}, c) }}
+{%- endmacro -%}
+
+{%- macro head(id, title_, lead, align='start', role=none, extra='') -%}
+{%- set c -%}{{ title(1, id ~ '-title', none, title_) }}{{ text('', af_text('muted'), {}, af_esc(lead)) }}{{ extra }}{%- endset -%}
+{{ stack('2', align or 'start', '', '', {'role': role}, c) }}
+{%- endmacro -%}
+
+{%- macro messages(id, error, info) -%}
+{%- if error %}{{ alert('destructive', 'circle-alert', id ~ '-error', 'authfly-error', error) }}{% endif -%}
+{%- if info %}{{ alert('success', 'info', '', 'authfly-info', info) }}{% endif -%}
+{%- endmacro -%}
+
+{%- macro link(href, cls, testid, label) -%}
+{{ prim('ui/link/link.html.j2', {'Href': href, 'Class': cls, 'Attrs': af_attrs({'data-testid': testid})}, af_esc(label)) }}
+{%- endmacro -%}
+
+{%- macro button(href, type, cls, attrs={}, children='') -%}
+{{ prim('ui/button/button.html.j2', {'Href': href, 'Type': type, 'Class': cls, 'Attrs': af_attrs(attrs)}, children) }}
+{%- endmacro -%}

authfly_jinja2-0.4.0/authfly_jinja/__init__.py

@@ -0,0 +1,56 @@
+"""Authfly widgets for Jinja2 on the UI8Kit 3 primitives (ui/*, ui8kit_jinja — CLI-owned).
+
+`environment()` = ui8kit_jinja.environment(root) + the af_* skin helpers. Render a widget with
+`env.get_template("blocks/authfly-sign-in.html.j2").render(p=props)`; props are the xgen/react camelCase props.
+All text is passed through props and autoescaped; children markup is only built by authfly/components.html.j2.
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+from jinja2 import Environment
+from jinja2.runtime import Undefined
+from markupsafe import Markup, escape
+
+import ui8kit_jinja
+
+from . import skin
+from .lucide_icons import LUCIDE
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+if not os.path.isdir(os.path.join(ROOT, "blocks")):  # installed wheel: templates live in authfly_jinja2_templates
+    import importlib.util
+
+    _spec = importlib.util.find_spec("authfly_jinja2_templates")
+    if _spec and _spec.submodule_search_locations:
+        ROOT = list(_spec.submodule_search_locations)[0]
+
+
+def _p(v: Any) -> Any:
+    return None if isinstance(v, Undefined) else v
+
+
+def _attrs(a: Any) -> dict:
+    return {k: v for k, v in dict(a or {}).items() if _p(v) is not None and v != ""}
+
+
+def _describe(*ids: Any) -> str:
+    return " ".join(str(i) for i in ids if _p(i))
+
+
+def environment(root: str | None = None, **options: Any) -> Environment:
+    env = ui8kit_jinja.environment(root or ROOT, **options)
+    g = env.globals
+    g["af_skin"] = lambda name, *a: getattr(skin, name)(*[_p(x) for x in a])
+    g["af_text"] = lambda k: skin.TEXT[k]
+    g["af_cn"] = lambda *a: skin.cn(*[_p(x) for x in a])
+    g["af_gap"] = lambda k, d: skin.GAP[_p(k) or d]
+    g["af_align"] = lambda k, d: skin.ALIGN[_p(k) or d]
+    g["af_justify"] = lambda k: skin.JUSTIFY[k] if _p(k) else ""
+    g["af_lucide"] = lambda n: Markup(LUCIDE.get(n) or LUCIDE["circle"])
+    g["af_attrs"] = _attrs
+    g["af_describe"] = _describe
+    g["af_esc"] = lambda v: escape("" if _p(v) is None else v)
+    return env