practical 0.1.0

data/app/lib/practical/views/form_builders/base.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+class Practical::Views::FormBuilders::Base < ActionView::Helpers::FormBuilder
+  include Practical::Views::ElementHelper
+  attr_reader :template, :object
+
+  def fieldset(options = {}, &block)
+    finalized_options = mix({class: 'wa-stack'}, options)
+    template.tag.fieldset(**finalized_options, &block)
+  end
+
+  def legend(options = {}, &block)
+    finalized_options = mix({}, options)
+    template.tag.legend(**finalized_options, &block)
+  end
+
+  def fieldset_title(icon:, title:)
+    template.render(Practical::Views::Form::FieldsetTitleComponent.new) do |component|
+      component.with_icon {
+        template.render icon
+      }
+
+      title
+    end
+  end
+
+  def field_title(icon:, title:)
+    template.render(Practical::Views::Form::FieldTitleComponent.new) do |component|
+      component.with_icon {
+        template.render icon
+      }
+
+      title
+    end
+  end
+
+  def input_component(object_method, label_options: {}, &block)
+    template.render(Practical::Views::Form::InputComponent.new(
+      f: self,
+      object_method: object_method,
+      label_options: label_options
+    ), &block)
+  end
+
+  def practical_editor_field(object_method:, direct_upload_url:, hidden_input_options: {}, options: {})
+    aria_describedby_id = field_errors_id(object_method)
+    input_id = field_id(object_method)
+
+    finalized_hidden_input_options = mix({
+      "aria-describedby": aria_describedby_id,
+      "aria-invalid": errors_for(object_method).present?,
+      "id": input_id,
+    }, hidden_input_options)
+
+    template.safe_join([
+      self.hidden_field(object_method, **finalized_hidden_input_options),
+      template.render(Practical::Views::Form::PracticalEditorComponent.new(
+        input_id: input_id,
+        aria_describedby_id: aria_describedby_id,
+        direct_upload_url: direct_upload_url,
+        options: options
+      ))
+    ])
+  end
+
+  def button_component(options = {}, &block)
+    template.render(Practical::Views::ButtonComponent.new(**options), &block)
+  end
+
+  def check_box_collection(field_method:, options:, collection_check_boxes_options: {})
+    collection_check_boxes(field_method,
+                           options,
+                           :value,
+                           :title,
+                           collection_check_boxes_options
+    ) do |collection_builder|
+      collection_builder.label(class: "wa-flank") do
+        template.safe_join([
+          collection_builder.checkbox,
+          template.render(Practical::Views::Form::OptionLabelComponent.new) do |component|
+            component.with_title do
+              template.icon_text(
+                icon: collection_builder.object.icon,
+                text: collection_builder.object.title
+              )
+            end
+
+            component.with_description{ collection_builder.object.description }
+          end
+        ])
+      end
+    end
+  end
+
+  def radio_collection(field_method:, options:, collection_check_boxes_options: {})
+    collection_radio_buttons(field_method,
+                           options,
+                           :value,
+                           :title,
+                           collection_check_boxes_options
+    ) do |collection_builder|
+      collection_builder.label(class: "wa-flank") do
+        template.safe_join([
+          collection_builder.radio_button,
+          template.render(Practical::Views::Form::OptionLabelComponent.new) do |component|
+            component.with_title do
+              template.icon_text(
+                icon: collection_builder.object.icon,
+                text: collection_builder.object.title
+              )
+            end
+
+            component.with_description{ collection_builder.object.description }
+          end
+        ])
+      end
+    end
+  end
+
+  def required_radio_collection_wrapper(object_method, options = {}, &block)
+    template.render(Practical::Views::Form::RequiredRadioCollectionWrapperComponent.new(
+      f: self,
+      object_method: object_method,
+      options: options
+    ), &block)
+  end
+
+  def field_errors(object_method, options = {})
+    template.render Practical::Views::Form::FieldErrorsComponent.new(
+      f: self,
+      object_method: object_method,
+      options: options
+    )
+  end
+
+  def fallback_error_section(blurb_key: :"practical_framework.forms.generic_error_blurb", id:, options: {})
+    template.render Practical::Views::Form::FallbackErrorsSectionComponent.new(
+      f: self,
+      blurb: template.translate(blurb_key, raise: true),
+      options: options
+    )
+  end
+
+  def errors_for(object_method)
+    return unless object.present? && object_method.present?
+    object.errors.group_by_attribute[object_method]
+  end
+
+  def field_errors_id(object_method)
+    field_id(object_method, :errors)
+  end
+end

data/app/lib/practical/views/icon_set.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+class Practical::Views::IconSet
+  IconDefinition = Data.define(:method_name, :icon_name, :preset)
+  SpritesheetIconDefinition = Data.define(:method_name, :icon_name, :library)
+
+  Preset = Data.define(:family, :variant)
+
+  PRESETS = {
+    brand: Preset.new(family: :brands, variant: nil),
+    duotone: Preset.new(family: :duotone, variant: :solid),
+    regular: Preset.new(family: :classic, variant: :regular),
+    solid: Preset.new(family: :solid, variant: nil)
+  }.freeze
+
+  def self.presets
+    PRESETS
+  end
+
+  def self.icon(**options)
+    Practical::Views::IconComponent.new(**options)
+  end
+
+  def self.spritesheet_icon(library:, **options)
+    Practical::Views::IconComponent.new(**options.with_defaults(
+      family: :default,
+      options: {library: library}
+    ))
+  end
+
+  presets.keys.each do |label|
+    define_singleton_method(:"#{label}_icon") do |**options|
+      preset = presets.fetch(label)
+      return icon(**options.merge(family: preset.family, variant: preset.variant))
+    end
+  end
+
+  def self.define_icons(icon_definitions:)
+    icon_definitions.each do |icon_definition|
+      define_singleton_method(icon_definition.method_name) do
+        preset = presets.fetch(icon_definition.preset.to_sym)
+        return icon(
+          family: preset.family,
+          variant: preset.variant,
+          name: icon_definition.icon_name
+        )
+      end
+    end
+  end
+
+  def self.define_spritesheet_icons(spritesheet_icon_definitions:)
+    spritesheet_icon_definitions.each do |icon_definition|
+      define_singleton_method(icon_definition.method_name) do
+        return spritesheet_icon(
+          library: icon_definition.library,
+          name: icon_definition.icon_name
+        )
+      end
+    end
+  end
+
+  define_icons(icon_definitions: [
+    IconDefinition.new(method_name: :user_icon, icon_name: :user, preset: :duotone),
+    IconDefinition.new(method_name: :save_icon, icon_name: :"floppy-disk", preset: :duotone),
+    IconDefinition.new(method_name: :filters_icon, icon_name: :filters, preset: :duotone),
+    IconDefinition.new(method_name: :filters_icon, icon_name: :filters, preset: :duotone),
+    IconDefinition.new(method_name: :ascending_icon, icon_name: :"sort-up", preset: :duotone),
+    IconDefinition.new(method_name: :descending_icon, icon_name: :"sort-down", preset: :duotone),
+
+    IconDefinition.new(method_name: :apply_filters_icon, icon_name: :filter, preset: :solid),
+    IconDefinition.new(method_name: :generic_add_icon, icon_name: :"circle-plus", preset: :solid),
+    IconDefinition.new(method_name: :error_list_icon, icon_name: :"circle-exclamation", preset: :solid),
+    IconDefinition.new(method_name: :notes_icon, icon_name: :note, preset: :solid),
+    IconDefinition.new(method_name: :dialog_close_icon, icon_name: :xmark, preset: :solid),
+
+    IconDefinition.new(method_name: :sort_icon, icon_name: :sort, preset: :regular),
+
+    IconDefinition.new(method_name: :info_icon, icon_name: :"circle-info", preset: :duotone),
+    IconDefinition.new(method_name: :signup_icon, icon_name: :"user-plus", preset: :duotone),
+    IconDefinition.new(method_name: :send_email_icon, icon_name: :"paper-plane", preset: :duotone),
+    IconDefinition.new(method_name: :sent_email_icon, icon_name: :"envelope-dot", preset: :duotone),
+    IconDefinition.new(method_name: :link_icon, icon_name: :link, preset: :duotone),
+    IconDefinition.new(method_name: :remove_link_icon, icon_name: :"link-slash", preset: :duotone),
+    IconDefinition.new(method_name: :theme_icon, icon_name: :swatchbook, preset: :duotone),
+    IconDefinition.new(method_name: :sign_out_icon, icon_name: :"person-from-portal", preset: :duotone),
+    IconDefinition.new(method_name: :theming_icon, icon_name: :"spray-can-sparkles", preset: :duotone),
+    IconDefinition.new(method_name: :share_icon, icon_name: :"share-from-square", preset: :duotone),
+    IconDefinition.new(method_name: :caution_diamond_icon, icon_name: :"diamond-exclamation", preset: :duotone),
+    IconDefinition.new(method_name: :alert_icon, icon_name: :"triangle-exclamation", preset: :duotone),
+    IconDefinition.new(method_name: :swap_icon, icon_name: :swap, preset: :duotone),
+    IconDefinition.new(method_name: :waiting_icon, icon_name: :"hourglass-half", preset: :duotone),
+    IconDefinition.new(method_name: :accept_icon, icon_name: :"circle-check", preset: :duotone),
+    IconDefinition.new(method_name: :deny_icon, icon_name: :"circle-xmark", preset: :duotone),
+    IconDefinition.new(method_name: :destroy_user_icon, icon_name: :"user-slash", preset: :duotone),
+    IconDefinition.new(method_name: :organization_icon, icon_name: :warehouse, preset: :duotone),
+
+    IconDefinition.new(method_name: :user_name_icon, icon_name: :"hand-wave", preset: :solid),
+    IconDefinition.new(method_name: :email_address_icon, icon_name: :at, preset: :solid),
+    IconDefinition.new(method_name: :light_theme_icon, icon_name: :sun, preset: :solid),
+    IconDefinition.new(method_name: :dark_theme_icon, icon_name: :moon, preset: :solid),
+    IconDefinition.new(method_name: :match_system_theme_icon, icon_name: :"circle-half-stroke", preset: :solid),
+    IconDefinition.new(method_name: :previous_arrow, icon_name: :"arrow-left", preset: :solid),
+    IconDefinition.new(method_name: :next_arrow, icon_name: :"arrow-right", preset: :solid),
+    IconDefinition.new(method_name: :checkbox_check_icon, icon_name: :check, preset: :solid),
+    IconDefinition.new(method_name: :passkey_label_icon, icon_name: :tag, preset: :solid),
+    IconDefinition.new(method_name: :success_icon, icon_name: :"circle-check", preset: :solid),
+    IconDefinition.new(method_name: :memberships_icon, icon_name: :hexagon, preset: :solid),
+    IconDefinition.new(method_name: :badge_icon, icon_name: :"id-card", preset: :solid),
+    IconDefinition.new(method_name: :close_toast_icon, icon_name: :"circle-xmark", preset: :solid),
+    IconDefinition.new(method_name: :home_icon, icon_name: :home, preset: :solid),
+
+    IconDefinition.new(method_name: :revoke_membership_invitation_icon, icon_name: :"link-slash", preset: :duotone),
+
+    IconDefinition.new(method_name: :organization_manager_icon, icon_name: "users-gear", preset: :duotone),
+  ])
+
+  define_icons(icon_definitions: [
+    IconDefinition.new(method_name: :csv_icon, icon_name: "file-csv", preset: :duotone),
+    IconDefinition.new(method_name: :xls_icon, icon_name: "file-xls", preset: :duotone),
+    IconDefinition.new(method_name: :doc_icon, icon_name: "file-doc", preset: :duotone),
+    IconDefinition.new(method_name: :pdf_icon, icon_name: "file-pdf", preset: :duotone),
+    IconDefinition.new(method_name: :heic_icon, icon_name: "file-image", preset: :duotone),
+    IconDefinition.new(method_name: :missing_file_icon, icon_name: "file-slash", preset: :solid),
+    IconDefinition.new(method_name: :txt_icon, icon_name: "file-txt", preset: :duotone),
+  ])
+
+  define_spritesheet_icons(spritesheet_icon_definitions: [
+    SpritesheetIconDefinition.new(method_name: :passkey_icon, icon_name: :passkey, library: :kit),
+    SpritesheetIconDefinition.new(method_name: :add_note_icon, icon_name: :"solid-note-circle-plus", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :edit_note_icon, icon_name: :"solid-note-pen", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :delete_note_icon, icon_name: :"solid-note-slash", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :archive_membership_icon, icon_name: :"solid-id-badge-slash", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :accepted_membership_invitation_icon, icon_name: :"solid-warehouse-circle-check", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :destroy_membership_invitation_icon, icon_name: :"solid-warehouse-slash", library: :kit),
+    SpritesheetIconDefinition.new(method_name: :delete_note_icon, icon_name: :"solid-note-slash", library: :kit),
+
+  ])
+
+  def self.profile_icon = badge_icon
+
+  def self.checkbox_indeterminate_icon
+    solid_icon(name: :minus, options: {class: "indeterminate-icon"})
+  end
+
+  def self.emergency_passkey_registration_icon
+    duotone_icon(name: :"light-emergency-on", options: {style: "--secondary-color: var(--wa-color-danger-fill-loud); --secondary-opacity: 0.7;"})
+  end
+
+  def self.signin_icon
+    duotone_icon(name: :"person-to-portal", options: {style: "--secondary-color: var(--wa-color-brand-fill-normal); --secondary-opacity: 0.9;"})
+  end
+
+  def self.signout_icon
+    duotone_icon(name: :"person-from-portal", options: {style: "--secondary-color: var(--wa-color-brand-fill-normal); --secondary-opacity: 0.9;"})
+  end
+end

data/app/lib/practical/views/web_awesome/style_utility/appearance_variant.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class Practical::Views::WebAwesome::StyleUtility::AppearanceVariant < Practical::Views::WebAwesome::StyleUtility::Base
+  attr_accessor :variants
+
+  def initialize(variants:)
+    if variants.kind_of?(Array)
+      variants = variants.map(&:to_s)
+    else
+      variants = variants.to_s.split(" ")
+    end
+
+    self.variants = Array.wrap(variants)
+  end
+
+  def to_css
+    ApplicationController.helpers.class_names(variants.map{|variant| self.class.apply_css_prefix(variant) })
+  end
+end

data/app/lib/practical/views/web_awesome/style_utility/base.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class Practical::Views::WebAwesome::StyleUtility::Base
+  include Practical::Views::ElementHelper
+  def to_web_awesome
+    raise NotImplementedError
+  end
+
+  def to_css
+    raise NotImplementedError
+  end
+
+  def self.css(**options)
+    self.new(**options).to_css
+  end
+
+  def self.apply_css_prefix(value)
+    return value if value.start_with?("wa-")
+    "wa-#{value}"
+  end
+end

data/app/lib/practical/views/web_awesome/style_utility/color_variant.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Practical::Views::WebAwesome::StyleUtility::ColorVariant < Practical::Views::WebAwesome::StyleUtility::Base
+  attr_accessor :variant
+
+  def initialize(variant:)
+    self.variant = variant.to_s
+  end
+
+  def to_web_awesome
+    variant
+  end
+
+  def to_css
+    self.class.apply_css_prefix(variant)
+  end
+end

data/app/lib/practical/views/web_awesome/style_utility/size.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+class Practical::Views::WebAwesome::StyleUtility::Size < Practical::Views::WebAwesome::StyleUtility::Base
+  attr_accessor :size
+
+  def initialize(size:)
+    self.size = size.to_s
+  end
+
+  def to_css
+    self.class.apply_css_prefix(self.class.from_alias(size: size))
+  end
+
+  def self.apply_css_prefix(value)
+    return value if value.start_with?("wa-size")
+    "wa-size-#{value}"
+  end
+
+  def self.from_alias(size:)
+    case size.to_sym
+    when :small
+      return :s
+    when :medium
+      return :m
+    when :large
+      return :l
+    else
+      return size
+    end
+  end
+end

data/config/locales/auth.en.yml

@@ -0,0 +1,38 @@
+en:
+  emergency_passkey_registrations:
+    request_form:
+      title:
+        text: "Can’t log in?"
+
+      description:
+        html: "<p>Not to worry! You can register a new passkey and get back into your account.</p>"
+
+    registration_form:
+      title:
+        text: "Register your new passkey"
+
+      description:
+        html: "<p>Once you register your new passkey, you'll be able to log back into your account.</p>"
+
+    sent_message: "Sending the instructions to your email!"
+    registered_message: "Your passkey has been registered; you can login now!"
+    prompt: "Can’t log in?"
+  registration:
+    prompt: "Create an account"
+  signin:
+    prompt: "Sign in"
+    form:
+      title: "Sign in"
+      submit_button: "Sign in"
+
+  user_settings:
+    registration:
+      form:
+        title: Create an account
+        submit_button_title: "Sign up"
+
+  app_navigation:
+    user_settings:
+      home_title: "Home"
+      profile_title: "My Account"
+      signout_title: "Sign out"

data/config/locales/devise.passkeys.en.yml

@@ -0,0 +1,18 @@
+en:
+  devise:
+    emergency_passkey_registrations:
+      credential_missing_or_could_not_be_parsed: "We weren't able to register this passkey."
+      webauthn_origin_verification_error: "There was an error setting up this passkey."
+      webauthn_challenge_verification_error: "We weren't able to verify this passkey; please try again."
+    failure:
+      credential_missing_or_could_not_be_parsed: "We weren't able to register this passkey."
+      webauthn_origin_verification_error: "There was an error setting up this passkey."
+      webauthn_challenge_verification_error: "We weren't able to verify this passkey; please try again."
+      stored_credential_not_found: "We weren't able to find this passkey."
+    passkeys:
+      must_be_at_least_one_passkey: "You need at least 1 passkey to be able to login."
+      not_reauthenticated: "You need to verify your identity with an existing passkey first."
+    registrations:
+      email_missing: "Please provide your email address."
+      passkey_label_missing: "Please label your passkey."
+      not_reauthenticated: "You need to verify your identity with an existing passkey first."

data/config/locales/practical_framework.en.yml

@@ -0,0 +1,9 @@
+en:
+  practical_framework:
+    forms:
+      generic_error_blurb: "Please fix the following errors:"
+      placeholders:
+        email: "grace@hopper.me"
+        name: "Grace Hopper"
+        passkey_label: "iCloud Keychain"
+      unlock_title: "Unlock"

data/config/routes.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+Rails.application.routes.draw do
+end

data/db/seeds/setup.rb

@@ -0,0 +1,13 @@
+users.defaults(name: -> { Faker::Name.name },
+               email: -> { Faker::Internet.email },
+               webauthn_id: -> { SecureRandom.uuid }
+              )
+
+
+def users.create_labeled(label, email: labeled_email(label), **)
+  create(label, unique_by: :email, email: email, **)
+end
+
+def users.labeled_email(label)
+  "#{label}@example.com"
+end

data/db/seeds/users/default.rb

@@ -0,0 +1,34 @@
+user_1 = users.create_labeled(:user_1)
+
+passkeys.create(:user_1_passkey,
+  unique_by: :user,
+  user: user_1,
+  label: "Passkey 1",
+  external_id: SecureRandom.hex,
+  public_key: SecureRandom.hex
+)
+
+user_1.emergency_passkey_registrations.create!
+
+user_2 = users.create_labeled(:user_2)
+
+passkeys.create(:user_2_passkey,
+  unique_by: :user,
+  user: user_2,
+  label: "Passkey 2",
+  external_id: SecureRandom.hex,
+  public_key: SecureRandom.hex
+)
+
+passkeys.create(:user_1_passkey_2,
+  unique_by: :user,
+  user: user_1,
+  label: "Passkey 3",
+  external_id: SecureRandom.hex,
+  public_key: SecureRandom.hex
+)
+
+user_1.emergency_passkey_registrations.create!(
+  used_at: 1.week.ago,
+  passkey: passkeys.user_1_passkey_2
+)

data/lib/generators/practical/test/helper/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Creates a new test helper for the Practical Framework, under the namespace Practical::Test::Helpers
+
+Example:
+    bin/rails generate practical:test:helper assertions
+
+    This will create:
+        app/lib/practical/test/helpers/assertions.rb

data/lib/generators/practical/test/helper/helper_generator.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class Practical::Test::HelperGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path("templates", __dir__)
+
+  def create_helper
+    template "helper.rb", File.join("app/lib/practical/test/helpers", "#{file_path}.rb")
+  end
+end

data/lib/generators/practical/test/helper/templates/helper.rb.tt

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+module Practical::Test::Helpers::<%= class_name %>
+end

data/lib/generators/practical/test/shared_test/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Creates a new module for tests that should be shared across all apps that use the framework; which can be included
+    in an app's test files as needed, in `Practical::Test::Shared`
+
+Example:
+    bin/rails generate practical:test:shared_test auth/models/user/base
+
+    This will create:
+        app/lib/practical/test/shared/auth/models/user/base.rb

data/lib/generators/practical/test/shared_test/shared_test_generator.rb

@@ -0,0 +1,7 @@
+class Practical::Test::SharedTestGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path("templates", __dir__)
+
+  def create_shared_test
+    template "shared_test.rb", File.join("app/lib/practical/test/shared/", "#{file_path}.rb")
+  end
+end

data/lib/generators/practical/test/shared_test/templates/shared_test.rb.tt

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Practical::Test::Shared::<%= class_name %>
+  extend ActiveSupport::Concern
+
+  included do
+    test "a test shared across apps using the framework"
+  end
+end

data/lib/generators/practical/views/component/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Wrapper around the `component` generator, to prefix the given name with `practical/views/` and set the parent to
+    `Practical::Views::BaseComponent`
+
+Example:
+    bin/rails practical:views:component icon name
+
+    This will create:
+        app/components/practical/views/icon_component.rb

data/lib/generators/practical/views/component/component_generator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'view_component'
+
+class Practical::Views::ComponentGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path("templates", __dir__)
+
+  class_option :parent, default: "Practical::Views::BaseComponent"
+  class_option :component, type: :boolean, default: true
+
+  def prepare_name
+    unless class_name.start_with? "Practical::Views"
+      self.name = "practical/views/#{name}"
+    end
+  end
+
+  hook_for :component, in: :rails, type: :boolean do |instance, generator_klass|
+    instance.invoke generator_klass, [ instance.name, *instance.args], instance.options
+  end
+end

data/lib/practical/framework/engine.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Practical
+  module Framework
+    class Engine < ::Rails::Engine
+      config.app_generators do |g|
+        g.apply_rubocop_autocorrect_after_generate!
+        g.test_framework :test_unit, fixture: false, fixture_replacement: :oaken
+      end
+
+      # Hopefully can be removed in the future: https://github.com/rails/rails/issues/39522
+      module PracticalFrameworkFormBuilderActiveSupportExtension
+        def practical_form_with(**args, &block)
+          original_field_error_proc = ::ActionView::Base.field_error_proc
+          ::ActionView::Base.field_error_proc = ->(html_tag, instance) { html_tag }
+          content_tag(:"practical-framework-error-handling") do
+            form_with(**args, &block)
+          end
+        ensure
+          ::ActionView::Base.field_error_proc = original_field_error_proc
+        end
+      end
+
+      initializer 'practical-framework.view_helpers' do
+        ActiveSupport.on_load(:action_view) do
+          include Practical::Framework::Engine::PracticalFrameworkFormBuilderActiveSupportExtension
+          include Practical::Helpers::FormWithHelper
+          include Practical::Helpers::IconHelper
+          include Practical::Helpers::TextHelper
+          include Practical::Helpers::TranslationHelper
+        end
+      end
+    end
+  end
+end

data/lib/practical/helpers/form_with_helper.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Practical::Helpers::FormWithHelper
+  def application_form_with(**options, &block)
+    finalized_options = options.with_defaults(
+      builder: ApplicationFormBuilder
+    )
+    practical_form_with(**finalized_options, &block)
+  end
+end