raindown 0.9.1 → 0.11.0

data/lib/raindown/variables.rb

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
 
+require 'antlers/api'
+
 module Raindown
   # The front matter values that Antlers variables like {title} and <{ title }> render.
   # Antlers reads a variable from the binding's locals, then by sending it to the binding's receiver, which is this.
   # It's a BasicObject so a key like "hash" or "display" isn't shadowed by a method, and unknown names render nothing.
-  # Nested values work too, like {author.name} and <{ for: tag in: tags }>.
+  # Nested values are hashes and arrays like {author.name}, {tags.0} or <{ for: name, url in: links }>.
   class Variables < BasicObject
     # Braces in a value become the placeholders that render as braces, so Antlers doesn't read them as a variable.
     def self.wrap(value)
       case value
-      when ::Hash then new(value)
+      when ::Hash then value.transform_values { |item| wrap(item) }
       when ::Array then value.map { |item| wrap(item) }
       when ::String then value.gsub(/[{}]/, CODE_BRACES)
       else value
@@ -20,6 +22,7 @@ module Raindown
     def self.unwrap(value)
       case value
       when Variables then value.to_h
+      when ::Hash then value.transform_values { |item| unwrap(item) }
       when ::Array then value.map { |item| unwrap(item) }
       when ::String then value.tr(CODE_BRACES.values.join, CODE_BRACES.keys.join)
       else value
@@ -28,7 +31,8 @@ module Raindown
 
     # A variable's value, like author.name, read the way {author.name} reads it, unwrapped. Unknown names are nil.
     def self.value(variables, name)
-      unwrap(name.split('.').reduce(variables) { |value, key| value.respond_to?(key) ? value.send(key) : nil })
+      first, *path = name.split('.')
+      unwrap(::Antlers::Queries.read_path(value: variables.send(first), path:))
     end
 
     def initialize(values)

data/lib/raindown/watcher/file_watcher.rb

@@ -51,7 +51,9 @@ module Raindown
 
       # The files' metadata is loaded again each time, so new and renamed files are listed.
       def rewrite
-        Rewriter.update(path:, bare:, execute:, metadata: Pages.for(path))
+        changed = Rewriter.update(path:, bare:, execute:, metadata: Pages.for(path))
+        EndpointRunner.failures(content: Utils.read_markdown(path), path:, bare:).each { warn "Endpoint check failed: #{it}" }
+        changed
       end
     end
   end

data/lib/raindown/watcher/project.rb

@@ -30,6 +30,8 @@ module Raindown
       def update(path)
         changed = Rewriter.update(path:, bare: @bare, execute: @execute, metadata: Pages.for(path))
         puts "[#{name}] Updated #{relative(path)}" if changed
+        EndpointRunner.failures(content: Utils.read_markdown(path), path:, bare: @bare)
+                      .each { warn "[#{name}] Endpoint check failed: #{it}" }
       rescue StandardError => e
         raise if ENV['RAINDOWN_DEBUG']
 

data/lib/raindown/wiki_links.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative 'code'
+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:
+  #   [[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>)
+  # A name matches a file's name, or the end of its path, like [[notes/Reading list]], without its extension and
+  # whatever its case. One that matches no file, and ones in code or front matter, are left as they are, as are
+  # embeds, like ![[photo.png]].
+  module WikiLinks
+    LINK = /(?<!!)\[\[([^\[\]|#\n]+)(?:#([^\[\]|\n]+))?(?:\|([^\[\]\n]+))?\]\]/
+
+    module_function
+
+    def to_markdown(markdown, metadata:)
+      return markdown unless markdown.include?('[[')
+
+      pages = metadata.list
+      links(markdown).reverse_each.with_object(markdown.b) do |link, bytes|
+        page = page_for(link[1], pages)
+        bytes[link.byteoffset(0)[0]...link.byteoffset(0)[1]] = markdown_link(link, page).b if page
+      end.force_encoding('UTF-8')
+    end
+
+    # The links in the Markdown, outside its code and front matter, as matches.
+    def links(markdown)
+      start = markdown.bytesize - FrontMatter.parse(markdown).last.bytesize
+      code = Code.ranges(markdown)
+      found = []
+
+      markdown.scan(LINK) do
+        link = ::Regexp.last_match
+        offset = link.byteoffset(0)[0]
+        found << link if offset >= start && code.none? { it.cover?(offset) }
+      end
+
+      found
+    end
+
+    # The page a name links to: one whose path without its extension is the name, or ends with it.
+    def page_for(name, pages)
+      name = name.strip.downcase.sub(/\.(?:md|rd|markdown|raindown)\z/, '')
+      stems = pages.to_h { [it, it.path.to_s.downcase.sub(%r{\.[^./]+\z}, '')] }
+
+      pages.find { stems[it] == name } || pages.find { stems[it].end_with?("/#{name}") }
+    end
+
+    def markdown_link(link, page)
+      name, heading, label = link.captures.map { it&.strip }
+      label ||= [name, heading].compact.join(' > ')
+      anchor = "##{anchor(heading)}" if heading
+
+      "[#{label.gsub(/[\[\]]/) { "\\#{it}" }}](<#{page.path}#{anchor}>)"
+    end
+
+    # A heading's id, the way Commonmarker makes it, like to-read for "To read".
+    def anchor(heading)
+      heading.downcase.gsub(/[^\p{Word}\- ]/, '').tr(' ', '-')
+    end
+  end
+end

data/lib/raindown.rb

@@ -17,6 +17,7 @@ require_relative 'raindown/pages'
 require_relative 'raindown/pre_renderer'
 require_relative 'raindown/utils'
 require_relative 'raindown/variables'
+require_relative 'raindown/wiki_links'
 
 module Raindown
   # Antlers evaluates any braces in the HTML, so braces in code are swapped for placeholders
@@ -83,6 +84,7 @@ module Raindown
   # 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:))
   end
 

data/lib/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: raindown
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.11.0
 platform: ruby
 authors:
 - maedi
 bindir: bin
 cert_chain: []
-date: 2026-11-03 00:00:00.000000000 Z
+date: 2026-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: antlers
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.2
+        version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.2
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: commonmarker
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +121,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: lowtype
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: plugs
   requirement: !ruby/object:Gem::Requirement
@@ -211,8 +225,13 @@ files:
 - lib/raindown/config.rb
 - lib/raindown/directives.rb
 - lib/raindown/document.rb
+- lib/raindown/editing.rb
 - lib/raindown/endpoint/curl.rb
+- lib/raindown/endpoint/curl_response.rb
+- lib/raindown/endpoint/endpoint_args.rb
 - 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
@@ -220,6 +239,7 @@ files:
 - lib/raindown/heading_ids.rb
 - lib/raindown/js/host.mjs
 - lib/raindown/js/js_nodes.rb
+- lib/raindown/markdown_nodes.rb
 - lib/raindown/node.rb
 - lib/raindown/node_blocks.rb
 - lib/raindown/node_injector.rb
@@ -229,6 +249,7 @@ files:
 - lib/raindown/pre_renderer.rb
 - lib/raindown/projects.rb
 - lib/raindown/rewriter.rb
+- lib/raindown/server.rb
 - lib/raindown/stat.rb
 - lib/raindown/table_formatter.rb
 - lib/raindown/toc.rb
@@ -304,14 +325,15 @@ files:
 - lib/raindown/watcher/file_watcher.rb
 - lib/raindown/watcher/project.rb
 - lib/raindown/watcher/supervisor.rb
+- lib/raindown/wiki_links.rb
 - lib/raindown/workers/worker.rb
 - lib/raindown/workers/workers.rb
 - lib/version.rb
-homepage: https://github.com/raindeer-rb/raindown
+homepage: https://github.com/rainpour/raindown
 licenses: []
 metadata:
-  homepage_uri: https://github.com/raindeer-rb/raindown
-  source_code_uri: https://github.com/raindeer-rb/raindown/src/branch/main
+  homepage_uri: https://github.com/rainpour/raindown
+  source_code_uri: https://github.com/rainpour/raindown/tree/main
 rdoc_options: []
 require_paths:
 - lib