stipa 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff378718ea5094cf20614ab1fa80b2ab2fe66b96dbedfc448f230a752034d69d
-  data.tar.gz: db686eb560e89166d73ddf100c6b65695cc288a0f8118e9461edcb0d9b4e8aa8
+  metadata.gz: c22dd3975ab3276a80054b24f2b9e04912139c30e57d2500ffbc79bdf9de37da
+  data.tar.gz: 8013ed53bddd21485caff447749c2c36fcdba2344930e283dc70003097b40337
 SHA512:
-  metadata.gz: bdc3509de75f0de34b898e68ecbd2f3803eaca1959f0c27162c77b2845e8288bf51f0c329be6db0278491a2a5b9c49010952a11bc804fdc79856250b98594c6f
-  data.tar.gz: '072216312185f44a7f236477fd06cfe1a52f2a33fc286ddd6d00f4bfec92f21054345222fa9a5d6b0e2141ffb5f28ff441999e44895debcf42d9d06c04f2cf3c'
+  metadata.gz: a4f9cb7efbc203c13bd8fb2a0071761b3fa28c22b63d843a40eff56a6234a30a5ba342b29da7145f3af46ff6a42ce11e4ba3fa958083e09d1a99873fba19f736
+  data.tar.gz: cae5c45e818554b9732bf6668feff3b932cf9c0cacc107b5678e5a789debe4b89eea691c0f85514be026ae566801fe0159a70f457827722fdb1a0009097e37dc

data/lib/js/stipa-vue.js

@@ -1,5 +1,5 @@
 /**
- * Stīpa Vue Bootstrapper
+ * Stīpa Vue Bootstrapper (ES Module)
  *
  * Automatically mounts Vue 3 components declared with the ERB helper:
  *   <%= vue_component("Counter", props: { initial: 5 }) %>
@@ -7,102 +7,82 @@
  * Which renders on the page as:
  *   <div data-vue-component="Counter" data-props='{"initial":5}'></div>
  *
- * Usage in your layout (after vue_script and component <script> tags):
- *   <%= stipa_vue_bootstrap %>
+ * Usage in your layout:
+ *   <script type="importmap">{ "imports": { "vue": "/vendor/vue.esm-browser.prod.js" } }</script>
+ *   <script type="module" src="/stipa-vue.js"></script>
+ *   <script type="module" src="/app.js"></script>
  *
- * Register components before DOMContentLoaded fires, or call StipaVue.mount()
- * manually after dynamic content is inserted.
- *
- * Example:
- *   <script type="module">
- *     import Counter from '/components/Counter.js'
- *     StipaVue.register('Counter', Counter)
- *   </script>
- *   <%= stipa_vue_bootstrap %>
+ * In app/main.ts, register components and call mount():
+ *   const { StipaVue } = window
+ *   StipaVue.register('Counter', Counter)
+ *   StipaVue.mount()
  */
-(() => {
-	const COMPONENT_ATTR = "data-vue-component";
-	const PROPS_ATTR = "data-props";
-	const MOUNTED_ATTR = "data-stipa-vue-mounted";
+import { createApp } from 'vue'
 
-	const registry = {};
-	const mounted = [];
+const COMPONENT_ATTR = 'data-vue-component'
+const PROPS_ATTR = 'data-props'
+const MOUNTED_ATTR = 'data-stipa-vue-mounted'
 
-	const StipaVue = {
-		register(name, component) {
-			registry[name] = component;
-		},
+const registry = {}
+const mounted = []
 
-		mount(root) {
-			root = root || document;
+const StipaVue = {
+	register(name, component) {
+		registry[name] = component
+	},
 
-			if (typeof Vue === "undefined") {
-				console.error(
-					"[StipaVue] Vue is not defined. Make sure vue_script() appears before stipa_vue_bootstrap() in your layout.",
-				);
-				return;
-			}
+	mount(root) {
+		root = root || document
 
-			// Prune stale entries for elements no longer in the DOM
-			for (let i = mounted.length - 1; i >= 0; i--) {
-				if (!document.contains(mounted[i].el)) {
-					mounted.splice(i, 1);
-				}
+		// Prune stale entries for elements no longer in the DOM
+		for (let i = mounted.length - 1; i >= 0; i--) {
+			if (!document.contains(mounted[i].el)) {
+				mounted.splice(i, 1)
 			}
+		}
 
-			const selector = "[" + COMPONENT_ATTR + "]:not([" + MOUNTED_ATTR + "])";
-			const elements = root.querySelectorAll(selector);
+		const selector = `[${COMPONENT_ATTR}]:not([${MOUNTED_ATTR}])`
+		const elements = root.querySelectorAll(selector)
 
-			elements.forEach((el) => {
-				const name = el.getAttribute(COMPONENT_ATTR);
-				const component = registry[name];
+		elements.forEach((el) => {
+			const name = el.getAttribute(COMPONENT_ATTR)
+			const component = registry[name]
 
-				if (!component) {
-					console.warn(
-						'[StipaVue] Component "' +
-							name +
-							'" is not registered. ' +
-							'Call StipaVue.register("' +
-							name +
-							'", YourComponent) before the DOM loads.',
-					);
-					return;
-				}
+			if (!component) {
+				console.warn(
+					`[StipaVue] Component "${name}" is not registered. ` +
+					`Call StipaVue.register("${name}", YourComponent) before calling StipaVue.mount().`
+				)
+				return
+			}
 
-				let props = {};
-				const propsRaw = el.getAttribute(PROPS_ATTR);
-				if (propsRaw) {
-					try {
-						props = JSON.parse(propsRaw);
-					} catch (e) {
-						console.error('[StipaVue] Failed to parse props for "' + name + '":', e);
-					}
+			let props = {}
+			const propsRaw = el.getAttribute(PROPS_ATTR)
+			if (propsRaw) {
+				try {
+					props = JSON.parse(propsRaw)
+				} catch (e) {
+					console.error(`[StipaVue] Failed to parse props for "${name}":`, e)
 				}
+			}
 
-				const app = Vue.createApp(component, props);
-				app.mount(el);
-
-				el.setAttribute(MOUNTED_ATTR, "1");
-				mounted.push({ app, el });
-			});
-		},
+			const app = createApp(component, props)
+			app.mount(el)
 
-		unmountAll() {
-			mounted.forEach((entry) => {
-				entry.app.unmount();
-				entry.el.removeAttribute(MOUNTED_ATTR);
-			});
-			mounted.length = 0;
-		},
-	};
+			el.setAttribute(MOUNTED_ATTR, '1')
+			mounted.push({ app, el })
+		})
+	},
 
-	// DOMContentLoaded handles the synchronous registration pattern:
-	// components registered via classic <script> tags before this event fires
-	// will be mounted automatically. For async/module-based registration,
-	// call StipaVue.mount() manually after registering.
-	document.addEventListener("DOMContentLoaded", () => {
-		StipaVue.mount();
-	});
+	unmountAll() {
+		mounted.forEach((entry) => {
+			entry.app.unmount()
+			entry.el.removeAttribute(MOUNTED_ATTR)
+		})
+		mounted.length = 0
+	},
+}
 
-	window.StipaVue = StipaVue;
-})();
+window.StipaVue = StipaVue
+export { StipaVue }
+export default StipaVue

data/lib/stipa/generators/api.rb

@@ -23,6 +23,7 @@ module Stipa
 
       def files
         {
+          '.gitignore'                             => t_gitignore,
           'Gemfile'                                => t_gemfile,
           'server.rb'                              => t_server,
           'config/routes.rb'                       => t_routes(
@@ -34,6 +35,10 @@ module Stipa
         }
       end
 
+      def t_gitignore
+        t_gitignore_common
+      end
+
       def t_server
         <<~RUBY
           require 'stipa'

data/lib/stipa/generators/base.rb

@@ -23,6 +23,7 @@ module Stipa
         make_dirs
         write_files
         post_generate
+        init_git
         say done_message
       end
 
@@ -41,14 +42,46 @@ module Stipa
 
       def post_generate = nil
 
+      def init_git
+        return unless git_available?
+
+        Dir.chdir(target) do
+          system('git init -q')
+          system('git add .')
+          system("git commit -q -m 'Initial commit'")
+        end
+        say '  git     initialized repository with initial commit'
+      rescue => e
+        say "  warn    git init failed: #{e.message}"
+      end
+
       def say(msg) = puts(msg)
 
       def app_title
         name.split(/[-_]/).map(&:capitalize).join(' ')
       end
 
+      def git_available?
+        system('git --version > /dev/null 2>&1')
+      end
+
       # ── Shared templates ───────────────────────────────────────────────────────
 
+      def t_gitignore_common
+        <<~GITIGNORE
+          # Ruby
+          .bundle/
+          vendor/bundle/
+          Gemfile.lock
+
+          # OS
+          .DS_Store
+          Thumbs.db
+          *.swp
+          *.swo
+        GITIGNORE
+      end
+
       def t_gemfile
         <<~RUBY
           source 'https://rubygems.org'

data/lib/stipa/generators/vue.rb

@@ -9,13 +9,13 @@ module Stipa
 
       def dirs
         %w[
-          src/config
-          src/controllers
-          src/models
-          src/views/layouts
-          src/views/home
-          src/components
-          public/components
+          app/config
+          app/controllers
+          app/models
+          app/views/layouts
+          app/views/home
+          app/components
+          public/vendor
         ]
       end
 
@@ -42,42 +42,65 @@ module Stipa
             cd #{name}
             bundle install
             npm install
-            npm run build       # compile Vue components
+            npm run build       # copies Vue from node_modules + compiles app bundle
             bundle exec ruby server.rb
+
+          To upgrade Vue:
+            npm install vue@3.x.x
+            npm run build
         DONE
       end
 
       def files
         {
+          '.gitignore'                             => t_gitignore,
           'Gemfile'                                => t_gemfile,
           'package.json'                           => t_package_json,
           'rollup.config.js'                       => t_rollup_config,
           'tsconfig.json'                          => t_tsconfig,
           'server.rb'                                      => t_server,
-          'src/config/routes.rb'                         => t_routes(
+          'app/config/routes.rb'                         => t_routes(
             extra_requires: ['../controllers/home_controller', '../controllers/health_controller'],
             extra_routes:   ["get '/', to: 'home#index'", "get '/api/health', to: 'health#show'"],
             method_override: true,
           ),
-          'src/controllers/application_controller.rb'   => t_application_controller,
-          'src/controllers/home_controller.rb'           => t_home_controller,
-          'src/controllers/health_controller.rb'         => t_health_controller,
-          'src/views/layouts/application.html.erb'      => t_layout,
-          'src/views/home/index.html.erb'                => t_home_index,
+          'app/controllers/application_controller.rb'   => t_application_controller,
+          'app/controllers/home_controller.rb'           => t_home_controller,
+          'app/controllers/health_controller.rb'         => t_health_controller,
+          'app/views/layouts/application.html.erb'      => t_layout,
+          'app/views/home/index.html.erb'                => t_home_index,
           'public/app.css'                               => t_app_css,
-          'src/components/RequestCard.vue'               => t_request_card_vue,
+          'app/components/RequestCard.vue'               => t_request_card_vue,
+          'app/main.ts'                                  => t_main_ts,
+          'app/shims-vue.d.ts'                           => t_shims_vue,
         }
       end
 
+      def t_gitignore
+        t_gitignore_common + <<~GITIGNORE
+
+          # Node
+          node_modules/
+          package-lock.json
+
+          # Build output
+          public/app.js
+          public/app.js.map
+          public/vendor/
+        GITIGNORE
+      end
+
       def t_package_json
         JSON.pretty_generate(
           name: name,
           private: true,
           type: 'module',
           scripts: {
-            build: 'rollup -c',
-            watch: 'rollup -c --watch',
-            dev: 'concurrently "bundle exec ruby server.rb" "rollup -c --watch"',
+            'copy:vue'  => 'cp node_modules/vue/dist/vue.esm-browser.prod.js public/vendor/vue.esm-browser.prod.js',
+            build:       'npm run copy:vue && rollup -c',
+            watch:       'rollup -c --watch',
+            dev:         'npm run copy:vue && concurrently "STIPA_RELOAD=1 bundle exec ruby server.rb" "rollup -c --watch"',
+            typecheck:   'vue-tsc --noEmit',
           },
           devDependencies: {
             'concurrently'              => '^8.0.0',
@@ -87,6 +110,7 @@ module Stipa
             '@vue/compiler-sfc'         => '^3.4.0',
             'typescript'                => '^5.0.0',
             'vue'                       => '^3.4.0',
+            'vue-tsc'                   => '^2.0.0',
           },
         ) + "\n"
       end
@@ -95,30 +119,18 @@ module Stipa
         <<~JS
           import vue from 'rollup-plugin-vue'
           import typescript from '@rollup/plugin-typescript'
-          import { readdirSync } from 'fs'
-
-          const src = './src/components'
-          const out = './public/components'
-
-          const inputs = readdirSync(src).filter(f => f.endsWith('.vue') || f.endsWith('.ts'))
-
-          export default inputs.map(file => {
-            const name = file.replace(/\\.(vue|ts)$/, '')
-            const isTs = file.endsWith('.ts')
-            return {
-              input: `${src}/${file}`,
-              output: {
-                file: `${out}/${name}.js`,
-                format: 'iife',
-                name,
-                globals: { vue: 'Vue' },
-              },
-              external: ['vue'],
-              // rollup-plugin-vue handles <script lang="ts"> internally;
-              // @rollup/plugin-typescript is only needed for plain .ts files.
-              plugins: [vue(), ...(isTs ? [typescript({ tsconfig: './tsconfig.json' })] : [])],
-            }
-          })
+
+          export default {
+            input: 'app/main.ts',
+            output: {
+              file: 'public/app.js',
+              format: 'es',
+            },
+            external: ['vue'],
+            // rollup-plugin-vue handles <script lang="ts"> in .vue SFCs;
+            // @rollup/plugin-typescript compiles app/main.ts and other plain .ts files.
+            plugins: [vue(), typescript({ tsconfig: './tsconfig.json' })],
+          }
         JS
       end
 
@@ -130,20 +142,21 @@ module Stipa
             moduleResolution: 'bundler',
             strict:           true,
             skipLibCheck:     true,
+            allowJs:          true,
           },
-          include: ['src/**/*'],
+          include: ['app/**/*'],
         ) + "\n"
       end
 
       def t_server
         <<~RUBY
           require 'stipa'
-          require_relative 'src/config/routes'
+          require_relative 'app/config/routes'
 
           APP_DIR = __dir__
 
           app = Stipa::App.new(
-            views:  "\#{APP_DIR}/src/views",
+            views:  "\#{APP_DIR}/app/views",
             public: "\#{APP_DIR}/public",
           )
 
@@ -261,17 +274,16 @@ module Stipa
             <link rel="icon" href="/favicon.ico">
             <%= stylesheet_tag '/app.css' %>
 
-            <%# Vue 3 global build — sets window.Vue %>
-            <script src="https://unpkg.com/vue@3/dist/vue.global.prod.js"></script>
+            <%# Pin Vue version via importmap — upgrade by changing vue in package.json and rebuilding %>
+            <script type="importmap">
+              { "imports": { "vue": "/vendor/vue.esm-browser.prod.js" } }
+            </script>
 
-            <%# Stipa Vue bootstrapper — sets window.StipaVue, auto-mounts on DOMContentLoaded %>
+            <%# Stipa Vue bootstrapper — exposes window.StipaVue %>
             <%= stipa_vue_bootstrap %>
 
-            <%# Compiled Vue components — add one block per component %>
-            <script src="/components/RequestCard.js"></script>
-            <script>
-              window.StipaVue.register('RequestCard', window.RequestCard)
-            </script>
+            <%# App bundle — registers components and mounts them %>
+            <script type="module" src="/app.js"></script>
 
             <%# Measure time from first byte to DOMContentLoaded %>
             <script>const _t0 = performance.now()</script>
@@ -396,6 +408,28 @@ module Stipa
 
 
 
+      def t_shims_vue
+        <<~TS
+          declare module '*.vue' {
+            import type { DefineComponent } from 'vue'
+            const component: DefineComponent
+            export default component
+          }
+        TS
+      end
+
+      def t_main_ts
+        <<~TS
+          import RequestCard from './components/RequestCard.vue'
+
+          // window.StipaVue is set by /stipa-vue.js, loaded as a module before this script.
+          const { StipaVue } = window as any
+
+          StipaVue.register('RequestCard', RequestCard)
+          StipaVue.mount()
+        TS
+      end
+
       def t_request_card_vue
         <<~VUE
           <template>

data/lib/stipa/reloader.rb

@@ -0,0 +1,85 @@
+module Stipa
+  # Development file watcher that restarts the process when Ruby source files change.
+  #
+  # Enabled when:
+  #   - STIPA_RELOAD=1 environment variable is set, OR
+  #   - reload: true is passed to App#start / Server#start
+  #
+  # Strategy:
+  #   A background thread polls the mtime of all .rb files visible to Ruby
+  #   ($LOADED_FEATURES) plus any extra watch paths supplied by the user.
+  #   When a change is detected it calls exec($0, *ARGV) which replaces the
+  #   current process image with a fresh one — same PID namespace, same
+  #   command line arguments, all changes picked up from scratch.
+  #
+  # Why exec instead of in-process reload:
+  #   In-process reload requires clearing constants, unloading files, and
+  #   rebuilding the route table. exec is simpler, safer, and handles any
+  #   kind of change (routes, middleware, config, gems) without edge cases.
+  class Reloader
+    DEFAULT_INTERVAL = 0.5 # seconds between polls
+
+    def initialize(logger:, interval: DEFAULT_INTERVAL, watch: [])
+      @logger   = logger
+      @interval = interval
+      @extra    = Array(watch).map { |p| File.expand_path(p) }
+      @mtimes   = {}
+      @thread   = nil
+    end
+
+    def start
+      snapshot!
+      @thread = Thread.new { watch_loop }
+      @thread.name = 'stipa-reloader'
+      @thread.abort_on_exception = false
+      @logger.warn('reloader active — watching for file changes')
+    end
+
+    def stop
+      @thread&.kill
+    end
+
+    private
+
+    def watch_loop
+      loop do
+        sleep @interval
+        if changed?
+          @logger.warn('file change detected — restarting')
+          $stdout.flush
+          $stderr.flush
+          exec($0, *ARGV)
+        end
+      end
+    rescue => e
+      @logger.error("reloader crashed: #{e.class}: #{e.message}")
+    end
+
+    # Collect the current set of watched files: everything Ruby has loaded
+    # plus any extra paths the user specified.
+    def watched_files
+      ($LOADED_FEATURES + @extra).uniq
+    end
+
+    def snapshot!
+      watched_files.each do |path|
+        @mtimes[path] = mtime(path)
+      end
+    end
+
+    def changed?
+      watched_files.any? do |path|
+        current = mtime(path)
+        previous = @mtimes[path]
+        @mtimes[path] = current
+        current != previous
+      end
+    end
+
+    def mtime(path)
+      File.mtime(path)
+    rescue Errno::ENOENT
+      nil
+    end
+  end
+end

data/lib/stipa/server.rb

@@ -53,6 +53,7 @@ module Stipa
       max_body_size:       1 * 1024 * 1024,
       backpressure:        :drop,   # :drop (503) or :block (wait briefly)
       log_level:           :info,
+      reload:              ENV['STIPA_RELOAD'] == '1',
     }.freeze
 
     def initialize(app:, **overrides)
@@ -64,7 +65,8 @@ module Stipa
         queue_depth: @config[:queue_depth],
         on_error:    method(:pool_error),
       )
-      @running = false
+      @running  = false
+      @reloader = @config[:reload] ? Reloader.new(logger: @logger) : nil
     end
 
     # Start the server. Blocks until SIGTERM/SIGINT.
@@ -73,6 +75,7 @@ module Stipa
       @running = true
 
       register_signals
+      @reloader&.start
 
       @logger.info(
         req: nil, res: nil,
@@ -85,6 +88,7 @@ module Stipa
 
       accept_loop
     ensure
+      @reloader&.stop
       @server&.close rescue nil
       @logger.info(req: nil, res: nil, msg: 'Stīpa stopped')
     end

data/lib/stipa/template.rb

@@ -156,7 +156,7 @@ module Stipa
     #
     #   <%= stipa_vue_bootstrap %>
     def stipa_vue_bootstrap(src: '/stipa-vue.js')
-      %(<script src="#{src}"></script>)
+      %(<script type="module" src="#{src}"></script>)
     end
 
     # Include one or more JavaScript files.

data/lib/stipa/version.rb

@@ -1,3 +1,3 @@
 module Stipa
-  VERSION = "0.1.0"
+  VERSION = '0.1.2'
 end

data/lib/stipa.rb

@@ -20,6 +20,7 @@
 require_relative 'stipa/version'
 require_relative 'stipa/logger'
 require_relative 'stipa/thread_pool'
+require_relative 'stipa/reloader'
 require_relative 'stipa/middleware'
 require_relative 'stipa/static'
 require_relative 'stipa/template'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stipa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Pedro Harbs
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-18 00:00:00.000000000 Z
+date: 2026-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -100,6 +100,7 @@ files:
 - lib/stipa/generators/vue.rb
 - lib/stipa/logger.rb
 - lib/stipa/middleware.rb
+- lib/stipa/reloader.rb
 - lib/stipa/request.rb
 - lib/stipa/response.rb
 - lib/stipa/server.rb