tungsten 0.4.14 → 0.5.1

package/types/assets.d.ts

@@ -0,0 +1,21 @@
+//// Importing a stylesheet gives the url of the compiled file, inserted at build. A string so the
+//// value is a valid ContentNode and can be passed as children: `<Stylesheet>{globalStyles}</Stylesheet>`
+//// No import or export in this file: as a script these are ambient declarations, where in a
+//// module they would be augmentations, which cannot add exports
+
+declare module '*.css' {
+    const href: string
+    export default href
+}
+declare module '*.sass' {
+    const href: string
+    export default href
+}
+declare module '*.scss' {
+    const href: string
+    export default href
+}
+declare module '*.less' {
+    const href: string
+    export default href
+}

package/types/index.d.ts

@@ -1,6 +1,15 @@
 
 /* eslint-disable no-var */
 
+// the stylesheet module declarations live in a script file: this one is a module, and a
+// `declare module '*.css'` here would augment the app's own '*.css' declaration, which cannot add exports.
+// A reference, as an import of a script file is refused
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference
+/// <reference path="./assets.d.ts" />
+// Disposable and Symbol.dispose appear in the shipped types (component using(), browser storage), and in
+// TS 6 that lib comes only with ESNext - so bring it in here rather than require it of every app's lib list
+/// <reference lib="esnext.disposable" />
+
 import { CssNames } from 'tungsten/CssNames.js'
 
 //export type { JSX } from './jsx/jsx.d.js'
@@ -12,12 +21,27 @@ declare global {
     var Scss: (style: TemplateStringsArray) => CssNames
     var ReactZoneScss: (style: TemplateStringsArray) => CssNames
     //var Less: (style: TemplateStringsArray) => CssNames
+
+    //// Rewritten at build by BabelTransformDocInit: fn is inlined into the document head and runs
+    //// there before <body>; the call becomes a read of its result (the server gets serverValue).
+    //// fn must be self-contained - only globals like document and localStorage exist in the head.
+    var DocInit: {
+        <T>(fn: () => T, serverValue: NoInfer<T>): T
+        (fn: () => void): void
+    }
 }
 
+//// Apps fill these by declaration merging in their env module: `interface TungstenPrivateEnv extends PrivateEnv {}`.
+//// Empty here on purpose: a base that extended the core env types would collide with an app whose schema
+//// makes a core field required (TS2320). Tungsten's own reads of the core fields come from src/env/Interfaces.ts
+/* eslint-disable @typescript-eslint/no-empty-object-type */
 declare global {
+    interface TungstenPrivateEnv {}
+    interface TungstenPublicEnv {}
     var tungstenPrivateEnv: TungstenPrivateEnv
     var tungstenPublicEnv: TungstenPublicEnv
 }
+/* eslint-enable @typescript-eslint/no-empty-object-type */
 
 //// In dev, cjsHelpers.ts installs a partial `process` on the browser global so that converted
 //// CommonJS packages can read process.env.NODE_ENV. It flags itself with __tungstenCjsShim so
@@ -36,33 +60,4 @@ declare global {
 //     var __T_CurrentElement: TElement // eslint-disable-line no-var
 // }
 
-//// Allow importing css files (treated as exporting the url of the final stylesheet file
-//// as a string, which is actually magically inserted by compilation)
-//// A string is used so that the value is a valid ContentNode and can be passed as children,
-//// e.g. `<Stylesheet>{globalStyles}</Stylesheet>`
-//// For some reason these declarions are recognised, but TS complains unless the project folder
-//// contains an additional `declare module '*.sass'` entry
-
-// declare module '*.css'
-// declare module '*.sass'
-// declare module '*.scss'
-// declare module '*.less'
-
-declare module '*.css' {
-    const href: string
-    export default href
-}
-declare module '*.sass' {
-    const href: string
-    export default href
-}
-declare module '*.scss' {
-    const href: string
-    export default href
-}
-declare module '*.less' {
-    const href: string
-    export default href
-}
-
 export {}

package/types/jsx/html.d.ts

@@ -967,7 +967,6 @@ export interface LiHTMLAttributes<T, BO extends object> extends HTMLAttributes<T
 export interface LinkHTMLAttributes<T> extends HTMLAttributes<T> {
     as?: string | undefined;
     crossOrigin?: 'anonymous' | 'use-credentials' | '' | undefined;
-    fetchpriority?: 'high' | 'low' | 'auto';
     href?: string | undefined;
     hrefLang?: string | undefined;
     integrity?: string | undefined;

package/types/jsx/html.global.d.ts

@@ -15,7 +15,6 @@ interface WheelEvent extends Event { }
 interface EventTarget { }
 interface Document { }
 interface DataTransfer { }
-interface StyleMedia { }
 
 interface Element { }
 interface DocumentFragment { }

package/types/jsx/html.values.d.ts

@@ -7,7 +7,6 @@ export type Booleanish = boolean | 'true' | 'false'
 // ----------------------------------------------------------------------
 
 export interface AbstractView {
-    styleMedia: StyleMedia;
     document: Document;
 }
 

package/types/jsx/jsx.d.ts

@@ -1,5 +1,5 @@
 
-import type { ContentNode, ContentNodeComponent } from 'tungsten/ContentNode.js'
+import type { ContentNode, ContentNodeElement, ContentNodeType } from 'tungsten/ContentNode.js'
 import { TungstenBaseComponent } from 'tungsten/Components.jsx'
 import type { FunctionComponent } from 'tungsten/FunctionComponent.js'
 import type { TungstenRef } from 'tungsten/createRef.js'
@@ -324,16 +324,16 @@ export interface TungstenIntrinsicElements {
     view: SVGProps<SVGViewElement>;
 }
 
-type IntrinsicElement = TungstenIntrinsicElements[keyof TungstenIntrinsicElements]
-
-type TungstenElementType = string | JSXElementConstructor<any>;
-export type TungstenElement = IntrinsicElement | ContentNodeComponent
-export interface TungstenElementAttributesProperty { props: {}; } // eslint-disable-line @typescript-eslint/ban-types
-export interface TungstenElementChildrenAttribute { children: {}; } // eslint-disable-line @typescript-eslint/ban-types
+export type TungstenElement = ContentNodeElement
+export interface TungstenElementAttributesProperty { props: {}; } // eslint-disable-line @typescript-eslint/no-empty-object-type
+export interface TungstenElementChildrenAttribute { children: {}; } // eslint-disable-line @typescript-eslint/no-empty-object-type
 
 declare global {
     namespace JSX {
-        export type Element = ContentNode // ContentNode allows an array. Use Core because Element is exclusive of an array of Elements
+        export type Element = ContentNodeElement // every JSX expression is an element node - a fragment included
+        // what may stand as a tag. Declared (TS 5.1+) so a component's return type is checked against
+        // ContentNode through its own signature, not against Element
+        export type ElementType = ContentNodeType
         export interface ElementAttributesProperty extends TungstenElementAttributesProperty {}
         export interface ElementChildrenAttribute extends TungstenElementChildrenAttribute {}
         export type ElementClass = TungstenBaseComponent<any, any> | FunctionComponent<any, any>

package/vendor/manifest.json

@@ -1,7 +1,7 @@
 {
     "lockfile": {
-        "size": 246952,
-        "mtimeMs": 1788803027627.8281
+        "size": 247038,
+        "mtimeMs": 1789221974883.9106
     },
     "specifiers": {
         "@babel/core": "babel-core",