weft 0.1.0

data/lib/weft/shorthands.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Weft
+  # Registry for named interaction shorthands. Each shorthand is a preset of
+  # trigger/swap/target defaults that Context expands via loads:.
+  #
+  # Shipped presets are registered at the bottom of this file. Users will be
+  # able to register custom shorthands in v1.x via the same API.
+  module Shorthands
+    class << self
+      # Register a named interaction shorthand.
+      #
+      #   Weft::Shorthands.register :tooltip, trigger: :hover, swap: :fill
+      def register(name, **defaults)
+        registry[name] = defaults
+      end
+
+      # Look up a registered shorthand by name. Returns the defaults hash or nil.
+      def lookup(name)
+        registry[name]
+      end
+
+      # All registered shorthand names.
+      def registered
+        registry.keys
+      end
+
+      private
+
+      def registry
+        @registry ||= {}
+      end
+    end
+  end
+end
+
+# Shipped interaction shorthands. Adding a new one is one line.
+# The mechanism (Context dispatch + loads: expansion) handles the rest.
+#
+# NOTE: "shorthand" naming is provisional — may be renamed to "pattern"
+# or similar after evaluation (Mission 29).
+
+Weft::Shorthands.register :tooltip,         trigger: :hover, swap: :fill
+Weft::Shorthands.register :inline_expand,   trigger: :click, swap: :after
+Weft::Shorthands.register :lazy,            trigger: :visible, swap: :fill, target: :self
+Weft::Shorthands.register :modal,           trigger: :click, swap: :fill
+Weft::Shorthands.register :load_more,       trigger: :click, swap: :replace, target: :self
+Weft::Shorthands.register :infinite_scroll, trigger: :visible, swap: :after
+Weft::Shorthands.register :live_search,     trigger: :input, swap: :fill
+Weft::Shorthands.register :tabs,            trigger: :click, swap: :fill
+
+# Retry is the odd one out: its value is a URL (the failing component's own GET
+# URL, injected as the :retry_url recovery attr), not a target Class. It ships a
+# concrete hx-target so error components never hand-write htmx — outerHTML-swapping
+# the enclosing .weft-error box replaces the whole error display with the fresh
+# component. Callers override target: for a differently-classed container.
+Weft::Shorthands.register :retry,           trigger: :click, swap: :outer_html, target: "closest .weft-error"

data/lib/weft/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Weft
+  VERSION = "0.1.0"
+end

data/lib/weft.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "logger"
+
+require "active_support"
+require "active_support/core_ext/integer/time"
+require "active_support/core_ext/string/inflections"
+require "arbre"
+
+require "weft/error"
+require "weft/attributes"
+require "weft/dsl/attributes"
+require "weft/dsl/recoveries"
+require "weft/dsl/triggers"
+require "weft/dsl/inclusions"
+require "weft/dsl/updates"
+require "weft/dsl/actions"
+require "weft/dsl/containers"
+require "weft/configuration"
+require "weft/registry"
+require "weft/registry/eligibility"
+require "weft/action"
+require "weft/component"
+require "weft/context"
+require "weft/resolver"
+require "weft/page"
+require "weft/redirect"
+require "weft/router"
+require "weft/version"
+
+# Component-oriented hypermedia for Ruby.
+module Weft
+  class << self
+    attr_writer :logger
+
+    # Weft's process-wide logger. In standalone mode this defaults to a $stdout
+    # Logger at the configured log_level (:info by default) — modeling the
+    # unified activity+error stream a 12-factor Rails container emits under
+    # RAILS_LOG_TO_STDOUT, so deployments aggregate it like any other web
+    # container. When mounted in Rails, set +Weft.logger = Rails.logger+ and
+    # this default never applies. Weft.configure applies log_level to it.
+    def logger
+      @logger ||= Logger.new($stdout)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def registry
+      @registry ||= Registry.new
+    end
+
+    def configure
+      yield configuration
+      apply_configuration
+    end
+
+    # Convenience wrapper for Weft::Redirect.to.
+    def redirect(target, **attrs)
+      Redirect.to(target, **attrs)
+    end
+
+    # Register a named interaction shorthand. Delegates to Weft::Shorthands.
+    #
+    #   Weft.register_shorthand :tooltip, trigger: :hover, swap: :fill
+    def register_shorthand(name, **defaults)
+      Shorthands.register(name, **defaults)
+    end
+
+    # Look up a registered shorthand by name. Delegates to Weft::Shorthands.
+    def shorthand(name)
+      Shorthands.lookup(name)
+    end
+
+    private
+
+    # Apply side-effects from the current Weft.configuration. Called by
+    # Weft.configure after the user block yields. Safe to call multiple
+    # times — each apply step is idempotent.
+    def apply_configuration
+      logger.level = configuration.resolved_log_level
+      Router.set(:logging, configuration.router_logging)
+      enable_auto_reload! if configuration.auto_reload && !@auto_reload_applied
+      apply_static_assets!
+    end
+
+    def enable_auto_reload!
+      require "sinatra/reloader"
+      Router.register(Sinatra::Reloader)
+      configuration.reload_paths.each { |path| Router.also_reload(path) }
+      @auto_reload_applied = true
+    end
+
+    def apply_static_assets!
+      @mounted_static_bundles ||= Set.new
+      configuration.static_assets.each do |name, bundle|
+        next if @mounted_static_bundles.include?(name)
+
+        mount_static_assets_route(bundle[:root], bundle[:from])
+        @mounted_static_bundles << name
+      end
+    end
+
+    # Mount a Sinatra before-filter that serves files under `from` at the URL
+    # prefix `root`. send_file handles content-type/etag/halt; the expand-
+    # path containment check rejects path-traversal attempts (e.g.
+    # /static/../../etc/passwd resolves outside `from` and returns 404).
+    def mount_static_assets_route(root, from)
+      expanded_from = File.expand_path(from)
+      Router.before "#{root}/*" do
+        next unless request.get? || request.head?
+
+        requested = File.expand_path(params[:splat].first, expanded_from)
+        halt 404 unless requested.start_with?("#{expanded_from}/") && File.file?(requested)
+
+        send_file requested
+      end
+    end
+  end
+end
+
+require "weft/shorthands"
+require "weft/defaults"

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: weft
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andy Rusterholz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: arbre
+  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: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sinatra-contrib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Weft is a rapid web development framework where front-end components
+  declare what behaviors are possible, and the back-end routing and request handling
+  is derived automatically. No routes. No controllers. Just Weft.
+email:
+- andyrusterholz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- docs/app-patterns.md
+- docs/arbre.md
+- docs/configuration.md
+- docs/dsl.md
+- docs/error-handling.md
+- docs/examples/README.md
+- docs/examples/active-search.md
+- docs/examples/browser-dialogs.md
+- docs/examples/bulk-update.md
+- docs/examples/click-to-edit.md
+- docs/examples/click-to-load.md
+- docs/examples/delete-row.md
+- docs/examples/edit-row.md
+- docs/examples/file-upload.md
+- docs/examples/infinite-scroll.md
+- docs/examples/inline-expansion.md
+- docs/examples/inline-validation.md
+- docs/examples/keyboard-shortcuts.md
+- docs/examples/lazy-loading.md
+- docs/examples/live-ticker.md
+- docs/examples/modal-dialog.md
+- docs/examples/progress-bar.md
+- docs/examples/reset-user-input.md
+- docs/examples/tabs.md
+- docs/examples/tooltip.md
+- docs/examples/updating-other-content.md
+- docs/examples/value-select.md
+- docs/routing.md
+- docs/tutorial.md
+- lib/weft.rb
+- lib/weft/action.rb
+- lib/weft/attributes.rb
+- lib/weft/component.rb
+- lib/weft/configuration.rb
+- lib/weft/context.rb
+- lib/weft/context/interception.rb
+- lib/weft/defaults.rb
+- lib/weft/defaults/error_component.rb
+- lib/weft/defaults/error_page.rb
+- lib/weft/defaults/not_found_component.rb
+- lib/weft/defaults/not_found_page.rb
+- lib/weft/dsl/actions.rb
+- lib/weft/dsl/attributes.rb
+- lib/weft/dsl/containers.rb
+- lib/weft/dsl/inclusions.rb
+- lib/weft/dsl/recoveries.rb
+- lib/weft/dsl/triggers.rb
+- lib/weft/dsl/updates.rb
+- lib/weft/error.rb
+- lib/weft/page.rb
+- lib/weft/redirect.rb
+- lib/weft/registry.rb
+- lib/weft/registry/eligibility.rb
+- lib/weft/resolver.rb
+- lib/weft/router.rb
+- lib/weft/router/actions.rb
+- lib/weft/router/errors.rb
+- lib/weft/router/oob_includes.rb
+- lib/weft/router/streaming.rb
+- lib/weft/shorthands.rb
+- lib/weft/version.rb
+homepage: https://github.com/rusterholz/weft
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rusterholz/weft
+  source_code_uri: https://github.com/rusterholz/weft
+  changelog_uri: https://github.com/rusterholz/weft/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Component-oriented hypermedia for Ruby.
+test_files: []