practical 0.1.0

data/lib/practical/helpers/icon_helper.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Practical::Helpers::IconHelper
+  include Practical::Views::ElementHelper
+
+  def icon_set
+    ApplicationIconSet
+  end
+
+  def icon_text(icon:, text:, options: {})
+    tag.span(**mix({class: "wa-flank wa-gap-xs icon-text"}, options)) {
+      safe_join([
+        (render icon),
+        tag.span(text)
+      ])
+    }
+  end
+end

data/lib/practical/helpers/text_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Practical::Helpers::TextHelper
+  def double_quoted_text(text)
+    "“#{text}”"
+  end
+
+  def single_quoted_text(text)
+    "‘#{text}’"
+  end
+
+  def initials(name:)
+    space_split = name.split(" ")
+    if space_split.size >= 2
+      return space_split.first(2).map{|x| x[0]&.upcase }.join("")
+    end
+
+    return name.first(2).upcase
+  end
+end

data/lib/practical/helpers/translation_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Practical::Helpers::TranslationHelper
+  def guided_translate(key, **options)
+    new_options = options.reverse_merge(
+      default: []
+    )
+
+    if key.start_with?(".")
+      path_parts = controller_path.split("/")
+      namespaced_versions = path_parts.each_with_index
+                                      .map{|part, i| path_parts[0..i]}
+                                      .map{|x| :"#{x.join(".")}#{key}"}
+
+      guided_defaults = [
+        namespaced_versions,
+        key[1..].to_sym
+      ].flatten
+
+      new_options[:default] += guided_defaults
+    end
+
+    t(key, **new_options)
+  end
+end

data/lib/practical/version.rb

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

data/lib/practical/views/element_helper.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Practical::Views::ElementHelper
+  extend ActiveSupport::Concern
+
+  def mix(*args)
+    args.each_with_object({}) do |object, result|
+      result.merge!(object) do |_key, old, new|
+        case [old, new].freeze
+        in [Array, Array] | [Set, Set]
+          old + new
+        in [Array, Set]
+          old + new.to_a
+        in [Array, String]
+          old + [new]
+        in [Hash, Hash]
+          mix(old, new)
+        in [Set, Array]
+          old.to_a + new
+        in [Set, String]
+          old.to_a + [new]
+        in [String, Array]
+          [old] + new
+        in [String, Set]
+          [old] + new.to_a
+        in [String, String]
+          "#{old} #{new}"
+        in [_, nil]
+          old
+        else
+          new
+        end
+      end
+
+      result.transform_keys! do |key|
+        key.end_with?("!") ? key.name.chop.to_sym : key
+      end
+    end
+  end
+
+  def grab(**bindings)
+    if bindings.size > 1
+      bindings.values
+    else
+      bindings.values.first
+    end
+  end
+end

data/lib/practical.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "practical/version"
+require "practical/framework/engine"
+
+module Practical
+  module Framework
+  end
+
+  module Helpers
+  end
+
+  module Views
+  end
+end
+
+require "practical/views/element_helper"
+require "practical/helpers/form_with_helper"
+require "practical/helpers/icon_helper"
+require "practical/helpers/text_helper"
+require "practical/helpers/translation_helper"

data/lib/tasks/practical/coverage.rake

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+namespace :coverage do
+  desc "Collates all result sets generated by the different test runners"
+  task :report do
+    require 'simplecov'
+    require "simplecov_json_formatter"
+
+    SimpleCov.collate Dir["coverage_results/.resultset-*.json"] do
+      formatter SimpleCov::Formatter::MultiFormatter.new(
+        [
+          SimpleCov::Formatter::SimpleFormatter,
+          SimpleCov::Formatter::HTMLFormatter,
+          SimpleCov.formatter = SimpleCov::Formatter::JSONFormatter
+        ]
+      )
+    end
+  end
+end

data/lib/tasks/practical/framework_tasks.rake

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# desc "Explaining what the task does"
+# task :practical_framework do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,303 @@
+--- !ruby/object:Gem::Specification
+name: practical
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Thomas Cannon
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.2
+- !ruby/object:Gem::Dependency
+  name: view_component
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: loaf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pagy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: honeybadger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: semantic_logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: devise-passkeys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shrine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oaken
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: action_policy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The Ruby code for the Practical Framework
+email:
+- tcannon00@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- app/components/practical/views/base_component.rb
+- app/components/practical/views/button_component.rb
+- app/components/practical/views/datatable.rb
+- app/components/practical/views/datatable/filter_applied.rb
+- app/components/practical/views/datatable/filter_section_component.html.erb
+- app/components/practical/views/datatable/filter_section_component.rb
+- app/components/practical/views/datatable/sort_link_component.rb
+- app/components/practical/views/flash_messages_component.rb
+- app/components/practical/views/form/error_list_component.rb
+- app/components/practical/views/form/error_list_item_component.rb
+- app/components/practical/views/form/error_list_item_template_component.rb
+- app/components/practical/views/form/fallback_errors_section_component.html.erb
+- app/components/practical/views/form/fallback_errors_section_component.rb
+- app/components/practical/views/form/field_errors_component.rb
+- app/components/practical/views/form/field_title_component.rb
+- app/components/practical/views/form/fieldset_title_component.rb
+- app/components/practical/views/form/input_component.html.erb
+- app/components/practical/views/form/input_component.rb
+- app/components/practical/views/form/option_label_component.rb
+- app/components/practical/views/form/practical_editor_component.rb
+- app/components/practical/views/form/required_radio_collection_wrapper_component.rb
+- app/components/practical/views/form_wrapper.rb
+- app/components/practical/views/icon_component.rb
+- app/components/practical/views/icon_for_file_extension_component.rb
+- app/components/practical/views/modal_dialog_component.html.erb
+- app/components/practical/views/modal_dialog_component.rb
+- app/components/practical/views/navigation/breadcrumb_item_component.rb
+- app/components/practical/views/navigation/breadcrumbs_component.html.erb
+- app/components/practical/views/navigation/breadcrumbs_component.rb
+- app/components/practical/views/navigation/navigation_link_component.rb
+- app/components/practical/views/navigation/pagination/goto_form_component.html.erb
+- app/components/practical/views/navigation/pagination/goto_form_component.rb
+- app/components/practical/views/navigation/pagination_component.html.erb
+- app/components/practical/views/navigation/pagination_component.rb
+- app/components/practical/views/open_dialog_button_component.rb
+- app/components/practical/views/page_component.html.erb
+- app/components/practical/views/page_component.rb
+- app/components/practical/views/relative_time_component.rb
+- app/components/practical/views/tiptap_document_component.rb
+- app/components/practical/views/toast_component.html.erb
+- app/components/practical/views/toast_component.rb
+- app/controllers/concerns/practical/auth/passkeys/emergency_registrations.rb
+- app/controllers/concerns/practical/auth/passkeys/web_authn_debug_context.rb
+- app/controllers/concerns/practical/views/flash_helpers.rb
+- app/controllers/concerns/practical/views/json_redirection.rb
+- app/lib/practical/defaults/shrine.rb
+- app/lib/practical/test/helpers/administrator/test_helpers.rb
+- app/lib/practical/test/helpers/extra_assertions.rb
+- app/lib/practical/test/helpers/flash_assertions.rb
+- app/lib/practical/test/helpers/integration/assertions.rb
+- app/lib/practical/test/helpers/passkey/system/base.rb
+- app/lib/practical/test/helpers/passkey/system/rack_test.rb
+- app/lib/practical/test/helpers/passkey/system/selenium.rb
+- app/lib/practical/test/helpers/passkey/test_helper.rb
+- app/lib/practical/test/helpers/postmark.rb
+- app/lib/practical/test/helpers/relation_builder_assertions.rb
+- app/lib/practical/test/helpers/setup/debug.rb
+- app/lib/practical/test/helpers/setup/faker_seed_pinning.rb
+- app/lib/practical/test/helpers/setup/simplecov.rb
+- app/lib/practical/test/helpers/shrine/test_data.rb
+- app/lib/practical/test/helpers/spy_assertions.rb
+- app/lib/practical/test/helpers/system/assertions.rb
+- app/lib/practical/test/helpers/system/capybara_prep.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/emergency_registration/base.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/emergency_registration/self_service.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/reauthentication/base.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/registrations/no_self_destroy.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/registrations/no_self_signup.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/registrations/self_destroy.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/registrations/self_signup.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/registrations/update.rb
+- app/lib/practical/test/shared/auth/passkeys/controllers/sessions/base.rb
+- app/lib/practical/test/shared/auth/passkeys/forms/emergency_registration.rb
+- app/lib/practical/test/shared/auth/passkeys/models/emergency_registration/base.rb
+- app/lib/practical/test/shared/auth/passkeys/models/emergency_registration/use_for_and_notify.rb
+- app/lib/practical/test/shared/auth/passkeys/models/passkey.rb
+- app/lib/practical/test/shared/auth/passkeys/models/resource_with_passkeys.rb
+- app/lib/practical/test/shared/auth/passkeys/policies/passkey.rb
+- app/lib/practical/test/shared/auth/passkeys/services/send_emergency_registration.rb
+- app/lib/practical/test/shared/models/normalized_email.rb
+- app/lib/practical/test/shared/models/user.rb
+- app/lib/practical/test/shared/models/utility/ip_address.rb
+- app/lib/practical/test/shared/models/utility/user_agent.rb
+- app/lib/practical/views/button/styling.rb
+- app/lib/practical/views/error_handling.rb
+- app/lib/practical/views/form_builders/base.rb
+- app/lib/practical/views/icon_set.rb
+- app/lib/practical/views/web_awesome/style_utility/appearance_variant.rb
+- app/lib/practical/views/web_awesome/style_utility/base.rb
+- app/lib/practical/views/web_awesome/style_utility/color_variant.rb
+- app/lib/practical/views/web_awesome/style_utility/size.rb
+- config/locales/auth.en.yml
+- config/locales/devise.passkeys.en.yml
+- config/locales/practical_framework.en.yml
+- config/routes.rb
+- db/seeds/setup.rb
+- db/seeds/users/default.rb
+- lib/generators/practical/test/helper/USAGE
+- lib/generators/practical/test/helper/helper_generator.rb
+- lib/generators/practical/test/helper/templates/helper.rb.tt
+- lib/generators/practical/test/shared_test/USAGE
+- lib/generators/practical/test/shared_test/shared_test_generator.rb
+- lib/generators/practical/test/shared_test/templates/shared_test.rb.tt
+- lib/generators/practical/views/component/USAGE
+- lib/generators/practical/views/component/component_generator.rb
+- lib/practical.rb
+- lib/practical/framework/engine.rb
+- lib/practical/helpers/form_with_helper.rb
+- lib/practical/helpers/icon_helper.rb
+- lib/practical/helpers/text_helper.rb
+- lib/practical/helpers/translation_helper.rb
+- lib/practical/version.rb
+- lib/practical/views/element_helper.rb
+- lib/tasks/practical/coverage.rake
+- lib/tasks/practical/framework_tasks.rake
+homepage: https://github.com/practical-computer/practical
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/practical-computer/practical
+  source_code_uri: https://github.com/practical-computer/practical
+  changelog_uri: https://github.com/practical-computer/practical/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: The Practical Framework
+test_files: []