glib-web 6.10.3 → 7.0.0.beta1

data/app/models/snapshot_blob_reference.rb

@@ -1,20 +0,0 @@
-# Top-level (NOT namespaced under Glib::) by design — see issue #960's hard constraint:
-#
-#   The gem's SnapshotBlobReference must stay a top-level model on table
-#   `snapshot_blob_references` — not namespaced. Drop-in compatibility holds only
-#   because `isolate_namespace` is off in lib/glib/engine.rb. Namespacing it (e.g.
-#   Glib::SnapshotBlobReference → table `glib_snapshot_blob_references`) or enabling
-#   isolate_namespace orphans every existing consumer's table + rows and forces a
-#   rename/data migration.
-#
-# This file lives at `app/models/snapshot_blob_reference.rb` (not under `app/models/glib/`)
-# so the Rails autoloader resolves the constant as top-level `SnapshotBlobReference`, which
-# in turn maps to the un-prefixed table name `snapshot_blob_references`. The host app's
-# existing `SnapshotBlobReference` model can be deleted verbatim when it bumps the gem.
-#
-# Inherits from the host's `ApplicationRecord` (the standard since Rails 5.0) so the model
-# shares the primary DB connection — same pattern as every other top-level host model.
-class SnapshotBlobReference < ApplicationRecord
-  belongs_to :snapshot, class_name: 'ActiveSnapshot::Snapshot'
-  belongs_to :blob, class_name: 'ActiveStorage::Blob'
-end

data/app/views/json_ui/garage/test_page/fields_change_trigger.json.jbuilder

@@ -1,128 +0,0 @@
-json.title 'Test Page (Fields Change Trigger)'
-
-page = json_ui_page json
-
-render 'json_ui/garage/test_page/header', json: json, page: page
-
-page.body(
-  childViews: ->(body) do
-
-    body.panels_responsive(
-      padding: glib_json_padding_body,
-      childViews: ->(res) do
-        res.h2 text: 'Fields Change Trigger'
-        res.spacer height: 8
-        res.label text: 'changeOn / changeDelay control WHEN a typed-input field reports its change to onChange.'
-        res.spacer height: 12
-
-        res.panels_form(
-          url: json_ui_garage_url(path: 'forms/generic_post'),
-          method: 'post',
-          childViews: ->(form) do
-
-            # ── Default: changeOn 'input', 300ms ──────────────────────────────
-            form.h4 text: 'Default (changeOn: input)'
-            form.spacer height: 8
-            form.label text: 'No options set: reports once the user pauses for the default 300ms.'
-            form.spacer height: 8
-
-            form.fields_text(
-              name: 'user[default_value]',
-              label: 'Default',
-              placeholder: 'default',
-              width: 'matchParent',
-              onChange: ->(action) do
-                action.logics_set(
-                  targetId: 'status_default',
-                  conditionalData: { text: { 'printf': ['Default: {0}', { 'var': 'user[default_value]' }] } }
-                )
-              end
-            )
-            form.spacer height: 8
-            form.label id: 'status_default', text: 'Default: idle'
-
-            form.spacer height: 12
-            form.hr width: 'matchParent'
-            form.spacer height: 12
-
-            # ── changeDelay ───────────────────────────────────────────────────
-            form.h4 text: 'changeDelay: 1500'
-            form.spacer height: 8
-            form.label text: 'Same input mode, longer pause. Leaving the field still reports right away, rather than waiting out the remaining delay.'
-            form.spacer height: 8
-
-            form.fields_text(
-              name: 'user[slow]',
-              label: 'Slow',
-              placeholder: 'slow',
-              width: 'matchParent',
-              changeDelay: 1500,
-              onChange: ->(action) do
-                action.logics_set(
-                  targetId: 'status_slow',
-                  conditionalData: { text: { 'printf': ['Slow: {0}', { 'var': 'user[slow]' }] } }
-                )
-              end
-            )
-            form.spacer height: 8
-            form.label id: 'status_slow', text: 'Slow: idle'
-
-            form.spacer height: 12
-            form.hr width: 'matchParent'
-            form.spacer height: 12
-
-            # ── changeOn: 'blur' ──────────────────────────────────────────────
-            form.h4 text: "changeOn: 'blur'"
-            form.spacer height: 8
-            form.label text: 'Stays idle no matter how long the user pauses; reports only once focus leaves.'
-            form.spacer height: 8
-
-            form.fields_text(
-              name: 'user[on_blur]',
-              label: 'Reports on blur',
-              placeholder: 'on blur',
-              width: 'matchParent',
-              changeOn: 'blur',
-              onChange: ->(action) do
-                action.logics_set(
-                  targetId: 'status_on_blur',
-                  conditionalData: { text: { 'printf': ['Blur: {0}', { 'var': 'user[on_blur]' }] } }
-                )
-              end
-            )
-            form.spacer height: 8
-            form.label id: 'status_on_blur', text: 'Blur: idle'
-
-            form.spacer height: 12
-            form.hr width: 'matchParent'
-            form.spacer height: 12
-
-            # ── Textarea on blur ──────────────────────────────────────────────
-            form.h4 text: "fields_textarea with changeOn: 'blur'"
-            form.spacer height: 8
-
-            form.fields_textarea(
-              name: 'user[notes]',
-              label: 'Notes',
-              placeholder: 'notes',
-              width: 'matchParent',
-              rows: 3,
-              changeOn: 'blur',
-              onChange: ->(action) do
-                action.logics_set(
-                  targetId: 'status_notes',
-                  conditionalData: { text: { 'printf': ['Notes: {0}', { 'var': 'user[notes]' }] } }
-                )
-              end
-            )
-            form.spacer height: 8
-            form.label id: 'status_notes', text: 'Notes: idle'
-
-            form.spacer height: 16
-            form.fields_submit text: 'Submit'
-          end
-        )
-      end
-    )
-  end
-)

data/lib/generators/glib/snapshot_v2_generator.rb

@@ -1,54 +0,0 @@
-module Glib
-  module Generators
-    # Installs the Glib::SnapshotV2 database prerequisites. Two opt-in pieces, each produced
-    # only when the corresponding flag is passed:
-    #
-    #   `rails g glib:snapshot_v2`                        # adds V2 columns only (required for V2)
-    #   `rails g glib:snapshot_v2 --with-blob-references` # also creates the blob-reference table
-    #
-    # Deliberately separate from `glib:install`: that generator overwrites `config/database.yml`
-    # and writes dynamic-text migrations to the non-standard `db/dynamic_text_migrate/` path,
-    # neither of which a snapshot adopter wants re-run on their app. Snapshot tables live in the
-    # primary DB and use the standard `db/migrate/` path.
-    #
-    # The V2 columns migration adds `action` / `version` / `diff` (jsonb) / `source` plus the
-    # two composite indexes Glib::SnapshotV2's queries rely on. It does NOT backfill — adopters
-    # who need to migrate legacy V1 snapshots (stored under metadata) own that one-way data
-    # conversion themselves. See issue #960.
-    class SnapshotV2Generator < Rails::Generators::Base
-      include Rails::Generators::Migration
-
-      source_root File.expand_path('../templates/snapshot_v2', __dir__)
-
-      class_option :with_blob_references, type: :boolean, default: false,
-                                          desc: 'Also create the snapshot_blob_references table (required to version attached files)'
-
-      def copy_v2_columns_migration
-        migration_template 'add_snapshot_v2_columns.rb',
-                           'db/migrate/add_snapshot_v2_columns.rb'
-      end
-
-      def copy_blob_references_migration
-        return unless options[:with_blob_references]
-
-        migration_template 'create_snapshot_blob_references.rb',
-                           'db/migrate/create_snapshot_blob_references.rb'
-      end
-
-      private
-        # Rails::Generators::Migration requires this class method. Returns the UTC timestamp for
-        # the next migration filename. The mutex + @last_number pair guarantees the second template
-        # (create_snapshot_blob_references) lands strictly AFTER the first (add_snapshot_v2_columns)
-        # within a single invocation — otherwise both share the same timestamp and load order is
-        # non-deterministic.
-        @@migration_mutex = Mutex.new
-
-        def self.next_migration_number(_dirname)
-          @@migration_mutex.synchronize do
-            @last_snapshot_v2_number ||= (Time.now.utc - 1.second).strftime('%Y%m%d%H%M%S')
-            @last_snapshot_v2_number = (@last_snapshot_v2_number.to_i + 1).to_s
-          end
-        end
-    end
-  end
-end

data/lib/generators/templates/snapshot_v2/add_snapshot_v2_columns.rb

@@ -1,18 +0,0 @@
-class AddSnapshotV2Columns < ActiveRecord::Migration[8.0]
-  def change
-    # PostgreSQL has jsonb (binary, indexable); SQLite (used by glib-web's dummy-app) and MySQL
-    # only have json. Pick the richest type the adapter supports so consumers on PG get indexable
-    # diffs while greenfield adopters on SQLite/MySQL still work without edits.
-    diff_type = connection.adapter_name.match?(/PostgreSQL/i) ? :jsonb : :json
-
-    change_table :snapshots, bulk: true do |t|
-      t.string  :action
-      t.integer :version
-      t.column  :diff, diff_type
-      t.string  :source
-    end
-
-    add_index :snapshots, [:action, :item_type, :item_id]
-    add_index :snapshots, [:item_type, :item_id, :version]
-  end
-end

data/lib/generators/templates/snapshot_v2/create_snapshot_blob_references.rb

@@ -1,10 +0,0 @@
-class CreateSnapshotBlobReferences < ActiveRecord::Migration[8.0]
-  def change
-    create_table :snapshot_blob_references do |t|
-      t.belongs_to :snapshot, null: false, foreign_key: { to_table: :snapshots }
-      t.belongs_to :blob, null: false, foreign_key: { to_table: :active_storage_blobs }
-      t.timestamps
-    end
-    add_index :snapshot_blob_references, [:snapshot_id, :blob_id], unique: true
-  end
-end

data/lib/glib/purge_unattached/config.rb

@@ -1,38 +0,0 @@
-require 'active_support/core_ext/numeric/time'
-
-module Glib
-  module PurgeUnattached
-    # Global settings for Glib::PurgeUnattachedJob.
-    #
-    # `min_age` is how long an unattached ActiveStorage blob must exist before
-    # the purge may remove it. The 8-hour default leaves room for multi-step
-    # upload flows (direct upload -> form submit -> attach) to finish before
-    # their blob becomes eligible; apps with slower flows raise it:
-    #
-    #   # config/initializers/glib.rb
-    #   Glib::PurgeUnattached::Config.min_age = 10.hours
-    #
-    # Deliberately NOT a setting on the job class: the job is autoloaded from
-    # app/, so an initializer-assigned value would be wiped the first time the
-    # class is reloaded. This file lives in lib/ and is required eagerly by
-    # glib-web.rb, which is what makes the setting survive reloads.
-    class Config
-      # The shipped default. Apps opt into a different window via the setter.
-      DEFAULT_MIN_AGE = 8.hours
-
-      @@min_age = DEFAULT_MIN_AGE
-
-      def self.min_age
-        @@min_age
-      end
-
-      def self.min_age=(value)
-        unless value.is_a?(ActiveSupport::Duration) && value.positive?
-          raise ArgumentError, "Invalid min_age: #{value.inspect}. Expected a positive ActiveSupport::Duration (e.g. 10.hours)."
-        end
-
-        @@min_age = value
-      end
-    end
-  end
-end

data/lib/glib/test/full_suite_rubocop.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-require 'English'
-
-module Glib
-  module Test
-    # Suite-wide RuboCop auto-remediation, lifted from the per-project
-    # `test/linters/rubocop_test.rb` convention (originated in neowork-str) so
-    # projects get it from the gem via a CONSCIOUS opt-in: include
-    # Glib::Test::RubocopGuards once in the test setup. Never auto-require
-    # this from Glib::TestHelpers — that would enable a file-rewriting test
-    # in every project without a decision. It lints the WHOLE repo, so files
-    # nobody touches cannot silently accumulate offenses.
-    #
-    # Runs `rubocop -a` (safe autocorrect), which REWRITES files on disk to
-    # fix offenses, then asserts nothing remains AND nothing was rewritten.
-    # The mutation is deliberate (the repo's auto-remediation convention —
-    # i18n-tasks normalize runs the same way): a run that dirties a file is
-    # reported as a FAILURE so the rewrite cannot go unnoticed — that is the
-    # drift signal. Do NOT strip the `-a`; review the diff, keep the corrected
-    # output, and re-run. If a long-passing test suddenly breaks, investigate
-    # WHY first: usually a non-canonical file was committed, or a rubocop
-    # version bump changed a cop's rules.
-    #
-    # It self-registers with Minitest, so it runs on EVERY `rails test`
-    # invocation, single-file runs included. That is cheap on purpose: RuboCop
-    # caches per-file results, so a full-repo run on an unchanged tree costs
-    # about a second on a mid-size app.
-    #
-    # Deliberately does NOT skip under ENV['CI']: the local rails-test
-    # wrapper sets CI=true, and skipping here would silence this layer
-    # exactly where it runs. Opt out per-run with SKIP_FULL_SUITE_RUBOCOP=1.
-    class FullSuiteRubocop < ::ActiveSupport::TestCase
-      # `--format simple` offense lines: "C:  12:  3: [Correctable] Cop/Name: message"
-      # (line/column right-aligned to width 3, so the padding is 0-2 spaces).
-      OFFENSE_LINE = /^[A-Z]: *\d+: *\d+: /
-
-      def test_rubocop_autocorrect_then_clean
-        skip 'opted out via SKIP_FULL_SUITE_RUBOCOP' if ENV['SKIP_FULL_SUITE_RUBOCOP'] == '1'
-
-        # `scrub`: stderr is merged in, and one invalid byte would turn the
-        # scans below into an ArgumentError instead of a lint failure.
-        output = `bundle exec rubocop -a --format simple 2>&1`.scrub
-        clean = $CHILD_STATUS.success?
-
-        # Three distinct outcomes hide in one output, and each needs a
-        # different action — the message must say which, or an agent told
-        # only "offenses detected" reaches for a `rubocop:disable`:
-        #   [Corrected]   -a already rewrote it on disk (exit 0 if that's all)
-        #   [Correctable] survived -a because only the UNSAFE -A can fix it
-        #   neither       no autocorrect exists — semantic, read the cop
-        # Counted on the offense LINES only, so a cop message that happens to
-        # contain a marker cannot shift a bucket.
-        offenses = output.lines.grep(OFFENSE_LINE)
-        corrected = offenses.count { |line| line.include?('[Corrected]') }
-        unsafe = offenses.count { |line| line.include?('[Correctable]') }
-        semantic = offenses.size - corrected - unsafe
-
-        # A Proc message is built only on failure (Minitest calls it lazily).
-        assert(clean && corrected.zero?, -> { failure_message(output, corrected: corrected, unsafe: unsafe, semantic: semantic) })
-      end
-
-      private
-        def failure_message(output, corrected:, unsafe:, semantic:)
-          parts = []
-          if corrected.positive?
-            parts << "`rubocop -a` REWROTE #{corrected} offense(s) on disk (the [Corrected] lines below). That is the " \
-                     'drift signal, not a problem with this test: review `git diff`, keep the corrected output, ' \
-                     'and re-run — do not strip the -a.'
-          end
-          if unsafe.positive?
-            parts << "#{unsafe} offense(s) marked [Correctable] survived `-a` because their fix is UNSAFE: apply it " \
-                     'with `rubocop -A <file>` only after checking what it changes, or fix by hand.'
-          end
-          if semantic.positive?
-            parts << "#{semantic} offense(s) have NO autocorrect, so they are semantic, not mechanical: fix each the " \
-                     "way the cop's own message prescribes — DevDoc cops name their prescribed alternative in the " \
-                     "offense itself (full docs: the dev-doc repo's docs/cops/). A `rubocop:disable` is only for " \
-                     "the case a cop's own doc calls genuinely unavoidable; disables already present in a file are " \
-                     'narrow exceptions, not precedent.'
-          end
-          parts << 'RuboCop did not finish cleanly (see output below).' if parts.empty?
-          "#{parts.join("\n\n")}\n\n#{output}"
-        end
-    end
-  end
-end

data/lib/glib/test/rubocop_guards.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module Glib
-  module Test
-    # Conscious opt-in for the suite-time RuboCop guard. Including this module
-    # ONCE in the project's test setup IS the project's explicit decision to
-    # run it. It must stay a separate include precisely because
-    # Glib::TestHelpers is mixed in for unrelated reasons (crawlers, travel
-    # helpers): auto-requiring the guard from there would enable it without
-    # any conscious decision, and FullSuiteRubocop runs `rubocop -a`, which
-    # REWRITES files on disk.
-    #
-    #   class ActiveSupport::TestCase
-    #     include Glib::Test::RubocopGuards # opts in: full-suite `rubocop -a`
-    #   end
-    #
-    # This module is defined as soon as the gem loads (glib/test_helpers
-    # requires it at file level), so the include works on its own — in
-    # ActiveSupport::TestCase or in a single test class — with no ordering
-    # dependency on Glib::TestHelpers.
-    #
-    # What the include switches on: Glib::Test::FullSuiteRubocop — `rubocop -a`
-    # over the whole repo on every `rails test` invocation, failing when
-    # anything was rewritten or remains (runs under CI too).
-    #
-    # MIGRATION NOTE: in the published releases before this change (6.9.3 and
-    # earlier as released), Glib::TestHelpers auto-required a report-only
-    # ChangedFilesRubocop guard (working-tree edits only, skipped under CI),
-    # so every project had it without asking. That guard is retired:
-    # FullSuiteRubocop is a superset, and the local rails-test wrapper sets
-    # CI=true, where the old guard never ran anyway. A project bumping to the
-    # first release that contains this change must add the include line above
-    # or it silently has no suite-time RuboCop guard at all.
-    module RubocopGuards
-      extend ActiveSupport::Concern
-
-      included do
-        require 'glib/test/full_suite_rubocop'
-      end
-    end
-  end
-end