playbook_ui 15.6.0.pre.alpha.play265012865 → 15.6.0.pre.alpha.play265012993

data/lib/playbook/forms/builder/collection_select_field.rb

@@ -4,10 +4,18 @@ module Playbook
   module Forms
     class Builder
       def collection_select(name, collection, value_method, text_method, options = {}, html_options = {}, props: {})
-        props[:label] = @template.label(@object_name, name) if props[:label] == true
+        props[:input_options] ||= {}
+        props[:input_options][:id] ||= "#{@object_name}_#{name}"
+
+        props[:label] = @template.label(@object_name, name, for: props[:input_options][:id]) if props[:label] == true
+
         options[:skip_default_ids] = false unless options.key?(:skip_default_ids)
         options[:prompt] = props[:blank_selection] || ""
         html_options[:required] = "required" if props[:required]
+        html_options[:id] = props[:input_options][:id]
+        html_options[:class] = props[:input_options][:class] if props[:input_options][:class]
+        html_options[:data] = (html_options[:data] || {}).merge(props[:input_options][:data] || {})
+
         input = super(name, collection, value_method, text_method, options, html_options)
 
         @template.pb_rails("select", props: props) do

data/lib/playbook/forms/builder/select_field.rb

@@ -4,10 +4,18 @@ module Playbook
   module Forms
     class Builder
       def select(name, choices = nil, options = {}, html_options = {}, props: {}, &block)
-        props[:label] = @template.label(@object_name, name) if props[:label] == true
+        props[:input_options] ||= {}
+        props[:input_options][:id] ||= "#{@object_name}_#{name}"
+
+        props[:label] = @template.label(@object_name, name, for: props[:input_options][:id]) if props[:label] == true
+
         options[:skip_default_ids] = false unless options.key?(:skip_default_ids)
         options[:prompt] = props[:blank_selection] || ""
         html_options[:required] = "required" if props[:required]
+        html_options[:id] = props[:input_options][:id]
+        html_options[:class] = props[:input_options][:class] if props[:input_options][:class]
+        html_options[:data] = (html_options[:data] || {}).merge(props[:input_options][:data] || {})
+
         input = super(name, choices, options, html_options, &block)
 
         @template.pb_rails("select", props: props) do

data/lib/playbook/forms/builder/time_zone_select_field.rb

@@ -4,10 +4,18 @@ module Playbook
   module Forms
     class Builder
       def time_zone_select_field(name, choices = {}, options = {}, html_options = {}, props: {})
-        props[:label] = @template.label(@object_name, name) if props[:label] == true
+        props[:input_options] ||= {}
+        props[:input_options][:id] ||= "#{@object_name}_#{name}"
+
+        props[:label] = @template.label(@object_name, name, for: props[:input_options][:id]) if props[:label] == true
+
         options[:skip_default_ids] = false unless options.key?(:skip_default_ids)
         options[:prompt] = props[:blank_selection] || ""
         html_options[:required] = "required" if props[:required]
+        html_options[:id] = props[:input_options][:id]
+        html_options[:class] = props[:input_options][:class] if props[:input_options][:class]
+        html_options[:data] = (html_options[:data] || {}).merge(props[:input_options][:data] || {})
+
         input = @template.time_zone_select(@object_name, name, choices, options, html_options)
 
         @template.pb_rails("select", props: props) do

data/lib/playbook/pb_kit_helper.rb

@@ -13,5 +13,40 @@ module Playbook
         render kit.new(props, &block), &block
       end
     end
+
+    def deprecated_kit_warning(kit_name, message = nil)
+      # Skip in test and production environments
+      return "".html_safe if Rails.env.test? || Rails.env.production?
+
+      # Build the warning message
+      base_message = "PLAYBOOK DEPRECATION WARNING\\n  ----------------------------\\n  The \\\"#{kit_name}\\\" kit is deprecated and will be removed in a future version."
+
+      full_message = if message
+                       "#{base_message} #{message}"
+                     else
+                       "#{base_message} Please migrate to the recommended alternative"
+                     end
+
+      # Escape the message for JavaScript
+      escaped_message = full_message.gsub("'", "\\\\'").gsub("\n", "\\n")
+
+      # Return a self-executing script that checks if we're already warned
+      # Uses client-side tracking to ensure one warning per page load
+      # Only shows warnings on localhost (matching React behavior)
+      script = "<script type=\"text/javascript\">\n"
+      script += "(function() {\n"
+      script += "  var hostname = window.location.hostname;\n"
+      script += "  var isLocalDev = hostname === 'localhost' || hostname === '127.0.0.1' || hostname.endsWith('.local') || hostname.includes('local.') || !hostname;\n"
+      script += "  if (!isLocalDev) return;\n"
+      script += "  if (!window.__PB_WARNED_KITS__) window.__PB_WARNED_KITS__ = new Set();\n"
+      script += "  if (!window.__PB_WARNED_KITS__.has('#{kit_name}')) {\n"
+      script += "    window.__PB_WARNED_KITS__.add('#{kit_name}');\n"
+      script += "    console.warn('#{escaped_message}');\n"
+      script += "  }\n"
+      script += "})();\n"
+      script += "</script>"
+
+      script.html_safe
+    end
   end
 end

data/lib/playbook/version.rb

@@ -2,5 +2,5 @@
 
 module Playbook
   PREVIOUS_VERSION = "15.6.0"
-  VERSION = "15.6.0.pre.alpha.play265012865"
+  VERSION = "15.6.0.pre.alpha.play265012993"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: playbook_ui
 version: !ruby/object:Gem::Version
-  version: 15.6.0.pre.alpha.play265012865
+  version: 15.6.0.pre.alpha.play265012993
 platform: ruby
 authors:
 - Power UX
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-05 00:00:00.000000000 Z
+date: 2025-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -2935,6 +2935,9 @@ files:
 - app/pb_kits/playbook/pb_select/docs/_select_inline_compact.jsx
 - app/pb_kits/playbook/pb_select/docs/_select_inline_show_arrow.html.erb
 - app/pb_kits/playbook/pb_select/docs/_select_inline_show_arrow.jsx
+- app/pb_kits/playbook/pb_select/docs/_select_input_options.html.erb
+- app/pb_kits/playbook/pb_select/docs/_select_input_options.jsx
+- app/pb_kits/playbook/pb_select/docs/_select_input_options.md
 - app/pb_kits/playbook/pb_select/docs/_select_multiple.html.erb
 - app/pb_kits/playbook/pb_select/docs/_select_multiple.jsx
 - app/pb_kits/playbook/pb_select/docs/_select_multiple.md
@@ -3799,7 +3802,6 @@ files:
 - app/pb_kits/playbook/tokens/exports/_typography.module.scss
 - app/pb_kits/playbook/tokens/exports/exports.d.ts
 - app/pb_kits/playbook/tokens/index.scss
-- app/pb_kits/playbook/utilities/DEPRECATION_WARNINGS.md
 - app/pb_kits/playbook/utilities/_background_colors.scss
 - app/pb_kits/playbook/utilities/_border_radius.scss
 - app/pb_kits/playbook/utilities/_colors.scss
@@ -3863,9 +3865,9 @@ files:
 - app/pb_kits/playbook/utilities/test/globalProps/truncate.test.js
 - app/pb_kits/playbook/utilities/text.ts
 - app/pb_kits/playbook/utilities/validEmojiChecker.ts
-- dist/chunks/_typeahead-Mjy3POtc.js
+- dist/chunks/_typeahead-DMyvWpig.js
 - dist/chunks/lazysizes-B7xYodB-.js
-- dist/chunks/lib-CgpqUb6l.js
+- dist/chunks/lib-DDDLiZuu.js
 - dist/chunks/vendor.js
 - dist/menu.yml
 - dist/playbook-rails-react-bindings.js

data/app/pb_kits/playbook/utilities/DEPRECATION_WARNINGS.md

@@ -1,82 +0,0 @@
-# Deprecation Warning System for React Kits
-
-## Overview
-
-This system provides runtime console warnings when deprecated Playbook kits are used in development mode. It helps developers identify deprecated kit usage in Nitro, Tempo, Runway, and other apps without impacting production builds.
-
-## How It Works
-
-### Key Features
-
-✅ **Once per page load**: Each deprecated kit logs exactly one warning per page load, preventing spam on re-renders  
-✅ **Dev mode only**: No warnings in production builds (`process.env.NODE_ENV === 'production'`)  
-✅ **Platform-specific**: Can warn only for React or Rails, or both  
-✅ **Customizable messages**: Default or custom deprecation messages
-
-## Usage
-
-### Step 1: Import the utility
-
-In your kit's main React component file (e.g., `_bar_graph.tsx`):
-
-```tsx
-import { deprecatedKitWarning } from "../utilities/deprecated";
-```
-
-### Step 2: Add the warning in a useEffect hook
-
-Add a `useEffect` hook that calls the warning once when the component mounts:
-
-```tsx
-const YourKit = (props: YourKitProps): React.ReactElement => {
-
-  useEffect(() => {
-    deprecatedKitWarning('YourKitName', 'Optional custom message');
-  }, []); // Empty dependency array ensures it runs once
-
-  // rest of component
-};
-```
-
-
-## API Reference
-
-### `deprecatedKitWarning(kitName, message?)`
-
-**Parameters:**
-- `kitName` (string, required): Name of the deprecated kit (e.g., 'BarGraph')
-- `message` (string, optional): Custom deprecation message. If omitted, uses default.
-
-**Default message format:**
-```
-[Playbook] The "{kitName}" kit is deprecated and will be removed in a future version. Please migrate to the recommended alternative.
-```
-
-**Behavior:**
-- Only logs in development mode (`process.env.NODE_ENV !== 'production'`)
-- Tracks warned kits in a Set to prevent duplicate warnings
-- Silent in production builds
-
-
-## Best Practices
-
-### 1. Place the warning early in the component lifecycle
-```tsx
-useEffect(() => {
-  deprecatedKitWarning('YourKit');
-}, []); // Run once on mount
-```
-
-### 2. Provide helpful migration messages
-```tsx
-deprecatedKitWarning(
-  'BarGraph', 
-  '[Playbook] The "BarGraph" kit is deprecated. Please use "PbBarGraph" instead.'
-);
-```
-
-### 3. Check menu.yml before applying
-Always verify the kit's status in `playbook-website/config/menu.yml` to ensure it's actually deprecated for React.
-
-### 4. Don't over-warn
-The utility handles deduplication, but keep it to one `deprecatedKitWarning` call per kit component.