feat: Add :data:render: inline role

Add DataRenderRole as the inline counterpart of DataRenderDirective,
allowing inline template rendering with :data:render: role.

Fixes a bug where the role used self.content (always empty for roles)
instead of self.text. Also passes an instance rather than a class to
app.add_role to comply with docutils callable expectations.

Co-authored-by: DeepSeek <service@deepseek.com>

Author: SilverRainZ

docs/usage.rst

@@ -121,6 +121,24 @@ Directives
 
          ``1 + 1 = {{ 1 + 1 }}``
 
+.. _ext-usage-roles:
+
+Roles
+=====
+
+.. rst:role:: data.render
+
+   Render a template inline without defining data.
+   This is the inline counterpart of :rst:dir:`data.render` directive.
+
+   The role content is used as the Jinja2 template with an empty context.
+   Refer to :doc:`tmpl` for guide of writing template.
+
+   .. example::
+      :style: grid
+
+      :data.render:`{{ 1 + 1 }}` equals 2.
+
 .. _usage-custom-directive:
 
 Defining Custom Directives

src/sphinxnotes/render/ext/adhoc.py

@@ -25,6 +25,7 @@
     BaseContextDirective,
     BaseDataDefineDirective,
     BaseDataDefineRole,
+    BaseContextRole,
 )
 from ..utils.freestyle import FreeStyleDirective
 
@@ -200,12 +201,27 @@ def install(self, app: Sphinx, docname: str, source: list[str]) -> None:
         self.enable()
 
 
+class DataRenderRole(BaseContextRole):
+    @override
+    def current_context(self) -> UnresolvedContext | ResolvedContext:
+        return {}
+
+    @override
+    def current_template(self) -> Template:
+        return Template(
+            self.text,
+            phase=self.options.get('on', Phase.default()),
+            debug='debug' in self.options,
+        )
+
+
 def setup(app: Sphinx) -> None:
     app.add_directive('data.define', FreeDataDefineDirective)
     app.add_directive('data.template', TemplateDefineDirective)
     app.add_directive('data.schema', SchemaDefineDirective)
     app.add_directive('data.render', DataRenderDirective)
 
     app.add_role('data.define', FreeDataDefineRole)
+    app.add_role('data.render', DataRenderRole())
 
     app.connect('source-read', FreeDataDefineRoleDispatcher().install)

tests/roots/test-data-render-role/conf.py

@@ -0,0 +1 @@
+extensions = ['sphinxnotes.render.ext']

tests/roots/test-data-render-role/index.rst

@@ -0,0 +1,6 @@
+Data Render Role Test
+=====================
+
+This is a test of :data.render:`**bold**`.
+
+Inline math: :data.render:`{{ 1 + 1 }}`.

tests/test_e2e.py

@@ -107,6 +107,17 @@ def test_render_ext_data_define_directives(app, status, warning, phase):
     assert 'RenderedContent' in html
 
 
+@pytest.mark.sphinx('html', testroot='data-render-role')
+def test_render_ext_data_render_role(app, status, warning):
+    """Test that :data:render: role works correctly."""
+    app.build()
+
+    html = (app.outdir / 'index.html').read_text(encoding='utf-8')
+
+    assert '<strong>bold</strong>' in html
+    assert '2' in html
+
+
 @pytest.mark.sphinx('html', testroot='derive')
 def test_derived_render_ext_data_define_directives(app, status, warning):
     """Test that render_ext_data_define_directives generates directives correctly."""