typelizer 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 391ff3345874135d72e3875c60aff109ebfd8ce98b0766e51dd1d2a8909e2af9
-  data.tar.gz: 1a3c12dad42402fc5485f3124660e2376db4f8dec7b36d016a8d48a33d568fa0
+  metadata.gz: 067c0e093a70b8c8273e7504004a687c08272a536367958662e9d7c2fe293151
+  data.tar.gz: 6dc5ef91af5f50ead351f90ee6cf8026360f1f605d06df5a30e20a9633ec168b
 SHA512:
-  metadata.gz: 6111652d2f134f20fa6450c1eccaf592a1bade20e0325b49b43a55628e9ac4f7eab1dfbfad09df0aa28893ae898571ccb486d92aa79f23cce682ab3d0c61b8d4
-  data.tar.gz: 1b73e070ce4dc50cc87d1a589a286afffcca8f42f596a6172e9b236e9911c72b45ea391d8e7b20ac8321eb83bb488f871c48d67e2a5ece6672530e0e897a6689
+  metadata.gz: b518818c82709eea2ef5461272c929189d0fa59f53aa3f1cb6309e538ffe586b0bd2117cd520a165def41221f9f05528caf934842584f840f64370ce035488a9
+  data.tar.gz: c89f29ad82e7fa44f3118385ccbd8a6ffb5fde9bbe1d3e400994704fdb8a709ccb9b22f029332cd36da6bdc3c8b190b5c0cf1c9492fa5e11cda4ad7d082c8898

data/CHANGELOG.md

@@ -7,6 +7,55 @@ and this project adheres to [Semantic Versioning].
 
 ## [Unreleased]
 
+## [0.4.1] - 2025-06-10
+
+### Added
+
+- Add option to use double quotes in generated TypeScript interfaces through `prefer_double_quotes` config option ([@kristinemcbride])
+
+### Fixed
+
+- Fix types not being generated on the fly since [0.2.0]. ([@skryukov])
+- Improve memory consumption (~100x less memory) & speed of types generation (~5x faster). ([@skryukov])
+- Fix nullable detection for `belongs_to` associations with `:active_record` strategy. ([@NOX73])
+- Alba: fix unknown type for conditional attribute with `transform_keys`. ([@nkriege])
+
+## [0.4.0] - 2025-05-03
+
+### Added 
+
+- Support for `panko_serializer` gem ([@PedroAugustoRamalhoDuarte], [@skryukov])
+- Mark `has_one` and `belongs_to` association as nullable. ([@skryukov])
+
+  By default, `has_one` associations are marked as nullable in TypeScript interfaces.
+  `belongs_to` associations are marked as nullable if the database column is nullable.
+  Use the new `config.associations_strategy = :active_record` configuration option to mark associations as nullable based on the `required`/`optional` options.  
+  You can also use the type hint `typelize latest_post: {nullable: false}` in the serializer to override the defaults.
+
+- Support inherited typelization. ([@skryukov])
+
+  Set `config.inheritance_strategy = :inheritance` to make Typelizer respect the inheritance hierarchy of serializers:
+
+  ```ruby
+    class AdminSerializer < UserSerializer
+      attributes :admin_level
+    end
+  ```
+  
+  ```typescript
+    // app/javascript/types/serializers/Admin.ts
+    import { User } from "@/types";
+    
+    export type Admin = User & {
+      admin_level: number;
+    }
+  ```
+
+### Fixed
+
+- Alba: always use strings for keys in properties. ([@skryukov])
+  This change will fire update of all hashes for Alba serializers, but it's necessary to support inheritance strategy.
+
 ## [0.3.0] - 2025-02-28
 
 ### Added
@@ -112,11 +161,16 @@ and this project adheres to [Semantic Versioning].
 
 [@davidrunger]: https://github.com/davidrunger
 [@Envek]: https://github.com/Envek
+[@kristinemcbride]: https://github.com/kristinemcbride
+[@nkriege]: https://github.com/nkriege
+[@NOX73]: https://github.com/NOX73
 [@okuramasafumi]: https://github.com/okuramasafumi
 [@patvice]: https://github.com/patvice
 [@skryukov]: https://github.com/skryukov
 
-[Unreleased]: https://github.com/skryukov/typelizer/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/skryukov/typelizer/compare/v0.4.1...HEAD
+[0.4.1]: https://github.com/skryukov/typelizer/compare/v0.4.0...v0.4.1
+[0.4.0]: https://github.com/skryukov/typelizer/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/skryukov/typelizer/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/skryukov/typelizer/compare/v0.1.5...v0.2.0
 [0.1.5]: https://github.com/skryukov/typelizer/compare/v0.1.4...v0.1.5

data/README.md

@@ -29,7 +29,7 @@ Typelizer is a Ruby gem that automatically generates TypeScript interfaces from
 ## Features
 
 - Automatic TypeScript interface generation
-- Support for multiple serializer libraries (`Alba`, `ActiveModel::Serializer`, `Oj::Serializer`)
+- Support for multiple serializer libraries (`Alba`, `ActiveModel::Serializer`, `Oj::Serializer`, `Panko::Serializer`)
 - File watching and automatic regeneration in development
 
 ## Installation
@@ -50,6 +50,10 @@ Include the Typelizer DSL in your serializers:
 class ApplicationResource
   include Alba::Resource
   include Typelizer::DSL
+
+  # For Alba, we recommend using the `helper` method instead of `include`.
+  # See the documentation: https://github.com/okuramasafumi/alba/blob/main/README.md#helper
+  # helper Typelizer::DSL
 end
 
 class PostResource < ApplicationResource
@@ -252,6 +256,16 @@ Typelizer.configure do |config|
   # Strategy for handling null values (:nullable, :optional, or :nullable_and_optional)
   config.null_strategy = :nullable
 
+  # Strategy for handling serializer inheritance (:none, :inheritance)
+  # :none - lists all attributes of the serializer in the type
+  # :inheritance - extends the type from the parent serializer
+  config.inheritance_strategy = :none
+
+  # Strategy for handling `has_one` and `belongs_to` associations nullability (:database, :active_record)
+  # :database - uses the database column nullability
+  # :active_record - uses the `required` / `optional` association options
+  config.associations_strategy = :database
+
   # Directory where TypeScript interfaces will be generated
   config.output_dir = Rails.root.join("app/javascript/types/serializers")
 
@@ -267,6 +281,9 @@ Typelizer.configure do |config|
   # Will change imports and exports of types from default to support this syntax option
   config.verbatim_module_syntax = false
 
+  # Use double quotes in generated TypeScript interfaces (default: false)
+  config.prefer_double_quotes = false
+
   # Support comments in generated TypeScript interfaces (default: false)
   # Will add comments to the generated interfaces
   config.comments = false

data/lib/typelizer/config.rb

@@ -25,7 +25,10 @@ module Typelizer
     :types_import_path,
     :types_global,
     :verbatim_module_syntax,
+    :inheritance_strategy,
+    :associations_strategy,
     :comments,
+    :prefer_double_quotes,
     keyword_init: true
   ) do
     class << self
@@ -47,7 +50,10 @@ module Typelizer
 
           type_mapping: TYPE_MAPPING,
           null_strategy: :nullable,
+          inheritance_strategy: :none,
+          associations_strategy: :database,
           comments: false,
+          prefer_double_quotes: false,
 
           output_dir: js_root.join("types/serializers"),
 

data/lib/typelizer/generator.rb

@@ -16,16 +16,14 @@ module Typelizer
     def call(force: false)
       return unless Typelizer.enabled?
 
-      writer.call(interfaces, force: force)
-
-      interfaces
+      found_interfaces = interfaces
+      writer.call(found_interfaces, force: force)
+      found_interfaces
     end
 
     def interfaces
-      @interfaces ||= begin
-        read_serializers
-        target_serializers.map(&:typelizer_interface).reject(&:empty?)
-      end
+      read_serializers
+      target_serializers.map(&:typelizer_interface).reject(&:empty?)
     end
 
     private
@@ -44,14 +42,10 @@ module Typelizer
 
     def read_serializers(files = nil)
       files ||= Typelizer.dirs.flat_map { |dir| Dir["#{dir}/**/*.rb"] }
-
       files.each do |file|
         trace = TracePoint.new(:call) do |tp|
-          begin
-            next unless tp.self.methods.include?(:typelizer_interface)
-          rescue WeakRef::RefError
-            next
-          end
+          next unless tp.self.is_a?(Class) && tp.self.respond_to?(:typelizer_interface) && tp.self.typelizer_interface.is_a?(Interface)
+
           serializer_plugin = tp.self.typelizer_interface.serializer_plugin
 
           if tp.callee_id.in?(serializer_plugin.methods_to_typelize)

data/lib/typelizer/interface.rb

@@ -17,7 +17,7 @@ module Typelizer
 
     def name
       if inline?
-        Renderer.new("inline_type.ts.erb").call(properties: properties).strip
+        Renderer.call("inline_type.ts.erb", properties: properties).strip
       else
         config.serializer_name_mapper.call(serializer).tr_s(":", "")
       end
@@ -53,20 +53,46 @@ module Typelizer
       end
     end
 
+    def overwritten_properties
+      return [] unless parent_interface
+
+      @overwritten_properties ||= parent_interface.properties - properties
+    end
+
+    def own_properties
+      @own_properties ||= properties - (parent_interface&.properties || [])
+    end
+
+    def properties_to_print
+      parent_interface ? own_properties : properties
+    end
+
+    def parent_interface
+      return if config.inheritance_strategy == :none
+      return unless serializer.superclass.respond_to?(:typelizer_interface)
+
+      interface = serializer.superclass.typelizer_interface
+      return if interface.empty?
+
+      interface
+    end
+
     def imports
-      association_serializers, attribute_types = properties.filter_map(&:type)
-        .uniq
-        .partition { |type| type.is_a?(Interface) }
+      @imports ||= begin
+        association_serializers, attribute_types = properties_to_print.filter_map(&:type)
+          .uniq
+          .partition { |type| type.is_a?(Interface) }
 
-      serializer_types = association_serializers
-        .filter_map { |interface| interface.name if interface.name != name && !interface.inline? }
+        serializer_types = association_serializers
+          .filter_map { |interface| interface.name if interface.name != name && !interface.inline? }
 
-      custom_type_imports = attribute_types
-        .flat_map { |type| extract_typescript_types(type.to_s) }
-        .uniq
-        .reject { |type| global_type?(type) }
+        custom_type_imports = attribute_types
+          .flat_map { |type| extract_typescript_types(type.to_s) }
+          .uniq
+          .reject { |type| global_type?(type) }
 
-      (custom_type_imports + serializer_types).uniq - Array(self_type_name)
+        (custom_type_imports + serializer_types + Array(parent_interface&.name)).uniq - Array(self_type_name)
+      end
     end
 
     def inspect
@@ -74,7 +100,11 @@ module Typelizer
     end
 
     def fingerprint
-      "<#{self.class.name} #{name} properties=[#{properties.map(&:fingerprint).join(", ")}]>"
+      "<#{self.class.name} #{name} properties=[#{properties_to_print.map(&:fingerprint).join(", ")}]>"
+    end
+
+    def quote(str)
+      config.prefer_double_quotes ? "\"#{str}\"" : "'#{str}'"
     end
 
     private

data/lib/typelizer/model_plugins/active_record.rb

@@ -9,6 +9,30 @@ module Typelizer
       attr_reader :model_class, :config
 
       def infer_types(prop)
+        if (association = model_class&.reflect_on_association(prop.column_name.to_sym))
+          case association.macro
+          when :belongs_to
+            foreign_key = association.foreign_key
+            column = model_class&.columns_hash&.dig(foreign_key.to_s)
+            if config.associations_strategy == :database
+              prop.nullable = column.null if column
+            elsif config.associations_strategy == :active_record
+              prop.nullable = association.options[:optional] === true || association.options[:required] === false
+            else
+              raise "Unknown associations strategy: #{config.associations_strategy}"
+            end
+          when :has_one
+            if config.associations_strategy == :database
+              prop.nullable = true
+            elsif config.associations_strategy == :active_record
+              prop.nullable = !association.options[:required]
+            else
+              raise "Unknown associations strategy: #{config.associations_strategy}"
+            end
+          end
+          return prop
+        end
+
         column = model_class&.columns_hash&.dig(prop.column_name.to_s)
         return prop unless column
 

data/lib/typelizer/model_plugins/poro.rb

@@ -1,7 +1,7 @@
 module Typelizer
   module ModelPlugins
     class Poro
-      # We don't care about intialization
+      # We don't care about initialization
       def initialize(...)
       end
 

data/lib/typelizer/property.rb

@@ -9,6 +9,12 @@ module Typelizer
       "<#{self.class.name} #{props}>"
     end
 
+    def eql?(other)
+      return false unless other.is_a?(self.class)
+
+      fingerprint == other.fingerprint
+    end
+
     def to_s
       type_str = type_name
       type_str = "Array<#{type_str}>" if multi
@@ -18,8 +24,10 @@ module Typelizer
     end
 
     def fingerprint
-      props = to_h.merge(type: type_name).reject { |_, v| v.nil? }.map { |k, v| "#{k}=#{v.inspect}" }.join(" ")
-      "<#{self.class.name} #{props}>"
+      props = to_h
+      props[:type] = type_name
+      props = props.filter_map { |k, v| "#{k}=#{v.inspect}" unless v.nil? }
+      "<#{self.class.name} #{props.join(" ")}>"
     end
 
     private

data/lib/typelizer/renderer.rb

@@ -4,6 +4,10 @@ require "erb"
 
 module Typelizer
   class Renderer
+    def self.call(template, **context)
+      new(template).call(**context)
+    end
+
     def initialize(template)
       @erb = ERB.new(File.read(File.join(File.dirname(__FILE__), "templates/#{template}")), trim_mode: "-")
     end
@@ -24,5 +28,9 @@ module Typelizer
       spaces = " " * multiplier
       content.to_s.each_line.map { |line| line.blank? ? line : "#{spaces}#{line}" }.join
     end
+
+    def render(template, **context)
+      Renderer.call(template, **context)
+    end
   end
 end

data/lib/typelizer/serializer_plugins/alba.rb

@@ -13,7 +13,7 @@ module Typelizer
 
       def properties
         serializer._attributes.map do |name, attr|
-          build_property(name, attr)
+          build_property(name.is_a?(Symbol) ? name.name : name, attr)
         end
       end
 
@@ -124,7 +124,7 @@ module Typelizer
             **options
           )
         when ::Alba::ConditionalAttribute
-          build_property(name, attr.instance_variable_get(:@body), optional: true)
+          build_property(column_name, attr.instance_variable_get(:@body), optional: true)
         else
           raise ArgumentError, "Unsupported attribute type: #{attr.class}"
         end

data/lib/typelizer/serializer_plugins/auto.rb

@@ -13,6 +13,8 @@ module Typelizer
             Alba
           elsif defined?(ActiveModel::Serializer) && serializer.ancestors.include?(ActiveModel::Serializer)
             AMS
+          elsif defined?(::Panko::Serializer) && serializer.ancestors.include?(::Panko::Serializer)
+            Panko
           else
             raise "Can't guess serializer plugin for #{serializer}. " \
                     "Please specify it with `config.serializer_plugin`."

data/lib/typelizer/serializer_plugins/panko.rb

@@ -0,0 +1,63 @@
+require_relative "base"
+
+module Typelizer
+  module SerializerPlugins
+    class Panko < Base
+      def methods_to_typelize
+        [:has_many, :has_one, :attributes, :method_added]
+      end
+
+      def properties
+        descriptor = serializer.new.instance_variable_get(:@descriptor)
+        attributes = descriptor.attributes
+        methods_attributes = descriptor.method_fields
+        has_many_associations = descriptor.has_many_associations
+        has_one_associations = descriptor.has_one_associations
+
+        attributes.map do |att|
+          attribute_property(att)
+        end + methods_attributes.map do |att|
+          attribute_property(att)
+        end + has_many_associations.map do |assoc|
+          association_property(assoc, multi: true)
+        end + has_one_associations.map do |assoc|
+          association_property(assoc, multi: false)
+        end
+      end
+
+      def typelize_method_transform(method:, name:, binding:, type:, attrs:)
+        if method == :method_added && binding.local_variable_defined?(:method)
+          name = binding.local_variable_get(:method)
+        end
+
+        super
+      end
+
+      private
+
+      def attribute_property(att)
+        Property.new(
+          name: att.alias_name || att.name,
+          optional: false,
+          nullable: false,
+          multi: false,
+          column_name: att.name
+        )
+      end
+
+      def association_property(assoc, multi: false)
+        key = assoc.name_str
+        serializer = assoc.descriptor.type
+        type = serializer ? Interface.new(serializer: serializer) : nil
+        Property.new(
+          name: key,
+          type: type,
+          optional: false,
+          nullable: false,
+          multi: multi,
+          column_name: key
+        )
+      end
+    end
+  end
+end

data/lib/typelizer/templates/comment.ts.erb

@@ -0,0 +1,8 @@
+<%
+comment = ""
+comment += property.comment.to_s if interface.config.comments
+if property.deprecated
+  comment += "\n@deprecated #{property.deprecated.is_a?(String) ? property.deprecated : ''}"
+end
+-%>
+<%= indent("/** #{comment.strip.split("\n").map(&:strip).join("\n * ")} */\n") unless comment.empty? -%>

data/lib/typelizer/templates/index.ts.erb

@@ -1,7 +1,7 @@
 <%- interfaces.each do |interface| -%>
 <%- if interface.config.verbatim_module_syntax -%>
-export type { <%= interface.name %> } from './<%= interface.filename %>'
+export type { <%= interface.name %> } from <%= interface.quote('./' + interface.filename) %>
 <%- else -%>
-export type { default as <%= interface.name %> } from './<%= interface.filename %>'
-<%- end -%>
+export type { default as <%= interface.name %> } from <%= interface.quote('./' + interface.filename) %>
 <%- end -%>
+<%- end -%>

data/lib/typelizer/templates/inheritance.ts.erb

@@ -0,0 +1 @@
+<%= interface.overwritten_properties.any? ? "Omit<" : "" %><%= interface.parent_interface.name %><%= "[" + interface.quote(interface.parent_interface.root_key) + "]" if interface.parent_interface.root_key %><%= interface.overwritten_properties.any? ? ", " + interface.overwritten_properties.map { |pr| interface.quote(pr.name) }.join(' | ') + ">" : ""%>

data/lib/typelizer/templates/interface.ts.erb

@@ -1,34 +1,28 @@
-<%- if interface.imports.any? -%>
-import type {<%= interface.imports.join(", ") %>} from '<%= interface.config.types_import_path %>'
-<%- end -%>
+<% if interface.imports.any? -%>
+import type {<%= interface.imports.join(", ") %>} from <%= interface.quote(interface.config.types_import_path) %>
+<% end -%>
 
-<%- if interface.root_key -%>
-type <%= interface.name %>Data = {
-<%- interface.properties.each do |property| -%>
+type <%= interface.name %><%= "Data" if interface.root_key %> = <%=
+render("inheritance.ts.erb", interface: interface).strip if interface.parent_interface
+-%>
+<% unless interface.parent_interface && interface.properties_to_print.empty? -%>
+<%= " & " if interface.parent_interface %>{
+<% interface.properties_to_print.each do |property| -%>
+<%= render("comment.ts.erb", interface: interface, property: property) -%>
 <%= indent(property) %>;
-<%- end -%>
+<% end -%>
 }
-
-type <%= interface.name %> = {
-  <%= interface.root_key %>: <%= interface.name %>Data;
-<%- interface.meta_fields&.each do |property| -%>
-<%= indent(property) %>;
-<%- end -%>
-}
-<%- else -%>
+<% end %><% if interface.root_key %>
 type <%= interface.name %> = {
-<%- interface.properties.each do |property| -%>
-<%- comment = "" -%>
-<%- comment += property.comment.to_s if interface.config.comments -%>
-<%- comment += "\n@deprecated #{property.deprecated.is_a?(String) ? property.deprecated : ''}" if property.deprecated -%>
-<%= indent("/** #{comment.strip.split("\n").map(&:strip).join("\n * ")} */\n") unless comment.empty? -%>
+<%= indent(interface.root_key) %>: <%= interface.name %>Data;
+<% interface.meta_fields&.each do |property| -%>
 <%= indent(property) %>;
-<%- end -%>
+<% end -%>
 }
-<%- end -%>
+<% end -%>
 
-<%-if interface.config.verbatim_module_syntax -%>
+<% if interface.config.verbatim_module_syntax -%>
 export type { <%= interface.name %> };
-<%- else -%>
+<% else -%>
 export default <%= interface.name %>;
-<%- end -%>
+<% end -%>

data/lib/typelizer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Typelizer
-  VERSION = "0.3.0"
+  VERSION = "0.4.1"
 end

data/lib/typelizer.rb

@@ -14,6 +14,7 @@ require_relative "typelizer/serializer_plugins/auto"
 require_relative "typelizer/serializer_plugins/oj_serializers"
 require_relative "typelizer/serializer_plugins/alba"
 require_relative "typelizer/serializer_plugins/ams"
+require_relative "typelizer/serializer_plugins/panko"
 
 require_relative "typelizer/model_plugins/active_record"
 require_relative "typelizer/model_plugins/poro"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: typelizer
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Svyatoslav Kryukov
 bindir: bin
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -50,8 +50,11 @@ files:
 - lib/typelizer/serializer_plugins/auto.rb
 - lib/typelizer/serializer_plugins/base.rb
 - lib/typelizer/serializer_plugins/oj_serializers.rb
+- lib/typelizer/serializer_plugins/panko.rb
+- lib/typelizer/templates/comment.ts.erb
 - lib/typelizer/templates/fingerprint.ts.erb
 - lib/typelizer/templates/index.ts.erb
+- lib/typelizer/templates/inheritance.ts.erb
 - lib/typelizer/templates/inline_type.ts.erb
 - lib/typelizer/templates/interface.ts.erb
 - lib/typelizer/version.rb
@@ -80,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: A TypeScript type generator for Ruby serializers.
 test_files: []