@awaitio/input-url 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,64 @@
+# AwaitIO License
+
+Copyright © 2026 Orukami s.r.o., Rybná 716/24, 110 00 Praha 1, Czech Republic, company ID 64049159, registered in the Commercial Register kept by the Municipal Court in Prague, section C, file 74046 (the "Licensor")
+
+The source code of AwaitIO is public. Whether you can use it for free depends on how many people use it: small teams use AwaitIO for free, including commercially, while for-profit organizations with more users need a Company License. This keeps AwaitIO free for most people and funds its development.
+
+This license covers everything in this repository, the package `awaitio` and every package published by the Licensor under the `@awaitio` scope on npm, now or in the future, such as `@awaitio/input-text`, `@awaitio/input-textarea` and `@awaitio/input-datetime` (together, "AwaitIO").
+
+## Users
+
+A "user" is a person who uses an application built with AwaitIO, whether it runs locally or is deployed: an employee, a contractor or anyone else who opens it, runs its actions or answers them. What counts is the number of real people, not the number of logins: several people sharing one login are several users. Count each person once across all of your organization's AwaitIO applications and environments.
+
+## Free License
+
+### Who is eligible
+
+You may use AwaitIO for free if you are:
+
+- an individual or a for-profit organization with up to 3 users;
+- a non-profit or not-for-profit organization, or an educational institution; or
+- evaluating whether AwaitIO fits your needs, and not yet using it commercially.
+
+### What you may do
+
+If you are eligible, you are granted permission, free of charge, to:
+
+- use AwaitIO, commercially or not, including in production;
+- build applications and internal tools with AwaitIO, for yourself and for your clients; and
+- modify AwaitIO for your own use, or to contribute fixes and improvements back to AwaitIO.
+
+## Company License
+
+A for-profit organization with more than 3 users needs a Company License to use AwaitIO, priced by the number of users (see the pricing in the README). It allows the same use as the Free License. To get one, write to p.homoky@gmail.com.
+
+Eligibility is decided by the organization that uses AwaitIO. If you build tools with AwaitIO for a client and the client runs them, the client's users count and the client needs a Company License unless it is eligible for the Free License itself.
+
+## Same software, honor system
+
+The Free License and the Company License cover exactly the same software. AwaitIO has no paid features, no license keys, no usage limits and no telemetry, and it never checks which license you have. The licensing works on trust: if your organization needs a Company License, get one.
+
+## What nobody may do
+
+Whatever your license, without a separate written agreement with the Licensor you may not:
+
+1. copy or modify AwaitIO in order to sell, rent, license, relicense or sublicense AwaitIO itself or your own derivative or fork of it;
+2. offer AwaitIO, or a derivative or fork of it, to third parties as a product or service that competes with AwaitIO;
+3. offer to third parties a commercial hosted or managed service built on AwaitIO, such as a dashboard, cloud, monitoring or management service for applications that use AwaitIO; or
+4. sell or license to third parties components, plugins or extensions made for AwaitIO.
+
+Building applications with AwaitIO, running them and handing them over to your clients is none of the above.
+
+## Changes to this license
+
+The Licensor may change this license, including its prices and eligibility, at any time. A change applies to the versions of AwaitIO released after it; each version is governed by the license included with that version.
+
+If you do not agree with the license of a newer version, you may keep using the versions you already have under the license they came with, but you may not upgrade to a version released under the license you do not agree with. Installing or using a newer version means you accept its license.
+
+## Warranty
+
+AwaitIO 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 non-infringement. In no event shall the Licensor 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 AwaitIO or the use of or other dealings in AwaitIO.
+
+## Support
+
+Support is provided on a best-effort basis through GitHub issues. Company License holders get priority.

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# @awaitio/input-url
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+URL input for [AwaitIO](https://awaitio.com): `io.input.url()`, returns a URL.
+
+![A Website field filled with https://example.com/pricing, with help text under it](https://docs.awaitio.com/images/io-input-url.png)
+
+## Install
+
+```bash
+npm install @awaitio/input-url
+```
+
+Needs `awaitio` and `zod` in the app, see the [quickstart](https://docs.awaitio.com/quickstart).
+
+## Setup
+
+Register it under the key you want in `io`, see [Input components](https://docs.awaitio.com/core/input-components):
+
+```ts
+import { inputUrl } from '@awaitio/input-url';
+
+export const app = new AwaitIO({
+  // name, actionsDirectory, theme, secret, users…
+  components: { input: { url: inputUrl } },
+});
+```
+
+## Usage
+
+```ts
+const website = await io.input.url('Website', {
+  placeholder: 'https://example.com',
+});
+
+website.hostname; // 'example.com'
+```
+
+Props, optional, returns, built-in validation and custom validation are on the [Input URL docs page](https://docs.awaitio.com/io/input-url).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { inputUrl } from './inputUrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inputUrl = void 0;
+var inputUrl_1 = require("./inputUrl");
+Object.defineProperty(exports, "inputUrl", { enumerable: true, get: function () { return inputUrl_1.inputUrl; } });

package/dist/inputUrl.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod/v4';
+export declare const inputUrl: import("awaitio").ComponentDefinition<z.ZodObject<{
+    placeholder: z.ZodOptional<z.ZodString>;
+    helpText: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<URL, URL>]>, z.ZodTransform<string, string | URL>>>;
+    allowedProtocols: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<URL, string>>>;
+//# sourceMappingURL=inputUrl.d.ts.map

package/dist/inputUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputUrl.d.ts","sourceRoot":"","sources":["../src/inputUrl.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,QAAQ;;;;;uEAiCnB,CAAC"}

package/dist/inputUrl.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inputUrl = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const awaitio_1 = require("awaitio");
+const ui_1 = require("awaitio/ui");
+const v4_1 = require("zod/v4");
+exports.inputUrl = (0, awaitio_1.defineComponent)({
+    props: v4_1.z.object({
+        placeholder: v4_1.z.string().optional(),
+        helpText: v4_1.z.string().optional(),
+        // A URL from the handler travels as its text.
+        defaultValue: v4_1.z
+            .union([v4_1.z.string(), v4_1.z.instanceof(URL)])
+            .transform((value) => {
+            return value.toString();
+        })
+            .optional(),
+        // Schemes the address may use, without the colon: by default only web addresses.
+        allowedProtocols: v4_1.z.array(v4_1.z.string()).min(1).default(['http', 'https']),
+    }),
+    // The browser sends the text; the handler gets a URL.
+    returns: v4_1.z
+        .string()
+        .trim()
+        .url('enter a URL')
+        .transform((value) => {
+        return new URL(value);
+    }),
+    initialValue: (props) => {
+        return props.defaultValue ?? '';
+    },
+    validate: ({ label, props, value }) => {
+        const protocol = value.protocol.replace(/:$/, '');
+        return props.allowedProtocols.includes(protocol) ? null : `${label} must start with ${props.allowedProtocols.map((allowed) => `${allowed}://`).join(' or ')}.`;
+    },
+    component: ({ props, value, onChange, disabled, autoFocus, optional }) => {
+        return (0, jsx_runtime_1.jsx)(ui_1.Input, { type: "url", inputMode: "url", value: value, onChange: onChange, placeholder: props.placeholder, required: !optional, disabled: disabled, autoFocus: autoFocus });
+    },
+});

package/dist/ui/ui.js

@@ -0,0 +1 @@
+var awaitioComponent=(function(a,l,p,i){"use strict";const u=t=>({kind:"awaitio-component",...t,uiDirectory:null}),s="__AWAITIO__",d=t=>{const e=window[s],n=document.currentScript,o=n instanceof HTMLScriptElement?n.dataset.type:void 0;if(!e||!o)throw new Error("A component UI script must be loaded by the AwaitIO UI.");e.registerComponent(o,t)},m=t=>{const e=window[s],n=document.currentScript,o=n instanceof HTMLScriptElement?n.dataset.type:void 0;if(!e||!o)throw new Error("A display component UI script must be loaded by the AwaitIO UI.");e.registerDisplay(o,t)},w=t=>{const e=window[s],n=document.currentScript,o=n instanceof HTMLScriptElement?n.dataset.type:void 0;if(!e||!o)throw new Error("A layout UI script must be loaded by the AwaitIO UI.");e.registerLayout(o,t)},y=t=>{const e=window[s],n=document.currentScript,o=n instanceof HTMLScriptElement?n.dataset.type:void 0;if(!e||!o)throw new Error("A theme UI script must be loaded by the AwaitIO UI.");e.registerTheme(o,t)},r=u({props:i.z.object({placeholder:i.z.string().optional(),helpText:i.z.string().optional(),defaultValue:i.z.union([i.z.string(),i.z.instanceof(URL)]).transform(t=>t.toString()).optional(),allowedProtocols:i.z.array(i.z.string()).min(1).default(["http","https"])}),returns:i.z.string().trim().url("enter a URL").transform(t=>new URL(t)),initialValue:t=>t.defaultValue??"",validate:({label:t,props:e,value:n})=>{const o=n.protocol.replace(/:$/,"");return e.allowedProtocols.includes(o)?null:`${t} must start with ${e.allowedProtocols.map(c=>`${c}://`).join(" or ")}.`},component:({props:t,value:e,onChange:n,disabled:o,autoFocus:c,optional:f})=>l.jsx(p.Input,{type:"url",inputMode:"url",value:e,onChange:n,placeholder:t.placeholder,required:!f,disabled:o,autoFocus:c})});return Object.values(r).every(t=>t&&t.kind==="awaitio-theme-block")?y({blocks:Object.fromEntries(Object.entries(r).map(([t,e])=>[t,e.component]))}):r.kind==="awaitio-layout"?w({component:r.component}):r.kind==="awaitio-display"?m({component:r.component,wrap:r.wrap??!0}):d({component:r.component,initialValue:r.initialValue,wrap:r.wrap??!0,submitButton:r.submitButton??!0}),a.inputUrl=r,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"}),a})({},__AWAITIO__.jsxRuntime,__AWAITIO__.ui,__AWAITIO__.zod);

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@awaitio/input-url",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "URL input for AwaitIO: io.input.url(), returns a URL.",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "zod": "^3.25.0 || ^4.0.0",
+    "awaitio": "^0.1.0"
+  },
+  "dependencies": {
+    "react": "^19.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "@types/react": "^19.1.0",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@vitejs/plugin-react": "^5.0.0",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vite": "^7.1.0",
+    "vitest": "^3.2.0",
+    "zod": "^4.3.6",
+    "awaitio": "0.1.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && vite build",
+    "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput & vite build --watch",
+    "tsc": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "release": "pnpm build && pnpm publish --access public --no-git-checks"
+  }
 }