raindown 0.13.0 → 0.15.0

data/lib/raindown/watcher/changes.rb

@@ -19,10 +19,12 @@ module Raindown
       Listen.to(directory, ignore: IGNORE) { |modified, added, removed| yield(modified + added + removed) }
     end
 
-    # The changes among the paths, by the project each is in, the nearest one above it, or else the root, when there is
-    # one, leaving out files that are neither nodes nor Markdown, or are in ignored folders.
-    def self.changes(paths, root: nil)
+    # The changes among the paths in the directory, by the project each is in, the nearest one above it, or else the
+    # root, when there is one, leaving out files that are neither nodes nor Markdown, or are in ignored folders or vaults.
+    def self.changes(paths, directory:, root: nil)
       paths.filter_map do |path|
+        next if Projects.vault_below?(path, directory)
+
         project = Projects.root(path) || root || next
         next Change.new(root: project, path:, nodes: true) if Projects.node?(path, root: project)
 

data/lib/raindown/watcher/supervisor.rb

@@ -42,7 +42,7 @@ module Raindown
       # endpoint's request with -x, only holds up its own project. Without fork, the projects share this process, so
       # they're taken in turn.
       def handle(paths)
-        Watcher.changes(paths).each do |change|
+        Watcher.changes(paths, directory:).each do |change|
           next unless change.nodes? || change.saved?
           next take(change) unless fork?
 

data/lib/raindown/wiki_links.rb

@@ -5,7 +5,7 @@ require_relative 'front_matter'
 
 module Raindown
   # Obsidian's links between notes, which render as Markdown links to the file they name, by its path in the project,
-  # like files: links, while the file keeps them as they are:
+  # like list: links, while the file keeps them as they are:
   #   [[Reading list]]                   [Reading list](<notes/Reading list.md>)
   #   [[Reading list|books]]             [books](<notes/Reading list.md>)
   #   [[Reading list#To read]]           [Reading list > To read](<notes/Reading list.md#to-read>)

data/lib/raindown.rb

@@ -8,6 +8,7 @@ require_relative 'elements'
 require_relative 'raindown/bare_directives'
 require_relative 'raindown/code'
 require_relative 'raindown/config'
+require_relative 'raindown/context'
 require_relative 'raindown/directives'
 require_relative 'raindown/fragments'
 require_relative 'raindown/front_matter'
@@ -32,7 +33,7 @@ module Raindown
   # Without highlighting, code blocks are left for the browser to highlight, like <pre><code class="language-ruby">.
   UNHIGHLIGHTED_OPTIONS = { render: { **HTML_OPTIONS[:render], github_pre_lang: false } }.freeze
 
-  # Stands in for an app's metadata when there isn't any, so list: and files: list nothing.
+  # Stands in for an app's metadata when there isn't any, so list: lists nothing.
   module NoMetadata
     def self.list(**) = []
   end
@@ -49,13 +50,12 @@ module Raindown
   # Bare directives like "toc:" show in bold in the HTML, and the rest stay hidden, as comments.
   # Code blocks are highlighted, unless highlight_code is false for a site that highlights code in the browser.
   def render(markdown:, metadata: NoMetadata, bare: false, highlight_code: true)
-    bare ||= BareDirectives.front_matter?(markdown)
+    context = Context.new(document: markdown, metadata:, bare: bare || BareDirectives.front_matter?(markdown))
 
     highlighting(highlight_code) do
       Fragments.collect do
         # Components' HTML goes back in, then their headings get unique ids, before nodes like the TOC see it.
-        html = assembled(markdown:, metadata:, bare:)
-        html = Nodes.render_placeholders(html, document: markdown, metadata:, bare:, html:)
+        html = Nodes.render_placeholders(assembled(context), context)
 
         Directives.render("#{html.chomp}\n")
       end
@@ -77,15 +77,14 @@ module Raindown
   end
 
   # The document's HTML with its components' HTML put back, and unique heading ids.
-  def assembled(markdown:, metadata: NoMetadata, bare: false)
-    HeadingIds.unique(Fragments.fill(html(markdown:, variables: variables(markdown:), metadata:, bare:)))
+  def assembled(context)
+    HeadingIds.unique(Fragments.fill(html(context)))
   end
 
   # The document's HTML from Commonmarker, after nodes and the template pass, with components as fragments.
-  def html(markdown:, variables:, metadata: NoMetadata, bare: false)
-    markdown = NodeBlocks.to_rendered(markdown.dup.force_encoding('UTF-8'), metadata:, bare:)
-    markdown = WikiLinks.to_markdown(markdown, metadata:)
-    commonmark(PreRenderer.render(markdown, variables:, metadata:, bare:))
+  def html(context)
+    markdown = WikiLinks.to_markdown(NodeBlocks.to_rendered(context), metadata: context.metadata)
+    commonmark(PreRenderer.render(markdown, variables: context.variables, context:))
   end
 
   # Markdown to HTML, like a document's or a component's slot.
@@ -103,10 +102,6 @@ module Raindown
     doc.to_html(options: UNHIGHLIGHTED_OPTIONS, plugins: { syntax_highlighter: nil })
   end
 
-  def variables(markdown:)
-    Variables.new(FrontMatter.parse(markdown).first)
-  end
-
   # Commonmarker escapes directives, so they're hidden in HTML comments until it's done.
   def hide_directives(markdown:)
     markdown.gsub('<{', '<!-- ANTLERS').gsub('}>', 'ANTLERS -->').force_encoding('UTF-8')

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Raindown
-  VERSION = '0.13.0'
+  VERSION = '0.15.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: raindown
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.15.0
 platform: ruby
 authors:
 - maedi
 bindir: bin
 cert_chain: []
-date: 2026-11-05 00:00:00.000000000 Z
+date: 2026-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: antlers
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.5.0
 - !ruby/object:Gem::Dependency
   name: commonmarker
   requirement: !ruby/object:Gem::Requirement
@@ -204,10 +204,10 @@ files:
 - bin/raindown
 - lib/elements.rb
 - lib/lexemes/endpoint_lexeme.rb
-- lib/lexemes/list_lexeme.rb
-- lib/nodes/component_nodes.rb
+- lib/lexemes/node_lexeme.rb
 - lib/nodes/endpoint_node.rb
 - lib/nodes/list_node.rb
+- lib/nodes/write_in_node.rb
 - lib/raindown.rb
 - lib/raindown/actions.rb
 - lib/raindown/bare_directives.rb
@@ -223,6 +223,7 @@ files:
 - lib/raindown/code.rb
 - lib/raindown/code_blocks.rb
 - lib/raindown/config.rb
+- lib/raindown/context.rb
 - lib/raindown/directives.rb
 - lib/raindown/document.rb
 - lib/raindown/editing.rb
@@ -232,13 +233,13 @@ files:
 - lib/raindown/endpoint/endpoint_runner.rb
 - lib/raindown/endpoint/endpoint_variables.rb
 - lib/raindown/endpoint/schema_block.rb
-- lib/raindown/files.rb
 - lib/raindown/fragments.rb
 - lib/raindown/front_matter.rb
 - lib/raindown/gitignore.rb
 - lib/raindown/heading_ids.rb
 - lib/raindown/js/host.mjs
 - lib/raindown/js/js_nodes.rb
+- lib/raindown/list.rb
 - lib/raindown/markdown_nodes.rb
 - lib/raindown/node.rb
 - lib/raindown/node_blocks.rb
@@ -253,7 +254,9 @@ files:
 - lib/raindown/stat.rb
 - lib/raindown/table/markdown_table.rb
 - lib/raindown/table/table.rb
-- lib/raindown/table_formatter.rb
+- lib/raindown/table/table_formatter.rb
+- lib/raindown/table/table_formulas.rb
+- lib/raindown/table/written_table.rb
 - lib/raindown/toc.rb
 - lib/raindown/tui.rb
 - lib/raindown/tui/blueprints/blueprints_renderer.rb

data/lib/lexemes/list_lexeme.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require 'antlers/api'
-
-module Raindown
-  module ListLexeme
-    include Antlers::Lexeme
-
-    module_function
-
-    KEYWORDS = ['list:', 'folder:', 'order:', ':list'].freeze
-
-    def match?(keywords:, **)
-      KEYWORDS.include?(keywords.keys.first)
-    end
-
-    def lexeme(keywords:, **)
-      if keywords['list:']
-        *key, value = keywords['list:'].split(',').map(&:strip)
-
-        list_def = { list_def: value, folder: keywords['folder:'] }
-        list_def[:order] = keywords['order:'] if keywords['order:']
-        list_def[:key] = key.first unless key.empty?
-
-        return list_def
-      end
-
-      # TODO: Keep track of which list loop we're in to allow nested list loops.
-      { list_end: 'level_1' }
-    end
-  end
-end

data/lib/nodes/component_nodes.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-require 'antlers/api'
-require 'nodes/html_node'
-require 'nodes/prop_node'
-require 'nodes/slot_node'
-require_relative '../raindown/fragments'
-
-module Raindown
-  # <{ Card name=p.name }>, rendered by Antlers where it is in the template, so its props see loop variables.
-  # Its HTML is kept as a fragment, so Commonmarker doesn't read it as Markdown.
-  class PropComponentNode < Antlers::PropNode
-    def render(**)
-      Fragments.add(super)
-    end
-  end
-
-  # <{ Card: }>...<{ :Card }>, whose slot is its own Markdown, rendered to HTML in its scope first.
-  #
-  # Markdown children -> rendered to a Markdown string -> Commonmarker -> HTML
-  #   -> wrapped as a single Antlers::HTMLNode (replaces @children for the super call)
-  #   -> Antlers::SlotNode#render's "without a template" branch -> slot: receives that HTML
-  #   -> Card#render(slot:, **props)
-  #
-  # This only reaches Card#render directly when Card has no class-level template (see SlotNode#render);
-  # otherwise Antlers renders Card's own template instead, with this HTML passed to it as the slot_node.
-  class SlotComponentNode < Antlers::SlotNode
-    def render(current_binding: nil, parent_binding: nil, slot_node: nil, metadata: {})
-      markdown = @children.map { |child| child.render(current_binding:, parent_binding:, slot_node:, metadata:) || '' }.join
-      children = @children
-      @children = [Antlers::HTMLNode.new(html: Raindown.commonmark(markdown))]
-
-      Fragments.add(super)
-    ensure
-      @children = children if children
-    end
-  end
-end

data/lib/raindown/files.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'node'
-
-module Raindown
-  # The node behind files:, a list of links to the files the metadata has for its props, like files: folder: 'notes'.
-  # A project can change how files are listed with its own Files node in .raindown, like "class Files < Raindown::Files".
-  class Files < Node
-    def initialize(**tags)
-      @tags = tags
-    end
-
-    # Each file has its front matter, its path and its content.
-    def files(metadata: NoMetadata)
-      metadata.list(**@tags)
-    end
-
-    def replace(metadata: NoMetadata)
-      files(metadata:).map { |file| "- [#{file.title || file.path}](#{file.path})" }.join("\n")
-    end
-  end
-end