luoma 0.1.0

data/sig/luoma/template.rbs

@@ -0,0 +1,117 @@
+module Luoma
+  type t_block = Array[String | Luoma::Markup]
+               
+  class Template
+    @env: Environment
+
+    @source: String
+
+    @nodes: t_block
+
+    @globals: t_namespace?
+
+    @name: String
+
+    @overlay: t_namespace?
+
+    @up_to_date: untyped
+
+    @lines: Array[String]?
+
+    attr_reader env: Environment
+
+    attr_reader source: String
+
+    attr_reader nodes: t_block
+
+    attr_reader globals: t_namespace?
+
+    attr_reader name: String
+
+    attr_reader overlay: t_namespace?
+
+    attr_reader up_to_date: untyped
+
+    #  (Environment,
+    #   String,
+    #   t_block,
+    #   ?globals: t_namespace?,
+    #   ?name: String?,
+    #   ?overlay: t_namespace?,
+    #   ?up_to_date: Proc::_Callable?) -> void
+    def initialize: (Environment env, String source, t_block nodes, ?globals: t_namespace?, ?name: String?, ?overlay: t_namespace?, ?up_to_date: untyped?) -> void
+
+    #  (t_namespace?) -> String
+    def render: (?t_namespace? data) -> String
+
+    #  (RenderContext, String, ?isolated: bool) -> String
+    def render_with_context: (RenderContext context, String buffer, ?isolated: bool) -> String
+
+    #  (t_namespace) -> Template
+    def with_globals: (t_namespace namespace) -> Template
+                    
+    def lines: () -> Array[String]
+             
+    def up_to_date?: () -> bool
+
+    #  (t_namespace?) -> t_namespace?
+    def make_globals: (t_namespace? namespace) -> t_namespace?
+                    
+    # Statically analyze this template and report variable, tag and filter usage.
+    #
+    #  (?include_partials: bool) -> Luoma::StaticAnalysis::Result
+    def analyze: (?include_partials: bool) -> Luoma::StaticAnalysis::Result
+               
+    # Return an array of variable names used in this template, without path segments.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def variables: (?include_partials: bool) -> Array[String]
+
+    # Return an array of variables used in this template, including path segments.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def variable_paths: (?include_partials: bool) -> Array[String]
+
+    # Return an array of variables used in this template, each as an array of segments.
+    #
+    #  (?include_partials: bool) -> Array[Segments]
+    def variable_segments: (?include_partials: bool) -> Array[untyped]
+
+    # Return an array of global variables used in this template, without path segments.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def global_variables: (?include_partials: bool) -> Array[String]
+
+    # Return an array of global variables used in this template, including path segments.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def global_variable_paths: (?include_partials: bool) -> Array[String]
+
+    # Return an array of global variables used in this template, each as an array of segments.
+    #
+    #  (?include_partials: bool) -> Array[Segments]
+    def global_variable_segments: (?include_partials: bool) -> Array[untyped]
+
+    # Return the names of all filters used in this template.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def filter_names: (?include_partials: bool) -> Array[String]
+
+    # Return the names of all tags used in this template.
+    #
+    #  (?include_partials: bool) -> Array[String]
+    def tag_names: (?include_partials: bool) -> Array[String]
+
+    # Return an array of comment nodes found in this template.
+    #
+    # Comment nodes have `token` and `text` attributes. Use `template.comments.map(&:text)`
+    # to get an array of comment strings. Each comment string includes leading and trailing
+    # whitespace.
+    #
+    # Note that this method does not try to load included or render templates when looking.
+    # for comment nodes.
+    #
+    #  () -> Array[Comment]
+    def comments: () -> Array[Comment]
+  end
+end

data/sig/luoma/token.rbs

@@ -0,0 +1,81 @@
+module Luoma 
+  type t_token = [t_token_kind, Integer, Integer]
+               
+  type t_token_kind = (
+    :token_add |
+    :token_and |
+    :token_arrow |
+    :token_assign |
+    :token_colon |
+    :token_comma |
+    :token_comment |
+    :token_comment_end |
+    :token_comment_start |
+    :token_contains |
+    :token_div |
+    :token_dot |
+    :token_double_dot |
+    :token_double_escaped |
+    :token_double_quote |
+    :token_double_quoted |
+    :token_else |
+    :token_eq |
+    :token_false |
+    :token_float |
+    :token_ge |
+    :token_gt |
+    :token_ident |
+    :token_if |
+    :token_in |
+    :token_int |
+    :token_interpolation_end |
+    :token_interpolation_start |
+    :token_lbrace |
+    :token_lbracket |
+    :token_le |
+    :token_lparen |
+    :token_lt |
+    :token_mod |
+    :token_mul |
+    :token_ne |
+    :token_nil |
+    :token_not |
+    :token_null |
+    :token_or_else |
+    :token_or |
+    :token_out_end |
+    :token_out_start |
+    :token_pipe |
+    :token_question |
+    :token_rbrace |
+    :token_rbracket |
+    :token_rparen |
+    :token_single_escaped |
+    :token_single_quote |
+    :token_single_quoted |
+    :token_sub |
+    :token_tag_end |
+    :token_tag_name |
+    :token_tag_start |
+    :token_text |
+    :token_triple_dot |
+    :token_true |
+    :token_wc |
+    :token_eoi |
+    :token_unknown |
+    :token_hash |
+    :token_span |
+    :token_blank |
+    :token_empty |
+    :token_for |
+    :token_with |
+    :token_as
+  )
+
+  TOKEN_KIND_MAP: Hash[t_token_kind, String]
+
+  def self.get_token_value: (t_token token, String source) -> String
+                          
+  def self.span: (t_token start, t_token stop) -> t_token
+
+end

data/sig/luoma.rbs

@@ -0,0 +1,11 @@
+module Luoma
+  VERSION: String
+
+  DEFAULT_ENVIRONMENT: Environment
+
+  #: (String, ?globals: Hash[String, untyped]?) -> Template 
+  def self.parse: (untyped source, ?globals: untyped?) -> untyped
+
+  #: (String, ?Hash[String, untyped]?) -> String
+  def self.render: (untyped source, ?untyped? data) -> untyped
+end

data/zensical.toml

@@ -0,0 +1,363 @@
+# ============================================================================
+#
+# The configuration produced by default is meant to highlight the features
+# that Zensical provides and to serve as a starting point for your own
+# projects.
+#
+# ============================================================================
+
+[project]
+
+# The site_name is shown in the page header and the browser window title
+#
+# Read more: https://zensical.org/docs/setup/basics/#site_name
+site_name = "Luoma - Ruby"
+
+# The site_description is included in the HTML head and should contain a
+# meaningful description of the site content for use by search engines.
+#
+# Read more: https://zensical.org/docs/setup/basics/#site_description
+site_description = "A modern template engine."
+
+# The site_author attribute. This is used in the HTML head element.
+#
+# Read more: https://zensical.org/docs/setup/basics/#site_author
+site_author = "James"
+
+# The site_url is the canonical URL for your site. When building online
+# documentation you should set this.
+# Read more: https://zensical.org/docs/setup/basics/#site_url
+site_url = "https://jg-rp.github.io/luoma-ruby/"
+
+# The copyright notice appears in the page footer and can contain an HTML
+# fragment.
+#
+# Read more: https://zensical.org/docs/setup/basics/#copyright
+copyright = """
+Copyright © 2026 The authors
+"""
+
+
+nav = [
+  { "Docs" = [
+    { "Introduction" = "index.md" },
+    { "Setup" = "configuration.md" },
+    "template_loaders.md",
+    "extension_types.md",
+    "undefined_variables.md",
+    "template_loaders.md",
+    "static_analysis.md",
+    { "Template syntax" = "luoma_for_template_authors.md"}
+  ]},
+  
+  { "Tags" = ["tag_reference.md", "custom_tags.md"] },
+  { "Filters" = ["filter_reference.md", "custom_filters.md"] },
+  { "Expressions" = ["expressions.md"] },
+  { "Predicates" = ["predicate_reference.md"] }
+]
+
+# With the "extra_css" option you can add your own CSS styling to customize
+# your Zensical project according to your needs. You can add any number of
+# CSS files.
+#
+# The path provided should be relative to the "docs_dir".
+#
+# Read more: https://zensical.org/docs/customization/#additional-css
+#
+#extra_css = ["stylesheets/extra.css"]
+
+# With the `extra_javascript` option you can add your own JavaScript to your
+# project to customize the behavior according to your needs.
+#
+# The path provided should be relative to the "docs_dir".
+#
+# Read more: https://zensical.org/docs/customization/#additional-javascript
+#extra_javascript = ["javascripts/extra.js"]
+
+# ----------------------------------------------------------------------------
+# Section for configuring theme options
+# ----------------------------------------------------------------------------
+[project.theme]
+
+# change this to "classic" to use the traditional Material for MkDocs look.
+#variant = "classic"
+
+# Zensical allows you to override specific blocks, partials, or whole
+# templates as well as to define your own templates. To do this, uncomment
+# the custom_dir setting below and set it to a directory in which you
+# keep your template overrides.
+#
+# Read more:
+# - https://zensical.org/docs/customization/#extending-the-theme
+#
+#custom_dir = "overrides"
+
+# With the "favicon" option you can set your own image to use as the icon
+# browsers will use in the browser title bar or tab bar. The path provided
+# must be relative to the "docs_dir".
+#
+# Read more:
+# - https://zensical.org/docs/setup/logo-and-icons/#favicon
+# - https://developer.mozilla.org/en-US/docs/Glossary/Favicon
+#
+#favicon = "images/favicon.png"
+
+# Zensical supports more than 60 different languages. This means that the
+# labels and tooltips that Zensical's templates produce are translated.
+# The "language" option allows you to set the language used. This language
+# is also indicated in the HTML head element to help with accessibility
+# and guide search engines and translation tools.
+#
+# The default language is "en" (English). It is possible to create
+# sites with multiple languages and configure a language selector. See
+# the documentation for details.
+#
+# Read more:
+# - https://zensical.org/docs/setup/language/
+#
+language = "en"
+
+# Zensical provides a number of feature toggles that change the behavior
+# of the documentation site.
+features = [
+    # Zensical includes an announcement bar. This feature allows users to
+    # dismiss it when they have read the announcement.
+    # https://zensical.org/docs/setup/header/#announcement-bar
+    "announce.dismiss",
+
+    # If you have a repository configured and turn on this feature, Zensical
+    # will generate an edit button for the page. This works for common
+    # repository hosting services.
+    # https://zensical.org/docs/setup/repository/#content-actions
+    #"content.action.edit",
+
+    # If you have a repository configured and turn on this feature, Zensical
+    # will generate a button that allows the user to view the Markdown
+    # code for the current page.
+    # https://zensical.org/docs/setup/repository/#content-actions
+    #"content.action.view",
+
+    # Code annotations allow you to add an icon with a tooltip to your
+    # code blocks to provide explanations at crucial points.
+    # https://zensical.org/docs/authoring/code-blocks/#code-annotations
+    "content.code.annotate",
+
+    # This feature turns on a button in code blocks that allow users to
+    # copy the content to their clipboard without first selecting it.
+    # https://zensical.org/docs/authoring/code-blocks/#code-copy-button
+    "content.code.copy",
+
+    # Code blocks can include a button to allow for the selection of line
+    # ranges by the user.
+    # https://zensical.org/docs/authoring/code-blocks/#code-selection-button
+    "content.code.select",
+
+    # Zensical can render footnotes as inline tooltips, so the user can read
+    # the footnote without leaving the context of the document.
+    # https://zensical.org/docs/authoring/footnotes/#footnote-tooltips
+    "content.footnote.tooltips",
+
+    # If you have many content tabs that have the same titles (e.g., "Python",
+    # "JavaScript", "Cobol"), this feature causes all of them to switch to
+    # at the same time when the user chooses their language in one.
+    # https://zensical.org/docs/authoring/content-tabs/#linked-content-tabs
+    "content.tabs.link",
+
+    # With this feature enabled users can add tooltips to links that will be
+    # displayed when the mouse pointer hovers the link.
+    # https://zensical.org/docs/authoring/tooltips/#improved-tooltips
+    "content.tooltips",
+
+    # With this feature enabled, Zensical will automatically hide parts
+    # of the header when the user scrolls past a certain point.
+    # https://zensical.org/docs/setup/header/#automatic-hiding
+    # "header.autohide",
+
+    # Turn on this feature to expand all collapsible sections in the
+    # navigation sidebar by default.
+    # https://zensical.org/docs/setup/navigation/#navigation-expansion
+    # "navigation.expand",
+
+    # This feature turns on navigation elements in the footer that allow the
+    # user to navigate to a next or previous page.
+    # https://zensical.org/docs/setup/footer/#navigation
+    "navigation.footer",
+
+    # When section index pages are enabled, documents can be directly attached
+    # to sections, which is particularly useful for providing overview pages.
+    # https://zensical.org/docs/setup/navigation/#section-index-pages
+    "navigation.indexes",
+
+    # When instant navigation is enabled, clicks on all internal links will be
+    # intercepted and dispatched via XHR without fully reloading the page.
+    # https://zensical.org/docs/setup/navigation/#instant-navigation
+    "navigation.instant",
+
+    # With instant prefetching, your site will start to fetch a page once the
+    # user hovers over a link. This will reduce the perceived loading time
+    # for the user.
+    # https://zensical.org/docs/setup/navigation/#instant-prefetching
+    "navigation.instant.prefetch",
+
+    # In order to provide a better user experience on slow connections when
+    # using instant navigation, a progress indicator can be enabled.
+    # https://zensical.org/docs/setup/navigation/#progress-indicator
+    #"navigation.instant.progress",
+
+    # When navigation paths are activated, a breadcrumb navigation is rendered
+    # above the title of each page
+    # https://zensical.org/docs/setup/navigation/#navigation-path
+    "navigation.path",
+
+    # When pruning is enabled, only the visible navigation items are included
+    # in the rendered HTML, reducing the size of the built site by 33% or more.
+    # https://zensical.org/docs/setup/navigation/#navigation-pruning
+    #"navigation.prune",
+
+    # When sections are enabled, top-level sections are rendered as groups in
+    # the sidebar for viewports above 1220px, but remain as-is on mobile.
+    # https://zensical.org/docs/setup/navigation/#navigation-sections
+    "navigation.sections",
+
+    # When tabs are enabled, top-level sections are rendered in a menu layer
+    # below the header for viewports above 1220px, but remain as-is on mobile.
+    # https://zensical.org/docs/setup/navigation/#navigation-tabs
+    "navigation.tabs",
+
+    # When sticky tabs are enabled, navigation tabs will lock below the header
+    # and always remain visible when scrolling down.
+    # https://zensical.org/docs/setup/navigation/#sticky-navigation-tabs
+    #"navigation.tabs.sticky",
+
+    # A back-to-top button can be shown when the user, after scrolling down,
+    # starts to scroll up again.
+    # https://zensical.org/docs/setup/navigation/#back-to-top-button
+    "navigation.top",
+
+    # When anchor tracking is enabled, the URL in the address bar is
+    # automatically updated with the active anchor as highlighted in the table
+    # of contents.
+    # https://zensical.org/docs/setup/navigation/#anchor-tracking
+    "navigation.tracking",
+
+    # When search highlighting is enabled and a user clicks on a search result,
+    # Zensical will highlight all occurrences after following the link.
+    # https://zensical.org/docs/setup/search/#search-highlighting
+    "search.highlight",
+
+    # When anchor following for the table of contents is enabled, the sidebar
+    # is automatically scrolled so that the active anchor is always visible.
+    # https://zensical.org/docs/setup/navigation/#anchor-following
+    # "toc.follow",
+
+    # When navigation integration for the table of contents is enabled, it is
+    # always rendered as part of the navigation sidebar on the left.
+    # https://zensical.org/docs/setup/navigation/#navigation-integration
+    #"toc.integrate",
+]
+
+# ----------------------------------------------------------------------------
+# You can configure your own logo to be shown in the header using the "logo"
+# option in the "theme" subsection. The logo must be a relative path to a file
+# in your "docs_dir", e.g., to use `docs/assets/logo.png` you would set:
+# ----------------------------------------------------------------------------
+#logo = "assets/logo.png"
+
+# ----------------------------------------------------------------------------
+# If you don't have a dedicated project logo, you can use a built-in icon from
+# the icon sets shipped in Zensical. Please note that the setting lives in a
+# different subsection, and that the above take precedence over the icon.
+#
+# Read more:
+# - https://zensical.org/docs/setup/logo-and-icons
+# - https://github.com/zensical/ui/tree/master/dist/.icons
+# ----------------------------------------------------------------------------
+#[project.theme.icon]
+#logo = "lucide/smile"
+
+# ----------------------------------------------------------------------------
+# In the "font" subsection you can configure the fonts used. By default, fonts
+# are loaded from Google Fonts, giving you a wide range of choices from a set
+# of suitably licensed fonts. There are options for a normal text font and for
+# a monospaced font used in code blocks.
+# ----------------------------------------------------------------------------
+#[project.theme.font]
+#text = "Inter"
+#code = "Jetbrains Mono"
+
+# ----------------------------------------------------------------------------
+# In the "palette" subsection you can configure options for the color scheme.
+# You can configure different color schemes, e.g., to turn on dark mode,
+# that the user can switch between. Each color scheme can be further
+# customized.
+#
+# Read more:
+# - https://zensical.org/docs/setup/colors/
+# ----------------------------------------------------------------------------
+[[project.theme.palette]]
+scheme = "default"
+toggle.icon = "lucide/sun"
+toggle.name = "Switch to dark mode"
+primary = "red"
+accent = "red"
+
+[[project.theme.palette]]
+scheme = "slate"
+toggle.icon = "lucide/moon"
+toggle.name = "Switch to light mode"
+primary = "red"
+accent = "red"
+
+# ----------------------------------------------------------------------------
+# The "extra" section contains miscellaneous settings.
+# ----------------------------------------------------------------------------
+#[[project.extra.social]]
+#icon = "fontawesome/brands/github"
+#link = "https://github.com/user/repo"
+
+# ----------------------------------------------------------------------------
+# In this section you can configure the Markdown extensions that are used when
+# rendering your documentation. We enable the most useful extensions by default,
+# but you can customize this list to your needs.
+#
+# Read more:
+# - https://zensical.org/docs/setup/extensions/
+# ----------------------------------------------------------------------------
+[project.markdown_extensions.abbr]
+[project.markdown_extensions.admonition]
+[project.markdown_extensions.attr_list]
+[project.markdown_extensions.def_list]
+[project.markdown_extensions.footnotes]
+[project.markdown_extensions.md_in_html]
+[project.markdown_extensions.toc]
+permalink = true
+[project.markdown_extensions.pymdownx.arithmatex]
+generic = true
+[project.markdown_extensions.pymdownx.betterem]
+[project.markdown_extensions.pymdownx.caret]
+[project.markdown_extensions.pymdownx.details]
+[project.markdown_extensions.pymdownx.emoji]
+emoji_generator = "zensical.extensions.emoji.to_svg"
+emoji_index = "zensical.extensions.emoji.twemoji"
+
+[project.markdown_extensions.pymdownx.highlight]
+anchor_linenums = true
+line_spans = "__span"
+pygments_lang_class = true
+
+[project.markdown_extensions.pymdownx.inlinehilite]
+[project.markdown_extensions.pymdownx.keys]
+[project.markdown_extensions.pymdownx.magiclink]
+[project.markdown_extensions.pymdownx.mark]
+[project.markdown_extensions.pymdownx.smartsymbols]
+[project.markdown_extensions.pymdownx.superfences]
+custom_fences = [
+  { name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" }
+]
+
+[project.markdown_extensions.pymdownx.tabbed]
+alternate_style = true
+combine_header_slug = true
+[project.markdown_extensions.pymdownx.tasklist]
+custom_checkbox = true
+[project.markdown_extensions.pymdownx.tilde]