funicular 0.1.0 → 0.2.0

data/sig/model.rbs

@@ -1,5 +1,8 @@
 module Funicular
   class Model
+    include Funicular::Model::Validations
+    extend Funicular::Model::Validations::ClassMethods
+
     attr_reader id: untyped
     @changed_attributes: Hash[String, untyped]
 
@@ -10,10 +13,12 @@ module Funicular
 
     def initialize: (?Hash[untyped, untyped] attributes) -> void
     def self.load_schema: (Hash[String, untyped] schema_data) -> void
+    def self.register_schema_validations: (untyped validations) -> void
+    def self.normalize_validation_options: (Symbol | String kind, untyped opts) -> untyped
 
     def self.all: (?Hash[untyped, untyped] params) ?{ (Array[Model]? instances, String? error) -> void } -> void
     def self.find: (?untyped id, ?endpoint_name: String, ?model_class: singleton(Model)) ?{ (Model? instance, String? error) -> void } -> void
-    def self.create: (Hash[untyped, untyped] attrs, ?model_class: singleton(Model)) ?{ (Model? instance, String? error) -> void } -> void
+    def self.create: (Hash[untyped, untyped] attrs, ?model_class: singleton(Model)) ?{ (Model? instance, untyped error) -> void } -> void
     def self.destroy: (?untyped id) ?{ (bool success, untyped result) -> void } -> void
 
     def update: (?Hash[untyped, untyped]? attrs) ?{ (bool success, untyped result) -> void } -> void

data/sig/patcher.rbs

@@ -3,9 +3,12 @@ module Funicular
     BOOLEAN_ATTRIBUTES: Array[String]
 
     class Patcher
-      def initialize: (?JS::Object? doc) -> void
+      def initialize: (?JS::Element? doc) -> void
+      # `apply` accepts any DOM node so text-node patches (e.g. :replace)
+      # can recurse into it; Element-only operations are narrowed inside.
       def apply: (JS::Object element, Array[patch_t] patches) -> JS::Object
 
+      # Accepts JS::Object since callers narrow via is_a?(JS::Element) at runtime
       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

data/sig/router.rbs

@@ -19,7 +19,7 @@ module Funicular
     attr_reader current_component: Component?
     attr_reader current_path: String?
 
-    def initialize: (JS::Object container) -> void
+    def initialize: (JS::Element? 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
@@ -27,7 +27,8 @@ module Funicular
     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 match: (String path) -> [singleton(Component)?, Hash[Symbol, untyped]]
+    def start: (?hydrate: bool) -> void
     def stop: () -> void
     def navigate: (String path) -> void
     def current_hash_path: () -> String

data/sig/store.rbs

@@ -0,0 +1,89 @@
+module Funicular
+  class Store
+    EVENT_REGISTRY: Hash[Symbol, Array[singleton(Funicular::Store)]]
+    KVS_POOL: Hash[Array[String], IndexedDB::KVS]
+
+    class SubscribesTo < Data
+      attr_reader channel_name: String
+      attr_reader params_proc: ^(Funicular::Store::Scope) -> Hash[Symbol, untyped]
+      attr_reader handler_block: Proc
+
+      def self.new: (String channel_name, ^(Funicular::Store::Scope) -> Hash[Symbol, untyped] params_proc, Proc handler_block) -> instance
+    end
+
+    class Subscription
+      attr_reader cable_sub: Funicular::Cable::Subscription
+
+      def initialize: (Funicular::Cable::Subscription cable_sub) -> void
+      def unsubscribe: () -> nil
+    end
+
+    class Scope
+      attr_reader store_class: singleton(Funicular::Store)
+      attr_reader scope_kwargs: Hash[Symbol, untyped]
+
+      @on_change: Hash[Integer, Proc]
+      @next_cb_id: Integer
+      @subscription: Funicular::Store::Subscription?
+
+      def initialize: (singleton(Funicular::Store) store_class, Hash[Symbol, untyped] scope_kwargs) -> void
+      def method_missing: (Symbol name, *untyped args) -> untyped
+      def respond_to_missing?: (Symbol name, ?bool include_private) -> bool
+      def on_change: () { (untyped) -> void } -> Integer
+      def off_change: (Integer id) -> nil
+      def subscribed?: () -> bool
+      def subscription: () -> Funicular::Store::Subscription?
+      def subscribe!: () -> Funicular::Store::Subscription
+      def unsubscribe!: () -> nil
+
+      private def storage_key: () -> String
+      private def kvs: () -> IndexedDB::KVS
+      private def now_seconds: () -> Integer
+      private def expired_record?: (untyped rec) -> bool
+      private def fire_change: (untyped snapshot) -> void
+    end
+
+    self.@__database: String?
+    self.@__kvs_store_name: String?
+    self.@__scope_keys: Array[Symbol]?
+    self.@__expires_in: Integer?
+    self.@__source: untyped
+    self.@__belongs_to: Symbol?
+    self.@__cable_url: String?
+    self.@__cable_binding: SubscribesTo?
+    self.@__cleared_handlers: Hash[Symbol, Proc?]?
+    self.@__scope_pool: Hash[Hash[Symbol, untyped], Funicular::Store::Scope]?
+    self.@__consumer: Funicular::Cable::Consumer?
+
+    def self.database: (String name) -> String
+    def self.kvs_store: (String name) -> String
+    def self.scope: (*Symbol keys) -> Array[Symbol]
+    def self.expires_in: (Integer seconds) -> Integer
+    def self.source: (untyped model_class) -> untyped
+    def self.belongs_to: (Symbol name) -> Symbol
+    def self.cable_url: (String url) -> String
+    def self.subscribes_to: (String channel_name, params: ^(Funicular::Store::Scope) -> Hash[Symbol, untyped]) { (untyped, Funicular::Store::Scope) -> void } -> SubscribesTo
+    def self.cleared_on: (*Symbol event_names) ?{ (untyped) -> void } -> void
+
+    def self.where: (**untyped scope_kwargs) -> Funicular::Store::Scope
+    def self.scope_class: () -> singleton(Funicular::Store::Scope)
+
+    def self.__database: () -> String?
+    def self.__kvs_store_name: () -> String?
+    def self.__scope_keys: () -> Array[Symbol]?
+    def self.__expires_in: () -> Integer?
+    def self.__source: () -> untyped
+    def self.__belongs_to: () -> Symbol?
+    def self.__cable_url: () -> String?
+    def self.__cable_binding: () -> SubscribesTo?
+    def self.__cleared_handlers: () -> Hash[Symbol, Proc?]?
+    def self.__kvs: () -> IndexedDB::KVS
+    def self.__consumer: () -> Funicular::Cable::Consumer
+    def self.__handle_dispatch: (Symbol event, untyped payload) -> void
+    def self.__clear_all!: () -> nil
+
+    private def self.validate_scope_kwargs!: (Hash[Symbol, untyped] scope_kwargs) -> void
+
+    def self.dispatch: (Symbol | String event, ?untyped payload) -> nil
+  end
+end

data/sig/store_collection.rbs

@@ -0,0 +1,43 @@
+module Funicular
+  class Store
+    class Collection < Funicular::Store
+      DEFAULT_KEY_PROC: ^(untyped) -> untyped
+
+      self.@__limit: Integer?
+      self.@__order: Symbol?
+      self.@__key_proc: ^(untyped) -> untyped | nil
+
+      def self.limit: (Integer n) -> Integer
+      def self.order: (Symbol direction) -> Symbol
+      def self.key: (^(untyped) -> untyped proc) -> (^(untyped) -> untyped)
+      def self.scope_class: () -> singleton(Funicular::Store::Collection::Scope)
+
+      def self.__limit: () -> Integer?
+      def self.__order: () -> Symbol?
+      def self.__key_proc: () -> (^(untyped) -> untyped | nil)
+
+      class Scope < Funicular::Store::Scope
+        attr_reader store_class: singleton(Funicular::Store::Collection)
+        @store_class: singleton(Funicular::Store::Collection)
+
+        def all: () -> Array[untyped]
+        def replace: (untyped arr) -> Array[untyped]
+        def append: (untyped item) -> Array[untyped]
+        def remove: (untyped id) -> Array[untyped]
+        def last: () -> untyped
+        def last_id: () -> untyped
+        def size: () -> Integer
+        def clear: () -> nil
+        def expired?: () -> bool
+        def same_tail?: (untyped other) -> bool
+
+        private def key_proc: () -> ^(untyped) -> untyped
+        private def cap: (Array[untyped] arr) -> Array[untyped]
+        private def append_to: (Array[untyped] arr, untyped item) -> Array[untyped]
+        private def read: () -> untyped
+        private def write: (Array[untyped] items) -> Hash[String, untyped]
+        private def erase: () -> nil
+      end
+    end
+  end
+end

data/sig/store_singleton.rbs

@@ -0,0 +1,19 @@
+module Funicular
+  class Store
+    class Singleton < Funicular::Store
+      def self.scope_class: () -> singleton(Funicular::Store::Singleton::Scope)
+
+      class Scope < Funicular::Store::Scope
+        def value: () -> untyped
+        def value=: (untyped v) -> untyped
+        def delete: () -> nil
+        def present?: () -> bool
+        def expired?: () -> bool
+
+        private def read: () -> untyped
+        private def write: (untyped v) -> Hash[String, untyped]
+        private def erase: () -> nil
+      end
+    end
+  end
+end

data/sig/validations.rbs

@@ -0,0 +1,103 @@
+module Funicular
+  class Model
+    # Validation error collection (a small slice of ActiveModel::Errors).
+    class Errors
+      @messages: Hash[Symbol, Array[String]]
+
+      def initialize: () -> void
+      def add: (Symbol | String attribute, String message) -> String
+      def []: (Symbol | String attribute) -> Array[String]
+      def added?: (Symbol | String attribute) -> bool
+      def messages: () -> Hash[Symbol, Array[String]]
+      def full_messages: () -> Array[String]
+      def clear: () -> void
+      def empty?: () -> bool
+      def any?: () -> bool
+
+      private
+      def humanize: (Symbol | String attribute) -> String
+    end
+
+    # ActiveModel-style validation, mixed into Model.
+    module Validations
+      def self.included: (untyped base) -> void
+
+      # Base class for attribute validators.
+      class EachValidator
+        @attributes: Array[Symbol]
+        @options: Hash[Symbol, untyped]
+
+        attr_reader attributes: Array[Symbol]
+        attr_reader options: Hash[Symbol, untyped]
+
+        def initialize: (attributes: Array[Symbol], **untyped options) -> void
+        def kind: () -> Symbol
+        def validate: (untyped record) -> void
+        def validate_each: (untyped record, Symbol attribute, untyped value) -> void
+
+        private
+        def blank?: (untyped value) -> bool
+        def present?: (untyped value) -> bool
+      end
+
+      module ClassMethods
+        @validators: Array[EachValidator]
+
+        SHARED_OPTIONS: Array[Symbol]
+
+        def validators: () -> Array[EachValidator]
+        def validators_on: (Symbol | String attribute) -> Array[EachValidator]
+        def validates: (*Symbol | String attributes, **untyped options) -> void
+        def add_schema_validator: (Symbol | String attribute, Symbol | String kind, untyped opts) -> void
+
+        private
+        def validator_class_for: (Symbol | String key) -> singleton(EachValidator)?
+        def symbolize_keys: (untyped hash) -> Hash[Symbol, untyped]
+      end
+
+      # Instance API (mixed into Model).
+      @errors: Errors
+      def errors: () -> Errors
+      def read_attribute_for_validation: (Symbol attribute) -> untyped
+      def valid?: () -> bool
+      def invalid?: () -> bool
+
+      # --- concrete validators ---
+
+      class PresenceValidator < EachValidator
+      end
+
+      class AbsenceValidator < EachValidator
+      end
+
+      class LengthValidator < EachValidator
+        private
+        def range_include?: (untyped range, Integer length) -> bool
+      end
+
+      class FormatValidator < EachValidator
+      end
+
+      class NumericalityValidator < EachValidator
+        CHECKS: Hash[Symbol, String]
+
+        private
+        def compare: (Numeric number, Symbol option, untyped target) -> bool
+        def message_for: (Symbol option, untyped target) -> String
+        def to_number: (untyped value) -> (Numeric | nil)
+      end
+
+      class InclusionValidator < EachValidator
+      end
+
+      class ExclusionValidator < EachValidator
+      end
+
+      class AcceptanceValidator < EachValidator
+      end
+
+      class ConfirmationValidator < EachValidator
+      end
+    end
+  end
+end

data/sig/vdom.rbs

@@ -32,18 +32,18 @@ module Funicular
     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
+      def initialize: (?JS::Element? doc) -> void
+      def render: (VDOM::VNode | VDOM::Text | nil vnode, ?JS::Element? parent) -> JS::Element
 
       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
+      private def render_element: (Element element, JS::Element? parent) -> JS::Element
+      private def render_text: (VDOM::Text text, JS::Element? parent) -> JS::Element
+      private def render_component: (VDOM::Component component_vnode, JS::Element? parent) -> JS::Element
     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.render: (VNode vnode, JS::Element 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
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: funicular
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - HASUMI Hitoshi
@@ -46,18 +46,10 @@ files:
 - 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.css
 - lib/funicular/assets/funicular.rb
 - lib/funicular/assets/funicular_debug.css
 - lib/funicular/assets/funicular_debug.js
@@ -66,11 +58,22 @@ files:
 - lib/funicular/configuration.rb
 - lib/funicular/helpers/picoruby_helper.rb
 - lib/funicular/middleware.rb
+- lib/funicular/plugin.rb
 - lib/funicular/railtie.rb
 - lib/funicular/route_parser.rb
+- lib/funicular/schema.rb
+- lib/funicular/ssr.rb
+- lib/funicular/ssr/runtime.rb
+- lib/funicular/testing.rb
+- lib/funicular/testing/node_runner.mjs
+- lib/funicular/testing/node_runner.rb
 - lib/funicular/vendor/picorbc/VERSION
 - lib/funicular/vendor/picorbc/picorbc.js
 - lib/funicular/vendor/picorbc/picorbc.wasm
+- lib/funicular/vendor/picoruby-test-node/VERSION
+- lib/funicular/vendor/picoruby-test-node/picoruby.js
+- lib/funicular/vendor/picoruby-test-node/picoruby.wasm
+- lib/funicular/vendor/picoruby-test-node/picoruby.wasm.map
 - lib/funicular/vendor/picoruby/VERSION
 - lib/funicular/vendor/picoruby/debug/init.iife.js
 - lib/funicular/vendor/picoruby/debug/picoruby.js
@@ -79,10 +82,32 @@ files:
 - lib/funicular/vendor/picoruby/dist/picoruby.js
 - lib/funicular/vendor/picoruby/dist/picoruby.wasm
 - lib/funicular/version.rb
+- lib/generators/funicular/chat/chat_generator.rb
+- lib/generators/funicular/chat/templates/application_cable_channel.rb.tt
+- lib/generators/funicular/chat/templates/application_cable_connection.rb.tt
+- lib/generators/funicular/chat/templates/create_funicular_chat_messages.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat.css.tt
+- lib/generators/funicular/chat/templates/funicular_chat_channel.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat_component.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat_component_picotest.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat_controller.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat_message.rb.tt
+- lib/generators/funicular/chat/templates/funicular_chat_messages_controller.rb.tt
+- lib/generators/funicular/chat/templates/initializer.rb.tt
+- lib/generators/funicular/chat/templates/show.html.erb.tt
 - lib/tasks/funicular.rake
+- minitest/fixtures/funicular_app/components/greeting_component.rb
+- minitest/fixtures/funicular_app/initializer.rb
 - minitest/funicular_test.rb
+- minitest/hydration_test.rb
+- minitest/plugin_test.rb
+- minitest/schema_test.rb
+- minitest/ssr_test.rb
 - minitest/test_helper.rb
+- minitest/validations_test.rb
 - mrbgem.rake
+- mrblib/0_validations.rb
+- mrblib/1_validators.rb
 - mrblib/cable.rb
 - mrblib/component.rb
 - mrblib/debug.rb
@@ -92,10 +117,14 @@ files:
 - mrblib/file_upload.rb
 - mrblib/form_builder.rb
 - mrblib/funicular.rb
+- mrblib/html_serializer.rb
 - mrblib/http.rb
 - mrblib/model.rb
 - mrblib/patcher.rb
 - mrblib/router.rb
+- mrblib/store.rb
+- mrblib/store_collection.rb
+- mrblib/store_singleton.rb
 - mrblib/styles.rb
 - mrblib/vdom.rb
 - sig/cable.rbs
@@ -107,11 +136,16 @@ files:
 - sig/file_upload.rbs
 - sig/form_builder.rbs
 - sig/funicular.rbs
+- sig/html_serializer.rbs
 - sig/http.rbs
 - sig/model.rbs
 - sig/patcher.rbs
 - sig/router.rbs
+- sig/store.rbs
+- sig/store_collection.rbs
+- sig/store_singleton.rbs
 - sig/styles.rbs
+- sig/validations.rbs
 - sig/vdom.rbs
 homepage: https://github.com/picoruby/funicular
 licenses:
@@ -137,7 +171,8 @@ post_install_message: |2+
     seamless asset pipeline support.
       bin/rails funicular:install
 
-  For more information: https://github.com/picoruby/funicular
+  For Web App Developers: https://picoruby.org/funicular
+  For Funicular Contributors: https://github.com/picoruby/funicular
 
 rdoc_options: []
 require_paths:
@@ -153,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.4
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Rails plugin for client-side Ruby development with mruby
 test_files: []