sevgi-function 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7fd50bb171b09d5221092de41845690e2b1e8e05e62811b972306b0522f6cbea
-  data.tar.gz: d8cff5f7b9af0492f0d0824271b4a2dc95069d2d4e82bbab012b56e0b15dc631
+  metadata.gz: cdb33b0136955f83cc59d68d1bf5f316debfcc20dd6f798d077c38ead8a9143b
+  data.tar.gz: c6500ab4812b1c6bac6dd1e61574baa2f6ca0d0344114124f39f915aa6179f7c
 SHA512:
-  metadata.gz: ca877b117f6e9e7d7a3da866b3ac73d6120c820038e0192e0e55bb927c9b28c527f68b16ecf02fddbd69f47435fdb940214e70fe78f2f3d96e4f3a006a9732cd
-  data.tar.gz: 5cced2a22f74bb0836f96d29de58d2d2dd1052d871bcc24bce6ffd1e59ee2760ab71e5bb2f83d36e7cf6bcdb30e3d3f0f6a4c9f7ca755bde02f2cb405948b16c
+  metadata.gz: 8e7eebdc538779ead3fd4e1df77e1215a97aad59774c357828a435a35633472265458ed6a2070a2cd141538570e592dac9794847513ebf9c7e812124fb73dd93
+  data.tar.gz: c48b0c56d4f6d92c0e9650714c363e91acc201ff599268d7f57dd5129ba450b4443dbdb5b3037d25d683bdd20d4167d0e5632333e5f5f830a9d1617ae37b2b99

data/CHANGELOG.md

@@ -3,6 +3,32 @@
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## Unreleased
+
+## 1.1.1 - 2026-10-29
+
+### Fixed
+
+- Pass the configuration flag after the pdfcpu subcommand so A5-on-A4 export works.
+
+## 1.1.0 - 2026-10-29
+
+### Added
+
+- `Classes` returns an element's distinct CSS class names without changing the element; `Classify` shares its attribute normalization.
+- Generic document-local Style declarations with `Target`, `Param`, `Group`, and `Profiles`, and optional prepared PDF export through the native Mainz CLI.
+- Backend-independent `fallback: false` for export failures and `F.executable` for executable path lookup.
+- `F.path` for path validation and expansion, and `F.output_path` for default output names and directory targets.
+
+### Changed
+
+- Moved Graphics XML validation into auxiliary helpers and kept built-in paper dimensions in `Paper`.
+- Shared path validation between Graphics writers and Sundries exports while preserving output paths and error messages.
+
+### Fixed
+
+- Stamp code placeholders in nested and shared PDF Forms, with cycle-safe resource traversal.
+
 ## 1.0.0 - 2026-09-16
 
 ### Added

data/lib/sevgi/function/file.rb

@@ -93,6 +93,40 @@ module Sevgi
         end
       end
 
+      # Resolves an output path, using the default when value is nil or an existing directory.
+      # The default is validated only when used. This method does not create files or directories.
+      # @param value [String, #to_path, nil] explicit output path or directory
+      # @param default [String, #to_path] default output path; its basename is used for a directory target
+      # @param context [String] public operation named in errors
+      # @return [String] expanded output path
+      # @raise [Sevgi::ArgumentError] when a selected path/default is blank, invalid, or cannot be converted
+      def output_path(value, default:, context: "Output")
+        return path(default, context: "#{context} default") if value.nil?
+
+        output = path(value, context: "#{context} path")
+        return output unless ::File.directory?(output)
+
+        default = path(default, context: "#{context} default")
+        ::File.join(output, ::File.basename(default))
+      end
+
+      # Converts a non-blank path to an expanded String without requiring it to exist.
+      # @param value [String, #to_path] raw path value
+      # @param context [String] error-message subject
+      # @return [String] expanded path
+      # @raise [Sevgi::ArgumentError] when value is blank, has an invalid type, or path conversion fails
+      def path(value, context: "Path")
+        path = value.respond_to?(:to_path) ? value.to_path : value
+        ArgumentError.("#{context} must be a String or path-like object") unless path.is_a?(::String)
+        ArgumentError.("#{context} must be provided") if path.strip.empty?
+
+        ::File.expand_path(path)
+      rescue ::Sevgi::ArgumentError
+        raise
+      rescue ::StandardError => e
+        ArgumentError.("#{context} must be a String or path-like object: #{e.message}")
+      end
+
       # Adds a default extension when a path has no extension.
       # @param file [String] file path
       # @param default_extension [String] extension to append without a leading dot

data/lib/sevgi/function/shell.rb

@@ -8,20 +8,30 @@ module Sevgi
     # Command methods promoted to {Sevgi::F}. This module owns the public immutable {Shell::Result} value but is not
     # otherwise a consumer mixin contract.
     module Shell
-      # Checks whether a program exists and is executable.
+      # Returns the absolute path of the first executable regular file, or nil.
       # @param program [Object] program name, absolute path, or relative slash-containing path
-      # @return [Boolean] true when an executable regular file is found
+      # @return [String, nil] absolute executable path, preserving a selected symlink
       # @note PATH is evaluated on every call. Empty PATH segments mean the current directory.
-      def executable?(program)
+      def executable(program)
         program = program.to_s
-        return false if program.empty?
-        return executable_file?(program) if slash_path?(program)
+        return if program.empty?
+        if slash_path?(program)
+          return executable_file?(program) ? ::File.expand_path(program) : nil
+        end
 
-        ENV.fetch("PATH", "").split(::File::PATH_SEPARATOR, -1).any? do |dir|
-          executable_file?(::File.join(dir.empty? ? "." : dir, program))
+        ENV.fetch("PATH", "").split(::File::PATH_SEPARATOR, -1).each do |dir|
+          path = ::File.expand_path(program, dir.empty? ? "." : dir)
+          return path if executable_file?(path)
         end
+        nil
       end
 
+      # Checks whether a program exists and is executable.
+      # @param program [Object] program name, absolute path, or relative slash-containing path
+      # @return [Boolean] true when an executable regular file is found
+      # @see #executable
+      def executable?(program) = !executable(program).nil?
+
       # Requires the first command argument to name an executable program.
       # @param args [Array<Object>] command arguments
       # @return [nil]

data/lib/sevgi/function/version.rb

@@ -3,6 +3,6 @@
 module Sevgi
   module Function
     # Current version of the Sevgi function gem.
-    VERSION = "1.0.0"
+    VERSION = "1.1.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sevgi-function
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Recai Oktaş