funicular 0.0.1 → 0.1.0

data/sig/patcher.rbs

@@ -0,0 +1,15 @@
+module Funicular
+  module VDOM
+    BOOLEAN_ATTRIBUTES: Array[String]
+
+    class Patcher
+      def initialize: (?JS::Object? doc) -> void
+      def apply: (JS::Object element, Array[patch_t] patches) -> JS::Object
+
+      private def update_props: (JS::Object element, Hash[Symbol, String?] props_patch) -> void
+      private def create_element: (untyped vnode) -> JS::Object
+      private def unmount_component: (VDOM::VNode vnode) -> void
+    end
+
+  end
+end

data/sig/router.rbs

@@ -0,0 +1,43 @@
+module Funicular
+  type route_constraints_t = Hash[Symbol, Regexp]
+  type route_definition_t = { method: Symbol, path: String, component: singleton(Component), name: String?, pattern_segments: Array[String], constraints: route_constraints_t }
+
+  # URL helper methods are dynamically generated based on route definitions
+  # Example: router.get('/users/:id', to: UserComponent, as: 'user')
+  # generates: user_path(id) -> String
+  module RouteHelpers
+    # Dynamic methods are generated at runtime by Router#generate_url_helper
+    # Method signatures depend on route parameters:
+    # - No parameters: def helper_name_path: () -> String
+    # - With parameters: def helper_name_path: (Integer | String | untyped) -> String
+    def method_missing: (Symbol method, *untyped args) -> String
+    def respond_to_missing?: (Symbol method, ?bool include_private) -> bool
+  end
+
+  class Router
+    attr_reader routes: Array[route_definition_t]
+    attr_reader current_component: Component?
+    attr_reader current_path: String?
+
+    def initialize: (JS::Object container) -> void
+    def get: (String path, to: singleton(Component), ?as: String?, ?constraints: route_constraints_t?) -> void
+    def post: (String path, to: singleton(Component), ?as: String?, ?constraints: route_constraints_t?) -> void
+    def put: (String path, to: singleton(Component), ?as: String?, ?constraints: route_constraints_t?) -> void
+    def patch: (String path, to: singleton(Component), ?as: String?, ?constraints: route_constraints_t?) -> void
+    def delete: (String path, to: singleton(Component), ?as: String?, ?constraints: route_constraints_t?) -> void
+    def add_route: (String path, singleton(Component) component_class, ?as: String?, ?constraints: route_constraints_t?) -> void
+    def set_default: (String path) -> void
+    def start: () -> void
+    def stop: () -> void
+    def navigate: (String path) -> void
+    def current_hash_path: () -> String
+    def current_location_path: () -> String
+
+    private def add_route_with_method: (Symbol method, String path, singleton(Component) component_class, String? name, ?route_constraints_t? constraints) -> void
+    private def generate_url_helper: (String name, String path_pattern) -> void
+    private def extract_param_names: (String path_pattern) -> Array[Symbol]
+    private def handle_route_change: () -> void
+    private def unmount_current_component: () -> void
+    private def find_route: (String path) -> [singleton(Component) | nil, Hash[Symbol, untyped]]
+  end
+end

data/sig/styles.rbs

@@ -0,0 +1,25 @@
+module Funicular
+  # StyleValue represents a CSS class string that can be combined with other styles
+  class StyleValue
+    attr_reader value: String
+    def initialize: (String | untyped value) -> void
+    def |: (StyleValue | String | nil other) -> StyleValue
+    def to_s: () -> String
+  end
+
+  # StyleAccessor provides access to defined styles via method calls
+  class StyleAccessor
+    def initialize: (Hash[Symbol, Hash[Symbol, untyped]] definitions) -> void
+    private def method_missing: (Symbol name, *untyped args) -> StyleValue
+    private def respond_to_missing?: (Symbol name, ?bool include_private) -> bool
+  end
+
+  # StyleBuilder is used to define styles within the styles {} block
+  class StyleBuilder
+    @definitions: Hash[Symbol, Hash[Symbol, untyped]]
+
+    def initialize: () -> void
+    def to_definitions: () -> Hash[Symbol, Hash[Symbol, untyped]]
+    private def method_missing: (Symbol name, *untyped args) -> void
+  end
+end

data/sig/vdom.rbs

@@ -0,0 +1,59 @@
+module Funicular
+  module VDOM
+    type patch_t = Array[untyped]
+    type child_t = Element | Text | Component | String | Array[Element | Text | Component | String]
+
+    URL_ATTRIBUTES: Array[String]
+
+    class VNode
+      attr_reader type: Symbol
+      attr_reader key: untyped
+
+      def initialize: (Symbol type) -> void
+    end
+
+    class Element < VNode
+      attr_reader tag: String
+      attr_reader props: Hash[Symbol, untyped]
+      attr_reader children: Array[child_t]
+
+      def initialize: (String tag, ?Hash[Symbol, untyped] props, ?Array[child_t] children) -> void
+      def ==: (untyped other) -> bool
+      private def normalize_children: (Array[child_t] children) -> Array[child_t]
+    end
+
+    class Text < VNode
+      attr_reader content: String
+
+      def initialize: (String content) -> void
+      def ==: (untyped other) -> bool
+    end
+
+    class Renderer
+      @error_boundary_stack: Array[Funicular::ErrorBoundary]
+
+      def initialize: (?JS::Object? doc) -> void
+      def render: (VDOM::VNode | VDOM::Text | nil vnode, ?JS::Object? parent) -> JS::Object
+
+      private def current_error_boundary: () -> ErrorBoundary?
+      private def render_element: (Element element, JS::Object? parent) -> JS::Object
+      private def render_text: (VDOM::Text text, JS::Object? parent) -> JS::Object
+      private def render_component: (VDOM::Component component_vnode, JS::Object? parent) -> JS::Object
+    end
+
+    def self.create_element: (String tag, ?Hash[Symbol, untyped] props, *child_t children) -> Element
+    def self.create_text: (String content) -> Text
+    def self.render: (VNode vnode, JS::Object container) -> void
+    def self.diff: (VNode? old_vnode, VNode? new_vnode) -> Array[patch_t]
+    def self.patch: (JS::Object element, Array[patch_t] patches) -> JS::Object
+
+    class Component < VNode
+      attr_reader component_class: untyped
+      attr_reader props: Hash[Symbol, untyped]
+      attr_accessor instance: untyped
+
+      def initialize: (untyped component_class, ?Hash[Symbol, untyped] props) -> void
+      def ==: (untyped other) -> bool
+    end
+  end
+end

metadata

@@ -1,18 +1,34 @@
 --- !ruby/object:Gem::Specification
 name: funicular
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - HASUMI Hitoshi
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: Funicular is a tool
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+description: Funicular enables you to write client-side UI components in Ruby, powered
+  by PicoRuby.wasm
 email:
 - hasumikin@gmail.com
-executables: []
+executables:
+- funicular
 extensions: []
 extra_rdoc_files: []
 files:
@@ -21,14 +37,108 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- demo/keymap_editor.html
+- demo/test_cable.html
+- demo/test_chartjs.html
+- demo/test_component.html
+- demo/test_diff_patch.html
+- demo/test_error_boundary.html
+- demo/test_router.html
+- demo/test_vdom.html
+- demo/tic-tac-toe.html
+- docs/README.md
+- docs/advanced-features.md
+- docs/architecture.md
+- docs/components-and-state.md
+- docs/data-fetching.md
+- docs/forms.md
+- docs/rails-integration.md
+- docs/realtime.md
+- docs/routing-and-navigation.md
+- docs/styling.md
+- exe/funicular
 - lib/funicular.rb
+- lib/funicular/assets/funicular.rb
+- lib/funicular/assets/funicular_debug.css
+- lib/funicular/assets/funicular_debug.js
+- lib/funicular/commands/routes.rb
+- lib/funicular/compiler.rb
+- lib/funicular/configuration.rb
+- lib/funicular/helpers/picoruby_helper.rb
+- lib/funicular/middleware.rb
+- lib/funicular/railtie.rb
+- lib/funicular/route_parser.rb
+- lib/funicular/vendor/picorbc/VERSION
+- lib/funicular/vendor/picorbc/picorbc.js
+- lib/funicular/vendor/picorbc/picorbc.wasm
+- lib/funicular/vendor/picoruby/VERSION
+- lib/funicular/vendor/picoruby/debug/init.iife.js
+- lib/funicular/vendor/picoruby/debug/picoruby.js
+- lib/funicular/vendor/picoruby/debug/picoruby.wasm
+- lib/funicular/vendor/picoruby/dist/init.iife.js
+- lib/funicular/vendor/picoruby/dist/picoruby.js
+- lib/funicular/vendor/picoruby/dist/picoruby.wasm
 - lib/funicular/version.rb
+- lib/tasks/funicular.rake
+- minitest/funicular_test.rb
+- minitest/test_helper.rb
+- mrbgem.rake
+- mrblib/cable.rb
+- mrblib/component.rb
+- mrblib/debug.rb
+- mrblib/differ.rb
+- mrblib/environment_inquirer.rb
+- mrblib/error_boundary.rb
+- mrblib/file_upload.rb
+- mrblib/form_builder.rb
+- mrblib/funicular.rb
+- mrblib/http.rb
+- mrblib/model.rb
+- mrblib/patcher.rb
+- mrblib/router.rb
+- mrblib/styles.rb
+- mrblib/vdom.rb
+- sig/cable.rbs
+- sig/component.rbs
+- sig/debug.rbs
+- sig/differ.rbs
+- sig/environment_iquirer.rbs
+- sig/error_boundary.rbs
+- sig/file_upload.rbs
+- sig/form_builder.rbs
 - sig/funicular.rbs
-homepage: https://github.com/hasumikin/funicular
+- sig/http.rbs
+- sig/model.rbs
+- sig/patcher.rbs
+- sig/router.rbs
+- sig/styles.rbs
+- sig/vdom.rbs
+homepage: https://github.com/picoruby/funicular
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/hasumikin/funicular
+  homepage_uri: https://picoruby.org/funicular-getting-started
+  source_code_uri: https://github.com/picoruby/funicular
+  changelog_uri: https://github.com/picoruby/funicular/blob/master/CHANGELOG.md
+post_install_message: |2+
+
+  Thank you for installing Funicular!
+
+  Funicular bundles a WebAssembly build of picorbc, which compiles your
+  Ruby code to .mrb bytecode. Make sure Node.js is installed on machines
+  that run the compilation.
+
+  Funicular works in two modes:
+
+    Standalone: include PicoRuby.wasm directly in any HTML page using the
+    bundled WASM artifacts. No server framework required.
+
+    Rails integration: use the Railtie, middleware, and view helpers for
+    seamless asset pipeline support.
+      bin/rails funicular:install
+
+  For more information: https://github.com/picoruby/funicular
+
 rdoc_options: []
 require_paths:
 - lib
@@ -43,7 +153,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.0.dev
+rubygems_version: 4.0.4
 specification_version: 4
-summary: Funicular
+summary: Rails plugin for client-side Ruby development with mruby
 test_files: []
+...