normalmapai-url-tools 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 15e6bdeb7a680b598346d9760229e2fe3f67f165832648af14c9946017ca4c22
+  data.tar.gz: 9d59b5608e977f27ee832e4a558fb3ca83768e8fe7405ae6b0b70c123d76eede
+SHA512:
+  metadata.gz: bcfbd24f4fb26ee0ab0c6c7f53af2c23ae5c1b0669f72b4ade43cefb0d8d91902486023a51d64093f78fbe3a78f48d7ced497b09e4bee9a8ccd40756f8a44ee1
+  data.tar.gz: 1e065abc3a790750b99fe67d5ea7fcd00e759ef48ab5eef51e6f25ab11271b18a274e44a3ede3b67bb70fbcff1d0191fb07764ab1fbf8c10101248fd77c12dea

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangneo276-lgtm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,20 @@
+# normalmapai-url-tools
+
+Builds canonical HTTPS URLs for pages that exist on [NormalMapAI](https://normalmapai.com/).
+
+Free normal map generator by NormalMapAI. Convert any photo into a normal map with live 3D preview — plus height, roughness, AO and more. Private in-browser; export for Unity, Unreal, Godot and Blender.
+
+Not an official SDK. The helper only accepts paths that are already on the public site. It does not upload images or call the site.
+
+## Examples
+
+- `canonicalUrl("/height-map-generator/")` → https://normalmapai.com/height-map-generator
+- `canonicalUrl("https://normalmapai.com/app?ref=1#editor")` → https://normalmapai.com/app
+- `mapUrl("roughness")` → https://normalmapai.com/roughness-map-generator
+- `mapUrl("ao")` → https://normalmapai.com/ao-map-generator
+- `guideUrl("directx-vs-opengl-normal-maps")` → https://normalmapai.com/guides/directx-vs-opengl-normal-maps
+- `pageUrl("pricing")` → https://normalmapai.com/pricing
+
+Source: https://github.com/wangneo276-lgtm/normalmapai-url-tools
+
+License: MIT.

data/ruby/lib/normalmapai_url_tools.rb

@@ -0,0 +1,67 @@
+module NormalMapAiUrlTools
+  ORIGIN = 'https://normalmapai.com'.freeze
+  DESCRIPTION = 'Free normal map generator by NormalMapAI. Convert any photo into a normal map with live 3D preview — plus height, roughness, AO and more. Private in-browser; export for Unity, Unreal, Godot and Blender.'.freeze
+  PATHS = ['/', '/app', '/pricing', '/guides', '/about', '/contact', '/privacy', '/terms', '/ai-texture-generator', '/ai-3d-texture', '/ai-3d-model-generator', '/seamless-texture', '/metallic-map-generator', '/curvature-map-generator', '/orm-map-generator', '/glossiness-map-generator', '/albedo-map-generator', '/tileable-texture-generator', '/normal-map-inverter', '/height-to-normal-map', '/normal-to-height-map', '/seamless-texture-checker', '/3d-print-height-map', '/power-of-two-texture-resizer', '/bump-map-generator', '/ao-map-generator', '/roughness-map-generator', '/height-map-generator', '/displacement-map-generator', '/specular-map-generator', '/texture-maker', '/pbr-texture-generator', '/transparent-png', '/image-to-normal-map', '/guides/how-to-use-normal-map-generator', '/guides/how-to-make-seamless-textures', '/guides/import-pbr-maps-unity-unreal-blender', '/guides/pbr-maps-explained', '/guides/height-vs-displacement-maps', '/guides/directx-vs-opengl-normal-maps'].freeze
+  MAPS = {"normal" => "/image-to-normal-map", "height" => "/height-map-generator", "roughness" => "/roughness-map-generator", "ao" => "/ao-map-generator", "bump" => "/bump-map-generator", "displacement" => "/displacement-map-generator", "specular" => "/specular-map-generator", "metallic" => "/metallic-map-generator", "curvature" => "/curvature-map-generator", "orm" => "/orm-map-generator", "glossiness" => "/glossiness-map-generator", "albedo" => "/albedo-map-generator"}.freeze
+  GUIDES = {"how-to-use-normal-map-generator" => "/guides/how-to-use-normal-map-generator", "how-to-make-seamless-textures" => "/guides/how-to-make-seamless-textures", "import-pbr-maps-unity-unreal-blender" => "/guides/import-pbr-maps-unity-unreal-blender", "pbr-maps-explained" => "/guides/pbr-maps-explained", "height-vs-displacement-maps" => "/guides/height-vs-displacement-maps", "directx-vs-opengl-normal-maps" => "/guides/directx-vs-opengl-normal-maps"}.freeze
+  PAGES = {"home" => "/", "app" => "/app", "pricing" => "/pricing", "guides" => "/guides", "about" => "/about", "contact" => "/contact", "privacy" => "/privacy", "terms" => "/terms"}.freeze
+
+  module_function
+
+  def canonical_url(input)
+    raise ArgumentError, 'path required' unless input.is_a?(String)
+    raw = input.strip
+    raise ArgumentError, 'path required' if raw.empty?
+    raise ArgumentError, 'invalid path' if raw.include?('\\') || raw.include?('%')
+    raw = raw.split('#', 2)[0]
+    raw = raw.split('?', 2)[0]
+    lower = raw.downcase
+    if lower.start_with?('https://') || lower.start_with?('http://') || raw.start_with?('//')
+      rest = if lower.start_with?('https://')
+               raw[8..]
+             elsif lower.start_with?('http://')
+               raw[7..]
+             else
+               raw[2..]
+             end
+      slash = rest.index('/')
+      hostport = slash.nil? ? rest : rest[0...slash]
+      path = slash.nil? ? '/' : rest[slash..]
+      raise ArgumentError, 'userinfo not allowed' if hostport.include?('@')
+      raise ArgumentError, 'port not allowed' if hostport.include?(':')
+      raise ArgumentError, 'host not allowed' unless hostport.downcase == 'normalmapai.com'
+    elsif raw.start_with?('/')
+      path = raw
+    else
+      path = '/' + raw
+    end
+    path = path.downcase
+    path = path.gsub(%r{//+}, '/')
+    path.split('/').each do |seg|
+      raise ArgumentError, 'path traversal' if seg == '.' || seg == '..'
+    end
+    path = path.sub(%r{/+$}, '') if path.length > 1
+    path = '/' if path.empty?
+    raise ArgumentError, 'unknown path: ' + path unless PATHS.include?(path)
+    path == '/' ? ORIGIN + '/' : ORIGIN + path
+  end
+
+  def home_url
+    canonical_url('/')
+  end
+
+  def page_url(name)
+    path = PAGES[name] or raise ArgumentError, 'unknown page: ' + name
+    canonical_url(path)
+  end
+
+  def map_url(kind)
+    path = MAPS[kind] or raise ArgumentError, 'unknown map: ' + kind
+    canonical_url(path)
+  end
+
+  def guide_url(slug)
+    path = GUIDES[slug] or raise ArgumentError, 'unknown guide: ' + slug
+    canonical_url(path)
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: normalmapai-url-tools
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- wangneo276-lgtm
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Free normal map generator by NormalMapAI. Convert any photo into a normal
+  map with live 3D preview — plus height, roughness, AO and more. Private in-browser;
+  export for Unity, Unreal, Godot and Blender.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- ruby/lib/normalmapai_url_tools.rb
+homepage: https://normalmapai.com/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://normalmapai.com/
+  source_code_uri: https://github.com/wangneo276-lgtm/normalmapai-url-tools
+rdoc_options: []
+require_paths:
+- ruby/lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: Free normal map generator by NormalMapAI. Convert any photo into a normal
+  map with live 3D preview — plus height, roughness, AO and more. Private in-browser;
+  export for Unity, Unreal, Godot and Blender.
+test_files: []