interfacets 0.9.9 → 0.99999

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +9 -17
  3. data/lib/interfacets/client/actor.rb +2 -1
  4. data/lib/interfacets/client/assets.rb +77 -63
  5. data/lib/interfacets/client/bus.rb +31 -8
  6. data/lib/interfacets/client/channels/api.rb +141 -35
  7. data/lib/interfacets/client/channels/audio.rb +13 -10
  8. data/lib/interfacets/client/channels/base.rb +2 -2
  9. data/lib/interfacets/client/channels/pubsub.rb +69 -0
  10. data/lib/interfacets/client/channels/react/builder.rb +42 -72
  11. data/lib/interfacets/client/channels/react/channel.rb +7 -5
  12. data/lib/interfacets/client/channels/react/evaluator.rb +6 -4
  13. data/lib/interfacets/client/channels/timer.rb +8 -7
  14. data/lib/interfacets/client/channels/url.rb +39 -6
  15. data/lib/interfacets/client/registry.rb +10 -70
  16. data/lib/interfacets/client/slots.rb +45 -0
  17. data/lib/interfacets/client/system.rb +20 -15
  18. data/lib/interfacets/client/template.rb +90 -0
  19. data/lib/interfacets/client/utils/mruby_patches.rb +8 -4
  20. data/lib/interfacets/client/utils/open_struct.rb +88 -77
  21. data/lib/interfacets/component_registry.rb +120 -0
  22. data/lib/interfacets/component_schema_parser.rb +88 -0
  23. data/lib/interfacets/mruby/build_config.rb +8 -4
  24. data/lib/interfacets/mruby/entrypoint.rb +2 -2
  25. data/lib/interfacets/server/api.rb +44 -27
  26. data/lib/interfacets/server/assets.rb +69 -28
  27. data/lib/interfacets/server/basic_router.rb +38 -23
  28. data/lib/interfacets/server/bus.rb +8 -14
  29. data/lib/interfacets/server/registry.rb +31 -185
  30. data/lib/interfacets/shared/basic_routable.rb +48 -0
  31. data/lib/interfacets/shared/entities/bus.rb +623 -177
  32. data/lib/interfacets/shared/entities/changeset.rb +432 -0
  33. data/lib/interfacets/shared/entities/collection_proxy.rb +132 -72
  34. data/lib/interfacets/shared/entities/specs/handlers.rb +74 -37
  35. data/lib/interfacets/shared/entities/specs.rb +223 -20
  36. data/lib/interfacets/shared/entity.rb +124 -110
  37. data/lib/interfacets/shared/entity_dsl.rb +272 -0
  38. data/lib/interfacets/shared/facet.rb +260 -0
  39. data/lib/interfacets/shared/generated_store.rb +74 -35
  40. data/lib/interfacets/shared/refreshable.rb +85 -0
  41. data/lib/interfacets/shared/utils.rb +36 -32
  42. data/lib/interfacets/shared/validations.rb +749 -25
  43. data/lib/interfacets/shared/view.rb +120 -0
  44. data/lib/interfacets/test/component_registry.rb +82 -0
  45. data/lib/interfacets/test/js/inline_bus.rb +68 -33
  46. data/lib/interfacets/test/js/nodo_bus.rb +37 -9
  47. data/lib/interfacets/test/js/receivers/api.rb +17 -4
  48. data/lib/interfacets/test/js/receivers/audio.rb +61 -0
  49. data/lib/interfacets/test/js/receivers/pubsub.rb +50 -0
  50. data/lib/interfacets/test/js/receivers/react/node/xml_parser.rb +103 -0
  51. data/lib/interfacets/test/js/receivers/react/node.rb +91 -71
  52. data/lib/interfacets/test/js/receivers/react.rb +15 -5
  53. data/lib/interfacets/test/js/receivers/timer.rb +81 -0
  54. data/lib/interfacets/test/js/receivers/url.rb +51 -10
  55. data/lib/interfacets/test/standard_elements.yml +173 -0
  56. data/lib/interfacets/test/ui_simulator.rb +145 -0
  57. data/lib/interfacets/test/validation_engine.rb +184 -0
  58. data/lib/interfacets/test.rb +1 -7
  59. data/lib/interfacets/version.rb +1 -1
  60. data/lib/interfacets.rb +13 -2
  61. metadata +51 -37
  62. data/.rubocop.yml +0 -180
  63. data/LICENSE.txt +0 -21
  64. data/Rakefile +0 -10
  65. data/lib/interfacets/client/channels/page_visibility.rb +0 -21
  66. data/lib/interfacets/client/channels/react/dom.rb +0 -91
  67. data/lib/interfacets/client/channels/speech_to_text.rb +0 -100
  68. data/lib/interfacets/client/config.rb +0 -22
  69. data/lib/interfacets/client/delegator.rb +0 -37
  70. data/lib/interfacets/client/facet.rb +0 -26
  71. data/lib/interfacets/client/facet2.rb +0 -15
  72. data/lib/interfacets/client/facets/attributes/accessor.rb +0 -28
  73. data/lib/interfacets/client/facets/attributes/association.rb +0 -50
  74. data/lib/interfacets/client/facets/attributes/bind.rb +0 -25
  75. data/lib/interfacets/client/facets/attributes/collection.rb +0 -47
  76. data/lib/interfacets/client/facets/attributes/readonly.rb +0 -19
  77. data/lib/interfacets/client/facets/deserializer.rb +0 -30
  78. data/lib/interfacets/client/facets/schema/deserializer.rb +0 -63
  79. data/lib/interfacets/client/facets/schema.rb +0 -63
  80. data/lib/interfacets/client/facets/serializer.rb +0 -18
  81. data/lib/interfacets/client/view.rb +0 -47
  82. data/lib/interfacets/server/assets/facet.rb +0 -61
  83. data/lib/interfacets/server/basic_routable.rb +0 -40
  84. data/lib/interfacets/server/config.rb +0 -87
  85. data/lib/interfacets/server/facet.rb +0 -51
  86. data/lib/interfacets/server/facets/deserializer.rb +0 -25
  87. data/lib/interfacets/server/facets/schema/serializer.rb +0 -54
  88. data/lib/interfacets/server/facets/serializer.rb +0 -50
  89. data/lib/interfacets/shared/entity_collection.rb +0 -88
  90. data/lib/interfacets/test/browser.rb +0 -63
@@ -0,0 +1,85 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Interfacets
4
+ module Shared
5
+ # Opt-in: lets a facet pull fresh state from the server without losing the
6
+ # user's in-flight work, and wires that up to pubsub messages.
7
+ #
8
+ # class ApplicationFacet
9
+ # include Interfacets::Shared::Facet
10
+ # def self.inherited(mod)
11
+ # mod.include(Interfacets::Shared::Refreshable)
12
+ # end
13
+ # end
14
+ #
15
+ # Adds:
16
+ # - a `refresh` server action. The request carries no attributes (so it
17
+ # cannot clobber server state with stale client state); the server
18
+ # replies with a `refresh` event carrying `in_reply_to`, which the client merges as a patch
19
+ # (nothing is checkpointed, so dirty fields stay dirty and
20
+ # `protect_during_patch` / `merge(attr, :patch)` rules apply).
21
+ # - a client `on_pubsub(topic:, data:)` handler: a message carrying
22
+ # `"attributes"` (or a full patch envelope as built by
23
+ # `Server::Api#patch`) is merged as a patch; any other message is a
24
+ # signal and triggers `refresh`. Override `on_pubsub` to do something
25
+ # else.
26
+ module Refreshable
27
+ extend(ActiveSupport::Concern)
28
+
29
+ module ClientMethods
30
+ def on_pubsub(topic:, data:)
31
+ event = refreshable_patch_event(data)
32
+
33
+ if event
34
+ Shared::Entities::Bus.new(entity: self).handle(event:)
35
+ else
36
+ refresh
37
+ end
38
+ end
39
+
40
+ private
41
+
42
+ def refreshable_patch_event(data)
43
+ return nil unless data.is_a?(Hash)
44
+
45
+ envelope = data["payload"]
46
+ if envelope.is_a?(Hash) && envelope.key?("action") && envelope["payload"].is_a?(Hash)
47
+ envelope
48
+ elsif data["attributes"].is_a?(Hash)
49
+ {
50
+ "id" => SecureRandom.uuid,
51
+ "from" => "server",
52
+ "to" => entity_role.to_s,
53
+ "nesting" => data["nesting"] || ["root"],
54
+ "action" => "patch",
55
+ "payload" => { "attributes" => data["attributes"] },
56
+ }
57
+ end
58
+ end
59
+ end
60
+
61
+ included do
62
+ entity_base do
63
+ server_action(
64
+ :refresh,
65
+ only_if_valid: false,
66
+ stateless: true,
67
+ reply: { patch: true }
68
+ )
69
+ end
70
+
71
+ # The reply is the server entity as loaded for the request.
72
+ server_entity do
73
+ def refresh
74
+ end
75
+ end
76
+
77
+ client_entity do
78
+ include(
79
+ Interfacets::Shared::Refreshable::ClientMethods
80
+ )
81
+ end
82
+ end
83
+ end
84
+ end
85
+ end
@@ -3,52 +3,56 @@
3
3
  module Interfacets
4
4
  module Shared
5
5
  module Utils
6
- extend self
7
-
8
- def permissive_exec(receiver, *, &lambda)
6
+ # rubocop:disable Style/ArgumentsForwarding
7
+ def self.permissive_exec(receiver, *args, &lambda)
9
8
  if lambda.arity.zero?
10
9
  receiver.instance_exec(&lambda)
11
10
  else
12
- receiver.instance_exec(*, &lambda)
13
- end
14
- end
15
-
16
- def permissive_call(lambda, ...)
17
- if lambda.arity.zero?
18
- lambda.call
19
- else
20
- lambda.call(...)
11
+ receiver.instance_exec(*args, &lambda)
21
12
  end
22
13
  end
14
+ # rubocop:enable Style/ArgumentsForwarding
23
15
 
24
- def facet_id_to_path(config:, facet:, id:)
25
- [config.mount_point, facet, id].join("/")
26
- end
27
-
28
- def path_to_facet_id(config:, path:)
29
- parts = path.sub(/.*#{config.mount_point}/, "").split("/")
30
- id = parts.pop
31
- facet = parts.join("/")
16
+ def self.blank?(obj)
17
+ return true if obj.nil? || obj == false
18
+ return false if obj == true || obj.is_a?(Numeric)
19
+ return obj.empty? if obj.is_a?(Array) || obj.is_a?(Hash)
20
+ return !obj.match(/\S/) if obj.is_a?(String)
21
+ return obj.empty? if obj.respond_to?(:empty?)
32
22
 
33
- [facet, id]
23
+ false
34
24
  end
35
25
 
36
- # ActiveSupport?
37
- def blank?(str)
38
- return true if str.nil?
39
- return str.empty? if str.is_a?(Array)
40
- return str.match(/^\s*$/) if str.is_a?(String)
41
-
42
- raise("unsupported blank check")
43
- end
44
-
45
- def present?(str)
26
+ def self.present?(str)
46
27
  !blank?(str)
47
28
  end
48
29
 
49
- def presence(obj)
30
+ def self.presence(obj)
50
31
  present?(obj) ? obj : nil
51
32
  end
33
+
34
+ def self.deep_dup(obj)
35
+ case obj
36
+ when Hash
37
+ result = {}
38
+ obj.each do |k, v|
39
+ result[deep_dup(k)] = deep_dup(v)
40
+ end
41
+ result
42
+ when Array
43
+ obj.map { deep_dup(_1) }
44
+ when String
45
+ obj.dup
46
+ when Numeric, Symbol, TrueClass, FalseClass, NilClass
47
+ obj
48
+ else
49
+ begin
50
+ obj.dup
51
+ rescue TypeError
52
+ obj
53
+ end
54
+ end
55
+ end
52
56
  end
53
57
  end
54
58
  end